Skip to content

CLAUDE.md

Latest commit

 

History

History
37 lines (29 loc) · 1.48 KB

CLAUDE.md

File metadata and controls

37 lines (29 loc) · 1.48 KB
Raw

quire-cli

Static binary CLI wrapping quire-rs (render, parse, extract, validate).

Commands

make fmt            # format with rustfmt
make fmt-check      # verify formatting (CI gate)
make lint           # clippy with -D warnings
make test           # cargo test
make build          # release build
make clean          # cargo clean
make deny           # cargo deny check licenses
make audit-unsafe   # check that every unsafe block has a // SAFETY: comment
make ci             # fmt-check + lint + test + deny + audit-unsafe

Safety scaffolding

Backported from agent-ix/ecaz:

  • clippy.toml pins MSRV to 1.75 and caps cognitive complexity / arg count
  • deny.toml allow-lists licenses and denies unknown registries/git sources
  • scripts/check_unsafe_comments.sh runs in CI and locally via make audit-unsafe. Every unsafe { block must have a // SAFETY: comment within the 3 preceding lines, or be listed in scripts/unsafe_comment_baseline.txt. Update the baseline with bash scripts/check_unsafe_comments.sh --update-baseline.
  • rustfmt.toml uses 100-char width and StdExternalCrate import grouping. CI fails on drift.
  • rust-toolchain.toml pins to stable + rustfmt + clippy.

Layout

src/lib.rs             # crate root
tests/integration.rs   # end-to-end tests
benches/               # criterion benchmarks (opt-in; add criterion to dev-deps)
spec/                  # requirements artifacts (from /spec-create-spec)
scripts/               # local tooling