Contributing

Issues and pull requests are welcome: github.com/dk0d/shki.

Setup

git clone https://github.com/dk0d/shki
cd shki
cargo build

Dev tooling is driven by Task:

task tools:install   # cargo-nextest, bacon, cargo-dist, cargo-release, llvm-cov
task up              # start the PostgreSQL container used by integration tests
task down            # stop it and drop volumes
task test            # cargo nextest run
task test:cov:html   # coverage report in the browser

Tests

cargo nextest run                       # everything
cargo nextest run --test integration    # CLI/end-to-end behavior
cargo nextest run --test querygen       # typed query generation

Query codegen fixtures live in tests/fixtures/querygen/<case>/. Each queries.sql keeps a -- ```rust expectation block immediately above its query annotation; the default fixture test compares that exact function output and parses the generated module:

cargo nextest run --test querygen -E 'test(generated_query_code_is_valid_rust)'

The slower Cargo type-check is ignored by default:

cargo nextest run --test querygen -E 'test(generated_query_code_compiles)' --run-ignored ignored-only

Design decisions

Architecture decision records live in docs/adr/ — start there before reworking a subsystem.

Docs site

This site is an Astro Starlight project under docs-site/, deployed to GitHub Pages on every push to main that touches it.

cd docs-site
bun install
bun run dev      # local preview
bun run build    # what CI runs

Pages are Markdown under docs-site/src/content/docs/; the sidebar is defined in docs-site/astro.config.mjs.