@intentius/chant-lexicon-gitlab 0.117.0 → 0.118.0

package/dist/components/generate-op-waves-pipeline.d.ts

@@ -15,6 +15,9 @@
  * with the spec's cron. It retries a waiting wave's job once its approval
  * arrived, with `CHANT_FORGE_TOKEN` (a project access token with the `api`
  * scope and the Developer role; the job token cannot retry jobs).
+ *
+ * A `pr-review` wave (#3684) adds `<name>-record-plans`, run in merge request
+ * pipelines only, which records the digests the merge request's head plans.
  */
 import { type OpWavesSpec } from "@intentius/chant/op/op-waves";
 import type { OpWavesPipelineOptions, OpWavesPipelineResult } from "@intentius/chant/lexicon";

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

@@ -1 +1 @@
-{"version":3,"file":"generate-op-waves-pipeline.d.ts","sourceRoot":"","sources":["../../src/components/generate-op-waves-pipeline.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAGH,OAAO,EAAoC,KAAK,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAClG,OAAO,KAAK,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAK9F,gHAAgH;AAChH,wBAAgB,6BAA6B,CAAC,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,sBAAsB,GAAG,qBAAqB,CA8DvH"}
+{"version":3,"file":"generate-op-waves-pipeline.d.ts","sourceRoot":"","sources":["../../src/components/generate-op-waves-pipeline.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAGH,OAAO,EAAoC,KAAK,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAClG,OAAO,KAAK,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAK9F,gHAAgH;AAChH,wBAAgB,6BAA6B,CAAC,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,sBAAsB,GAAG,qBAAqB,CA4EvH"}

package/dist/integrity.json

@@ -1,7 +1,7 @@
 {
   "algorithm": "sha256",
   "artifacts": {
-    "manifest.json": "fc6a6222b403c05e20fa7b85e244284685b464cffd4593a916b6c7f46eb44ae0",
+    "manifest.json": "598869766c3821ca4fdf25bbd91ade4e8957542e0694373764d3f8d7120a0cdb",
     "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": "dfa9a73db3849ec92d83c08a543b49cfb699a43a7e9760dd119850a1cff48bd1"
+  "composite": "9f524e8c727cefaf1e1cf3d24a63928defc3a947f3a7dbc44a396c7d90d0f36f"
 }

package/dist/manifest.json

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@intentius/chant-lexicon-gitlab",
-  "version": "0.117.0",
+  "version": "0.118.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.117.0",
-    "@intentius/chant-lexicon-github": "^0.117.0",
+    "@intentius/chant": "^0.118.0",
+    "@intentius/chant-lexicon-github": "^0.118.0",
     "typescript": "^5.9.3"
   },
   "peerDependenciesMeta": {

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

@@ -36,4 +36,12 @@ describe("generateGitlabOpWavesPipeline", () => {
     expect(yaml).toContain('give the schedule the cron "*/10 * * * *"');
     expect(generateGitlabOpWavesPipeline(spec, { specFile: "waves.json" }).files[0]!.yaml).not.toContain("resume");
   });
+
+  test("a pr-review wave adds a merge request job that records the head's plans (#3684)", () => {
+    const yaml = generateGitlabOpWavesPipeline({ ...spec, waves: spec.waves.map((w, i) => (i === spec.waves.length - 1 ? { ...w, approval: "pr-review" as const } : w)) }, { specFile: "waves.json" }).files[0]!.yaml;
+    expect(yaml).toContain(`${spec.name}-record-plans:`);
+    expect(yaml).toContain('$CI_PIPELINE_SOURCE == "merge_request_event"');
+    expect(yaml).toContain("chant run wave --spec waves.json --record-plans");
+    expect(yaml).toMatch(/stages:\n\s+- plans\n/);
+  });
 });

package/src/components/generate-op-waves-pipeline.ts

@@ -15,6 +15,9 @@
  * with the spec's cron. It retries a waiting wave's job once its approval
  * arrived, with `CHANT_FORGE_TOKEN` (a project access token with the `api`
  * scope and the Developer role; the job token cannot retry jobs).
+ *
+ * A `pr-review` wave (#3684) adds `<name>-record-plans`, run in merge request
+ * pipelines only, which records the digests the merge request's head plans.
  */
 
 import { emitYAMLEntry } from "@intentius/chant/yaml";
@@ -36,7 +39,8 @@ export function generateGitlabOpWavesPipeline(spec: OpWavesSpec, options: OpWave
   }
   const rules = branches.map((branch) => ({ if: `$CI_PIPELINE_SOURCE == "push" && $CI_COMMIT_BRANCH == "${branch}"` }));
 
-  const stages = spec.waves.map((wave, i) => `wave-${i + 1}-${wave.name}`);
+  const byReview = spec.waves.some((w) => w.approval === "pr-review");
+  const stages = [...(byReview ? ["plans"] : []), ...spec.waves.map((wave, i) => `wave-${i + 1}-${wave.name}`)];
   if (spec.resume) stages.push("resume");
   const sections: string[] = [emitYAMLEntry("stages", stages)];
   if (options.variables && Object.keys(options.variables).length > 0) sections.push(emitYAMLEntry("variables", options.variables));
@@ -53,7 +57,7 @@ export function generateGitlabOpWavesPipeline(spec: OpWavesSpec, options: OpWave
     });
     sections.push(
       emitYAMLEntry(job.jobName, {
-        stage: stages[job.wave - 1],
+        stage: stages[job.wave - 1 + (byReview ? 1 : 0)],
         image,
         resource_group: `${spec.name}-${wave.name}`,
         ...(wave.environment
@@ -77,6 +81,19 @@ export function generateGitlabOpWavesPipeline(spec: OpWavesSpec, options: OpWave
       }),
     );
   }
+  if (byReview) {
+    sections.splice(
+      options.variables && Object.keys(options.variables).length > 0 ? 2 : 1,
+      0,
+      emitYAMLEntry(`${spec.name}-record-plans`, {
+        stage: "plans",
+        image,
+        variables: { GIT_DEPTH: "0" },
+        rules: [{ if: '$CI_PIPELINE_SOURCE == "merge_request_event"' }],
+        script: [...(options.beforeScript ?? []), ["chant", "run", "wave", "--spec", options.specFile, "--record-plans"].join(" ")],
+      }),
+    );
+  }
   const header = [
     `# chant Op waves "${spec.name}" (#3679): one stage per wave, each needing the one before.`,
     "# A wave that waits at its gate exits 3 and stops the waves after it; approve the",