@intentius/chant-lexicon-gitlab 0.0.18 → 0.0.24

package/dist/integrity.json

@@ -1,7 +1,7 @@
 {
   "algorithm": "xxhash64",
   "artifacts": {
-    "manifest.json": "2c937933d498dcb5",
+    "manifest.json": "5879275be7cad0fa",
     "meta.json": "c663c6c63748a9d0",
     "types/index.d.ts": "64e65524615be023",
     "rules/missing-stage.ts": "6d5379e74209a735",
@@ -28,8 +28,8 @@
     "rules/wgl027.ts": "ea7928f37607a583",
     "rules/wgl014.ts": "6248a852888e8028",
     "rules/yaml-helpers.ts": "3e414c7affe56728",
-    "skills/chant-gitlab.md": "d791ef1f7f83e9c1",
-    "skills/gitlab-ci-patterns.md": "bdb522359253aac8"
+    "skills/chant-gitlab.md": "fe29add147305b7e",
+    "skills/chant-gitlab-patterns.md": "efb54bd8ea52071b"
   },
-  "composite": "77e2588f9bf9bc48"
+  "composite": "58a5f51312595838"
 }

package/dist/manifest.json

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

package/dist/skills/{gitlab-ci-patterns.md → chant-gitlab-patterns.md}

@@ -1,5 +1,5 @@
 ---
-skill: gitlab-ci-patterns
+skill: chant-gitlab-patterns
 description: GitLab CI/CD pipeline stages, caching, artifacts, includes, and advanced patterns
 user-invocable: true
 ---

package/dist/skills/chant-gitlab.md

@@ -8,7 +8,7 @@ user-invocable: true
 
 ## How chant and GitLab CI relate
 
-chant is a **synthesis-only** tool — it compiles TypeScript source files into `.gitlab-ci.yml` (YAML). chant does NOT call GitLab APIs. Your job as an agent is to bridge the two:
+chant is a **synthesis compiler** — it compiles TypeScript source files into `.gitlab-ci.yml` (YAML). `chant build` does not call GitLab APIs; synthesis is pure and deterministic. Your job as an agent is to bridge synthesis and deployment:
 
 - Use **chant** for: build, lint, diff (local YAML comparison)
 - Use **git + GitLab API** for: push, merge requests, pipeline monitoring, job logs, rollback, and all deployment operations
@@ -244,7 +244,7 @@ new Job({
 
 ### Environment promotion
 
-Deploy through environments in order: dev → staging → production. Use `rules:` and `when: manual` to gate promotions.
+Deploy through environments in order: dev -> staging -> production. Use `rules:` and `when: manual` to gate promotions.
 
 ### Rollback to a previous deployment
 
@@ -356,11 +356,11 @@ rules:
 
 ### Merged results pipelines
 
-Enable in project settings → CI/CD → General pipelines → "Merged results pipelines". These test the result of merging your branch into the target — catching integration issues before merge.
+Enable in project settings -> CI/CD -> General pipelines -> "Merged results pipelines". These test the result of merging your branch into the target — catching integration issues before merge.
 
 ### Merge trains
 
-Merge trains queue MRs and test each one merged on top of the previous. Enable in project settings → Merge requests → "Merge trains". Requires merged results pipelines.
+Merge trains queue MRs and test each one merged on top of the previous. Enable in project settings -> Merge requests -> "Merge trains". Requires merged results pipelines.
 
 ## Troubleshooting decision tree
 
@@ -373,11 +373,11 @@ curl --header "PRIVATE-TOKEN: $GITLAB_TOKEN" \
 
 ### Step 2: Branch on status
 
-- **`running` / `pending` / `created`** → Wait. Do not take action while the pipeline is in progress.
-- **`failed`** → Read the failed job logs (Step 3).
-- **`success`** → Pipeline is healthy. If behavior is wrong, check job scripts and configuration.
-- **`canceled`** → Re-run if needed: `curl --request POST ... /pipelines/$PIPELINE_ID/retry`
-- **`skipped`** → All jobs were filtered out by `rules:`. Check rule conditions.
+- **`running` / `pending` / `created`** -> Wait. Do not take action while the pipeline is in progress.
+- **`failed`** -> Read the failed job logs (Step 3).
+- **`success`** -> Pipeline is healthy. If behavior is wrong, check job scripts and configuration.
+- **`canceled`** -> Re-run if needed: `curl --request POST ... /pipelines/$PIPELINE_ID/retry`
+- **`skipped`** -> All jobs were filtered out by `rules:`. Check rule conditions.
 
 ### Step 3: Read failed job logs
 
@@ -413,7 +413,7 @@ curl --header "PRIVATE-TOKEN: $GITLAB_TOKEN" \
 
 Variables are resolved in this order (highest priority first):
 1. Job-level `variables:`
-2. Project CI/CD variables (Settings → CI/CD → Variables)
+2. Project CI/CD variables (Settings -> CI/CD -> Variables)
 3. Group CI/CD variables
 4. Instance CI/CD variables
 

package/package.json

@@ -1,7 +1,25 @@
 {
   "name": "@intentius/chant-lexicon-gitlab",
-  "version": "0.0.18",
+  "version": "0.0.24",
+  "description": "GitLab CI lexicon for chant — declarative IaC in TypeScript",
   "license": "Apache-2.0",
+  "homepage": "https://intentius.io/chant",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/intentius/chant.git",
+    "directory": "lexicons/gitlab"
+  },
+  "bugs": {
+    "url": "https://github.com/intentius/chant/issues"
+  },
+  "keywords": [
+    "infrastructure-as-code",
+    "iac",
+    "typescript",
+    "gitlab",
+    "gitlab-ci",
+    "chant"
+  ],
   "type": "module",
   "files": [
     "src/",
@@ -25,7 +43,7 @@
     "prepack": "bun run generate && bun run bundle && bun run validate"
   },
   "dependencies": {
-    "@intentius/chant": "0.0.18"
+    "@intentius/chant": "0.0.22"
   },
   "devDependencies": {
     "typescript": "^5.9.3"

package/src/composites/composites.test.ts

@@ -138,6 +138,16 @@ describe("DockerBuild", () => {
     const props = (instance.build as any).props;
     expect(props.rules).toBeUndefined();
   });
+
+  test("per-member defaults override build job", () => {
+    const instance = DockerBuild({
+      defaults: {
+        build: { tags: ["docker-runner"] },
+      },
+    });
+    const props = (instance.build as any).props;
+    expect(props.tags).toEqual(["docker-runner"]);
+  });
 });
 
 // ---------------------------------------------------------------------------
@@ -287,6 +297,36 @@ describe("NodePipeline", () => {
     const artProps = (props.artifacts as any).props;
     expect(artProps.when).toBe("always");
   });
+
+  test("per-member defaults override build job", () => {
+    const instance = NodePipeline({
+      defaults: {
+        build: { tags: ["node-runner"] },
+      },
+    });
+    const props = (instance.build as any).props;
+    expect(props.tags).toEqual(["node-runner"]);
+  });
+
+  test("per-member defaults override test job", () => {
+    const instance = NodePipeline({
+      defaults: {
+        test: { allow_failure: true },
+      },
+    });
+    const props = (instance.test as any).props;
+    expect(props.allow_failure).toBe(true);
+  });
+
+  test("per-member defaults override defaults member", () => {
+    const instance = NodePipeline({
+      defaults: {
+        defaults: { interruptible: true },
+      },
+    });
+    const props = (instance.defaults as any).props;
+    expect(props.interruptible).toBe(true);
+  });
 });
 
 // ---------------------------------------------------------------------------
@@ -451,6 +491,37 @@ describe("PythonPipeline", () => {
     const cacheProps = (defaultProps.cache[0] as any).props;
     expect(cacheProps.policy).toBe("pull-push");
   });
+
+  test("per-member defaults override test job", () => {
+    const instance = PythonPipeline({
+      defaults: {
+        test: { tags: ["python-runner"] },
+      },
+    });
+    const props = (instance.test as any).props;
+    expect(props.tags).toEqual(["python-runner"]);
+  });
+
+  test("per-member defaults override lint job", () => {
+    const instance = PythonPipeline({
+      defaults: {
+        lint: { allow_failure: true },
+      },
+    });
+    const members = instance.members as any;
+    const props = (members.lint as any).props;
+    expect(props.allow_failure).toBe(true);
+  });
+
+  test("per-member defaults override defaults member", () => {
+    const instance = PythonPipeline({
+      defaults: {
+        defaults: { interruptible: true },
+      },
+    });
+    const props = (instance.defaults as any).props;
+    expect(props.interruptible).toBe(true);
+  });
 });
 
 // ---------------------------------------------------------------------------
@@ -609,4 +680,26 @@ describe("ReviewApp", () => {
     const envProps = (props.environment as any).props;
     expect(envProps.url).toContain("$CI_ENVIRONMENT_SLUG");
   });
+
+  test("per-member defaults override deploy job", () => {
+    const instance = ReviewApp({
+      ...baseProps,
+      defaults: {
+        deploy: { tags: ["deploy-runner"] },
+      },
+    });
+    const props = (instance.deploy as any).props;
+    expect(props.tags).toEqual(["deploy-runner"]);
+  });
+
+  test("per-member defaults override stop job", () => {
+    const instance = ReviewApp({
+      ...baseProps,
+      defaults: {
+        stop: { allow_failure: true },
+      },
+    });
+    const props = (instance.stop as any).props;
+    expect(props.allow_failure).toBe(true);
+  });
 });

package/src/composites/docker-build.ts

@@ -1,4 +1,4 @@
-import { Composite } from "@intentius/chant";
+import { Composite, mergeDefaults } from "@intentius/chant";
 import { Job, Image, Service, Rule } from "../generated";
 import { CI } from "../variables";
 
@@ -23,6 +23,10 @@ export interface DockerBuildProps {
   rules?: InstanceType<typeof Rule>[];
   /** Docker version. Default: "27" */
   dockerVersion?: string;
+  /** Per-member defaults for customizing the build job. */
+  defaults?: {
+    build?: Partial<ConstructorParameters<typeof Job>[0]>;
+  };
 }
 
 export const DockerBuild = Composite<DockerBuildProps>((props) => {
@@ -37,6 +41,7 @@ export const DockerBuild = Composite<DockerBuildProps>((props) => {
     buildArgs,
     rules,
     dockerVersion = "27",
+    defaults: defs,
   } = props;
 
   const buildArgFlags = buildArgs
@@ -63,7 +68,7 @@ export const DockerBuild = Composite<DockerBuildProps>((props) => {
     );
   }
 
-  const build = new Job({
+  const build = new Job(mergeDefaults({
     stage,
     image: new Image({ name: `docker:${dockerVersion}-cli` }),
     services: [new Service({ name: `docker:${dockerVersion}-dind`, alias: "docker" })],
@@ -75,7 +80,7 @@ export const DockerBuild = Composite<DockerBuildProps>((props) => {
     ],
     script,
     ...(rules ? { rules } : {}),
-  });
+  }, defs?.build));
 
   return { build };
 }, "DockerBuild");

package/src/composites/node-pipeline.ts

@@ -1,4 +1,4 @@
-import { Composite, withDefaults } from "@intentius/chant";
+import { Composite, mergeDefaults, withDefaults } from "@intentius/chant";
 import { Job, Default, Image, Cache, Artifacts } from "../generated";
 import { CI } from "../variables";
 
@@ -17,6 +17,12 @@ export interface NodePipelineProps {
   artifactExpiry?: string;
   /** Override auto-detected install command */
   installCommand?: string;
+  /** Per-member defaults for customizing the generated resources. */
+  defaults?: {
+    defaults?: Partial<ConstructorParameters<typeof Default>[0]>;
+    build?: Partial<ConstructorParameters<typeof Job>[0]>;
+    test?: Partial<ConstructorParameters<typeof Job>[0]>;
+  };
 }
 
 const cacheConfig = {
@@ -52,6 +58,7 @@ export const NodePipeline = Composite<NodePipelineProps>((props) => {
     buildArtifactPaths = ["dist/"],
     artifactExpiry = "1 hour",
     installCommand,
+    defaults: defs,
   } = props;
 
   const pm = cacheConfig[packageManager];
@@ -68,13 +75,13 @@ export const NodePipeline = Composite<NodePipelineProps>((props) => {
 
   const variables = Object.keys(pm.envVars).length > 0 ? pm.envVars : undefined;
 
-  const defaults = new Default({
+  const defaults = new Default(mergeDefaults({
     image: nodeImage,
     cache: [cache],
     ...(variables ? {} : {}),
-  });
+  }, defs?.defaults));
 
-  const build = new Job({
+  const build = new Job(mergeDefaults({
     stage: "build",
     script: [install, `${run} ${buildScript}`],
     artifacts: new Artifacts({
@@ -82,9 +89,9 @@ export const NodePipeline = Composite<NodePipelineProps>((props) => {
       expire_in: artifactExpiry,
     }),
     ...(variables ? { variables } : {}),
-  });
+  }, defs?.build));
 
-  const test = new Job({
+  const test = new Job(mergeDefaults({
     stage: "test",
     script: [install, `${run} ${testScript}`],
     artifacts: new Artifacts({
@@ -92,7 +99,7 @@ export const NodePipeline = Composite<NodePipelineProps>((props) => {
       when: "always",
     }),
     ...(variables ? { variables } : {}),
-  });
+  }, defs?.test));
 
   return { defaults, build, test };
 }, "NodePipeline");

package/src/composites/python-pipeline.ts

@@ -1,4 +1,4 @@
-import { Composite } from "@intentius/chant";
+import { Composite, mergeDefaults } from "@intentius/chant";
 import { Job, Default, Image, Cache, Artifacts } from "../generated";
 import { CI } from "../variables";
 
@@ -13,6 +13,12 @@ export interface PythonPipelineProps {
   requirementsFile?: string;
   /** Use poetry instead of pip. Default: false */
   usePoetry?: boolean;
+  /** Per-member defaults for customizing the generated resources. */
+  defaults?: {
+    defaults?: Partial<ConstructorParameters<typeof Default>[0]>;
+    test?: Partial<ConstructorParameters<typeof Job>[0]>;
+    lint?: Partial<ConstructorParameters<typeof Job>[0]>;
+  };
 }
 
 export const PythonPipeline = Composite<PythonPipelineProps>((props) => {
@@ -22,6 +28,7 @@ export const PythonPipeline = Composite<PythonPipelineProps>((props) => {
     lintCommand = "ruff check .",
     requirementsFile = "requirements.txt",
     usePoetry = false,
+    defaults: defs,
   } = props;
 
   const pythonImage = new Image({ name: `python:${pythonVersion}-slim` });
@@ -42,13 +49,13 @@ export const PythonPipeline = Composite<PythonPipelineProps>((props) => {
 
   const activateStep = usePoetry ? "source .venv/bin/activate" : "source .venv/bin/activate";
 
-  const defaults = new Default({
+  const defaults = new Default(mergeDefaults({
     image: pythonImage,
     cache: [cache],
     before_script: [...installSteps],
-  });
+  }, defs?.defaults));
 
-  const test = new Job({
+  const test = new Job(mergeDefaults({
     stage: "test",
     variables: { PIP_CACHE_DIR: `${CI.ProjectDir}/.pip-cache` },
     script: [activateStep, testCommand],
@@ -56,15 +63,15 @@ export const PythonPipeline = Composite<PythonPipelineProps>((props) => {
       reports: { junit: "report.xml" },
       when: "always",
     }),
-  });
+  }, defs?.test));
 
   const lint =
     lintCommand !== null
-      ? new Job({
+      ? new Job(mergeDefaults({
           stage: "test",
           variables: { PIP_CACHE_DIR: `${CI.ProjectDir}/.pip-cache` },
           script: [activateStep, lintCommand],
-        })
+        }, defs?.lint))
       : undefined;
 
   if (lint) {

package/src/composites/review-app.ts

@@ -1,4 +1,4 @@
-import { Composite } from "@intentius/chant";
+import { Composite, mergeDefaults } from "@intentius/chant";
 import { Job, Image, Environment, Rule } from "../generated";
 import { CI } from "../variables";
 
@@ -17,6 +17,11 @@ export interface ReviewAppProps {
   image?: InstanceType<typeof Image>;
   /** Job stage. Default: "deploy" */
   stage?: string;
+  /** Per-member defaults for customizing the deploy and stop jobs. */
+  defaults?: {
+    deploy?: Partial<ConstructorParameters<typeof Job>[0]>;
+    stop?: Partial<ConstructorParameters<typeof Job>[0]>;
+  };
 }
 
 export const ReviewApp = Composite<ReviewAppProps>((props) => {
@@ -28,6 +33,7 @@ export const ReviewApp = Composite<ReviewAppProps>((props) => {
     autoStopIn = "1 week",
     image,
     stage = "deploy",
+    defaults: defs,
   } = props;
 
   const stopJobName = `${name}-stop`;
@@ -35,7 +41,7 @@ export const ReviewApp = Composite<ReviewAppProps>((props) => {
   const deployScriptArr = Array.isArray(deployScript) ? deployScript : [deployScript];
   const stopScriptArr = Array.isArray(stopScript) ? stopScript : [stopScript];
 
-  const deploy = new Job({
+  const deploy = new Job(mergeDefaults({
     stage,
     ...(image ? { image } : {}),
     environment: new Environment({
@@ -46,9 +52,9 @@ export const ReviewApp = Composite<ReviewAppProps>((props) => {
     }),
     rules: [new Rule({ if: CI.MergeRequestIid })],
     script: deployScriptArr,
-  });
+  }, defs?.deploy));
 
-  const stop = new Job({
+  const stop = new Job(mergeDefaults({
     stage,
     ...(image ? { image } : {}),
     environment: new Environment({
@@ -57,7 +63,7 @@ export const ReviewApp = Composite<ReviewAppProps>((props) => {
     }),
     rules: [new Rule({ if: CI.MergeRequestIid, when: "manual" })],
     script: stopScriptArr,
-  });
+  }, defs?.stop));
 
   return { deploy, stop };
 }, "ReviewApp");