ballast-examples

Sample repositories for smoke testing Ballast language detection and install flows.

Ballast

• Repository: https://github.com/everydaydevopsio/ballast
• Installation guide: https://github.com/everydaydevopsio/ballast/blob/main/docs/installation.md

Quick install (Go CLI):

go install github.com/everydaydevopsio/ballast/packages/ballast-go/cmd/ballast-go@latest

If you want the ballast command name locally, add an alias (for example in your shell profile):

alias ballast=ballast-go

Layout

• go-sample/
• python-sample/
• typescript-sample/

Run Smoke Tests

1) Run locally (host)

From repo root:

./smoke.sh

This runs:

• ballast install --target cursor --agent linting --yes in each sample project

Prerequisite: ballast must be available on your PATH.

2) Run in Docker (preinstalled CLIs)

If your Ballast repo is next to this one:

cd ../ballast
docker build -f Dockerfile.smoke -t ballast-smoke .
docker run --rm -it -v "$(pwd)/../ballast-examples:/workspace/examples" ballast-smoke bash -lc "cd /workspace/examples && ./smoke.sh"

3) Run in Docker (lazy-download CLIs)

cd ../ballast
docker build -f Dockerfile.smoke --build-arg PREINSTALL_ALL_BINARIES=0 -t ballast-smoke-lazy .
docker run --rm -it -v "$(pwd)/../ballast-examples:/workspace/examples" ballast-smoke-lazy bash -lc "cd /workspace/examples && ./smoke.sh"

4) Run in GitHub Actions

Smoke tests run from the ballast repository workflow. To trigger manually:

gh workflow run examples-smoke.yml --repo everydaydevopsio/ballast

CI Smoke Matrix

GitHub Actions runs smoke tests on push/PR in ballast for all three samples.

Workflow file: ballast/.github/workflows/examples-smoke.yml

Each matrix job:

• builds ballast wrapper + language CLIs from source
• runs ballast install --target cursor --agent linting --yes
• verifies generated rule file

Expected Output

• Each sample gets .cursor/rules/linting.mdc.