@intentius/chant-lexicon-gitlab 0.79.0 → 0.80.0

package/dist/components/generate-pipeline.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generate-pipeline.d.ts","sourceRoot":"","sources":["../../src/components/generate-pipeline.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAGH,OAAO,EAAyB,KAAK,eAAe,EAAE,MAAM,oCAAoC,CAAC;AACjG,OAAO,KAAK,EACV,oBAAoB,IAAI,YAAY,EACpC,wBAAwB,IAAI,qBAAqB,EACjD,uBAAuB,IAAI,oBAAoB,EAChD,MAAM,0BAA0B,CAAC;AAElC,YAAY,EAAE,YAAY,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,CAAC;AAS1E;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,eAAe,EAAE,EAC7B,OAAO,GAAE,qBAA0B,GAClC,oBAAoB,CAqFtB"}
+{"version":3,"file":"generate-pipeline.d.ts","sourceRoot":"","sources":["../../src/components/generate-pipeline.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAGH,OAAO,EAAyB,KAAK,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAEjG,OAAO,KAAK,EACV,oBAAoB,IAAI,YAAY,EACpC,wBAAwB,IAAI,qBAAqB,EACjD,uBAAuB,IAAI,oBAAoB,EAChD,MAAM,0BAA0B,CAAC;AAElC,YAAY,EAAE,YAAY,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,CAAC;AAS1E;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,eAAe,EAAE,EAC7B,OAAO,GAAE,qBAA0B,GAClC,oBAAoB,CAyHtB"}

package/dist/integrity.json

@@ -1,7 +1,7 @@
 {
   "algorithm": "sha256",
   "artifacts": {
-    "manifest.json": "77df7f883d9d0a9adf5d80b4e936dd5a076473afaffba5b70d0606f3ac927343",
+    "manifest.json": "073de2644bb1121ba60a3afcbffb9c821b972968c75e1b966446fe5a1833bd29",
     "meta.json": "931fc3246a55645b1493080bbeb160e5d205e42349e8bdca96ca243adb5f0da3",
     "types/index.d.ts": "5cd2e99f135a929b72bdd822d00d780d39b1cd407ba0cfb3d511c7ac9d667b58",
     "rules/artifact-no-expiry.ts": "3f3cabf9792cbf8207e53a25f506715466b19ec25e9c3b4d0d77fed6b2eb4542",
@@ -55,5 +55,5 @@
     "skills/chant-gitlab-migrate.md": "4853d04980560b379e5b0f7267dcb0a1e5d5879cb9e9931681ce76b2a5fe69d8",
     "skills/chant-gitlab-patterns.md": "6d9a44e9e8de4c3820be9d65381b0d2ede4cb3626aaaf0011e21838a9fbf556e"
   },
-  "composite": "fe857e0abc3900a63ccea9a656ec8bd996cd4330bb4efc8c8fdc2ae2cfc1072e"
+  "composite": "163341752b7f5181bd0682992b19dd2242df3f5b977dd5c6c64303b4ebc11f7e"
 }

package/dist/manifest.json

@@ -1,6 +1,6 @@
 {
   "name": "gitlab",
-  "version": "0.79.0",
+  "version": "0.80.0",
   "chantVersion": ">=0.1.0",
   "namespace": "GitLab",
   "intrinsics": [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@intentius/chant-lexicon-gitlab",
-  "version": "0.79.0",
+  "version": "0.80.0",
   "description": "GitLab CI lexicon for chant — declarative IaC in TypeScript",
   "license": "Apache-2.0",
   "homepage": "https://intentius.io/chant",
@@ -67,8 +67,8 @@
     "typescript": "^5.9.3"
   },
   "peerDependencies": {
-    "@intentius/chant": "^0.79.0",
-    "@intentius/chant-lexicon-github": "^0.79.0",
+    "@intentius/chant": "^0.80.0",
+    "@intentius/chant-lexicon-github": "^0.80.0",
     "typescript": "^5.9.3"
   },
   "peerDependenciesMeta": {

package/src/components/generate-pipeline.test.ts

@@ -257,3 +257,40 @@ describe("generateGitlabPipeline: options", () => {
     expect((job.script as string[])[0]).toContain("--env production");
   });
 });
+
+describe("generateGitlabPipeline: a promote job (#2575)", () => {
+  const components = (): DriverComponent[] => [
+    { name: "shared-alb", dependsOn: [], deploy: [] },
+    {
+      name: "api",
+      dependsOn: ["shared-alb"],
+      deploy: [
+        { phase: "Build", steps: [{ kind: "docker-build", context: ".", into: "dist/api.tar" }] },
+        { phase: "Publish", steps: [{ kind: "publish-image", from: "archive:dist/api.tar" }] },
+      ],
+    },
+  ];
+
+  test("without promoteTo the pipeline is unchanged", () => {
+    const yaml = generateGitlabPipeline(components(), { env: "staging" }).yaml;
+    expect(yaml).not.toContain("promote");
+    expect(yaml).not.toContain("dist/api.tar");
+  });
+
+  test("building jobs keep their archive as artifacts, and a promote stage job needs every component job", () => {
+    const result = generateGitlabPipeline(components(), { env: "staging", promoteTo: "prod" });
+    const parsed = parseYAML(result.yaml);
+
+    expect((parsed["api"] as Record<string, unknown>).artifacts).toEqual({ paths: ["dist/api.tar"] });
+    expect((parsed["shared-alb"] as Record<string, unknown>).artifacts).toEqual({ paths: ["shared-alb.outputs.json"] });
+
+    expect(parsed.stages).toEqual(["wave-1", "wave-2", "promote"]);
+    expect(result.stages).toEqual(["wave-1", "wave-2"]);
+    expect(parsed["promote-prod"]).toEqual({
+      stage: "promote",
+      image: "node:22-slim",
+      script: ["chant components promote --from staging --to prod"],
+      needs: ["api", "shared-alb"],
+    });
+  });
+});

package/src/components/generate-pipeline.ts

@@ -34,6 +34,7 @@
 
 import { emitYAML } from "@intentius/chant/yaml";
 import { resolveComponentGraph, type DriverComponent } from "@intentius/chant/components/driver";
+import { promoteArchivePaths } from "@intentius/chant/components/promote";
 import type {
   ComponentPipelineJob as GeneratedJob,
   ComponentPipelineOptions as GenerateGitlabOptions,
@@ -82,6 +83,19 @@ export function generateGitlabPipeline(
   for (const c of components) for (const dep of c.dependsOn ?? []) dependedUpon.add(dep);
   const outputsFile = (name: string) => `${name}.outputs.json`;
 
+  // A promote job (#2575) runs apart from the deploy jobs, and a promote
+  // publishes from the build archive on disk, so each component job keeps the
+  // files its build steps wrote as artifacts. GitLab hands them to the promote
+  // job across its `needs:` edges.
+  const promoteTo = options.promoteTo;
+  const archives = new Map<string, string[]>();
+  if (promoteTo !== undefined) {
+    for (const c of components) {
+      const paths = promoteArchivePaths(c);
+      if (paths.length > 0) archives.set(c.name, paths);
+    }
+  }
+
   const stages = waves.map((_, i) => `wave-${i + 1}`);
   const jobs: GeneratedJob[] = [];
   const jobNameByComponent = new Map<string, string>();
@@ -125,11 +139,30 @@ export function generateGitlabPipeline(
       };
       if (needs.length > 0) jobProps.needs = needs;
       // Publish this component's dumped outputs so dependent jobs receive it.
-      if (dependedUpon.has(name)) jobProps.artifacts = { paths: [outputsFile(name)] };
+      const artifactPaths = [
+        ...(dependedUpon.has(name) ? [outputsFile(name)] : []),
+        ...(archives.get(name) ?? []),
+      ];
+      if (artifactPaths.length > 0) jobProps.artifacts = { paths: artifactPaths };
       doc[jobName] = jobProps;
     }
   });
 
+  let promoteJob: string | undefined;
+  if (promoteTo !== undefined) {
+    promoteJob = `promote-${toJobName(promoteTo)}`;
+    if (promoteJob in doc) {
+      throw new Error(`the promote job "${promoteJob}" has the same name as a component job; rename the component`);
+    }
+    const command = options.promoteCommand ?? ["chant", "components", "promote", "--from", env, "--to", promoteTo];
+    doc[promoteJob] = {
+      stage: "promote",
+      image,
+      script: [...beforeScript, command.join(" "), ...extraScript],
+      needs: [...jobNameByComponent.values()].sort(),
+    };
+  }
+
   const sections: string[] = [];
   // `emitYAML` returns a `\n`-led block for a non-empty sequence and an inline
   // `[]` for an empty one, so the header needs a space in the second case.
@@ -137,12 +170,16 @@ export function generateGitlabPipeline(
   // when whitespace or the line's end follows it — which is how GitLab's own
   // reader takes it, and now how `parseYAML` does too (chant #2013).
   sections.push("workflow:" + emitYAML(doc.workflow, 1));
-  sections.push(stages.length > 0 ? "stages:" + emitYAML(stages, 1) : "stages: []");
+  // The promote stage is YAML only: `stages` in the result stays one entry
+  // per graph wave.
+  const yamlStages = promoteJob ? [...stages, "promote"] : stages;
+  sections.push(yamlStages.length > 0 ? "stages:" + emitYAML(yamlStages, 1) : "stages: []");
   if (doc.variables) sections.push("variables:" + emitYAML(doc.variables, 1));
   for (const job of jobs) {
     const props = doc[job.jobName] as Record<string, unknown>;
     sections.push(`${job.jobName}:` + emitYAML(props, 1));
   }
+  if (promoteJob) sections.push(`${promoteJob}:` + emitYAML(doc[promoteJob], 1));
 
   return { yaml: sections.join("\n\n") + "\n", stages, jobs, env };
 }