@catladder/cli 0.0.0-next-8b9ad5ca → 0.0.0-next-6a4450e0

package/dist/bundles/catenv/index.js

@@ -1522,7 +1522,11 @@ const createAllJobs_1 = __nccwpck_require__(3671);
 const config_1 = __nccwpck_require__(6925);
 const ciVariables_1 = __nccwpck_require__(3093);
 const createGithubJobs_1 = __nccwpck_require__(4016);
+const jobImagesPlan_1 = __nccwpck_require__(1585);
+const scriptFunctions_1 = __nccwpck_require__(5759);
+const utils_1 = __nccwpck_require__(595);
 const githubReleaseJobs_1 = __nccwpck_require__(5611);
+const scriptFiles_1 = __nccwpck_require__(9189);
 const WORKFLOWS_FOLDER = ".github/workflows";
 /**
  * generated workflow files are prefixed so that cleanup never touches
@@ -1567,18 +1571,29 @@ class GithubBackend {
   async cleanup() {
     const entries = await (0, promises_1.readdir)(WORKFLOWS_FOLDER).catch(() => []);
     await Promise.all(entries.filter(file => file.startsWith(GENERATED_FILE_PREFIX)).map(file => (0, promises_1.unlink)((0, path_1.join)(WORKFLOWS_FOLDER, file))));
+    await (0, promises_1.rm)(scriptFiles_1.GITHUB_SCRIPTS_FOLDER, {
+      recursive: true,
+      force: true
+    });
   }
   async createFiles(config) {
-    const workflows = await this.createWorkflows(config);
-    return Object.entries(workflows).map(([fileName, workflow]) => ({
+    const images = this.createImagesPlan(config);
+    const scripts = new scriptFiles_1.GithubScriptFiles();
+    const workflows = await this.createWorkflows(config, images, scripts);
+    return [...Object.entries(workflows).map(([fileName, workflow]) => ({
       path: (0, path_1.join)(WORKFLOWS_FOLDER, fileName),
       content: workflow
-    }));
+    })),
+    // materialized job scripts and image definitions (repo mode)
+    ...scripts.getGeneratedFiles(), ...images.getGeneratedFiles()];
+  }
+  createImagesPlan(config) {
+    return new jobImagesPlan_1.JobImagesPlan((0, jobImagesPlan_1.getJobImagesMode)(config, this.type), this.type);
   }
   /**
    * all workflows keyed by file name, mainly for testing purposes
    */
-  async createWorkflows(config) {
+  async createWorkflows(config, images = this.createImagesPlan(config), scripts = new scriptFiles_1.GithubScriptFiles()) {
     const workflows = {};
     const reviewStopJobs = {};
     const manualJobs = {};
@@ -1589,13 +1604,14 @@ class GithubBackend {
         pipelineType: this.type
       });
       const uploadProviderIds = (0, createGithubJobs_1.getUploadProviderIds)(allJobs);
+      const secretKinds = (0, createGithubJobs_1.collectSecretKinds)(allJobs);
       const jobs = {};
       // NOTE: agent jobs are gitlab-only and skipped on github
       [...allJobs.workspaces, ...allJobs.components].forEach(({
         context,
         jobs: contextJobs
       }) => contextJobs.forEach(job => {
-        const [id, githubJob] = (0, createGithubJobs_1.makeGithubJob)(context, job, allJobs, uploadProviderIds);
+        const [id, githubJob] = (0, createGithubJobs_1.makeGithubJob)(context, job, allJobs, uploadProviderIds, images, scripts, secretKinds);
         if (isReviewStopJob(context, job)) {
           reviewStopJobs[id] = githubJob;
         } else if (isManualTaskJob(job)) {
@@ -1605,15 +1621,19 @@ class GithubBackend {
         }
       }));
       if (trigger === "mainBranch") {
-        const releaseJobs = (0, githubReleaseJobs_1.getGithubReleaseJobs)(config, Object.keys(jobs));
+        const releaseJobs = (0, githubReleaseJobs_1.getGithubReleaseJobs)(config, Object.keys(jobs), images);
         Object.assign(jobs, releaseJobs.main);
         Object.assign(manualJobs, releaseJobs.manual);
       }
       if (Object.keys(jobs).length > 0) {
         workflows[`${GENERATED_FILE_PREFIX}${workflowFileName(trigger)}`] = {
           ...TRIGGER_WORKFLOWS[trigger],
+          ...workflowPermissions(images),
           env: ciVariables_1.GITHUB_INJECTED_WORKFLOW_ENV,
-          jobs
+          jobs: {
+            ...makeEnsureImageGithubJobs(images),
+            ...jobs
+          }
         };
       }
     }
@@ -1625,8 +1645,12 @@ class GithubBackend {
             types: ["closed"]
           }
         },
+        ...workflowPermissions(images),
         env: ciVariables_1.GITHUB_INJECTED_WORKFLOW_ENV,
-        jobs: reviewStopJobs
+        jobs: {
+          ...makeEnsureImageGithubJobs(images),
+          ...reviewStopJobs
+        }
       };
     }
     if (Object.keys(manualJobs).length > 0) {
@@ -1644,17 +1668,51 @@ class GithubBackend {
             }
           }
         },
+        ...workflowPermissions(images),
         env: ciVariables_1.GITHUB_INJECTED_WORKFLOW_ENV,
-        jobs: Object.fromEntries(Object.entries(manualJobs).map(([id, job]) => [id, {
-          ...job,
-          if: `\${{ inputs.job == '${id}' }}`
-        }]))
+        jobs: {
+          ...makeEnsureImageGithubJobs(images),
+          ...Object.fromEntries(Object.entries(manualJobs).map(([id, job]) => [id, {
+            ...job,
+            if: `\${{ inputs.job == '${id}' }}`
+          }]))
+        }
       };
     }
     return workflows;
   }
 }
 exports.GithubBackend = GithubBackend;
+/**
+ * repo mode needs packages:write for pushing job images to ghcr
+ */
+const workflowPermissions = images => images.mode === "repo" ? {
+  permissions: {
+    contents: "read",
+    packages: "write"
+  }
+} : {};
+/**
+ * the image build jobs: always run (github has no server-side
+ * changes-filter), the existence check makes unchanged runs fast.
+ * Docker is native on github runners — no container, no dind.
+ */
+const makeEnsureImageGithubJobs = images => Object.fromEntries(images.getEnsureJobs().map(job => {
+  var _a, _b;
+  return [(0, createGithubJobs_1.githubGlobalJobId)(job.name), {
+    name: job.name,
+    "runs-on": "ubuntu-latest",
+    steps: [{
+      name: "Checkout",
+      uses: "actions/checkout@v4"
+    }, {
+      name: job.name,
+      id: "main",
+      run: [...(0, scriptFunctions_1.getGithubScriptFunctionDefinitions)(), ...((_b = (_a = job.script) === null || _a === void 0 ? void 0 : _a.filter(utils_1.notNil)) !== null && _b !== void 0 ? _b : [])].join("\n"),
+      shell: "bash"
+    }]
+  }];
+}));
 const workflowFileName = trigger => {
   switch (trigger) {
     case "mr":
@@ -1705,7 +1763,8 @@ exports.GITHUB_CI_VARIABLES = {
   jobToken: "CL_JOB_TOKEN",
   jobImage: "CL_JOB_IMAGE",
   registry: "CL_REGISTRY",
-  registryImage: "CL_REGISTRY_IMAGE"
+  registryImage: "CL_REGISTRY_IMAGE",
+  registryUser: "CL_REGISTRY_USER"
 };
 /**
  * the workflow-level env the backend injects to provide the CL_*
@@ -1715,6 +1774,7 @@ exports.GITHUB_INJECTED_WORKFLOW_ENV = {
   CL_JOB_TOKEN: "${{ github.token }}",
   CL_REGISTRY: "ghcr.io",
   CL_REGISTRY_IMAGE: "ghcr.io/${{ github.repository }}",
+  CL_REGISTRY_USER: "${{ github.actor }}",
   // empty outside of pull request events
   CL_PR_NUMBER: "${{ github.event.number }}"
 };
@@ -1730,7 +1790,7 @@ exports.GITHUB_INJECTED_WORKFLOW_ENV = {
 Object.defineProperty(exports, "__esModule", ({
   value: true
 }));
-exports.getUploadProviderIds = exports.makeGithubJob = exports.resolveGithubNeeds = exports.githubJobId = void 0;
+exports.getUploadProviderIds = exports.makeGithubJob = exports.collectSecretKinds = exports.resolveGithubNeeds = exports.githubGlobalJobId = exports.githubJobId = void 0;
 const lodash_es_1 = __nccwpck_require__(4284);
 const getInjectVarsScript_1 = __nccwpck_require__(436);
 const createJobCache_1 = __nccwpck_require__(5644);
@@ -1738,6 +1798,7 @@ const getEnvironmentVariables_1 = __nccwpck_require__(5855);
 const utils_1 = __nccwpck_require__(595);
 const gitlab_1 = __nccwpck_require__(3468);
 const scriptFunctions_1 = __nccwpck_require__(5759);
+const ciVariables_1 = __nccwpck_require__(3093);
 /**
  * runner variables that only make sense on gitlab runners and must not
  * leak into github jobs (docker-in-docker daemon config, kubernetes
@@ -1756,6 +1817,9 @@ const slug = value => {
 };
 const githubJobId = (context, jobName) => slug(`${context.type === "workspace" ? "ws-" : ""}${context.name}-${jobName}-${context.env}`);
 exports.githubJobId = githubJobId;
+/** id of a job without component/workspace context (e.g. image builds) */
+const githubGlobalJobId = jobName => slug(jobName);
+exports.githubGlobalJobId = githubGlobalJobId;
 const githubJobName = (context, jobName) => `${context.name} ${jobName} | ${context.env}`;
 const resolveNeed = (context, need, allJobs) => {
   var _a;
@@ -1777,6 +1841,12 @@ const resolveNeed = (context, need, allJobs) => {
     return (0, exports.githubJobId)(provider.context, jobName);
   };
   if ((0, lodash_es_1.isObject)(need)) {
+    if ("global" in need && need.global) {
+      return {
+        id: (0, exports.githubGlobalJobId)(need.job),
+        artifacts: need.artifacts
+      };
+    }
     if ("workspaceName" in need && need.workspaceName) {
       return {
         id: findWorkspaceJob(need.workspaceName, need.job),
@@ -1794,9 +1864,9 @@ const resolveNeed = (context, need, allJobs) => {
     artifacts: true
   };
 };
-const resolveGithubNeeds = (context, job, allJobs) => {
+const resolveGithubNeeds = (context, job, allJobs, extraNeeds = []) => {
   var _a;
-  const resolved = ((_a = job.needs) !== null && _a !== void 0 ? _a : []).map(need => resolveNeed(context, need, allJobs));
+  const resolved = [...extraNeeds, ...((_a = job.needs) !== null && _a !== void 0 ? _a : [])].map(need => resolveNeed(context, need, allJobs));
   // deduplicate by provider id, explicit entries win (they come last)
   return [...new Map(resolved.map(n => [n.id, n])).values()].sort((a, b) => a.id.localeCompare(b.id));
 };
@@ -1837,29 +1907,73 @@ const createCacheSteps = (context, job) => {
     };
   });
 };
-const getSecretsEnv = context => {
+/**
+ * how a vault-stored value reaches the job env: masked github secret,
+ * or plain (unmasked) github variable for non-sensitive values — those
+ * stay readable in logs and usable in environment urls
+ */
+const vaultValueExpression = (name, kinds) => kinds.get(name) === "variable" ? `\${{ vars.${name} }}` : `\${{ secrets.${name} }}`;
+/**
+ * the kind of every vault-stored var of all components, keyed by its
+ * CL_* name — the lookup for cross-component references
+ */
+const collectSecretKinds = allJobs => {
+  const kinds = new Map();
+  allJobs.components.forEach(({
+    context
+  }) => {
+    var _a, _b;
+    const entries = [...context.environment.secretEnvVarKeys, ...((_a = context.environment.jobOnlyVars.build.secretEnvVarKeys) !== null && _a !== void 0 ? _a : []), ...((_b = context.environment.jobOnlyVars.deploy.secretEnvVarKeys) !== null && _b !== void 0 ? _b : [])];
+    entries.forEach(({
+      key,
+      kind
+    }) => kinds.set((0, getEnvironmentVariables_1.getSecretVarName)(context.env, context.name, key), kind !== null && kind !== void 0 ? kind : "secret"));
+  });
+  return kinds;
+};
+exports.collectSecretKinds = collectSecretKinds;
+const getSecretsEnv = (context, kinds) => {
   var _a, _b;
   const keys = [...context.environment.secretEnvVarKeys, ...((_a = context.environment.jobOnlyVars.build.secretEnvVarKeys) !== null && _a !== void 0 ? _a : []), ...((_b = context.environment.jobOnlyVars.deploy.secretEnvVarKeys) !== null && _b !== void 0 ? _b : [])];
   return Object.fromEntries(keys.map(({
     key
   }) => {
     const name = (0, getEnvironmentVariables_1.getSecretVarName)(context.env, context.name, key);
-    return [name, `\${{ secrets.${name} }}`];
+    return [name, vaultValueExpression(name, kinds)];
   }));
 };
-const makeGithubJob = (context, job, allJobs, uploadProviderIds) => {
+/**
+ * every CL_* variable the job script reads must exist in the job env.
+ * On gitlab all project variables are implicitly available in every
+ * job — cross-component references (`${other-component:KEY}`) rely on
+ * that. Github jobs only see what is injected explicitly, so the
+ * script is scanned for the names it actually references.
+ */
+const getReferencedSecretsEnv = (script, kinds) => Object.fromEntries([...script.matchAll(/\$\{?(CL_[A-Za-z0-9_]+)\}?/g)].map(match => match[1]).filter(name => !(name in ciVariables_1.GITHUB_INJECTED_WORKFLOW_ENV)).map(name => [name, vaultValueExpression(name, kinds)]));
+const makeGithubJob = (context, job, allJobs, uploadProviderIds, images, scripts, secretKinds = new Map()) => {
   var _a, _b, _c, _d, _e, _f, _g, _h, _j;
   const id = (0, exports.githubJobId)(context, job.name);
   const isComponent = context.type === "component";
   const createsJobEnv = !!job.environment && isComponent && (!job.environment.action || job.environment.action === "start");
   const skipCheckout = ((_a = job.runnerVariables) === null || _a === void 0 ? void 0 : _a.GIT_STRATEGY) === "none";
-  const needs = (0, exports.resolveGithubNeeds)(context, job, allJobs);
-  const image = typeof job.image === "string" ? job.image : Array.isArray(job.image) ? job.image[0] : (_b = job.image) === null || _b === void 0 ? void 0 : _b.name;
+  const resolved = images.resolve(job.image);
+  const needs = (0, exports.resolveGithubNeeds)(context, job, allJobs, resolved.need ? [resolved.need] : []);
+  const image = typeof resolved.image === "string" ? resolved.image : Array.isArray(resolved.image) ? resolved.image[0] : (_b = resolved.image) === null || _b === void 0 ? void 0 : _b.name;
   const runScript = [...(0, scriptFunctions_1.getGithubScriptFunctionDefinitions)(), ...(0, gitlab_1.collapseableSection)("injectvars", "Injecting variables")((0, getInjectVarsScript_1.getInjectVarsScript)((_c = job.variables) !== null && _c !== void 0 ? _c : {})), ...((_e = (_d = job.script) === null || _d === void 0 ? void 0 : _d.filter(utils_1.notNil)) !== null && _e !== void 0 ? _e : []), ...(createsJobEnv ? [`echo "url=$ROOT_URL" >> "$GITHUB_OUTPUT"`] : [])].join("\n");
+  // scripts live in committed files to keep workflows under github's
+  // 512 KB limit. Two classes of jobs must keep their script inline:
+  // jobs without a checkout have no repo files, and `${{ }}` expressions
+  // are only interpolated inside the workflow file itself.
+  const run = skipCheckout || runScript.includes("${{") ? runScript : scripts.add(id, runScript);
   const artifactPaths = (_g = (_f = job.artifacts) === null || _f === void 0 ? void 0 : _f.paths) !== null && _g !== void 0 ? _g : [];
-  const services = Object.fromEntries(((_h = job.services) !== null && _h !== void 0 ? _h : []).map(service => typeof service === "string" ? {
+  const declaredServices = ((_h = job.services) !== null && _h !== void 0 ? _h : []).map(service => typeof service === "string" ? {
     name: service
-  } : service).filter(service => !isDindService(service.name)).map(service => [slug("alias" in service && service.alias ? service.alias : service.name), {
+  } : service);
+  // docker runs natively on github runners, so gitlab's docker-in-docker
+  // services are dropped. The job container stays: the runner mounts the
+  // host's docker socket into it, and images like docker-build carry the
+  // helper scripts (ensure*Dockerfile etc.) the job scripts rely on.
+  const services = Object.fromEntries(declaredServices.filter(service => !isDindService(service.name)).map(service => [slug("alias" in service && service.alias ? service.alias : service.name), {
     image: service.name,
     ...("variables" in service && service.variables ? {
       env: service.variables
@@ -1867,7 +1981,8 @@ const makeGithubJob = (context, job, allJobs, uploadProviderIds) => {
   }]));
   const env = {
     ...Object.fromEntries(Object.entries((_j = job.runnerVariables) !== null && _j !== void 0 ? _j : {}).filter(([key]) => !GITLAB_ONLY_RUNNER_VARIABLES.has(key))),
-    ...(isComponent ? getSecretsEnv(context) : {}),
+    ...(isComponent ? getSecretsEnv(context, secretKinds) : {}),
+    ...getReferencedSecretsEnv(runScript, secretKinds),
     CL_JOB_IMAGE: image !== null && image !== void 0 ? image : "runner"
   };
   const githubJob = {
@@ -1878,7 +1993,14 @@ const makeGithubJob = (context, job, allJobs, uploadProviderIds) => {
     } : {}),
     ...(image ? {
       container: {
-        image
+        image,
+        // private images in the repo's registry need credentials
+        ...(resolved.fromRepoRegistry ? {
+          credentials: {
+            username: "${{ github.actor }}",
+            password: "${{ github.token }}"
+          }
+        } : {})
       }
     } : {}),
     ...(Object.keys(services).length > 0 ? {
@@ -1905,7 +2027,7 @@ const makeGithubJob = (context, job, allJobs, uploadProviderIds) => {
     })), {
       name: job.name,
       id: "main",
-      run: runScript,
+      run,
       shell: "bash"
     }, ...(uploadProviderIds.has(id) || artifactPaths.length > 0 ? artifactPaths.length > 0 ? [{
       name: "Upload artifacts",
@@ -1913,7 +2035,11 @@ const makeGithubJob = (context, job, allJobs, uploadProviderIds) => {
       with: {
         name: id,
         path: artifactPaths.join("\n"),
-        "if-no-files-found": "warn"
+        "if-no-files-found": "warn",
+        // gitlab artifacts include everything; upload-artifact
+        // silently drops hidden files by default — which is
+        // exactly where next.js builds live (.next)
+        "include-hidden-files": true
       }
     }] : [] : [])]
   };
@@ -1946,36 +2072,49 @@ Object.defineProperty(exports, "__esModule", ({
   value: true
 }));
 exports.getGithubReleaseJobs = void 0;
-const runner_1 = __nccwpck_require__(2348);
-const createReleaseJob = needs => ({
-  name: "create release",
-  "runs-on": "ubuntu-latest",
-  container: {
-    image: (0, runner_1.getRunnerImage)("semantic-release")
-  },
-  // semantic-release pushes the version tag and release commit
-  permissions: {
-    contents: "write"
-  },
-  ...(needs && needs.length > 0 ? {
-    needs
-  } : {}),
-  env: {
-    GITHUB_TOKEN: "${{ github.token }}"
-  },
-  steps: [{
-    name: "Checkout",
-    uses: "actions/checkout@v4",
-    // semantic-release needs the full history to determine the version
-    with: {
-      "fetch-depth": 0
-    }
-  }, {
+const createGithubJobs_1 = __nccwpck_require__(4016);
+const createReleaseJob = (images, needs) => {
+  const resolved = images.resolveRef({
+    catladderImage: "semantic-release"
+  });
+  const imageNeeds = resolved.need && typeof resolved.need === "object" ? [(0, createGithubJobs_1.githubGlobalJobId)(resolved.need.job)] : [];
+  const allNeeds = [...imageNeeds, ...(needs !== null && needs !== void 0 ? needs : [])];
+  return {
     name: "create release",
-    run: "semanticRelease",
-    shell: "bash"
-  }]
-});
+    "runs-on": "ubuntu-latest",
+    container: {
+      image: resolved.image,
+      ...(resolved.fromRepoRegistry ? {
+        credentials: {
+          username: "${{ github.actor }}",
+          password: "${{ github.token }}"
+        }
+      } : {})
+    },
+    // semantic-release pushes the version tag and release commit
+    permissions: {
+      contents: "write"
+    },
+    ...(allNeeds.length > 0 ? {
+      needs: allNeeds
+    } : {}),
+    env: {
+      GITHUB_TOKEN: "${{ github.token }}"
+    },
+    steps: [{
+      name: "Checkout",
+      uses: "actions/checkout@v4",
+      // semantic-release needs the full history to determine the version
+      with: {
+        "fetch-depth": 0
+      }
+    }, {
+      name: "create release",
+      run: "semanticRelease",
+      shell: "bash"
+    }]
+  };
+};
 /**
  * the release jobs for the github backend (the counterpart of the
  * gitlab release jobs):
@@ -1985,22 +2124,22 @@ const createReleaseJob = needs => ({
  * - otherwise (manual, the default): the release job goes to the
  *   manual tasks workflow
  */
-const getGithubReleaseJobs = (config, mainWorkflowJobIds) => {
+const getGithubReleaseJobs = (config, mainWorkflowJobIds, images) => {
   var _a;
   if (((_a = config.releases) === null || _a === void 0 ? void 0 : _a.when) === "auto") {
     return {
       main: {
-        "create-release": createReleaseJob(mainWorkflowJobIds)
+        "create-release": createReleaseJob(images, mainWorkflowJobIds)
       },
       manual: {
-        "force-create-release": createReleaseJob()
+        "force-create-release": createReleaseJob(images)
       }
     };
   }
   return {
     main: {},
     manual: {
-      "create-release": createReleaseJob()
+      "create-release": createReleaseJob(images)
     }
   };
 };
@@ -2038,6 +2177,64 @@ Object.defineProperty(exports, "__esModule", ({
 }));
 __exportStar(__nccwpck_require__(4038), exports);
 __exportStar(__nccwpck_require__(3093), exports);
+__exportStar(__nccwpck_require__(9189), exports);
+
+/***/ }),
+
+/***/ 9189:
+/***/ ((__unused_webpack_module, exports, __nccwpck_require__) => {
+
+"use strict";
+
+
+Object.defineProperty(exports, "__esModule", ({
+  value: true
+}));
+exports.GithubScriptFiles = exports.GITHUB_SCRIPTS_FOLDER = void 0;
+const path_1 = __nccwpck_require__(6928);
+/**
+ * folder for job scripts materialized into the repository (committed,
+ * like the image definitions). Owned entirely by the github backend.
+ */
+exports.GITHUB_SCRIPTS_FOLDER = ".catladder-generated/github/scripts";
+/**
+ * github silently ignores workflow files larger than 512 KB — no run,
+ * no check suite, no error. Inlining every job's bash script blows past
+ * that limit on bigger projects, so job scripts are materialized into
+ * committed files and the workflow step only invokes them.
+ *
+ * Scripts containing `${{ ... }}` expressions must stay inline: the
+ * runner only interpolates expressions in the workflow file itself,
+ * never in files read at runtime.
+ */
+class GithubScriptFiles {
+  constructor() {
+    this.files = new Map();
+  }
+  /**
+   * materializes a job script into a committed file and returns the
+   * step command invoking it
+   */
+  add(jobId, script) {
+    const path = (0, path_1.join)(exports.GITHUB_SCRIPTS_FOLDER, `${jobId}.sh`);
+    // `shell: bash` steps run with `bash -eo pipefail`; the script file
+    // must fail exactly like the inline version did
+    const content = `#!/usr/bin/env bash\nset -eo pipefail\n\n${script}\n`;
+    const existing = this.files.get(path);
+    if (existing !== undefined && existing !== content) {
+      throw new Error(`conflicting scripts for job id '${jobId}'`);
+    }
+    this.files.set(path, content);
+    return `bash ${path}`;
+  }
+  getGeneratedFiles() {
+    return [...this.files.entries()].map(([path, content]) => ({
+      path,
+      content
+    }));
+  }
+}
+exports.GithubScriptFiles = GithubScriptFiles;
 
 /***/ }),
 
@@ -2092,6 +2289,7 @@ const promises_1 = __nccwpck_require__(1943);
 const rules_1 = __nccwpck_require__(4565);
 const config_1 = __nccwpck_require__(6925);
 const createAllJobs_1 = __nccwpck_require__(3671);
+const jobImagesPlan_1 = __nccwpck_require__(1585);
 const createGitlabJobs_1 = __nccwpck_require__(512);
 const createGitlabPipeline_1 = __nccwpck_require__(1862);
 const gitlabReleaseJobs_1 = __nccwpck_require__(5531);
@@ -2111,31 +2309,38 @@ class GitlabBackend {
     });
   }
   async createFiles(config) {
-    const includes = await this.createIncludes(config);
+    const images = this.createImagesPlan(config);
+    const includes = await this.createIncludes(config, images);
     const mainFile = {
       path: ".gitlab-ci.yml",
       content: {
         include: includes.map(i => i.path)
       }
     };
-    return [mainFile, ...includes];
+    return [mainFile, ...includes,
+    // materialized image definitions (repo mode)
+    ...images.getGeneratedFiles()];
+  }
+  createImagesPlan(config) {
+    return new jobImagesPlan_1.JobImagesPlan((0, jobImagesPlan_1.getJobImagesMode)(config, this.type), this.type);
   }
   /**
    * the complete pipeline as one object (all includes merged into one),
    * mainly for testing purposes
    */
   async createCompletePipeline(config) {
-    const includes = await this.createIncludes(config);
+    const includes = await this.createIncludes(config, this.createImagesPlan(config));
     return includes.reduce((acc, {
       content
     }) => {
       return {
         ...acc,
+        // includes are always yaml objects
         ...content // merge all includes into one object
       };
     }, {});
   }
-  async createIncludes(config) {
+  async createIncludes(config, images) {
     const {
       jobs,
       image,
@@ -2143,7 +2348,7 @@ class GitlabBackend {
       variables,
       workflow,
       ...pipelineRest
-    } = await this.createPipeline(config);
+    } = await this.createPipeline(config, images);
     // we will create 1 include per component or workspace
     // this is for better readability in git diffs and to avoid problems with yaml files beeing too large
     // group by context
@@ -2176,14 +2381,14 @@ class GitlabBackend {
     };
     return [mainInclude, ...componentIncludes];
   }
-  async createPipeline(config) {
+  async createPipeline(config, images) {
     const stages = (0, getPipelineStages_1.getPipelineStages)(config);
     // for all triggers create jobs and add base rules
     const allJobsPerTrigger = await Promise.all(config_1.ALL_PIPELINE_TRIGGERS.map(async trigger => await (0, createGitlabJobs_1.createGitlabJobs)(await (0, createAllJobs_1.createAllJobs)({
       config,
       trigger,
       pipelineType: this.type
-    }), getGitlabRulesForTrigger(trigger)))).then(j => j.flat());
+    }), images, getGitlabRulesForTrigger(trigger)))).then(j => j.flat());
     const allWorkspaceJobs = allJobsPerTrigger.filter(j => {
       var _a;
       return ((_a = j.context) === null || _a === void 0 ? void 0 : _a.type) === "workspace";
@@ -2212,7 +2417,9 @@ class GitlabBackend {
       var _a;
       return ((_a = j.context) === null || _a === void 0 ? void 0 : _a.type) === "agent";
     });
-    const allJobs = [...allWorkspaceJobs, ...allComponentJobs, ...allGlobalJobs].reduce((acc, {
+    // context-less jobs (image build jobs)
+    const allContextlessJobs = allJobsPerTrigger.filter(j => j.context === null);
+    const allJobs = [...allContextlessJobs, ...allWorkspaceJobs, ...allComponentJobs, ...allGlobalJobs].reduce((acc, {
       gitlabJob,
       name,
       context
@@ -2326,7 +2533,8 @@ exports.GITLAB_CI_VARIABLES = {
   jobToken: "CI_JOB_TOKEN",
   jobImage: "CI_JOB_IMAGE",
   registry: "CI_REGISTRY",
-  registryImage: "CI_REGISTRY_IMAGE"
+  registryImage: "CI_REGISTRY_IMAGE",
+  registryUser: "CI_REGISTRY_USER"
 };
 
 /***/ }),
@@ -2395,7 +2603,7 @@ const getFullReferencedJobNameFromWorkspace = (referencedJobName, workspaceName,
   });
 };
 const getJobName = need => (0, lodash_es_1.isObject)(need) ? need.job : need;
-const makeGitlabJob = (context, job, allJobs, baseRules) => {
+const makeGitlabJob = (context, job, allJobs, images, baseRules) => {
   var _a, _b;
   const {
     environment,
@@ -2413,8 +2621,14 @@ const makeGitlabJob = (context, job, allJobs, baseRules) => {
     allow_failure: jobAllowFailure,
     cache: jobCache,
     caches,
+    image: jobImage,
     ...rest
   } = job;
+  // catladder image references resolve according to the jobImages mode;
+  // in repo mode the job additionally depends on the image build job
+  const resolvedImage = images.resolve(jobImage);
+  const image = resolvedImage.image;
+  const imageNeeds = resolvedImage.need ? [resolvedImage.need] : [];
   // the neutral `gate` translates to gitlab's when/allow_failure;
   // explicitly set gitlab fields take precedence
   const when = jobWhen !== null && jobWhen !== void 0 ? jobWhen : gate ? gate === "manual" ? "manual" : "on_success" : undefined;
@@ -2423,7 +2637,7 @@ const makeGitlabJob = (context, job, allJobs, baseRules) => {
   // an explicitly set gitlab `cache` takes precedence
   const cache = jobCache !== null && jobCache !== void 0 ? jobCache : caches && context.type !== "agent" ? (0, createJobCache_1.createJobCacheFromCacheConfigs)(context, caches) : undefined;
   const stage = envMode === "stagePerEnv" && context.type !== "agent" ? `${job.stage} ${context.env}` : job.stage;
-  const deduplicatedGitlabNeeds = getGitlabNeeds(context, job, allJobs);
+  const deduplicatedGitlabNeeds = getGitlabNeeds(context, job, allJobs, imageNeeds);
   const fullJobName = getFullJobName({
     type: context.type,
     name,
@@ -2452,6 +2666,7 @@ const makeGitlabJob = (context, job, allJobs, baseRules) => {
     retry: defaults_1.BASE_RETRY,
     interruptible: true,
     ...rest,
+    image,
     allow_failure,
     cache: cache ? (0, cache_1.addCacheFallback)(cache, context) : undefined,
     rules: rules.length > 0 ? rules : undefined,
@@ -2527,13 +2742,13 @@ const addGitlabEnvironment = (context, catladderJobEnvironment, job, allJobs) =>
     script: [...((_b = job.script) !== null && _b !== void 0 ? _b : []), ...(createsJobEnv ? scriptToAdd : [])]
   };
 };
-const createGitlabJobs = async (allJobs, baseRules) => {
-  return [...allJobs.workspaces, ...allJobs.components, ...allJobs.agents].flatMap(({
+const createGitlabJobs = async (allJobs, images, baseRules) => {
+  const contextualJobs = [...allJobs.workspaces, ...allJobs.components, ...allJobs.agents].flatMap(({
     context,
     jobs
   }) => {
     return jobs.map(job => {
-      const [fullJobName, gitlabJob] = (0, exports.makeGitlabJob)(context, job, allJobs, baseRules);
+      const [fullJobName, gitlabJob] = (0, exports.makeGitlabJob)(context, job, allJobs, images, baseRules);
       return {
         name: fullJobName,
         gitlabJob,
@@ -2541,13 +2756,66 @@ const createGitlabJobs = async (allJobs, baseRules) => {
       };
     });
   });
+  // image build jobs (repo mode): no context, plain names, their
+  // rules:changes combined with the trigger rules
+  const imageJobs = images.getEnsureJobs().map(job => ({
+    name: job.name,
+    gitlabJob: makeEnsureImageGitlabJob(job, baseRules),
+    context: null
+  }));
+  return [...imageJobs, ...contextualJobs];
 };
 exports.createGitlabJobs = createGitlabJobs;
-function getGitlabNeeds(context, job, allJobs) {
+/**
+ * lowers an image build job: only runs when the (generated) image
+ * definition changed, within the trigger's base rules
+ */
+const makeEnsureImageGitlabJob = (job, baseRules) => {
+  var _a, _b, _c, _d;
+  const changes = (_b = (_a = job.rules) === null || _a === void 0 ? void 0 : _a[0]) === null || _b === void 0 ? void 0 : _b.changes;
+  const rules = (baseRules !== null && baseRules !== void 0 ? baseRules : []).map(baseRule => baseRule.when === "never" ? baseRule : {
+    ...baseRule,
+    changes
+  });
+  return (0, removeUndefined_1.removeUndefined)({
+    retry: defaults_1.BASE_RETRY,
+    interruptible: true,
+    image: job.image,
+    services: job.services,
+    rules: rules.length > 0 ? rules : [{
+      changes
+    }],
+    variables: job.runnerVariables,
+    script: (_d = (_c = job.script) === null || _c === void 0 ? void 0 : _c.filter(utils_1.notNil)) !== null && _d !== void 0 ? _d : [],
+    stage: job.stage,
+    needs: []
+  });
+};
+function getGitlabNeeds(context, job, allJobs, extraNeeds = []) {
   var _a;
-  const needs = context.type === "workspace" ? getGitlabNeedsForWorkspaceJob(context, job, allJobs) : context.type === "agent" ? (_a = job.needs) !== null && _a !== void 0 ? _a : null : getGitlabNeedsForComponentJob(context, job, allJobs);
+  const jobWithExtraNeeds = extraNeeds.length > 0 ? {
+    ...job,
+    needs: [...extraNeeds, ...((_a = job.needs) !== null && _a !== void 0 ? _a : [])]
+  } : job;
+  const needs = context.type === "workspace" ? getGitlabNeedsForWorkspaceJob(context, jobWithExtraNeeds, allJobs) : context.type === "agent" ? mapAgentNeeds(jobWithExtraNeeds.needs) : getGitlabNeedsForComponentJob(context, jobWithExtraNeeds, allJobs);
   return needs ? deduplicateNeeds(needs) : undefined;
 }
+/**
+ * agent jobs use their needs as-is; global needs (image build jobs)
+ * keep their plain name and optional flag
+ */
+function mapAgentNeeds(needs) {
+  if (!needs) {
+    return null;
+  }
+  return needs.map(n => (0, lodash_es_1.isObject)(n) && "global" in n && n.global ? {
+    job: n.job,
+    artifacts: n.artifacts,
+    ...(n.optional ? {
+      optional: true
+    } : {})
+  } : n);
+}
 function deduplicateNeeds(needs) {
   return needs ? [...new Map(needs.map(n => [(0, lodash_es_1.isObject)(n) ? n.job : n, n])).values()] : undefined;
 }
@@ -2556,11 +2824,19 @@ function getGitlabNeedsForComponentJob(context, {
 }, allJobs) {
   return (needs !== null && needs !== void 0 ? needs : []).map(n => {
     var _a;
-    return (0, lodash_es_1.isObject)(n) ? "workspaceName" in n ? {
+    return (0, lodash_es_1.isObject)(n) ? "global" in n && n.global ?
+    // global jobs (e.g. image builds) keep their plain name
+    {
+      job: n.job,
+      artifacts: n.artifacts,
+      ...(n.optional ? {
+        optional: true
+      } : {})
+    } : "workspaceName" in n && n.workspaceName ? {
       job: getFullReferencedJobNameFromWorkspace(n.job, n.workspaceName, context.env, allJobs),
       artifacts: n.artifacts
     } : {
-      job: getFullReferencedJobNameFromComponent(n.job, (_a = n.componentName) !== null && _a !== void 0 ? _a : context.name, context.env, allJobs),
+      job: getFullReferencedJobNameFromComponent(n.job, "componentName" in n ? (_a = n.componentName) !== null && _a !== void 0 ? _a : context.name : context.name, context.env, allJobs),
       artifacts: n.artifacts
     } : getFullReferencedJobNameFromComponent(n, context.name, context.env, allJobs);
   }) // sort in a predictable manner for snapshot tests
@@ -2573,7 +2849,13 @@ function getGitlabNeedsForComponentJob(context, {
 function getGitlabNeedsForWorkspaceJob(context, {
   needs
 }, allJobs) {
-  return (needs !== null && needs !== void 0 ? needs : []).map(n => (0, lodash_es_1.isObject)(n) ? {
+  return (needs !== null && needs !== void 0 ? needs : []).map(n => (0, lodash_es_1.isObject)(n) ? "global" in n && n.global ? {
+    job: n.job,
+    artifacts: n.artifacts,
+    ...(n.optional ? {
+      optional: true
+    } : {})
+  } : {
     job: getFullReferencedJobNameFromWorkspace(n.job, "workspaceName" in n && n.workspaceName ? n.workspaceName : context.name, context.env, allJobs),
     artifacts: n.artifacts
   } : getFullReferencedJobNameFromWorkspace(n, context.name, context.env, allJobs)) // sort in a predictable manner for snapshot tests
@@ -2602,7 +2884,7 @@ const createGitlabPipelineWithDefaults = ({
   ...config
 }) => {
   return {
-    image: image !== null && image !== void 0 ? image : (0, runner_1.getRunnerImage)("jobs-default"),
+    image: image !== null && image !== void 0 ? image : (0, runner_1.getCentralRunnerImageUrl)("jobs-default"),
     // default image
     variables: {
       FF_USE_FASTZIP: "true",
@@ -2705,7 +2987,7 @@ const getGitlabReleaseJobs = config => {
   return {
     ["create release"]: {
       stage: "release",
-      image: (0, runner_1.getRunnerImage)("semantic-release"),
+      image: (0, runner_1.getCentralRunnerImageUrl)("semantic-release"),
       script: ["semanticRelease"],
       after_script: [EXPIRED_TOKEN_HELP],
       rules: [...baseReleaseRules, {
@@ -2718,7 +3000,7 @@ const getGitlabReleaseJobs = config => {
     },
     ["⚠️ force create release"]: {
       stage: "release",
-      image: (0, runner_1.getRunnerImage)("semantic-release"),
+      image: (0, runner_1.getCentralRunnerImageUrl)("semantic-release"),
       script: ["semanticRelease"],
       after_script: [EXPIRED_TOKEN_HELP],
       needs: [],
@@ -4461,7 +4743,10 @@ const getYarnInstallCommand = async context => {
   // inline builds make debugging easier as it prints it out in the logs, instead of writing it in temp files
   return `yarn install --immutable --inline-builds`;
 };
-const ensureNodeVersion = context => (0, gitlab_1.collapseableSection)("nodeinstall", "Ensure node version")(["if [ -f ~/.nvm/nvm.sh ];  then source ~/.nvm/nvm.sh; fi", "if command -v nvm &> /dev/null && [ -f ./.nvmrc ]; then nvm install; fi"]);
+const ensureNodeVersion = context => (0, gitlab_1.collapseableSection)("nodeinstall", "Ensure node version")([
+// github actions overrides HOME in container jobs, so also look
+// for nvm where the catladder images install it (/root/.nvm)
+'if [ -f "$HOME/.nvm/nvm.sh" ]; then source "$HOME/.nvm/nvm.sh"; elif [ -f /root/.nvm/nvm.sh ]; then export NVM_DIR=/root/.nvm; source /root/.nvm/nvm.sh; fi', "if command -v nvm &> /dev/null && [ -f ./.nvmrc ]; then nvm install; fi"]);
 exports.ensureNodeVersion = ensureNodeVersion;
 const getYarnInstall = async (context, options) => {
   const postInstall = context.type !== "workspace" && context.build.type !== "disabled" && "postInstall" in context.build.config ? context.build.config.postInstall : null;
@@ -4840,7 +5125,7 @@ Object.defineProperty(exports, "__esModule", ({
   value: true
 }));
 exports.DOCKER_REGISTRY = exports.PIPELINE_IMAGE_TAG = void 0;
-exports.PIPELINE_IMAGE_TAG = "next-8b9ad5ca" || 0;
+exports.PIPELINE_IMAGE_TAG = "next-6a4450e0" || 0;
 exports.DOCKER_REGISTRY = "git.panter.ch:5001/catladder/catladder" || 0;
 
 /***/ }),
@@ -5252,7 +5537,7 @@ const getBasePredefinedVariables = ctx => {
   };
 };
 const getEnvironmentVariables = async (ctx, options = {}) => {
-  var _a, _b, _c, _d, _e, _f, _g, _h;
+  var _a, _b, _c, _d, _e, _f, _g;
   const environmentContext = (0, getEnvironmentContext_1.getEnvironmentContext)(ctx);
   const {
     config,
@@ -5309,13 +5594,13 @@ const getEnvironmentVariables = async (ctx, options = {}) => {
   }
   const publicEnvVarsRaw = (_e = (_d = envConfigRaw.vars) === null || _d === void 0 ? void 0 : _d.public) !== null && _e !== void 0 ? _e : {};
   const additionalSecretKeys = deployConfigRaw ? deploy_1.DEPLOY_TYPES[deployConfigRaw.type].additionalSecretKeys(environmentContext) : [];
-  const secretEnvVarKeys = [...(0, envVars_1.stringListToSecreteEnvVarList)((_g = (_f = envConfigRaw.vars) === null || _f === void 0 ? void 0 : _f.secret) !== null && _g !== void 0 ? _g : []), ...additionalSecretKeys];
+  const secretEnvVarKeys = [...(0, envVars_1.normalizeSecretVarsConfig)((_f = envConfigRaw.vars) === null || _f === void 0 ? void 0 : _f.secret), ...additionalSecretKeys];
   const secretEnvVars = (0, envVars_1.makeSecretEnvVarMapping)(env, componentName, secretEnvVarKeys);
   const publicEnvVarsRawSanitized = (0, envVars_1.stringifyValues)(publicEnvVarsRaw);
   const publicEnvVarsUnresolved = Object.fromEntries(Object.entries(publicEnvVarsRawSanitized).map(([key, value]) => [key, (0, VariableValueContainingReferences_1.createVariableValueContainingReferencesFromString)(value, {
     componentName: ctx.componentName
   })]));
-  const publicEnvVars = ((_h = options.shouldResolveReferences) !== null && _h !== void 0 ? _h : true) ? await (0, resolveAllReferences_1.resolveAllReferences)(publicEnvVarsUnresolved, async otherComponentName => {
+  const publicEnvVars = ((_g = options.shouldResolveReferences) !== null && _g !== void 0 ? _g : true) ? await (0, resolveAllReferences_1.resolveAllReferences)(publicEnvVarsUnresolved, async otherComponentName => {
     const {
       envVars: otherEnvVars
     } = await (0, exports.getEnvironmentVariables)({
@@ -5475,7 +5760,7 @@ const envVars_1 = __nccwpck_require__(4946);
  * @returns
  */
 const transformJobOnlyVars = async (env, componentName, vars) => {
-  var _a, _b;
+  var _a;
   if (!vars) {
     return {
       envVars: {},
@@ -5483,7 +5768,7 @@ const transformJobOnlyVars = async (env, componentName, vars) => {
     };
   }
   const publicVars = (0, envVars_1.stringifyValues)((_a = vars === null || vars === void 0 ? void 0 : vars.public) !== null && _a !== void 0 ? _a : {});
-  const secretEnvVarKeys = (0, envVars_1.stringListToSecreteEnvVarList)((_b = vars === null || vars === void 0 ? void 0 : vars.secret) !== null && _b !== void 0 ? _b : []);
+  const secretEnvVarKeys = (0, envVars_1.normalizeSecretVarsConfig)(vars === null || vars === void 0 ? void 0 : vars.secret);
   const deployJobOnlySecretEnvVars = (vars === null || vars === void 0 ? void 0 : vars.secret) ? (0, envVars_1.makeSecretEnvVarMapping)(env, componentName, secretEnvVarKeys) : {};
   const envVars = {
     ...deployJobOnlySecretEnvVars,
@@ -5507,7 +5792,7 @@ exports.transformJobOnlyVars = transformJobOnlyVars;
 Object.defineProperty(exports, "__esModule", ({
   value: true
 }));
-exports.makeSecretEnvVarMapping = exports.stringListToSecreteEnvVarList = exports.stringifyValues = void 0;
+exports.makeSecretEnvVarMapping = exports.normalizeSecretVarsConfig = exports.stringListToSecreteEnvVarList = exports.stringifyValues = void 0;
 const lodash_es_1 = __nccwpck_require__(4284);
 const getEnvironmentVariables_1 = __nccwpck_require__(5855);
 const BashExpression_1 = __nccwpck_require__(5354);
@@ -5517,6 +5802,27 @@ const stringListToSecreteEnvVarList = keys => keys.map(key => ({
   key
 }));
 exports.stringListToSecreteEnvVarList = stringListToSecreteEnvVarList;
+/**
+ * normalizes both config forms of vault-stored env vars: the deprecated
+ * plain string[] (all keys secret) and the record form carrying a kind
+ * (or config object) per key
+ */
+const normalizeSecretVarsConfig = secret => {
+  if (!secret) {
+    return [];
+  }
+  if (Array.isArray(secret)) {
+    return (0, exports.stringListToSecreteEnvVarList)(secret);
+  }
+  return Object.entries(secret).map(([key, config]) => typeof config === "string" ? {
+    key,
+    kind: config
+  } : {
+    key,
+    ...config
+  });
+};
+exports.normalizeSecretVarsConfig = normalizeSecretVarsConfig;
 const makeSecretEnvVarMapping = (env, componentName, secretEnvVars) => {
   return Object.fromEntries(secretEnvVars.map(({
     key
@@ -5526,6 +5832,330 @@ exports.makeSecretEnvVarMapping = makeSecretEnvVarMapping;
 
 /***/ }),
 
+/***/ 3231:
+/***/ ((__unused_webpack_module, exports, __nccwpck_require__) => {
+
+"use strict";
+
+
+Object.defineProperty(exports, "__esModule", ({
+  value: true
+}));
+exports.computeCustomImageHash = void 0;
+const crypto_1 = __nccwpck_require__(6982);
+const fs_1 = __nccwpck_require__(9896);
+const path_1 = __nccwpck_require__(6928);
+const IGNORED_FILES = new Set([".DS_Store", "Thumbs.db"]);
+const isIgnoredFile = path => {
+  var _a;
+  return IGNORED_FILES.has((_a = path.split("/").pop()) !== null && _a !== void 0 ? _a : "");
+};
+function listFilesRecursive(dir) {
+  const resolved = (0, path_1.resolve)(dir);
+  const entries = (0, fs_1.readdirSync)(resolved, {
+    recursive: true,
+    encoding: "utf-8"
+  });
+  return entries.filter(entry => {
+    if (isIgnoredFile(entry)) {
+      // OS junk files exist locally but not in CI checkouts — they
+      // must never influence the content hash
+      return false;
+    }
+    const fullPath = (0, path_1.join)(resolved, entry);
+    return (0, fs_1.statSync)(fullPath).isFile();
+  }).sort();
+}
+function computeCustomImageHash(config) {
+  var _a;
+  const hash = (0, crypto_1.createHash)("sha256");
+  const watchedPaths = [];
+  // Hash all files in the dir (includes the Dockerfile and any context files)
+  const dirFiles = listFilesRecursive(config.dir);
+  for (const file of dirFiles) {
+    const fullPath = (0, path_1.join)((0, path_1.resolve)(config.dir), file);
+    hash.update(file); // include relative path for disambiguation
+    hash.update((0, fs_1.readFileSync)(fullPath));
+  }
+  watchedPaths.push(`${config.dir}/**/*`);
+  // extra dirs (e.g. included base image definitions)
+  for (const extraDir of (_a = config.extraDirs) !== null && _a !== void 0 ? _a : []) {
+    for (const file of listFilesRecursive(extraDir)) {
+      hash.update(file);
+      hash.update((0, fs_1.readFileSync)((0, path_1.join)((0, path_1.resolve)(extraDir), file)));
+    }
+    watchedPaths.push(`${extraDir}/**/*`);
+  }
+  // Hash extra paths (for files outside the dir)
+  if (config.hashExtraPaths) {
+    // Extra paths are literal file paths (not globs) for simplicity
+    const extraFiles = [...config.hashExtraPaths].sort();
+    for (const file of extraFiles) {
+      hash.update(file);
+      hash.update((0, fs_1.readFileSync)(file));
+    }
+    watchedPaths.push(...config.hashExtraPaths);
+  }
+  // Hash build args (sorted keys for determinism)
+  if (config.buildArgs) {
+    const sorted = Object.entries(config.buildArgs).sort(([a], [b]) => a.localeCompare(b));
+    hash.update(JSON.stringify(sorted));
+  }
+  return {
+    hash: hash.digest("hex").slice(0, 12),
+    watchedPaths
+  };
+}
+exports.computeCustomImageHash = computeCustomImageHash;
+
+/***/ }),
+
+/***/ 1585:
+/***/ ((__unused_webpack_module, exports, __nccwpck_require__) => {
+
+"use strict";
+
+
+Object.defineProperty(exports, "__esModule", ({
+  value: true
+}));
+exports.JobImagesPlan = exports.getJobImagesMode = exports.GENERATED_IMAGES_FOLDER = void 0;
+const fs_1 = __nccwpck_require__(9896);
+const path_1 = __nccwpck_require__(6928);
+const ciVariables_1 = __nccwpck_require__(4489);
+const docker_1 = __nccwpck_require__(2764);
+const constants_1 = __nccwpck_require__(3480);
+const runner_1 = __nccwpck_require__(2348);
+const gitlab_1 = __nccwpck_require__(3468);
+const hash_1 = __nccwpck_require__(3231);
+const shippedImages_1 = __nccwpck_require__(7734);
+exports.GENERATED_IMAGES_FOLDER = ".catladder-generated/images";
+/**
+ * the official docker cli image used to build the job images — NOT a
+ * catladder image, so building images never depends on one (bootstrap)
+ */
+const BUILDER_IMAGE = "docker.io/docker:29.5.1";
+const getJobImagesMode = (config, pipelineType) => {
+  var _a;
+  // the central registry is not reachable from github runners
+  if (pipelineType === "github" && config.jobImages === "central") {
+    throw new Error(`jobImages: "central" is not supported on github: catladder's central registry (${constants_1.DOCKER_REGISTRY}) is unreachable from github runners. Use "repo" (the default) instead.`);
+  }
+  return (_a = config.jobImages) !== null && _a !== void 0 ? _a : pipelineType === "github" ? "repo" : "central";
+};
+exports.getJobImagesMode = getJobImagesMode;
+const ensureJobName = name => `🐳 job image ${name}`;
+/**
+ * plans the catladder job images of one backend run: resolves image
+ * references, and (in repo mode) collects the image build jobs and the
+ * image definitions to materialize into the generated files.
+ *
+ * Reference-driven: only images actually used by a job are built.
+ */
+class JobImagesPlan {
+  constructor(mode, pipelineType) {
+    this.mode = mode;
+    this.pipelineType = pipelineType;
+    this.used = new Map();
+  }
+  /**
+   * resolves a job image (marker or concrete) to a concrete image url
+   * plus the build job dependency in repo mode
+   */
+  resolve(image) {
+    if (!(0, runner_1.isCatladderImageRef)(image)) {
+      return {
+        image
+      };
+    }
+    return this.resolveRef(image);
+  }
+  resolveRef(ref) {
+    const name = ref.catladderImage;
+    if (this.mode === "central" || shippedImages_1.CENTRAL_ONLY_IMAGES.has(name)) {
+      return {
+        image: (0, runner_1.getCentralRunnerImageUrl)(name)
+      };
+    }
+    const {
+      hash
+    } = this.use(name);
+    return {
+      image: `${this.registryImageRef()}/catladder/${name}:${hash}`,
+      fromRepoRegistry: true,
+      need: {
+        job: ensureJobName(name),
+        artifacts: false,
+        optional: true,
+        global: true
+      }
+    };
+  }
+  /**
+   * the registry image prefix. On github, container images can't use
+   * runtime env vars — the expression form is required.
+   */
+  registryImageRef() {
+    return this.pipelineType === "github" ? "ghcr.io/${{ github.repository }}" : `${(0, ciVariables_1.getCiVariable)({
+      pipelineType: this.pipelineType
+    }, "registryImage")}`;
+  }
+  use(name) {
+    var _a;
+    const existing = this.used.get(name);
+    if (existing) {
+      return existing;
+    }
+    const dependencies = (_a = shippedImages_1.RUNNER_IMAGE_DEPENDENCIES[name]) !== null && _a !== void 0 ? _a : [];
+    // dependencies are materialized (and hashed) as part of this image,
+    // but also usable standalone
+    dependencies.forEach(dependency => this.use(dependency));
+    const {
+      hash
+    } = (0, hash_1.computeCustomImageHash)({
+      dir: (0, shippedImages_1.getShippedImageDir)(name),
+      extraDirs: dependencies.map(dependency => (0, shippedImages_1.getShippedImageDir)(dependency))
+    });
+    const entry = {
+      hash
+    };
+    this.used.set(name, entry);
+    return entry;
+  }
+  /**
+   * the image build jobs for all used images (repo mode; empty in
+   * central mode)
+   */
+  getEnsureJobs() {
+    return [...this.used.entries()].map(([name, {
+      hash
+    }]) => this.createEnsureJob(name, hash));
+  }
+  createEnsureJob(name, hash) {
+    var _a;
+    const ctx = {
+      pipelineType: this.pipelineType
+    };
+    const registryUser = (0, ciVariables_1.getCiVariable)(ctx, "registryUser");
+    const jobToken = (0, ciVariables_1.getCiVariable)(ctx, "jobToken");
+    const registry = (0, ciVariables_1.getCiVariable)(ctx, "registry");
+    const imageRef = `${this.registryImageRef()}/catladder/${name}:${hash}`;
+    const watchedDirs = [name, ...((_a = shippedImages_1.RUNNER_IMAGE_DEPENDENCIES[name]) !== null && _a !== void 0 ? _a : [])];
+    const {
+      services,
+      runnerVariables
+    } = (0, docker_1.getDockerJobBaseProps)();
+    return {
+      name: ensureJobName(name),
+      stage: "setup",
+      image: BUILDER_IMAGE,
+      services,
+      runnerVariables,
+      needs: [],
+      // gitlab: only run when the image definition changed; github has
+      // no equivalent and always runs (the existence check is fast)
+      rules: [{
+        changes: watchedDirs.map(dir => `${exports.GENERATED_IMAGES_FOLDER}/${dir}/**/*`)
+      }],
+      variables: {},
+      script: [...(0, gitlab_1.collapseableSection)("docker-login", "Docker Login")([`docker login --username ${registryUser} --password ${jobToken} ${registry}`]), ...(0, gitlab_1.collapseableSection)("check-image", "Checking if image exists")([`if docker manifest inspect ${imageRef} > /dev/null 2>&1; then`, `  echo "Image ${imageRef} already exists, skipping build"`, `  exit 0`, `fi`]), ...(0, gitlab_1.collapseableSection)("docker-build", "Building image")([`DOCKER_BUILDKIT=1 docker build -t ${imageRef} -f ${exports.GENERATED_IMAGES_FOLDER}/${name}/Dockerfile ${shippedImages_1.RUNNER_IMAGE_BUILD_CONTEXT[name] === "root" ? exports.GENERATED_IMAGES_FOLDER : `${exports.GENERATED_IMAGES_FOLDER}/${name}`}`]), ...(0, gitlab_1.collapseableSection)("docker-push", "Pushing image")([`docker push ${imageRef}`])]
+    };
+  }
+  /**
+   * the image definitions of all used images, materialized into the
+   * generated files (so pipelines build from committed, reviewable
+   * files and gitlab's rules:changes can watch them)
+   */
+  getGeneratedFiles() {
+    return [...this.used.keys()].flatMap(name => {
+      const dir = (0, shippedImages_1.getShippedImageDir)(name);
+      return listFilesRecursive(dir).map(file => ({
+        path: (0, path_1.join)(exports.GENERATED_IMAGES_FOLDER, name, file),
+        content: (0, fs_1.readFileSync)((0, path_1.join)(dir, file), "utf-8")
+      }));
+    });
+  }
+}
+exports.JobImagesPlan = JobImagesPlan;
+const IGNORED_FILES = new Set([".DS_Store", "Thumbs.db"]);
+const listFilesRecursive = dir => (0, fs_1.readdirSync)(dir, {
+  recursive: true,
+  encoding: "utf-8"
+}).filter(entry => {
+  var _a;
+  // OS junk files exist locally but not in CI checkouts
+  return !IGNORED_FILES.has((_a = entry.split("/").pop()) !== null && _a !== void 0 ? _a : "") && (0, fs_1.statSync)((0, path_1.join)(dir, entry)).isFile();
+}).sort();
+
+/***/ }),
+
+/***/ 7734:
+/***/ ((__unused_webpack_module, exports, __nccwpck_require__) => {
+
+"use strict";
+
+
+Object.defineProperty(exports, "__esModule", ({
+  value: true
+}));
+exports.getShippedImageDir = exports.getShippedImagesDir = exports.RUNNER_IMAGE_BUILD_CONTEXT = exports.CENTRAL_ONLY_IMAGES = exports.RUNNER_IMAGE_DEPENDENCIES = void 0;
+const fs_1 = __nccwpck_require__(9896);
+const path_1 = __nccwpck_require__(6928);
+/**
+ * images whose Dockerfile INCLUDEs another image's Dockerfile
+ * (dockerfile-x/dockerfile-plus, resolved against the images root as
+ * build context)
+ */
+exports.RUNNER_IMAGE_DEPENDENCIES = {
+  "jobs-meteor": ["jobs-default"],
+  "jobs-testing-chrome": ["jobs-default"]
+};
+/**
+ * the docker build context of each image, mirroring the central image
+ * builds: the jobs family builds from the images root (their
+ * Dockerfiles INCLUDE sibling images), the others from their own dir
+ * (their COPY paths are relative to it)
+ */
+/**
+ * images that cannot be built from the shipped definitions and always
+ * come from the central registry: semantic-release bakes catladder's
+ * own cli sources into the image (repo-root build context).
+ * TODO: make the semantic-release image self-contained.
+ */
+exports.CENTRAL_ONLY_IMAGES = new Set(["semantic-release"]);
+exports.RUNNER_IMAGE_BUILD_CONTEXT = {
+  "jobs-default": "root",
+  "jobs-meteor": "root",
+  "jobs-testing-chrome": "root",
+  kubernetes: "self",
+  "docker-build": "self",
+  gcloud: "self",
+  "semantic-release": "self",
+  "agent-claude": "self"
+};
+/**
+ * the directory containing the image definitions shipped with the
+ * package (copied into dist at build time; the repository layout is
+ * the fallback for development and tests)
+ */
+const getShippedImagesDir = () => {
+  const candidates = [
+  // built package: dist/customImages -> dist/runner-images
+  (0, path_1.join)(__dirname, "..", "runner-images"),
+  // repository: pipeline/src/customImages -> <root>/runner-images
+  (0, path_1.join)(__dirname, "..", "..", "..", "runner-images")];
+  const found = candidates.find(candidate => (0, fs_1.existsSync)(candidate));
+  if (!found) {
+    throw new Error("shipped job image definitions not found");
+  }
+  return found;
+};
+exports.getShippedImagesDir = getShippedImagesDir;
+const getShippedImageDir = name => (0, path_1.join)((0, exports.getShippedImagesDir)(), name);
+exports.getShippedImageDir = getShippedImageDir;
+
+/***/ }),
+
 /***/ 4628:
 /***/ ((__unused_webpack_module, exports) => {
 
@@ -6752,7 +7382,10 @@ exports.GCLOUD_RUN_DEPLOY_TYPE = {
     hidden: true
   }, {
     key: exports.GCLOUD_RUN_CANONICAL_HOST_SUFFIX,
-    hidden: true
+    hidden: true,
+    // a public url fragment, not sensitive: masking it would
+    // suppress environment urls on github and break log links
+    kind: "variable"
   }] : []), ...(ctx.deployConfigRaw && ctx.deployConfigRaw.cloudSql ? [{
     key: "DB_PASSWORD"
   }] : [])],
@@ -6868,7 +7501,10 @@ const getDatabaseDeleteScript = (context, deployConfig) => {
   // unfortunatly the database cannot be deleted right after the service has stopped, as it might still have connections
   // we have to repeate this process
   return [`echo "deleting database ${DB_NAME}..."`, `echo "👆 this can take multiple attemps (3-5min), because google cloud run may still have a connection to the database after the cloud run service is shut down"`, (0, gitlab_1.repeatOnFailure)(`gcloud sql databases delete ${DB_NAME} --instance=${instanceId} --project ${projectId}`, {
-    pauseInSeconds: 10
+    pauseInSeconds: 10,
+    // connections normally clear within 3-5min; anything beyond is
+    // a permanent error (missing permission, wrong instance, ...)
+    maxAttempts: 30
   })];
 };
 exports.getDatabaseDeleteScript = getDatabaseDeleteScript;
@@ -8592,6 +9228,7 @@ const promises_1 = __nccwpck_require__(1943);
 const path_1 = __nccwpck_require__(6928);
 const backends_1 = __nccwpck_require__(3243);
 const gitlab_1 = __nccwpck_require__(8475);
+const jobImagesPlan_1 = __nccwpck_require__(1585);
 /**
  * generates the pipeline files of all pipeline types enabled in the
  * config (see `pipelines`). Pass an explicit `pipelineType` to generate
@@ -8599,6 +9236,16 @@ const gitlab_1 = __nccwpck_require__(8475);
  */
 async function generatePipelineFiles(context, pipelineType) {
   const pipelineTypes = pipelineType ? [pipelineType] : (0, backends_1.getEnabledPipelineTypes)(context.config);
+  if (!pipelineType) {
+    // the materialized image definitions are a union across all enabled
+    // backends and no single backend may wipe them — cleaned once per
+    // full generation, so images that fell out of use don't linger (and
+    // keep triggering gitlab's rules:changes)
+    await (0, promises_1.rm)(jobImagesPlan_1.GENERATED_IMAGES_FOLDER, {
+      recursive: true,
+      force: true
+    });
+  }
   for (const type of pipelineTypes) {
     await generatePipelineFilesForBackend(context, (0, backends_1.getPipelineBackend)(type));
   }
@@ -8616,7 +9263,11 @@ async function generatePipelineFilesForBackend(context, backend) {
     await (0, promises_1.mkdir)((0, path_1.dirname)(path), {
       recursive: true
     });
-    await context.fileWriter.writeYamlfile(path, content);
+    if (typeof content === "string") {
+      await context.fileWriter.writeGeneratedFileRaw(path, content);
+    } else {
+      await context.fileWriter.writeYamlfile(path, content);
+    }
   }));
 }
 /**
@@ -8972,10 +9623,23 @@ exports.RULE_CONDITION_HOTFIX_BRANCH = "$CI_COMMIT_BRANCH =~ /^[0-9]+.([0-9]+|x)
 Object.defineProperty(exports, "__esModule", ({
   value: true
 }));
-exports.getRunnerImage = void 0;
+exports.getCentralRunnerImageUrl = exports.getRunnerImage = exports.isCatladderImageRef = void 0;
 const constants_1 = __nccwpck_require__(3480);
-const getRunnerImage = imageName => constants_1.DOCKER_REGISTRY + "/" + imageName + ":" + constants_1.PIPELINE_IMAGE_TAG;
+const isCatladderImageRef = value => typeof value === "object" && value !== null && "catladderImage" in value && typeof value.catladderImage === "string";
+exports.isCatladderImageRef = isCatladderImageRef;
+/**
+ * job creators use this to reference a catladder-provided job image;
+ * the backends resolve it to a concrete image url
+ */
+const getRunnerImage = imageName => ({
+  catladderImage: imageName
+});
 exports.getRunnerImage = getRunnerImage;
+/**
+ * the image url in catladder's central registry (the classic behavior)
+ */
+const getCentralRunnerImageUrl = imageName => constants_1.DOCKER_REGISTRY + "/" + imageName + ":" + constants_1.PIPELINE_IMAGE_TAG;
+exports.getCentralRunnerImageUrl = getCentralRunnerImageUrl;
 
 /***/ }),
 
@@ -9190,8 +9854,14 @@ const sanitizeForBashVariable = name => name.replace(/-/g, "_");
 exports.sanitizeForBashVariable = sanitizeForBashVariable;
 const repeatOnFailure = (command, options) => {
   return `
+    _attempt=0
     until ${command}
     do
+      _attempt=$((_attempt+1))
+      if [ "$_attempt" -ge ${options.maxAttempts} ]; then
+        echo "giving up after ${options.maxAttempts} attempts"
+        exit 1
+      fi
       echo "Trying again."
       sleep ${options.pauseInSeconds}
     done
@@ -9379,6 +10049,14 @@ class FileWriter {
       extension: (_b = path.split(".").pop()) !== null && _b !== void 0 ? _b : ""
     };
   }
+  /**
+   * writes content verbatim (no auto-generated header) — e.g. for
+   * materialized dockerfiles, where a leading comment would break
+   * parser directives like `# syntax = ...`
+   */
+  async writeGeneratedFileRaw(path, content) {
+    await this.writeTheFile(path, content);
+  }
   async writeGeneratedFile(path, content, options) {
     await this.writeTheFile(path, [this.getAutoGeneratedHeader(options.commentChar), content].join("\n"));
   }