Development

Repository layout

dbt-forge/
├── cli/
│   ├── pyproject.toml
│   ├── src/dbt_forge/
│   │   ├── main.py              # init, doctor, status, update, preset commands
│   │   ├── cli/                 # add, doctor, status, update command modules
│   │   ├── scanner.py           # shared project scanning utilities
│   │   ├── manifest.py          # .dbt-forge.yml manifest for update tracking
│   │   ├── presets.py           # preset loading, validation, and application
│   │   ├── prompts/             # interactive prompts and ProjectConfig
│   │   ├── generator/           # file generation and Jinja2 rendering
│   │   └── templates/           # all .j2 templates
│   └── tests/
└── website/
    ├── astro.config.mjs
    ├── src/content/docs/
    └── src/pages/

Work on the CLI

cd cli
uv sync --all-groups
uv run ruff check .
uv run pytest -m "not integration"   # unit tests only
uv run pytest -m integration -v      # integration tests (dbt + DuckDB)
uv run pytest                        # all tests
uv build
uvx twine check dist/*

Work on the website

cd website
pnpm install
pnpm dev
pnpm build

Release flow

The package release happens from GitHub Actions on v* tags. The website is deployed separately on Vercel and is not a separately versioned release artifact.

From the repository root:

python3 scripts/release_assistant.py prepare 0.4.1
python3 scripts/release_assistant.py verify 0.4.1
python3 scripts/release_assistant.py publish 0.4.1 --confirm

prepare stages the version and changelog updates. verify is the release gate and requires a clean main branch aligned with origin/main. publish dispatches the manual TestPyPI preflight first, then pauses for confirmation before creating and pushing the release tag.

Release notes

Use RELEASING.md as the release checklist. It records:

• the package release scope for the CLI
• verified GitHub prerequisites from local inspection
• manual Trusted Publishing checks for PyPI and TestPyPI
• the release assistant commands and validation gates to run before tagging

Website hosting

The site is intended for Vercel with:

• Root Directory: website
• Build Command: pnpm build
• Output Directory: dist