git clone https://github.com/N4M3Z/forge-cli.git
cd forge-cli
make build
make testSee README.md for build targets. Run a single test:
cargo test -- test_nameRead docs/decisions/ for the full ADR collection. Key decisions:
- ASSEMBLY-0004 — two-stage pipeline (assemble → deploy) with intermediate build/
- ASSEMBLY-0002 — SLSA/in-toto provenance sidecars
- ASSEMBLY-0003 — deployment manifest (.manifest at target)
- CLI-0006 — INSTALL.md following Mintlify standard
The README has a pipeline diagram.
- 4-space indentation everywhere
- No tab characters
cargo fmt+cargo clippy -- -D warningsbefore committingResult<T, String>for error handling, no anyhow/thiserror#[forbid(unsafe_code)]- Clippy pedantic enabled
- Fixtures in
tests/fixtures/, loaded viainclude_str! - Test files as siblings:
mod.rs+tests.rs
Conventional Commits: type: description. Lowercase, no trailing period, no scope.
Types: feat, fix, docs, chore, refactor, test.
- Fork and create a branch
- Make changes following the conventions above
make test- Open a PR against
main
CI runs prek (linting, formatting, tests) and cargo test on every PR. The main branch requires passing CI and one approval before merge.