@lssm-tech/app.action-driftapp.action-drift
GitHub Action for ContractSpec drift detection
@lssm-tech/app.action-driftSource, release and verification context
Source snapshot bcc79fcc · Declared package version 4.0.4. This page combines the checked-in package guide and manifest; commands and runtime behavior were not executed in this review.
servernode
See where this package fits.
Follow a declared connection, inspect an import, then open the source guide when you need the detail.
THIS PACKAGEapp.action-driftapps
Arrows point from a package to its direct dependency. Each count is derived from the captured manifests.
PACKAGE GUIDERead at source ↗
@lssm-tech/action.drift
Website: https://contractspec.io
GitHub Action that detects contract drift between specs and implementation. Runs in CI to flag when generated code diverges from its source contracts.
What It Does
- Uses
@lssm-tech/lib.contracts-specfor contract definitions - Uses
@lssm-tech/bundle.workspacefor workspace analysis - Configured via
action.yml; nosrc/— logic lives in workspace bundle
Usage
name: ContractSpec Drift
on: pull_request
jobs:
contractspec:
runs-on: ubuntu-latest
permissions:
contents: read
packages: read
steps:
- uses: actions/checkout@v6
- uses: lssm-tech/contractspec/packages/apps/action-drift@main
with:
github-packages-token: ${{ secrets.CONTRACTSPEC_PACKAGES_TOKEN }}
generate-command: 'bun contractspec generate'For affected private GitHub Packages dependencies, github-packages-token must be a GitHub token that can read the ContractSpec packages granted to the consuming repository, bot, or GitHub App.
Entrées
package-manager(default:bun) — Package manager to use (bun|npm|pnpm|yarn)working-directory(default:.) — Working directory for running commandsgenerate-command(default:bun contractspec generate) — Command to regenerate artifactson-drift(default:fail) — Behavior when drift is detected (fail|issue|pr)drift-paths-allowlist— Comma-separated glob patterns to check for drifttoken(default:${{ github.token }}) — GitHub token for issues/PRsgithub-packages-token— Optional token used to configure private GitHub Packages auth before dependency installs
Outputs
drift-detected— Whether drift was detected
Key Files
action.yml— GitHub Action definitionfixtures/— Test report data for drift scenarios
Local Commands
bun run test— bun test
Recent Updates
- Replace eslint+prettier by biomejs to optimize speed
- Stability
- Stability improvements
Notes
- Do not change
action.ymlinputs/outputs without updating downstream workflow consumers - Fixture JSON files are used for CI testing — keep them valid
Declared capabilities.
This manifest does not declare a capability catalogue. Use the guide, import map and source to assess the package.
Imports and export paths.
1 entriesThese are package-manifest entry points. Named symbols listed above come from the capability catalogue; this is not an exhaustive TypeScript symbol reference.
1 import
No export paths match this search.
Dependencies and related packages.
Runtime dependencies 2
- @lssm-tech/bundle.workspace
- workspace:^
- @lssm-tech/lib.contracts-spec
- workspace:^
Development dependencies 4
- @lssm-tech/tool.typescript
- workspace:*
- @types/bun
- catalog:types
- @types/node
- catalog:types
- typescript
- catalog:
Package scripts.
Commands declared by this package. Review its setup requirements before running them; no command here was executed by this review.
test
bun test