@intentius/chant-lexicon-gitlab 0.1.0 → 0.1.8

package/README.md

@@ -17,6 +17,16 @@ npm install --save-dev @intentius/chant @intentius/chant-lexicon-gitlab
 | [@intentius/chant](https://www.npmjs.com/package/@intentius/chant) | Core type system, CLI, build pipeline |
 | [@intentius/chant-lexicon-aws](https://www.npmjs.com/package/@intentius/chant-lexicon-aws) | AWS CloudFormation lexicon |
 
+## Runtime observation: N/A
+
+`chant state snapshot` and `chant state diff --live` operate by querying a runtime equivalent of each declared resource. The GitLab lexicon doesn't fit that model:
+
+- The lexicon's chant entities (`Job`, `Workflow`, `Default`, `Image`, `Rule`, etc.) describe **CI pipeline definitions**, which are git-tracked. Drift in the definition itself is just `git diff` — no observation surface needed.
+- Pipeline **runs** are events (per-execution), not declared state. They're observable via the GitLab API but the abstraction is `listRecentRuns()`, not `describeResources()` or `listArtifacts()`. That's a separate plugin contract if/when it's needed.
+- "Is this workflow enabled in the GitLab UI?" is theoretically observable but a marginal use case.
+
+If a concrete observation use case surfaces, file a focused issue rather than retrofitting `listArtifacts()` to fit.
+
 ## License
 
 See the main project LICENSE file.

package/dist/integrity.json

@@ -1,35 +1,35 @@
 {
-  "algorithm": "xxhash64",
+  "algorithm": "sha256",
   "artifacts": {
-    "manifest.json": "5e3bc0d403d8f621",
-    "meta.json": "c663c6c63748a9d0",
-    "types/index.d.ts": "64e65524615be023",
-    "rules/missing-stage.ts": "6d5379e74209a735",
-    "rules/missing-script.ts": "923dde9acb46cc28",
-    "rules/deprecated-only-except.ts": "1f5a8c785777fb03",
-    "rules/artifact-no-expiry.ts": "26874cb6adfbca26",
-    "rules/wgl018.ts": "6ba77c7fa7a59f25",
-    "rules/wgl012.ts": "3d188d13fb2236c0",
-    "rules/wgl024.ts": "54fe7a6aec3d3e23",
-    "rules/wgl020.ts": "eff135a38c29ff2f",
-    "rules/wgl017.ts": "a9d460f549725f85",
-    "rules/wgl023.ts": "d02ea51ac7da06c4",
-    "rules/wgl011.ts": "b6b97e5104d91267",
-    "rules/wgl021.ts": "42470ba28e215bae",
-    "rules/wgl015.ts": "d7e9e080994f985",
-    "rules/wgl025.ts": "fcdf14c9d296e7b5",
-    "rules/wgl026.ts": "7c7a15478b702349",
-    "rules/wgl010.ts": "1548cad287cdf286",
-    "rules/wgl013.ts": "3519c933e23fc605",
-    "rules/wgl028.ts": "77c31c05a975bacb",
-    "rules/wgl016.ts": "f76358f42b1f39ea",
-    "rules/wgl022.ts": "adba5b533dc416c9",
-    "rules/wgl019.ts": "5a4ab8ebb115f074",
-    "rules/wgl027.ts": "ea7928f37607a583",
-    "rules/wgl014.ts": "6248a852888e8028",
-    "rules/yaml-helpers.ts": "3e414c7affe56728",
-    "skills/chant-gitlab.md": "fe29add147305b7e",
-    "skills/chant-gitlab-patterns.md": "efb54bd8ea52071b"
+    "manifest.json": "028f9a5d3b18be085acb465fda8da6ed24113b6048008d46a02af5215024e394",
+    "meta.json": "931fc3246a55645b1493080bbeb160e5d205e42349e8bdca96ca243adb5f0da3",
+    "types/index.d.ts": "5cd2e99f135a929b72bdd822d00d780d39b1cd407ba0cfb3d511c7ac9d667b58",
+    "rules/artifact-no-expiry.ts": "3f3cabf9792cbf8207e53a25f506715466b19ec25e9c3b4d0d77fed6b2eb4542",
+    "rules/deprecated-only-except.ts": "2341b95c0aaf3013c375fb404969858e23451e3430f3d1a63b128fcb21b90156",
+    "rules/missing-script.ts": "1dba062d77fa248fc02857fd08bc7789f90eefd3206e552ac63782a04b843888",
+    "rules/missing-stage.ts": "ce810703cba6c8942282c4ebaeff23fe3312c4ecc362acce05baf85d0fd32ea3",
+    "rules/wgl010.ts": "e9a14d5f9e4c49b1524ba5ee3746be739603125ec3c2dc4eb4b7c0bfc32581b0",
+    "rules/wgl011.ts": "15954191c836d416f27585303b24bfbe458779520212fa47e854f2214a4deef6",
+    "rules/wgl012.ts": "baf33141114cfd80316fb1f0f7cf23d8966c58d0bb7c6cd99d92166cfe7e900b",
+    "rules/wgl013.ts": "f1309b1c048c00684181b9488a633f44068b537fd743ac21b0ae2712478158ba",
+    "rules/wgl014.ts": "acbbeec029ec7f23e74cebcd4965dae12ea991a5a29e754040edd4a0c3fd8f0c",
+    "rules/wgl015.ts": "040da46b2fe8126ba18c8d44957b402a710537eca0dc05d885498022ccec006a",
+    "rules/wgl016.ts": "d8bf9a371b22f37a767f92e3361d5f8e064e6dd6ba879ff1a5fc90b4b09fd304",
+    "rules/wgl017.ts": "2d212de62eee4f7b086b49c92975b09d988c1ff05c2fb20cffccdc500a14e668",
+    "rules/wgl018.ts": "6ba795cb9dddcc6f3432f4ffc86f2351d9db0e7fa1a71ffb35791d3631a73bad",
+    "rules/wgl019.ts": "9bc86b3f8e8f5a4b52fffc728c15850ce89b1a5c9e6a400ced987e24fc1b56f6",
+    "rules/wgl020.ts": "81a84b49308f36ab2b01342bd0e262b59b2a8395d233760ac52a679c2a4ae0e6",
+    "rules/wgl021.ts": "59a75e0b0123779bcd4c7f66eb068c4302860df8333a4bc7b41c68e3983505da",
+    "rules/wgl022.ts": "b901e9c5386cdcd9ac61cf94ead46ffeb08a6c0bb7b02e54e916075160c41eca",
+    "rules/wgl023.ts": "8a34c5bd5cf690bc3b22c583d2fc1412cf8c9b438c0e18385ebd119983e8b8de",
+    "rules/wgl024.ts": "07db98e5e3d7419f347e9c717e834b207168df9e8d029db61e9c3e3769ca9ccf",
+    "rules/wgl025.ts": "52dbd9d363230fd5bdea0407bc3363d408dd5f750c58c83cf8d87e55568bb81c",
+    "rules/wgl026.ts": "b7d9f075aa8fc9623e28745b68c2368c223c2899641cbb7796952018717dcee5",
+    "rules/wgl027.ts": "1ff29b9101a268c58756593b0d86396b557a79527b5dc390c190ae224c12597a",
+    "rules/wgl028.ts": "f1c64eda25e2ad8da634d64a397f877a46ae8327713db5cf3193882bb9b96453",
+    "rules/yaml-helpers.ts": "f2322530a7fd812e482c5a7df05d0d05787b207574b67b811776786e00fd3e18",
+    "skills/chant-gitlab.md": "1e26a0c50ea891423479bd7fec3bc133f9185727c4a3eaadd525d7e7436056b6",
+    "skills/chant-gitlab-patterns.md": "cefda1b656f222293d16381dfbf452b2b376b545a69f62e55dc38907fe8aa7fa"
   },
-  "composite": "690703aa91a047dd"
+  "composite": "2f6e473cfad9b8e3afca160af10cfeb880fe4c71c90f15f9723ee620770e1549"
 }

package/dist/manifest.json

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

package/dist/skills/chant-gitlab.md

@@ -35,6 +35,7 @@ This creates `src/` with chant pipeline definitions. It does NOT create applicat
 |----------|-------------------|----------|
 | *(default)* | `config.ts` + `pipeline.ts` with build/test jobs | Custom pipelines from scratch |
 | `node-pipeline` | `NodePipeline` composite with npm install/build/test | Node.js apps |
+| `bun-pipeline` | `BunPipeline` composite — Bun runtime with frozen lockfile | Bun apps |
 | `python-pipeline` | `PythonPipeline` composite with venv/pytest | Python apps |
 | `docker-build` | `DockerBuild` composite + test job | Containerized apps |
 | `review-app` | `ReviewApp` composite + test job | Apps needing per-MR environments |
@@ -87,6 +88,8 @@ NodePipeline({
 
 Or generate a lockfile: `npm install && git add package-lock.json`.
 
+For Bun projects, use `BunPipeline` instead — it auto-configures `bun install --frozen-lockfile` and Bun's cache directory (`.bun/install/cache`). You can also pass `packageManager: "bun"` directly to `NodePipeline` for more control.
+
 ### Step-by-step: push to GitLab
 
 ```bash

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@intentius/chant-lexicon-gitlab",
-  "version": "0.1.0",
+  "version": "0.1.8",
   "description": "GitLab CI lexicon for chant — declarative IaC in TypeScript",
   "license": "Apache-2.0",
   "homepage": "https://intentius.io/chant",
@@ -36,14 +36,14 @@
     "./types": "./dist/types/index.d.ts"
   },
   "scripts": {
-    "generate": "bun run src/codegen/generate-cli.ts",
-    "bundle": "bun run src/package-cli.ts",
-    "validate": "bun run src/validate-cli.ts",
-    "docs": "bun run src/codegen/docs-cli.ts",
-    "prepack": "bun run generate && bun run bundle && bun run validate"
+    "generate": "tsx src/codegen/generate-cli.ts",
+    "bundle": "tsx src/package-cli.ts",
+    "validate": "tsx src/validate-cli.ts",
+    "docs": "tsx src/codegen/docs-cli.ts",
+    "prepack": "npm run generate && npm run bundle && npm run validate"
   },
   "devDependencies": {
-    "@intentius/chant": "0.1.0",
+    "@intentius/chant": "*",
     "typescript": "^5.9.3"
   },
   "peerDependencies": {

package/src/codegen/__snapshots__/snapshot.test.ts.snap

@@ -1,6 +1,6 @@
-// Bun Snapshot v1, https://bun.sh/docs/test/snapshots
+// Vitest Snapshot v1, https://vitest.dev/guide/snapshot.html
 
-exports[`generated lexicon-gitlab.json entries match snapshot 1`] = `
+exports[`generated lexicon-gitlab.json > entries match snapshot 1`] = `
 {
   "constraints": {
     "coverage": {
@@ -14,7 +14,7 @@ exports[`generated lexicon-gitlab.json entries match snapshot 1`] = `
 }
 `;
 
-exports[`generated lexicon-gitlab.json entries match snapshot 2`] = `
+exports[`generated lexicon-gitlab.json > entries match snapshot 2`] = `
 {
   "constraints": {
     "access": {
@@ -46,7 +46,7 @@ exports[`generated lexicon-gitlab.json entries match snapshot 2`] = `
 }
 `;
 
-exports[`generated lexicon-gitlab.json entries match snapshot 3`] = `
+exports[`generated lexicon-gitlab.json > entries match snapshot 3`] = `
 {
   "constraints": {
     "policy": {
@@ -74,7 +74,7 @@ exports[`generated lexicon-gitlab.json entries match snapshot 3`] = `
 }
 `;
 
-exports[`generated lexicon-gitlab.json entries match snapshot 4`] = `
+exports[`generated lexicon-gitlab.json > entries match snapshot 4`] = `
 {
   "constraints": {
     "name": {

package/src/codegen/docs.ts

@@ -105,7 +105,11 @@ export async function generateDocs(opts?: { verbose?: boolean }): Promise<void>
         slug: "pipeline-concepts",
         title: "Pipeline Concepts",
         description: "Jobs, stages, artifacts, caching, images, rules, environments, and triggers in the GitLab CI/CD lexicon",
-        content: `Every exported \`Job\` declaration becomes a job entry in the generated \`.gitlab-ci.yml\`. The serializer handles the translation automatically:
+        content: `import Diagram from '../../components/Diagram.astro';
+
+Every exported \`Job\` declaration becomes a job entry in the generated \`.gitlab-ci.yml\`. The serializer handles the translation automatically:
+
+<Diagram name="pipeline-hierarchy" alt="GitLab Pipeline with stages (build, test, deploy) each containing jobs, with stage dependencies flowing left to right" caption="GitLab CI pipeline hierarchy" />
 
 - Property names use spec-native snake_case (\`expire_in\`, \`allow_failure\`)
 - Converts export names to kebab-case job keys (\`buildApp\` → \`build-app\`)
@@ -469,10 +473,10 @@ export default {
 
 \`\`\`bash
 cd examples/getting-started
-bun install
+npm install
 chant build    # produces .gitlab-ci.yml
 chant lint     # runs lint rules
-bun test       # runs the example's tests
+npx vitest run    # run the tests
 \`\`\`
 
 ## Getting Started

package/src/codegen/fetch.test.ts

@@ -1,4 +1,4 @@
-import { describe, test, expect } from "bun:test";
+import { describe, test, expect } from "vitest";
 import { fetchCISchema, fetchSchemas, getCachePath, GITLAB_SCHEMA_VERSION } from "./fetch";
 
 describe("fetch", () => {

package/src/codegen/generate-cli.ts

@@ -1,4 +1,4 @@
-#!/usr/bin/env bun
+#!/usr/bin/env tsx
 /**
  * CLI entry point for GitLab CI lexicon generation.
  */

package/src/codegen/generate.test.ts

@@ -1,4 +1,4 @@
-import { describe, test, expect } from "bun:test";
+import { describe, test, expect } from "vitest";
 import { generate, writeGeneratedFiles } from "./generate";
 import { loadSchemaFixtureMap } from "../testdata/load-fixtures";
 

package/src/codegen/idempotency.test.ts

@@ -1,4 +1,4 @@
-import { describe, test, expect } from "bun:test";
+import { describe, test, expect } from "vitest";
 import { generate } from "./generate";
 import { loadSchemaFixtureMap } from "../testdata/load-fixtures";
 

package/src/codegen/naming.test.ts

@@ -1,4 +1,4 @@
-import { describe, test, expect } from "bun:test";
+import { describe, test, expect } from "vitest";
 import { gitlabShortName, type GitLabParseResult } from "./parse";
 import { NamingStrategy } from "./naming";
 

package/src/codegen/package.ts

@@ -3,9 +3,8 @@
  * with GitLab-specific manifest building and skill collection.
  */
 
-import { createRequire } from "module";
 import { readFileSync } from "fs";
-const require = createRequire(import.meta.url);
+import { gitlabPlugin } from "../plugin";
 import { join, dirname } from "path";
 import { fileURLToPath } from "url";
 import type { IntrinsicDef } from "@intentius/chant/lexicon";
@@ -53,9 +52,7 @@ export async function packageLexicon(opts: PackageOptions = {}): Promise<Package
 
       srcDir: pkgDir,
 
-      collectSkills: () => {
-        const { gitlabPlugin } = require("../plugin");
-        const skillDefs = gitlabPlugin.skills?.() ?? [];
+      collectSkills: () => {        const skillDefs = gitlabPlugin.skills?.() ?? [];
         return collectSkills(skillDefs);
       },
 

package/src/codegen/parse.test.ts

@@ -1,4 +1,4 @@
-import { describe, test, expect } from "bun:test";
+import { describe, test, expect } from "vitest";
 import { parseCISchema, gitlabShortName, gitlabServiceName } from "./parse";
 import { loadSchemaFixture } from "../testdata/load-fixtures";
 

package/src/codegen/patches.test.ts

@@ -1,4 +1,4 @@
-import { describe, test, expect } from "bun:test";
+import { describe, test, expect } from "vitest";
 import { applyPatches, schemaPatches } from "./patches";
 
 describe("applyPatches", () => {

package/src/codegen/snapshot.test.ts

@@ -1,4 +1,4 @@
-import { describe, test, expect } from "bun:test";
+import { describe, test, expect } from "vitest";
 import { existsSync, readFileSync } from "fs";
 import { join, dirname } from "path";
 import { fileURLToPath } from "url";

package/src/codegen/typecheck.test.ts

@@ -1,4 +1,4 @@
-import { describe, test, expect } from "bun:test";
+import { describe, test, expect } from "vitest";
 import { typecheckDTS } from "./typecheck";
 
 describe("typecheckDTS", () => {

package/src/composites/composites.test.ts

@@ -1,4 +1,4 @@
-import { describe, test, expect } from "bun:test";
+import { describe, test, expect } from "vitest";
 import { expandComposite, isCompositeInstance } from "@intentius/chant";
 import { DockerBuild } from "./docker-build";
 import { NodePipeline, BunPipeline, PnpmPipeline } from "./node-pipeline";

package/src/coverage.test.ts

@@ -1,4 +1,4 @@
-import { describe, test, expect } from "bun:test";
+import { describe, test, expect } from "vitest";
 import { existsSync, readFileSync } from "fs";
 import { join, dirname } from "path";
 import { fileURLToPath } from "url";

package/src/import/generator.test.ts

@@ -1,4 +1,4 @@
-import { describe, test, expect } from "bun:test";
+import { describe, test, expect } from "vitest";
 import { GitLabGenerator } from "./generator";
 import type { TemplateIR } from "@intentius/chant/import/parser";
 

package/src/import/parser.test.ts

@@ -1,4 +1,4 @@
-import { describe, test, expect } from "bun:test";
+import { describe, test, expect } from "vitest";
 import { GitLabParser } from "./parser";
 
 const parser = new GitLabParser();

package/src/import/roundtrip.test.ts

@@ -1,4 +1,4 @@
-import { describe, test, expect } from "bun:test";
+import { describe, test, expect } from "vitest";
 import { readFileSync, readdirSync } from "fs";
 import { join, dirname } from "path";
 import { fileURLToPath } from "url";

package/src/intrinsics.test.ts

@@ -1,4 +1,4 @@
-import { describe, test, expect } from "bun:test";
+import { describe, test, expect } from "vitest";
 import { reference, ReferenceIntrinsic } from "./intrinsics";
 import { INTRINSIC_MARKER } from "@intentius/chant/intrinsic";
 

package/src/lint/post-synth/post-synth.test.ts

@@ -1,4 +1,4 @@
-import { describe, test, expect } from "bun:test";
+import { describe, test, expect } from "vitest";
 import type { PostSynthContext } from "@intentius/chant/lint/post-synth";
 import { DECLARABLE_MARKER, type Declarable } from "@intentius/chant/declarable";
 import { wgl010 } from "./wgl010";

package/src/lint/post-synth/wgl012.test.ts

@@ -1,4 +1,4 @@
-import { describe, test, expect } from "bun:test";
+import { describe, test, expect } from "vitest";
 import { DECLARABLE_MARKER, type Declarable } from "@intentius/chant/declarable";
 import type { PostSynthContext } from "@intentius/chant/lint/post-synth";
 import { wgl012, checkDeprecatedProperties } from "./wgl012";

package/src/lint/post-synth/wgl013.test.ts

@@ -1,4 +1,4 @@
-import { describe, test, expect } from "bun:test";
+import { describe, test, expect } from "vitest";
 import type { PostSynthContext } from "@intentius/chant/lint/post-synth";
 import { wgl013, checkInvalidNeeds } from "./wgl013";
 

package/src/lint/post-synth/wgl014.test.ts

@@ -1,4 +1,4 @@
-import { describe, test, expect } from "bun:test";
+import { describe, test, expect } from "vitest";
 import type { PostSynthContext } from "@intentius/chant/lint/post-synth";
 import { wgl014, checkInvalidExtends } from "./wgl014";
 

package/src/lint/post-synth/wgl015.test.ts

@@ -1,4 +1,4 @@
-import { describe, test, expect } from "bun:test";
+import { describe, test, expect } from "vitest";
 import type { PostSynthContext } from "@intentius/chant/lint/post-synth";
 import { wgl015, checkCircularNeeds } from "./wgl015";
 

package/src/lint/post-synth/wgl016.test.ts

@@ -1,4 +1,4 @@
-import { describe, test, expect } from "bun:test";
+import { describe, test, expect } from "vitest";
 import { wgl016, checkSecretsInVariables } from "./wgl016";
 
 describe("WGL016: Secrets in Variables", () => {

package/src/lint/post-synth/wgl017.test.ts

@@ -1,4 +1,4 @@
-import { describe, test, expect } from "bun:test";
+import { describe, test, expect } from "vitest";
 import { wgl017, checkInsecureRegistry } from "./wgl017";
 
 describe("WGL017: Insecure Registry", () => {

package/src/lint/post-synth/wgl018.test.ts

@@ -1,4 +1,4 @@
-import { describe, test, expect } from "bun:test";
+import { describe, test, expect } from "vitest";
 import { DECLARABLE_MARKER, type Declarable } from "@intentius/chant/declarable";
 import type { PostSynthContext } from "@intentius/chant/lint/post-synth";
 import { wgl018 } from "./wgl018";

package/src/lint/post-synth/wgl019.test.ts

@@ -1,4 +1,4 @@
-import { describe, test, expect } from "bun:test";
+import { describe, test, expect } from "vitest";
 import { DECLARABLE_MARKER, type Declarable } from "@intentius/chant/declarable";
 import type { PostSynthContext } from "@intentius/chant/lint/post-synth";
 import { wgl019 } from "./wgl019";

package/src/lint/post-synth/wgl020.test.ts

@@ -1,4 +1,4 @@
-import { describe, test, expect } from "bun:test";
+import { describe, test, expect } from "vitest";
 import { wgl020, checkDuplicateJobNames } from "./wgl020";
 
 describe("WGL020: Duplicate Job Names", () => {

package/src/lint/post-synth/wgl021.test.ts

@@ -1,4 +1,4 @@
-import { describe, test, expect } from "bun:test";
+import { describe, test, expect } from "vitest";
 import { wgl021, checkUnusedVariables } from "./wgl021";
 
 describe("WGL021: Unused Variables", () => {

package/src/lint/post-synth/wgl022.test.ts

@@ -1,4 +1,4 @@
-import { describe, test, expect } from "bun:test";
+import { describe, test, expect } from "vitest";
 import { DECLARABLE_MARKER, type Declarable } from "@intentius/chant/declarable";
 import type { PostSynthContext } from "@intentius/chant/lint/post-synth";
 import { wgl022 } from "./wgl022";

package/src/lint/post-synth/wgl023.test.ts

@@ -1,4 +1,4 @@
-import { describe, test, expect } from "bun:test";
+import { describe, test, expect } from "vitest";
 import { DECLARABLE_MARKER, type Declarable } from "@intentius/chant/declarable";
 import type { PostSynthContext } from "@intentius/chant/lint/post-synth";
 import { wgl023 } from "./wgl023";

package/src/lint/post-synth/wgl024.test.ts

@@ -1,4 +1,4 @@
-import { describe, test, expect } from "bun:test";
+import { describe, test, expect } from "vitest";
 import { DECLARABLE_MARKER, type Declarable } from "@intentius/chant/declarable";
 import type { PostSynthContext } from "@intentius/chant/lint/post-synth";
 import { wgl024 } from "./wgl024";

package/src/lint/post-synth/wgl025.test.ts

@@ -1,4 +1,4 @@
-import { describe, test, expect } from "bun:test";
+import { describe, test, expect } from "vitest";
 import { DECLARABLE_MARKER, type Declarable } from "@intentius/chant/declarable";
 import type { PostSynthContext } from "@intentius/chant/lint/post-synth";
 import { wgl025 } from "./wgl025";

package/src/lint/post-synth/wgl026.test.ts

@@ -1,4 +1,4 @@
-import { describe, test, expect } from "bun:test";
+import { describe, test, expect } from "vitest";
 import { DECLARABLE_MARKER, type Declarable } from "@intentius/chant/declarable";
 import type { PostSynthContext } from "@intentius/chant/lint/post-synth";
 import { wgl026 } from "./wgl026";

package/src/lint/post-synth/wgl027.test.ts

@@ -1,4 +1,4 @@
-import { describe, test, expect } from "bun:test";
+import { describe, test, expect } from "vitest";
 import { DECLARABLE_MARKER, type Declarable } from "@intentius/chant/declarable";
 import type { PostSynthContext } from "@intentius/chant/lint/post-synth";
 import { wgl027 } from "./wgl027";

package/src/lint/post-synth/wgl028.test.ts

@@ -1,4 +1,4 @@
-import { describe, test, expect } from "bun:test";
+import { describe, test, expect } from "vitest";
 import { wgl028, checkRedundantNeeds } from "./wgl028";
 
 describe("WGL028: Redundant Needs", () => {

package/src/lint/rules/rules.test.ts

@@ -1,4 +1,4 @@
-import { describe, test, expect } from "bun:test";
+import { describe, test, expect } from "vitest";
 import * as ts from "typescript";
 import type { LintContext } from "@intentius/chant/lint/rule";
 import { deprecatedOnlyExceptRule } from "./deprecated-only-except";

package/src/lsp/completions.test.ts

@@ -1,4 +1,4 @@
-import { describe, test, expect } from "bun:test";
+import { describe, test, expect } from "vitest";
 import { existsSync } from "fs";
 import { join, dirname } from "path";
 import { fileURLToPath } from "url";

package/src/lsp/hover.test.ts

@@ -1,4 +1,4 @@
-import { describe, test, expect } from "bun:test";
+import { describe, test, expect } from "vitest";
 import { existsSync } from "fs";
 import { join, dirname } from "path";
 import { fileURLToPath } from "url";

package/src/package-cli.ts

@@ -1,6 +1,6 @@
-#!/usr/bin/env bun
+#!/usr/bin/env tsx
 /**
- * Thin entry point for `bun run bundle` in lexicon-gitlab.
+ * Thin entry point for `npm run bundle` in lexicon-gitlab.
  * Generates src/generated/ files and writes dist/ bundle.
  */
 import { generate, writeGeneratedFiles } from "./codegen/generate";

package/src/plugin.test.ts

@@ -1,4 +1,4 @@
-import { describe, test, expect } from "bun:test";
+import { describe, test, expect } from "vitest";
 import { gitlabPlugin } from "./plugin";
 import { isLexiconPlugin } from "@intentius/chant/lexicon";
 
@@ -215,7 +215,7 @@ describe("gitlabPlugin", () => {
   test("returns MCP tools", () => {
     const tools = gitlabPlugin.mcpTools!();
     expect(tools).toHaveLength(1);
-    expect(tools[0].name).toBe("diff");
+    expect(tools[0].name).toBe("gitlab:diff");
     expect(typeof tools[0].handler).toBe("function");
   });
 
@@ -223,13 +223,13 @@ describe("gitlabPlugin", () => {
     const resources = gitlabPlugin.mcpResources!();
     expect(resources.length).toBeGreaterThan(0);
     const uris = resources.map((r) => r.uri);
-    expect(uris).toContain("resource-catalog");
+    expect(uris).toContain("gitlab:resource-catalog");
     expect(uris).toContain("examples/basic-pipeline");
   });
 
   test("MCP resource-catalog handler returns JSON", async () => {
     const resources = gitlabPlugin.mcpResources!();
-    const catalog = resources.find((r) => r.uri === "resource-catalog")!;
+    const catalog = resources.find((r) => r.uri === "gitlab:resource-catalog")!;
     const result = await catalog.handler();
     const parsed = JSON.parse(result);
     expect(Array.isArray(parsed)).toBe(true);

package/src/plugin.ts

@@ -5,25 +5,27 @@
  * for GitLab CI/CD pipelines.
  */
 
-import { createRequire } from "module";
 import type { LexiconPlugin, IntrinsicDef, InitTemplateSet } from "@intentius/chant/lexicon";
-const require = createRequire(import.meta.url);
 import type { LintRule } from "@intentius/chant/lint/rule";
 import { discoverPostSynthChecks } from "@intentius/chant/lint/discover";
 import { createSkillsLoader, createDiffTool, createCatalogResource } from "@intentius/chant/lexicon-plugin-helpers";
 import { join, dirname } from "path";
 import { fileURLToPath } from "url";
 import { gitlabSerializer } from "./serializer";
+import { deprecatedOnlyExceptRule } from "./lint/rules/deprecated-only-except";
+import { missingScriptRule } from "./lint/rules/missing-script";
+import { missingStageRule } from "./lint/rules/missing-stage";
+import { artifactNoExpiryRule } from "./lint/rules/artifact-no-expiry";
+import { gitlabCompletions } from "./lsp/completions";
+import { gitlabHover } from "./lsp/hover";
+import { GitLabParser } from "./import/parser";
+import { GitLabGenerator } from "./import/generator";
 
 export const gitlabPlugin: LexiconPlugin = {
   name: "gitlab",
   serializer: gitlabSerializer,
 
   lintRules(): LintRule[] {
-    const { deprecatedOnlyExceptRule } = require("./lint/rules/deprecated-only-except");
-    const { missingScriptRule } = require("./lint/rules/missing-script");
-    const { missingStageRule } = require("./lint/rules/missing-stage");
-    const { artifactNoExpiryRule } = require("./lint/rules/artifact-no-expiry");
     return [deprecatedOnlyExceptRule, missingScriptRule, missingStageRule, artifactNoExpiryRule];
   },
 
@@ -187,22 +189,18 @@ export const test = new Job({
   },
 
   completionProvider(ctx: import("@intentius/chant/lsp/types").CompletionContext) {
-    const { gitlabCompletions } = require("./lsp/completions");
     return gitlabCompletions(ctx);
   },
 
   hoverProvider(ctx: import("@intentius/chant/lsp/types").HoverContext) {
-    const { gitlabHover } = require("./lsp/hover");
     return gitlabHover(ctx);
   },
 
   templateParser() {
-    const { GitLabParser } = require("./import/parser");
     return new GitLabParser();
   },
 
   templateGenerator() {
-    const { GitLabGenerator } = require("./import/generator");
     return new GitLabGenerator();
   },
 
@@ -254,12 +252,12 @@ export const test = new Job({
   },
 
   mcpTools() {
-    return [createDiffTool(gitlabSerializer, "Compare current build output against previous output for GitLab CI")];
+    return [createDiffTool(gitlabSerializer, "Compare current build output against previous output for GitLab CI", "gitlab")];
   },
 
   mcpResources() {
     return [
-      createCatalogResource(import.meta.url, "GitLab CI Entity Catalog", "JSON list of all supported GitLab CI entity types", "lexicon-gitlab.json"),
+      createCatalogResource(import.meta.url, "GitLab CI Entity Catalog", "JSON list of all supported GitLab CI entity types", "lexicon-gitlab.json", "gitlab"),
       {
         uri: "examples/basic-pipeline",
         name: "Basic Pipeline Example",

package/src/serializer.test.ts

@@ -1,4 +1,4 @@
-import { describe, test, expect } from "bun:test";
+import { describe, test, expect } from "vitest";
 import { gitlabSerializer } from "./serializer";
 import { DECLARABLE_MARKER, type Declarable } from "@intentius/chant/declarable";
 import { createProperty, createResource } from "@intentius/chant/runtime";

package/src/skills/chant-gitlab.md

@@ -35,6 +35,7 @@ This creates `src/` with chant pipeline definitions. It does NOT create applicat
 |----------|-------------------|----------|
 | *(default)* | `config.ts` + `pipeline.ts` with build/test jobs | Custom pipelines from scratch |
 | `node-pipeline` | `NodePipeline` composite with npm install/build/test | Node.js apps |
+| `bun-pipeline` | `BunPipeline` composite — Bun runtime with frozen lockfile | Bun apps |
 | `python-pipeline` | `PythonPipeline` composite with venv/pytest | Python apps |
 | `docker-build` | `DockerBuild` composite + test job | Containerized apps |
 | `review-app` | `ReviewApp` composite + test job | Apps needing per-MR environments |
@@ -87,6 +88,8 @@ NodePipeline({
 
 Or generate a lockfile: `npm install && git add package-lock.json`.
 
+For Bun projects, use `BunPipeline` instead — it auto-configures `bun install --frozen-lockfile` and Bun's cache directory (`.bun/install/cache`). You can also pass `packageManager: "bun"` directly to `NodePipeline` for more control.
+
 ### Step-by-step: push to GitLab
 
 ```bash

package/src/testdata/create-fixture.ts

@@ -1,7 +1,7 @@
-#!/usr/bin/env bun
+#!/usr/bin/env tsx
 /**
  * Script to create a minimal CI schema fixture for tests.
- * Run once: bun run src/testdata/create-fixture.ts
+ * Run once: npx tsx src/testdata/create-fixture.ts
  */
 
 import { readFileSync, writeFileSync } from "fs";
@@ -39,7 +39,7 @@ const minimal = {
   required: schema.required || [],
 };
 
-const outPath = join(import.meta.dir, "ci-schema-fixture.json");
+const outPath = join(import.meta.dirname, "ci-schema-fixture.json");
 writeFileSync(outPath, JSON.stringify(minimal, null, 2));
 console.log(`Fixture written to ${outPath}`);
 console.log(`Definitions: ${Object.keys(defs).length}`);

package/src/testdata/load-fixtures.ts

@@ -9,7 +9,7 @@ import { join } from "path";
  * Load the minimal CI schema fixture for offline testing.
  */
 export function loadSchemaFixture(): Buffer {
-  const fixturePath = join(import.meta.dir, "ci-schema-fixture.json");
+  const fixturePath = join(import.meta.dirname, "ci-schema-fixture.json");
   return Buffer.from(readFileSync(fixturePath));
 }
 

package/src/validate-cli.ts

@@ -1,6 +1,6 @@
-#!/usr/bin/env bun
+#!/usr/bin/env tsx
 /**
- * Thin entry point for `bun run validate` in lexicon-gitlab.
+ * Thin entry point for `npm run validate` in lexicon-gitlab.
  */
 import { validate } from "./validate";
 

package/src/validate.test.ts

@@ -1,4 +1,4 @@
-import { describe, test, expect } from "bun:test";
+import { describe, test, expect } from "vitest";
 import { existsSync } from "fs";
 import { join, dirname } from "path";
 import { fileURLToPath } from "url";

package/src/variables.test.ts

@@ -1,4 +1,4 @@
-import { describe, test, expect } from "bun:test";
+import { describe, test, expect } from "vitest";
 import { CI } from "./variables";
 
 describe("CI variables", () => {