@intentius/chant-lexicon-gitlab

@intentius/chant-lexicon-gitlab

GitLab CI lexicon for chant — declare CI/CD pipelines as typed TypeScript that serializes to .gitlab-ci.yml.

This package provides typed constructors for all GitLab CI keywords (Jobs, Workflows, Default, and property types like Artifacts, Cache, Image, Rule, Environment, and Trigger), the CI pseudo-parameter object for predefined variables, the reference() intrinsic for YAML !reference tags, and GitLab-specific lint rules. It also includes LSP and MCP server support for editor completions and hover.

npm install --save-dev @intentius/chant @intentius/chant-lexicon-gitlab

Documentation →

Related Packages

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.

GitHub Actions migration

chant migrate translates .github/workflows/*.yml into .gitlab-ci.yml or typed chant TypeScript. The transformer, action-mapping registry, and provenance model are ported from gitlab-org/ci-cd/github-actions-to-gitlab-ci (MIT). See Migration and ATTRIBUTIONS.md.

License

See the main project LICENSE file.