@catladder/cli 0.0.0-next-16388362 → 0.0.0-next-8b9ad5ca

package/dist/bundles/catenv/index.js

@@ -1,6 +1,78 @@
 /******/ (() => { // webpackBootstrap
 /******/ 	var __webpack_modules__ = ({
 
+/***/ 1917:
+/***/ ((__unused_webpack_module, exports, __nccwpck_require__) => {
+
+"use strict";
+
+
+Object.defineProperty(exports, "__esModule", ({
+  value: true
+}));
+exports.createNonInteractiveIO = void 0;
+const types_1 = __nccwpck_require__(2284);
+const vaultManagerAccess_1 = __nccwpck_require__(7881);
+/**
+ * the context of non-interactive runs (catenv via direnv): logging
+ * goes to stderr, any required interaction fails with a clear error.
+ */
+function createNonInteractiveIO(options = {}) {
+  const io = {
+    interactive: false,
+    getVaultManager: (0, vaultManagerAccess_1.createVaultManagerGetter)(() => io, {
+      mode: options.vaultMode
+    }),
+    log(message) {
+      // stderr: stdout may be evaluated (direnv)
+      console.error(message);
+    },
+    async confirm(message) {
+      throw new types_1.NonInteractiveError(`confirmation ("${message}")`);
+    },
+    async promptDirect(spec) {
+      throw new types_1.NonInteractiveError(`input "${spec.name}"`);
+    }
+  };
+  return io;
+}
+exports.createNonInteractiveIO = createNonInteractiveIO;
+
+/***/ }),
+
+/***/ 7881:
+/***/ ((__unused_webpack_module, exports, __nccwpck_require__) => {
+
+"use strict";
+
+
+Object.defineProperty(exports, "__esModule", ({
+  value: true
+}));
+exports.createVaultManagerGetter = void 0;
+const getProjectConfig_1 = __nccwpck_require__(1);
+const VaultManager_1 = __nccwpck_require__(5771);
+/**
+ * lazily creates the vault manager of a context (once per context),
+ * loading the project config on first use
+ */
+const createVaultManagerGetter = (io, options = {}) => {
+  let managerPromise;
+  return () => managerPromise !== null && managerPromise !== void 0 ? managerPromise : managerPromise = (async () => {
+    const config = await (0, getProjectConfig_1.getProjectConfig)();
+    if (!config) {
+      throw new Error("no catladder config found — the secrets vault needs a project config");
+    }
+    return new VaultManager_1.VaultManager(config, {
+      ...options,
+      io: io()
+    });
+  })();
+};
+exports.createVaultManagerGetter = createVaultManagerGetter;
+
+/***/ }),
+
 /***/ 6057:
 /***/ ((__unused_webpack_module, exports, __nccwpck_require__) => {
 
@@ -16,12 +88,19 @@ const verboseBanner_1 = __nccwpck_require__(5472);
 const writeDotEnvFiles_1 = __nccwpck_require__(5614);
 const writeEnvDTs_1 = __nccwpck_require__(8832);
 const pipeline_1 = __nccwpck_require__(241);
+const nonInteractive_1 = __nccwpck_require__(1917);
 exports["default"] = async (choice, options) => {
   const config = await (0, getProjectConfig_1.getProjectConfig)();
   if (!config) {
     return;
   }
-  const context = (0, pipeline_1.createCatenvContext)(config);
+  const io = (0, nonInteractive_1.createNonInteractiveIO)({
+    vaultMode: options === null || options === void 0 ? void 0 : options.vaultMode
+  });
+  const context = {
+    ...(0, pipeline_1.createCatenvContext)(config),
+    io
+  };
   if (options === null || options === void 0 ? void 0 : options.verbose) {
     (0, verboseBanner_1.printVerboseBanner)();
   }
@@ -42,19 +121,19 @@ Object.defineProperty(exports, "__esModule", ({
 exports.printVariables = void 0;
 const getProjectConfig_1 = __nccwpck_require__(1);
 const utils_1 = __nccwpck_require__(1909);
-const getAllVariablesToPrint = async (config, choice) => {
+const getAllVariablesToPrint = async (io, config, choice) => {
   const {
     env,
     currentComponent
   } = await (0, utils_1.getCurrentComponentAndEnvFromChoice)(config, choice);
   if (currentComponent) {
-    return await (0, getProjectConfig_1.getEnvVarsResolved)(null, env, currentComponent);
+    return await (0, getProjectConfig_1.getEnvVarsResolved)(io, env, currentComponent);
   } else {
     // when in a monorep and not in a subapp, merge all env vars.
     // this is not 100% correct, but better than not exporting any vars at all
     // so we also add prefixed variants
     return await Object.keys(config.components).reduce(async (acc, componentName) => {
-      const subappvars = await (0, getProjectConfig_1.getEnvVarsResolved)(null, env, componentName);
+      const subappvars = await (0, getProjectConfig_1.getEnvVarsResolved)(io, env, componentName);
       delete subappvars["_ALL_ENV_VAR_KEYS"];
       return {
         ...(await acc),
@@ -66,7 +145,7 @@ const getAllVariablesToPrint = async (config, choice) => {
   }
 };
 const printVariables = async (context, choice) => {
-  const variables = await getAllVariablesToPrint(context.config, choice);
+  const variables = await getAllVariablesToPrint(context.io, context.config, choice);
   console.log(makeExportKeyValuestring(variables));
 };
 exports.printVariables = printVariables;
@@ -185,7 +264,7 @@ const writeDotEnvFiles = async (context, choice) => {
   const componentsToActuallyWriteDotEnvNow = currentComponent ? componentsWithEnabledDotEnvWrite.includes(currentComponent) ? [currentComponent] : [] : componentsWithEnabledDotEnvWrite;
   const gitRoot = await (0, projects_1.getGitRoot)();
   for (const componentName of componentsToActuallyWriteDotEnvNow) {
-    const variables = await (0, getProjectConfig_1.getEnvVarsResolved)(null, env, componentName);
+    const variables = await (0, getProjectConfig_1.getEnvVarsResolved)(context.io, env, componentName);
     delete variables["_ALL_ENV_VAR_KEYS"];
     const componentDir = (0, utils_1.getComponentFullPath)(gitRoot, context.config, componentName);
     const filePath = (0, path_1.join)(componentDir, ".env");
@@ -279,11 +358,12 @@ const catenv_1 = __importDefault(__nccwpck_require__(6057));
 const parseChoice_1 = __nccwpck_require__(4272);
 const packageInfos_1 = __importDefault(__nccwpck_require__(3568));
 const program = new commander_1.Command();
-program.name("catenv").description("Environment variable and pipeline generation via direnv").version(packageInfos_1.default.version).argument("[envComponent]", "env or env:component").option("-v, --verbose", "verbose output").option("-p, --print-variables", "print variables").action((envComponent, opts) => {
+program.name("catenv").description("Environment variable and pipeline generation via direnv").version(packageInfos_1.default.version).argument("[envComponent]", "env or env:component").option("-v, --verbose", "verbose output").option("-p, --print-variables", "print variables").addOption(new commander_1.Option("--vault-mode <mode>", ["how to interact with the secrets vault:", "auto: contact the vault when cached secrets are missing (may prompt to unlock)", "no-prompt: like auto, but fail instead of prompting", "offline: never contact the vault, use only locally cached secrets", "refresh: ignore the local cache once and refresh it from the vault"].join("\n")).choices(["auto", "no-prompt", "offline", "refresh"]).default("auto")).action((envComponent, opts) => {
   var _a, _b;
   (0, catenv_1.default)(envComponent ? (0, parseChoice_1.parseChoice)(envComponent) : null, {
     verbose: (_a = opts.verbose) !== null && _a !== void 0 ? _a : false,
-    printVariables: (_b = opts.printVariables) !== null && _b !== void 0 ? _b : false
+    printVariables: (_b = opts.printVariables) !== null && _b !== void 0 ? _b : false,
+    vaultMode: opts.vaultMode
   }).then(() => {
     // we have to exit manually, because we have some file watches
     process.exit();
@@ -403,14 +483,24 @@ const getGitlabVar = async (io, env, componentName, variableName) => {
 };
 exports.getGitlabVar = getGitlabVar;
 const resolveSecrets = async (io, varSets) => {
-  const allVariablesInGitlab = await (0, gitlab_1.getAllVariables)(io);
+  // the secret variables actually referenced by the env var values —
+  // when they are all in the local cache, the vault is not contacted
+  const referencedNames = [...new Set(varSets.flatMap(({
+    envVars
+  }) => Object.values(envVars).flatMap(value => {
+    var _a;
+    return (_a = `${value}`.match(/\$CL_\w+/g)) !== null && _a !== void 0 ? _a : [];
+  })))].map(reference => reference.slice(1));
+  const vaultManager = await io.getVaultManager();
+  const secrets = await vaultManager.readSecrets(referencedNames, io);
+  const secretEntries = Object.entries(secrets);
   return Object.fromEntries(varSets.flatMap(({
     envVars,
     secretEnvVarKeys
   }) => Object.entries(envVars).filter(([key, value]) => {
     var _a;
     return value !== undefined && value !== null && !((_a = secretEnvVarKeys.find(k => k.key === key)) === null || _a === void 0 ? void 0 : _a.hidden);
-  }).map(([key, value]) => [key, allVariablesInGitlab.reduce((acc, curr) => acc.replace(new RegExp("\\$" + curr.key, "g"), curr.value), `${value}`)])));
+  }).map(([key, value]) => [key, secretEntries.reduce((acc, [name, secretValue]) => acc.replace(new RegExp("\\$" + name, "g"), secretValue), `${value}`)])));
 };
 const getEnvVarsResolved = async (io, env, componentName) => {
   if (!componentName) {
@@ -464,6 +554,36 @@ exports.parseChoice = parseChoice;
 
 /***/ }),
 
+/***/ 2284:
+/***/ ((__unused_webpack_module, exports) => {
+
+"use strict";
+
+
+Object.defineProperty(exports, "__esModule", ({
+  value: true
+}));
+exports.MissingInputError = exports.NonInteractiveError = void 0;
+// ─── Errors ──────────────────────────────────────────────────────────
+class NonInteractiveError extends Error {
+  constructor(interaction) {
+    super(`${interaction} requires an interactive terminal, but this context is not interactive`);
+    this.name = "NonInteractiveError";
+  }
+}
+exports.NonInteractiveError = NonInteractiveError;
+class MissingInputError extends Error {
+  constructor(inputName, promptMessage) {
+    super(`Missing required input: "${inputName}" (${promptMessage}). ` + `Provide it via --${inputName}=<value> or --inputs='{"${inputName}": ...}'`);
+    this.inputName = inputName;
+    this.promptMessage = promptMessage;
+    this.name = "MissingInputError";
+  }
+}
+exports.MissingInputError = MissingInputError;
+
+/***/ }),
+
 /***/ 6636:
 /***/ ((__unused_webpack_module, exports, __nccwpck_require__) => {
 
@@ -518,14 +638,14 @@ exports.getProjectRootPath = getProjectRootPath;
 /**
  * Get the git remote hostname and project path from the git config.
  */
-const getGitRemoteHostAndPath = async () => {
+const getGitRemoteHostAndPath = async (remoteName = "origin") => {
   var _a;
-  const remoteUrl = await (0, gitConfig_1.gitConfigGet)("remote.origin.url");
+  const remoteUrl = await (0, gitConfig_1.gitConfigGet)(`remote.${remoteName}.url`);
   const remoteReg = /(https:\/\/|git@)([^:/]+)[:/]([^.]*)(\.git)?/;
   const match = (_a = remoteUrl.match(remoteReg)) !== null && _a !== void 0 ? _a : [];
   const [,, gitRemoteHost, gitRemotePath] = match;
   if (!(gitRemoteHost === null || gitRemoteHost === void 0 ? void 0 : gitRemoteHost.length) || !(gitRemotePath === null || gitRemotePath === void 0 ? void 0 : gitRemotePath.length)) {
-    throw new Error(`Failed to parse git remote hostname and path from git configs remote.origin.url! ${remoteUrl}`);
+    throw new Error(`Failed to parse git remote hostname and path from git configs remote.${remoteName}.url! ${remoteUrl}`);
   }
   return {
     gitRemoteHost,
@@ -947,6 +1067,1017 @@ exports.getProjectNamespace = getProjectNamespace;
 
 /***/ }),
 
+/***/ 3510:
+/***/ ((__unused_webpack_module, exports, __nccwpck_require__) => {
+
+"use strict";
+
+
+Object.defineProperty(exports, "__esModule", ({
+  value: true
+}));
+exports.BitwardenVault = void 0;
+const pipeline_1 = __nccwpck_require__(241);
+const yaml_1 = __nccwpck_require__(6637);
+const bw_1 = __nccwpck_require__(2211);
+const DEFAULT_COLLECTION = "catladder";
+const SECURE_NOTE_TYPE = 2;
+/**
+ * one yaml note per env and component:
+ * `<customerName>/<appName>/<env>/<componentName>/secrets.yml`
+ */
+const itemName = (config, env, componentName) => `${config.customerName}/${config.appName}/${env}/${componentName}/secrets.yml`;
+const itemPrefix = config => `${config.customerName}/${config.appName}/`;
+/**
+ * parses env and componentName back out of an item name
+ */
+const parseItemName = (config, name) => {
+  const match = name.slice(itemPrefix(config).length).match(/^([^/]+)\/([^/]+)\/secrets\.yml$/);
+  return match ? {
+    env: match[1],
+    componentName: match[2]
+  } : null;
+};
+const findCollection = async (session, collectionName) => {
+  const collections = await (0, bw_1.runBwJson)(session, ["list", "collections", "--search", collectionName]);
+  const collection = collections.find(c => c.name === collectionName);
+  if (!collection) {
+    throw new Error(`bitwarden collection '${collectionName}' not found — create it and make sure you have access`);
+  }
+  return collection;
+};
+const encodePayload = payload => Buffer.from(JSON.stringify(payload), "utf-8").toString("base64");
+class BitwardenVault {
+  constructor(config, options,
+  /**
+   * whether a locked bitwarden may be unlocked interactively
+   * (false with catenv --vault-mode no-prompt)
+   */
+  allowPrompt) {
+    var _a;
+    this.config = config;
+    this.allowPrompt = allowPrompt;
+    this.collectionName = (_a = options.collection) !== null && _a !== void 0 ? _a : DEFAULT_COLLECTION;
+    this.id = `bitwarden:${this.collectionName}`;
+  }
+  session(io) {
+    return (0, bw_1.getBwSession)(io, {
+      allowPrompt: this.allowPrompt
+    });
+  }
+  async readAllSecrets(io) {
+    const {
+      config,
+      collectionName
+    } = this;
+    const bwSession = await this.session(io);
+    const collection = await findCollection(bwSession, collectionName);
+    const items = await (0, bw_1.runBwJson)(bwSession, ["list", "items", "--collectionid", collection.id]);
+    const secrets = {};
+    for (const item of items) {
+      const parsed = parseItemName(config, item.name);
+      if (!parsed || !item.notes) {
+        continue;
+      }
+      const values = (0, yaml_1.parse)(item.notes);
+      Object.entries(values !== null && values !== void 0 ? values : {}).forEach(([key, value]) => {
+        secrets[(0, pipeline_1.getSecretVarName)(parsed.env, parsed.componentName, key)] = typeof value === "string" ? value : JSON.stringify(value);
+      });
+    }
+    return secrets;
+  }
+  async writeSecrets(io, env, componentName, secrets) {
+    const {
+      config,
+      collectionName
+    } = this;
+    const bwSession = await this.session(io);
+    const collection = await findCollection(bwSession, collectionName);
+    const name = itemName(config, env, componentName);
+    const existing = (await (0, bw_1.runBwJson)(bwSession, ["list", "items", "--collectionid", collection.id, "--search", name])).find(item => item.name === name);
+    const notes = (0, yaml_1.stringify)(secrets);
+    if (existing) {
+      await (0, bw_1.runBw)(bwSession, ["edit", "item", existing.id, encodePayload({
+        ...existing,
+        notes
+      })]);
+    } else {
+      await (0, bw_1.runBw)(bwSession, ["create", "item", encodePayload({
+        type: SECURE_NOTE_TYPE,
+        secureNote: {
+          type: 0
+        },
+        name,
+        notes,
+        ...(collection.organizationId ? {
+          organizationId: collection.organizationId,
+          collectionIds: [collection.id]
+        } : {})
+      })]);
+    }
+  }
+}
+exports.BitwardenVault = BitwardenVault;
+
+/***/ }),
+
+/***/ 1107:
+/***/ ((__unused_webpack_module, exports, __nccwpck_require__) => {
+
+"use strict";
+
+
+Object.defineProperty(exports, "__esModule", ({
+  value: true
+}));
+exports.GitlabVault = void 0;
+const gitlab_1 = __nccwpck_require__(4508);
+/**
+ * the legacy (and default) vault: the gitlab project variables double
+ * as the secret store
+ */
+class GitlabVault {
+  constructor() {
+    this.id = "gitlab";
+  }
+  async readAllSecrets(io) {
+    const variables = await (0, gitlab_1.getAllVariables)(io);
+    return Object.fromEntries(variables.map(v => [v.key, v.value]));
+  }
+  async writeSecrets(io, env, componentName, secrets) {
+    await (0, gitlab_1.upsertAllVariables)(io, secrets, env, componentName);
+  }
+}
+exports.GitlabVault = GitlabVault;
+
+/***/ }),
+
+/***/ 5771:
+/***/ ((__unused_webpack_module, exports, __nccwpck_require__) => {
+
+"use strict";
+
+
+Object.defineProperty(exports, "__esModule", ({
+  value: true
+}));
+exports.VaultManager = void 0;
+const pipeline_1 = __nccwpck_require__(241);
+const BitwardenVault_1 = __nccwpck_require__(3510);
+const cache_1 = __nccwpck_require__(4236);
+const GitlabVault_1 = __nccwpck_require__(1107);
+/**
+ * only secrets of this env are cached locally — the other envs'
+ * secrets have no business sitting on developer machines
+ */
+const CACHED_ENV = "local";
+/**
+ * owns the configured vault, the secrets mode and the local cache.
+ * The vault is the readable source of truth for secrets; CI backends
+ * only receive mirrored copies.
+ */
+class VaultManager {
+  constructor(config, options = {}) {
+    var _a, _b;
+    this.config = config;
+    /** refresh mode bypasses the cache only once per manager */
+    this.refreshed = false;
+    this.mode = (_a = options.mode) !== null && _a !== void 0 ? _a : "auto";
+    this.io = (_b = options.io) !== null && _b !== void 0 ? _b : null;
+    this.vault = this.createVault();
+  }
+  createVault() {
+    const vaultConfig = (0, pipeline_1.getVaultConfig)(this.config);
+    switch (vaultConfig.type) {
+      case "gitlab":
+        return new GitlabVault_1.GitlabVault();
+      case "bitwarden":
+        return new BitwardenVault_1.BitwardenVault(this.config, vaultConfig, this.mode === "auto" || this.mode === "refresh");
+    }
+  }
+  /**
+   * the vault secrets, served from the local cache when it contains
+   * all required names; otherwise (depending on the mode) refreshed
+   * from the vault. Only the "local" env is (re-)cached.
+   */
+  async readSecrets(requiredNames, io = this.io) {
+    const bypassCache = this.mode === "refresh" && !this.refreshed;
+    const cache = bypassCache ? null : await (0, cache_1.readSecretsCache)();
+    // known entries include recorded misses (null values), so declared
+    // but intentionally unset secrets don't force a vault refresh
+    const known = (cache === null || cache === void 0 ? void 0 : cache.vaultId) === this.vault.id ? flattenSecrets(cache.secrets) : undefined;
+    const missing = requiredNames.filter(name => !(name in (known !== null && known !== void 0 ? known : {})));
+    // nothing missing (or nothing required at all): don't touch the vault
+    if (missing.length === 0 && (known || requiredNames.length === 0)) {
+      return withoutMisses(known !== null && known !== void 0 ? known : {});
+    }
+    if (this.mode === "offline") {
+      if (missing.length > 0) {
+        io === null || io === void 0 ? void 0 : io.log(`⚠️ vault is offline (--vault-mode offline) and ${missing.length} secrets are not in the local cache: ${missing.join(", ")}`);
+      }
+      return withoutMisses(known !== null && known !== void 0 ? known : {});
+    }
+    const secrets = await this.vault.readAllSecrets(io);
+    this.refreshed = true;
+    await (0, cache_1.writeSecretsCache)(this.vault.id, await this.cacheableSubset(secrets));
+    return secrets;
+  }
+  /**
+   * writes secrets of one env/component to the vault and updates the
+   * local cache (write-through, "local" env only)
+   */
+  async writeSecrets(env, componentName, secrets, io = this.io) {
+    if (!io) {
+      throw new Error("writing to the vault requires an interactive context");
+    }
+    await this.vault.writeSecrets(io, env, componentName, secrets);
+    if (env === CACHED_ENV) {
+      await (0, cache_1.updateSecretsCache)(this.vault.id, env, componentName, Object.fromEntries(Object.entries(secrets).map(([key, value]) => [key, typeof value === "string" ? value : JSON.stringify(value)])));
+    }
+  }
+  /**
+   * the subset of the vault secrets that may be cached: the declared
+   * secrets of the "local" env, per component, as a hierarchy
+   */
+  async cacheableSubset(flatSecrets) {
+    const local = {};
+    for (const componentName of Object.keys(this.config.components)) {
+      const keys = await this.declaredSecretKeys(componentName);
+      const values = Object.fromEntries(keys.map(key => {
+        var _a;
+        return [key,
+        // null records "absent in the vault" (a known miss)
+        (_a = flatSecrets[(0, pipeline_1.getSecretVarName)(CACHED_ENV, componentName, key)]) !== null && _a !== void 0 ? _a : null];
+      }));
+      if (Object.keys(values).length > 0) {
+        local[componentName] = values;
+      }
+    }
+    return Object.keys(local).length > 0 ? {
+      [CACHED_ENV]: local
+    } : {};
+  }
+  async declaredSecretKeys(componentName) {
+    try {
+      const {
+        secretEnvVarKeys,
+        jobOnlyVars
+      } = await (0, pipeline_1.getEnvironment)({
+        config: this.config,
+        componentName,
+        env: CACHED_ENV
+      });
+      return [...secretEnvVarKeys, ...jobOnlyVars.build.secretEnvVarKeys, ...jobOnlyVars.deploy.secretEnvVarKeys].map(({
+        key
+      }) => key);
+    } catch (_a) {
+      // components without a local env simply have nothing to cache
+      return [];
+    }
+  }
+}
+exports.VaultManager = VaultManager;
+/**
+ * the cache hierarchy as a flat map of raw secret variable names
+ * (null values = recorded misses)
+ */
+const flattenSecrets = secrets => Object.fromEntries(Object.entries(secrets).flatMap(([env, components]) => Object.entries(components).flatMap(([componentName, values]) => Object.entries(values).map(([key, value]) => [(0, pipeline_1.getSecretVarName)(env, componentName, key), value]))));
+/**
+ * only actual values — recorded misses stay unresolved, like any other
+ * unset variable
+ */
+const withoutMisses = known => Object.fromEntries(Object.entries(known).filter(entry => entry[1] !== null));
+
+/***/ }),
+
+/***/ 2211:
+/***/ ((__unused_webpack_module, exports, __nccwpck_require__) => {
+
+"use strict";
+
+
+Object.defineProperty(exports, "__esModule", ({
+  value: true
+}));
+exports.runBwJson = exports.runBw = exports.getBwSession = void 0;
+const child_process_1 = __nccwpck_require__(5317);
+const util_1 = __nccwpck_require__(9023);
+const preferences_1 = __nccwpck_require__(6261);
+const execFile = (0, util_1.promisify)(child_process_1.execFile);
+const SESSION_PREFERENCE = "bwsession";
+class BitwardenLockedError extends Error {
+  constructor() {
+    super("bitwarden is locked and prompting is disabled — run `bw unlock` or catenv without --vault-mode no-prompt");
+  }
+}
+/**
+ * runs an interactive bw command that prints a session key on stdout
+ * (login/unlock) while the user types the password on the terminal
+ */
+const interactiveSessionCommand = args => new Promise((resolve, reject) => {
+  var _a;
+  const child = (0, child_process_1.spawn)("bw", [...args, "--raw"], {
+    stdio: ["inherit", "pipe", "inherit"]
+  });
+  let session = "";
+  (_a = child.stdout) === null || _a === void 0 ? void 0 : _a.on("data", data => session += data.toString("utf-8"));
+  child.on("error", reject);
+  child.on("close", code => code === 0 && session.trim() ? resolve(session.trim()) : reject(new Error(`bw ${args[0]} failed`)));
+});
+const getBwStatus = async session => {
+  try {
+    const {
+      stdout
+    } = await execFile("bw", ["status"], {
+      env: {
+        ...process.env,
+        ...(session ? {
+          BW_SESSION: session
+        } : {})
+      }
+    });
+    return JSON.parse(stdout).status;
+  } catch (_a) {
+    return "unauthenticated";
+  }
+};
+/**
+ * a working bw session: reuses the cached one, otherwise unlocks (or
+ * logs in) interactively — unless prompting is disabled
+ */
+const getBwSession = async (io, {
+  allowPrompt
+}) => {
+  const cached = (await (0, preferences_1.hasPreference)(SESSION_PREFERENCE)) ? String(await (0, preferences_1.getPreference)(SESSION_PREFERENCE)) : null;
+  const status = await getBwStatus(cached);
+  if (status === "unlocked" && cached) {
+    return cached;
+  }
+  if (!allowPrompt) {
+    throw new BitwardenLockedError();
+  }
+  io === null || io === void 0 ? void 0 : io.log("");
+  io === null || io === void 0 ? void 0 : io.log(status === "unauthenticated" ? "# Please login to Bitwarden:" : "# Bitwarden is locked, please unlock:");
+  io === null || io === void 0 ? void 0 : io.log("");
+  const session = await interactiveSessionCommand([status === "unauthenticated" ? "login" : "unlock"]);
+  await (0, preferences_1.setPreference)(SESSION_PREFERENCE, session);
+  await (0, exports.runBw)(session, ["sync"]);
+  return session;
+};
+exports.getBwSession = getBwSession;
+/**
+ * runs a bw command with the given session and returns stdout
+ */
+const runBw = async (session, args) => {
+  const {
+    stdout
+  } = await execFile("bw", [...args, "--raw", "--nointeraction"], {
+    env: {
+      ...process.env,
+      BW_SESSION: session
+    },
+    maxBuffer: 50 * 1024 * 1024
+  });
+  return stdout;
+};
+exports.runBw = runBw;
+const runBwJson = async (session, args) => JSON.parse(await (0, exports.runBw)(session, args));
+exports.runBwJson = runBwJson;
+
+/***/ }),
+
+/***/ 4236:
+/***/ ((__unused_webpack_module, exports, __nccwpck_require__) => {
+
+"use strict";
+
+
+Object.defineProperty(exports, "__esModule", ({
+  value: true
+}));
+exports.updateSecretsCache = exports.writeSecretsCache = exports.readSecretsCache = void 0;
+const promises_1 = __nccwpck_require__(1943);
+const path_1 = __nccwpck_require__(6928);
+const gitProjectInformation_1 = __nccwpck_require__(1111);
+const getCacheFolder = async () => (0, path_1.join)(await (0, gitProjectInformation_1.getProjectRootPath)(), ".catladder");
+const getCachePath = async () => (0, path_1.join)(await getCacheFolder(), "secrets.json");
+const readSecretsCache = async () => {
+  try {
+    return JSON.parse(await (0, promises_1.readFile)(await getCachePath(), "utf-8"));
+  } catch (_a) {
+    return null;
+  }
+};
+exports.readSecretsCache = readSecretsCache;
+const writeSecretsCache = async (vaultId, secrets) => {
+  const folder = await getCacheFolder();
+  await (0, promises_1.mkdir)(folder, {
+    recursive: true
+  });
+  // the folder ignores itself, so the cache can never be committed
+  await (0, promises_1.writeFile)((0, path_1.join)(folder, ".gitignore"), "*\n");
+  const cache = {
+    vaultId,
+    updatedAt: new Date().toISOString(),
+    secrets
+  };
+  await (0, promises_1.writeFile)(await getCachePath(), JSON.stringify(cache, null, 2));
+};
+exports.writeSecretsCache = writeSecretsCache;
+/**
+ * merges freshly written secrets of one env/component into the cache
+ * (write-through from config-secrets), so the next catenv run doesn't
+ * need the vault
+ */
+const updateSecretsCache = async (vaultId, env, componentName, values) => {
+  var _a;
+  const existing = await (0, exports.readSecretsCache)();
+  const secrets = (existing === null || existing === void 0 ? void 0 : existing.vaultId) === vaultId ? existing.secrets : {};
+  secrets[env] = {
+    ...secrets[env],
+    [componentName]: {
+      ...((_a = secrets[env]) === null || _a === void 0 ? void 0 : _a[componentName]),
+      ...values
+    }
+  };
+  await (0, exports.writeSecretsCache)(vaultId, secrets);
+};
+exports.updateSecretsCache = updateSecretsCache;
+
+/***/ }),
+
+/***/ 4038:
+/***/ ((__unused_webpack_module, exports, __nccwpck_require__) => {
+
+"use strict";
+
+
+Object.defineProperty(exports, "__esModule", ({
+  value: true
+}));
+exports.GithubBackend = void 0;
+const promises_1 = __nccwpck_require__(1943);
+const path_1 = __nccwpck_require__(6928);
+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 githubReleaseJobs_1 = __nccwpck_require__(5611);
+const WORKFLOWS_FOLDER = ".github/workflows";
+/**
+ * generated workflow files are prefixed so that cleanup never touches
+ * user-maintained workflows in the same folder
+ */
+const GENERATED_FILE_PREFIX = "catladder-";
+const TRIGGER_WORKFLOWS = {
+  mr: {
+    name: "catladder review",
+    on: {
+      pull_request: {
+        types: ["opened", "synchronize", "reopened"]
+      }
+    },
+    concurrency: {
+      group: "catladder-review-${{ github.event.number }}",
+      "cancel-in-progress": true
+    }
+  },
+  mainBranch: {
+    name: "catladder main",
+    // TODO: make the default branch configurable
+    on: {
+      push: {
+        branches: ["main"]
+      }
+    }
+  },
+  taggedRelease: {
+    name: "catladder release",
+    on: {
+      push: {
+        tags: ["v*"]
+      }
+    }
+  }
+};
+class GithubBackend {
+  constructor() {
+    this.type = "github";
+  }
+  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))));
+  }
+  async createFiles(config) {
+    const workflows = await this.createWorkflows(config);
+    return Object.entries(workflows).map(([fileName, workflow]) => ({
+      path: (0, path_1.join)(WORKFLOWS_FOLDER, fileName),
+      content: workflow
+    }));
+  }
+  /**
+   * all workflows keyed by file name, mainly for testing purposes
+   */
+  async createWorkflows(config) {
+    const workflows = {};
+    const reviewStopJobs = {};
+    const manualJobs = {};
+    for (const trigger of config_1.ALL_PIPELINE_TRIGGERS) {
+      const allJobs = await (0, createAllJobs_1.createAllJobs)({
+        config,
+        trigger,
+        pipelineType: this.type
+      });
+      const uploadProviderIds = (0, createGithubJobs_1.getUploadProviderIds)(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);
+        if (isReviewStopJob(context, job)) {
+          reviewStopJobs[id] = githubJob;
+        } else if (isManualTaskJob(job)) {
+          manualJobs[id] = githubJob;
+        } else {
+          jobs[id] = githubJob;
+        }
+      }));
+      if (trigger === "mainBranch") {
+        const releaseJobs = (0, githubReleaseJobs_1.getGithubReleaseJobs)(config, Object.keys(jobs));
+        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],
+          env: ciVariables_1.GITHUB_INJECTED_WORKFLOW_ENV,
+          jobs
+        };
+      }
+    }
+    if (Object.keys(reviewStopJobs).length > 0) {
+      workflows[`${GENERATED_FILE_PREFIX}review-stop.yml`] = {
+        name: "catladder review stop",
+        on: {
+          pull_request: {
+            types: ["closed"]
+          }
+        },
+        env: ciVariables_1.GITHUB_INJECTED_WORKFLOW_ENV,
+        jobs: reviewStopJobs
+      };
+    }
+    if (Object.keys(manualJobs).length > 0) {
+      workflows[`${GENERATED_FILE_PREFIX}manual.yml`] = {
+        name: "catladder manual tasks",
+        on: {
+          workflow_dispatch: {
+            inputs: {
+              job: {
+                description: "the task to run",
+                required: true,
+                type: "choice",
+                options: Object.keys(manualJobs)
+              }
+            }
+          }
+        },
+        env: ciVariables_1.GITHUB_INJECTED_WORKFLOW_ENV,
+        jobs: Object.fromEntries(Object.entries(manualJobs).map(([id, job]) => [id, {
+          ...job,
+          if: `\${{ inputs.job == '${id}' }}`
+        }]))
+      };
+    }
+    return workflows;
+  }
+}
+exports.GithubBackend = GithubBackend;
+const workflowFileName = trigger => {
+  switch (trigger) {
+    case "mr":
+      return "review.yml";
+    case "mainBranch":
+      return "main.yml";
+    case "taggedRelease":
+      return "release.yml";
+  }
+  throw new Error(`${trigger} is not supported`);
+};
+/**
+ * stop jobs of review environments run in their own workflow when the
+ * pull request is closed (the counterpart of gitlab's on_stop wiring)
+ */
+const isReviewStopJob = (context, job) => {
+  var _a;
+  return ((_a = job.environment) === null || _a === void 0 ? void 0 : _a.action) === "stop" && context.type === "component" && context.environment.envType === "review";
+};
+/**
+ * stop/rollback jobs of non-review environments have no automatic
+ * trigger; they are collected in a workflow_dispatch workflow
+ * (gitlab runs them as manual jobs inside the pipeline)
+ */
+const isManualTaskJob = job => job.stage === "stop" || job.stage === "rollback";
+
+/***/ }),
+
+/***/ 3093:
+/***/ ((__unused_webpack_module, exports) => {
+
+"use strict";
+
+
+Object.defineProperty(exports, "__esModule", ({
+  value: true
+}));
+exports.GITHUB_INJECTED_WORKFLOW_ENV = exports.GITHUB_CI_VARIABLES = void 0;
+/**
+ * how the github backend names the predefined CI variables.
+ *
+ * GITHUB_* variables are provided by github actions natively; the CL_*
+ * variables are injected by the {@link GithubBackend} itself (workflow or
+ * job level), because github has no direct counterpart.
+ */
+exports.GITHUB_CI_VARIABLES = {
+  commitSha: "GITHUB_SHA",
+  jobToken: "CL_JOB_TOKEN",
+  jobImage: "CL_JOB_IMAGE",
+  registry: "CL_REGISTRY",
+  registryImage: "CL_REGISTRY_IMAGE"
+};
+/**
+ * the workflow-level env the backend injects to provide the CL_*
+ * variables referenced by {@link GITHUB_CI_VARIABLES}
+ */
+exports.GITHUB_INJECTED_WORKFLOW_ENV = {
+  CL_JOB_TOKEN: "${{ github.token }}",
+  CL_REGISTRY: "ghcr.io",
+  CL_REGISTRY_IMAGE: "ghcr.io/${{ github.repository }}",
+  // empty outside of pull request events
+  CL_PR_NUMBER: "${{ github.event.number }}"
+};
+
+/***/ }),
+
+/***/ 4016:
+/***/ ((__unused_webpack_module, exports, __nccwpck_require__) => {
+
+"use strict";
+
+
+Object.defineProperty(exports, "__esModule", ({
+  value: true
+}));
+exports.getUploadProviderIds = exports.makeGithubJob = exports.resolveGithubNeeds = exports.githubJobId = void 0;
+const lodash_es_1 = __nccwpck_require__(4284);
+const getInjectVarsScript_1 = __nccwpck_require__(436);
+const createJobCache_1 = __nccwpck_require__(5644);
+const getEnvironmentVariables_1 = __nccwpck_require__(5855);
+const utils_1 = __nccwpck_require__(595);
+const gitlab_1 = __nccwpck_require__(3468);
+const scriptFunctions_1 = __nccwpck_require__(5759);
+/**
+ * runner variables that only make sense on gitlab runners and must not
+ * leak into github jobs (docker-in-docker daemon config, kubernetes
+ * executor resource requests, gitlab clone strategy)
+ */
+const GITLAB_ONLY_RUNNER_VARIABLES = new Set(["DOCKER_HOST", "DOCKER_TLS_CERTDIR", "DOCKER_DRIVER", "KUBERNETES_CPU_REQUEST", "KUBERNETES_MEMORY_REQUEST", "KUBERNETES_CPU_LIMIT", "KUBERNETES_MEMORY_LIMIT", "GIT_STRATEGY"]);
+/**
+ * github runs docker natively on its runners, gitlab needs a
+ * docker-in-docker service for it
+ */
+const isDindService = image => /(^|\/)docker:.*dind/.test(image);
+const slug = value => {
+  const slugged = value.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
+  // job ids must start with a letter or _
+  return /^[a-z_]/.test(slugged) ? slugged : `job-${slugged}`;
+};
+const githubJobId = (context, jobName) => slug(`${context.type === "workspace" ? "ws-" : ""}${context.name}-${jobName}-${context.env}`);
+exports.githubJobId = githubJobId;
+const githubJobName = (context, jobName) => `${context.name} ${jobName} | ${context.env}`;
+const resolveNeed = (context, need, allJobs) => {
+  var _a;
+  const env = context.env;
+  const findComponentJob = (componentName, jobName) => {
+    const provider = allJobs.components.find(c => c.context.name === componentName && c.context.env === env);
+    const job = provider === null || provider === void 0 ? void 0 : provider.jobs.find(j => j.name === jobName);
+    if (!provider || !job) {
+      throw new Error(`unknown job referenced: '${jobName}' from '${env}:${componentName}'`);
+    }
+    return (0, exports.githubJobId)(provider.context, jobName);
+  };
+  const findWorkspaceJob = (workspaceName, jobName) => {
+    const provider = allJobs.workspaces.find(w => w.context.name === workspaceName && w.context.env === env);
+    const job = provider === null || provider === void 0 ? void 0 : provider.jobs.find(j => j.name === jobName);
+    if (!provider || !job) {
+      throw new Error(`unknown job referenced: '${jobName}' from workspace '${env}:${workspaceName}'`);
+    }
+    return (0, exports.githubJobId)(provider.context, jobName);
+  };
+  if ((0, lodash_es_1.isObject)(need)) {
+    if ("workspaceName" in need && need.workspaceName) {
+      return {
+        id: findWorkspaceJob(need.workspaceName, need.job),
+        artifacts: need.artifacts
+      };
+    }
+    return {
+      id: findComponentJob((_a = "componentName" in need ? need.componentName : undefined) !== null && _a !== void 0 ? _a : context.name, need.job),
+      artifacts: need.artifacts
+    };
+  }
+  return {
+    id: context.type === "workspace" ? findWorkspaceJob(context.name, need) : findComponentJob(context.name, need),
+    // plain string needs download artifacts by default (gitlab semantics)
+    artifacts: true
+  };
+};
+const resolveGithubNeeds = (context, job, allJobs) => {
+  var _a;
+  const resolved = ((_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));
+};
+exports.resolveGithubNeeds = resolveGithubNeeds;
+const createCacheSteps = (context, job) => {
+  var _a, _b;
+  if (!((_a = job.caches) === null || _a === void 0 ? void 0 : _a.length)) {
+    return [];
+  }
+  const lowered = (_b = (0, createJobCache_1.createJobCacheFromCacheConfigs)(context, job.caches)) !== null && _b !== void 0 ? _b : [];
+  return (0, utils_1.ensureArray)(lowered).map(cache => {
+    var _a, _b, _c, _d, _e, _f;
+    const paths = (0, utils_1.ensureArray)((_a = cache.paths) !== null && _a !== void 0 ? _a : []);
+    const key = cache.key;
+    const {
+      cacheKey,
+      restoreKeyPrefix,
+      label
+    } = typeof key === "string" || key === undefined ? {
+      // unique key per run so the cache is re-saved, restored via prefix
+      cacheKey: `${key !== null && key !== void 0 ? key : "cache"}-\${{ github.run_id }}`,
+      restoreKeyPrefix: `${key !== null && key !== void 0 ? key : "cache"}-`,
+      label: key !== null && key !== void 0 ? key : "cache"
+    } : {
+      cacheKey: `${(_b = key.prefix) !== null && _b !== void 0 ? _b : "files"}-\${{ hashFiles(${((_c = key.files) !== null && _c !== void 0 ? _c : []).map(f => `'${f}'`).join(", ")}) }}`,
+      restoreKeyPrefix: `${(_d = key.prefix) !== null && _d !== void 0 ? _d : "files"}-`,
+      label: (_e = key.prefix) !== null && _e !== void 0 ? _e : ((_f = key.files) !== null && _f !== void 0 ? _f : []).join(",")
+    };
+    return {
+      name: `Cache ${label}`,
+      // pull-only caches are restored but never saved
+      uses: cache.policy === "pull" ? "actions/cache/restore@v4" : "actions/cache@v4",
+      with: {
+        path: paths.join("\n"),
+        key: cacheKey,
+        "restore-keys": restoreKeyPrefix
+      }
+    };
+  });
+};
+const getSecretsEnv = context => {
+  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} }}`];
+  }));
+};
+const makeGithubJob = (context, job, allJobs, uploadProviderIds) => {
+  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 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");
+  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" ? {
+    name: service
+  } : service).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
+    } : {})
+  }]));
+  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) : {}),
+    CL_JOB_IMAGE: image !== null && image !== void 0 ? image : "runner"
+  };
+  const githubJob = {
+    name: githubJobName(context, job.name),
+    "runs-on": "ubuntu-latest",
+    ...(needs.length > 0 ? {
+      needs: needs.map(n => n.id)
+    } : {}),
+    ...(image ? {
+      container: {
+        image
+      }
+    } : {}),
+    ...(Object.keys(services).length > 0 ? {
+      services
+    } : {}),
+    ...(job.environment && isComponent ? {
+      environment: {
+        name: context.environment.envType === "review" ? `review-pr\${{ github.event.number }}-${context.name}` : `${context.env}-${context.name}`,
+        ...(createsJobEnv ? {
+          url: "${{ steps.main.outputs.url }}"
+        } : {})
+      }
+    } : {}),
+    env,
+    steps: [...(skipCheckout ? [] : [{
+      name: "Checkout",
+      uses: "actions/checkout@v4"
+    }]), ...createCacheSteps(context, job), ...needs.filter(n => n.artifacts).map(n => ({
+      name: `Download artifacts from ${n.id}`,
+      uses: "actions/download-artifact@v4",
+      with: {
+        name: n.id
+      }
+    })), {
+      name: job.name,
+      id: "main",
+      run: runScript,
+      shell: "bash"
+    }, ...(uploadProviderIds.has(id) || artifactPaths.length > 0 ? artifactPaths.length > 0 ? [{
+      name: "Upload artifacts",
+      uses: "actions/upload-artifact@v4",
+      with: {
+        name: id,
+        path: artifactPaths.join("\n"),
+        "if-no-files-found": "warn"
+      }
+    }] : [] : [])]
+  };
+  return [id, githubJob];
+};
+exports.makeGithubJob = makeGithubJob;
+/**
+ * the ids of all jobs whose artifacts are consumed by other jobs
+ * (they need an upload step)
+ */
+const getUploadProviderIds = allJobs => {
+  const ids = new Set();
+  [...allJobs.workspaces, ...allJobs.components].forEach(({
+    context,
+    jobs
+  }) => jobs.forEach(job => (0, exports.resolveGithubNeeds)(context, job, allJobs).filter(n => n.artifacts).forEach(n => ids.add(n.id))));
+  return ids;
+};
+exports.getUploadProviderIds = getUploadProviderIds;
+
+/***/ }),
+
+/***/ 5611:
+/***/ ((__unused_webpack_module, exports, __nccwpck_require__) => {
+
+"use strict";
+
+
+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
+    }
+  }, {
+    name: "create release",
+    run: "semanticRelease",
+    shell: "bash"
+  }]
+});
+/**
+ * the release jobs for the github backend (the counterpart of the
+ * gitlab release jobs):
+ * - releases.when === "auto": the release job runs in the main-branch
+ *   workflow after all other jobs; a force variant goes to the manual
+ *   tasks workflow
+ * - otherwise (manual, the default): the release job goes to the
+ *   manual tasks workflow
+ */
+const getGithubReleaseJobs = (config, mainWorkflowJobIds) => {
+  var _a;
+  if (((_a = config.releases) === null || _a === void 0 ? void 0 : _a.when) === "auto") {
+    return {
+      main: {
+        "create-release": createReleaseJob(mainWorkflowJobIds)
+      },
+      manual: {
+        "force-create-release": createReleaseJob()
+      }
+    };
+  }
+  return {
+    main: {},
+    manual: {
+      "create-release": createReleaseJob()
+    }
+  };
+};
+exports.getGithubReleaseJobs = getGithubReleaseJobs;
+
+/***/ }),
+
+/***/ 9635:
+/***/ (function(__unused_webpack_module, exports, __nccwpck_require__) {
+
+"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
+}));
+__exportStar(__nccwpck_require__(4038), exports);
+__exportStar(__nccwpck_require__(3093), exports);
+
+/***/ }),
+
+/***/ 5759:
+/***/ ((__unused_webpack_module, exports, __nccwpck_require__) => {
+
+"use strict";
+
+
+Object.defineProperty(exports, "__esModule", ({
+  value: true
+}));
+exports.getGithubScriptFunctionDefinitions = void 0;
+const globalScriptFunctions_1 = __nccwpck_require__(3891);
+/**
+ * github variants of the global script functions where the gitlab
+ * implementation uses gitlab-specific mechanics (e.g. collapsible log
+ * sections use gitlab's `section_start` escape codes, github uses
+ * `::group::` workflow commands). All other functions are plain bash
+ * and shared as-is.
+ */
+const GITHUB_FUNCTION_OVERRIDES = {
+  collapseable_section_start: `local section_title="\${1}"
+  local section_description="\${2:-$section_title}"
+  echo "::group::\${section_description}"`,
+  collapseable_section_end: `echo "::endgroup::"`
+};
+/**
+ * the bash function definitions to prepend to every job script.
+ * github has no pipeline-wide before_script like gitlab, so each job
+ * carries its own definitions.
+ */
+const getGithubScriptFunctionDefinitions = () => [...globalScriptFunctions_1.globalScriptFunctions.values()].map(fn => {
+  const override = GITHUB_FUNCTION_OVERRIDES[fn.name];
+  return override ? `function ${fn.name} () {\n${override.trim()}\n}` : fn.toBashFunction();
+});
+exports.getGithubScriptFunctionDefinitions = getGithubScriptFunctionDefinitions;
+
+/***/ }),
+
 /***/ 2278:
 /***/ ((__unused_webpack_module, exports, __nccwpck_require__) => {
 
@@ -957,6 +2088,7 @@ Object.defineProperty(exports, "__esModule", ({
   value: true
 }));
 exports.GitlabBackend = void 0;
+const promises_1 = __nccwpck_require__(1943);
 const rules_1 = __nccwpck_require__(4565);
 const config_1 = __nccwpck_require__(6925);
 const createAllJobs_1 = __nccwpck_require__(3671);
@@ -972,6 +2104,12 @@ class GitlabBackend {
     this.type = "gitlab";
     this.generatedFolder = GITLAB_GENERATED_FOLDER;
   }
+  async cleanup() {
+    await (0, promises_1.rm)(this.generatedFolder, {
+      force: true,
+      recursive: true
+    });
+  }
   async createFiles(config) {
     const includes = await this.createIncludes(config);
     const mainFile = {
@@ -1686,12 +2824,15 @@ var __exportStar = this && this.__exportStar || function (m, exports) {
 Object.defineProperty(exports, "__esModule", ({
   value: true
 }));
-exports.getEnabledPipelineTypes = exports.getPipelineBackend = void 0;
+exports.getEnabledPipelineTypes = exports.getVaultConfig = exports.getPipelineGitRemote = exports.getPipelineOptions = exports.getPipelineBackend = void 0;
+const github_1 = __nccwpck_require__(9635);
 const gitlab_1 = __nccwpck_require__(8475);
 __exportStar(__nccwpck_require__(2474), exports);
 __exportStar(__nccwpck_require__(8475), exports);
+__exportStar(__nccwpck_require__(9635), exports);
 const BACKENDS = {
-  gitlab: () => new gitlab_1.GitlabBackend()
+  gitlab: () => new gitlab_1.GitlabBackend(),
+  github: () => new github_1.GithubBackend()
 };
 const getPipelineBackend = type => {
   const createBackend = BACKENDS[type];
@@ -1701,6 +2842,38 @@ const getPipelineBackend = type => {
   return createBackend();
 };
 exports.getPipelineBackend = getPipelineBackend;
+/**
+ * the options of an enabled pipeline type (empty object when enabled
+ * with `true`)
+ */
+const getPipelineOptions = (config, type) => {
+  var _a;
+  const value = (_a = config.pipelines) === null || _a === void 0 ? void 0 : _a[type];
+  return typeof value === "object" ? value : {};
+};
+exports.getPipelineOptions = getPipelineOptions;
+/**
+ * the git remote pointing to the repository of this pipeline type's CI
+ * system (e.g. during a migration, gitlab may be `origin` and github a
+ * second remote)
+ */
+const getPipelineGitRemote = (config, type) => {
+  var _a;
+  return (_a = (0, exports.getPipelineOptions)(config, type).gitRemote) !== null && _a !== void 0 ? _a : "origin";
+};
+exports.getPipelineGitRemote = getPipelineGitRemote;
+/**
+ * the normalized secrets vault of a config (string shorthands resolved
+ * to their object form; defaults to the legacy gitlab store)
+ */
+const getVaultConfig = config => {
+  var _a, _b;
+  const vault = (_b = (_a = config.secrets) === null || _a === void 0 ? void 0 : _a.vault) !== null && _b !== void 0 ? _b : "gitlab";
+  return typeof vault === "string" ? {
+    type: vault
+  } : vault;
+};
+exports.getVaultConfig = getVaultConfig;
 /**
  * the pipeline types enabled for this config. Multiple types can be
  * enabled at once (parallel generation, e.g. during a CI migration).
@@ -2043,10 +3216,12 @@ Object.defineProperty(exports, "__esModule", ({
   value: true
 }));
 exports.getCiVariable = void 0;
-const ciVariables_1 = __nccwpck_require__(8506);
+const ciVariables_1 = __nccwpck_require__(3093);
+const ciVariables_2 = __nccwpck_require__(8506);
 const BashExpression_1 = __nccwpck_require__(5354);
 const CI_VARIABLES_PER_PIPELINE_TYPE = {
-  gitlab: ciVariables_1.GITLAB_CI_VARIABLES
+  gitlab: ciVariables_2.GITLAB_CI_VARIABLES,
+  github: ciVariables_1.GITHUB_CI_VARIABLES
 };
 /**
  * resolves a platform-neutral CI variable to a bash expression for the
@@ -3665,7 +4840,7 @@ Object.defineProperty(exports, "__esModule", ({
   value: true
 }));
 exports.DOCKER_REGISTRY = exports.PIPELINE_IMAGE_TAG = void 0;
-exports.PIPELINE_IMAGE_TAG = "next-16388362" || 0;
+exports.PIPELINE_IMAGE_TAG = "next-8b9ad5ca" || 0;
 exports.DOCKER_REGISTRY = "git.panter.ch:5001/catladder/catladder" || 0;
 
 /***/ }),
@@ -4232,7 +5407,9 @@ const bashExpressionPerPipelineType_1 = __nccwpck_require__(1945);
 const getEnvType_1 = __nccwpck_require__(8254);
 const REVIEW_SLUG = {
   default: "unknown-review-slug",
-  gitlab: new BashExpression_1.BashExpression(`$([ -n "$CI_MERGE_REQUEST_IID" ] && echo "mr$CI_MERGE_REQUEST_IID" || { [ -n "$CI_COMMIT_REF_SLUG" ] && echo "$CI_COMMIT_REF_SLUG" || echo "unknown"; })`)
+  gitlab: new BashExpression_1.BashExpression(`$([ -n "$CI_MERGE_REQUEST_IID" ] && echo "mr$CI_MERGE_REQUEST_IID" || { [ -n "$CI_COMMIT_REF_SLUG" ] && echo "$CI_COMMIT_REF_SLUG" || echo "unknown"; })`),
+  // CL_PR_NUMBER is injected by the github backend at the workflow level
+  github: new BashExpression_1.BashExpression(`$([ -n "$CL_PR_NUMBER" ] && echo "pr$CL_PR_NUMBER" || echo "unknown")`)
 };
 const getReviewSlug = (envConfig, env, pipelineType) => {
   const envType = (0, getEnvType_1.getEnvType)(env, envConfig);
@@ -5568,13 +6745,15 @@ exports.GCLOUD_RUN_DEPLOY_TYPE = {
     }
     return {};
   },
-  additionalSecretKeys: ctx => [{
+  additionalSecretKeys: ctx => [
+  // deploy-time credentials don't exist for the local env
+  ...(ctx.envType !== "local" ? [{
     key: exports.GCLOUD_DEPLOY_CREDENTIALS_KEY,
     hidden: true
   }, {
     key: exports.GCLOUD_RUN_CANONICAL_HOST_SUFFIX,
     hidden: true
-  }, ...(ctx.deployConfigRaw && ctx.deployConfigRaw.cloudSql ? [{
+  }] : []), ...(ctx.deployConfigRaw && ctx.deployConfigRaw.cloudSql ? [{
     key: "DB_PASSWORD"
   }] : [])],
   getAdditionalEnvVars: ctx => {
@@ -5582,7 +6761,8 @@ exports.GCLOUD_RUN_DEPLOY_TYPE = {
       fullName,
       env,
       componentName,
-      deployConfigRaw
+      deployConfigRaw,
+      envType
     } = ctx;
     const HOSTNAME_INTERNAL = (0, BashExpression_1.joinBashExpressions)([fullName, (0, BashExpression_1.getBashVariable)((0, context_1.getSecretVarName)(env, componentName, exports.GCLOUD_RUN_CANONICAL_HOST_SUFFIX))], "-").toLowerCase();
     const jobTriggers = deployConfigRaw && deployConfigRaw.jobs ? Object.fromEntries(Object.entries(deployConfigRaw.jobs).filter(([name, job]) => Boolean(job)).map(([name, job]) => ["CLOUD_RUN_JOB_TRIGGER_URL_" + (0, gitlab_1.sanitizeForBashVariable)(name), (0, cloudRunExecutionUrl_1.getCloudRunJobExecuteUrl)(name, {
@@ -5591,7 +6771,11 @@ exports.GCLOUD_RUN_DEPLOY_TYPE = {
       region: deployConfigRaw.region
     })])) : {};
     return {
-      HOSTNAME_INTERNAL,
+      // references the canonical host suffix secret, which doesn't
+      // exist for the local env
+      ...(envType !== "local" ? {
+        HOSTNAME_INTERNAL
+      } : {}),
       ...getCloudSqlVariables(ctx),
       ...jobTriggers,
       DEPLOY_CLOUD_RUN_SERVICE_NAME: (0, getServiceName_1.getServiceNameForEnvContext)(ctx),
@@ -7422,11 +8606,8 @@ async function generatePipelineFiles(context, pipelineType) {
 exports.generatePipelineFiles = generatePipelineFiles;
 async function generatePipelineFilesForBackend(context, backend) {
   const files = await backend.createFiles(context.config);
-  // first clean up the folder
-  await (0, promises_1.rm)(backend.generatedFolder, {
-    force: true,
-    recursive: true
-  });
+  // first clean up previously generated files
+  await backend.cleanup();
   // write files
   await Promise.all(files.map(async ({
     path,