keisei/KeiSeiKit-1.0
2
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
KeiSeiKit-1.0/_blocks/stack-rust-cli.md
Parfii-bot 0be354a920 KeiSeiKit-public — clean state 
Single-commit clean baseline after security scrub of niche-tells,
project codenames, internal jargon, and contributor-email leaks.

Contents:
- 100 Rust crates (_primitives/_rust/)
- 37 agent manifests (_manifests/) + generated specs (_generated/)
- 67 user-invocable skills (skills/)
- 33 hooks (hooks/)
- Composition blocks (_blocks/)
- Documentation (docs/, README.md)
- TS adapter packages (_ts_packages/)
- Assembler (_assembler/)
- Roles (_roles/)
- Templates (_templates/)
- Forgejo CI (.forgejo/)

Author: Denis Parfionovich <info@greendragon.info>

License: see LICENSE.
2026-05-01 12:09:03 +08:00

1.2 KiB
Raw Blame History

STACK — Rust CLI / tooling

Cargo workspace. Default language — no language justification needed.

Layout:

  • Workspace root Cargo.toml declares members = [...]; one crate per cube.
  • Binaries under <crate>/src/bin/*.rs; library root <crate>/src/lib.rs.
  • Integration tests in <crate>/tests/*.rs; unit tests inline with #[cfg(test)].

Hard invariants:

  • File > 200 LOC → split (Constructor Pattern). Function > 30 LOC → split.
  • clippy::pedantic in CI; warnings = errors on main.
  • thiserror for library error enums, anyhow::Result for binaries only. Never Box<dyn Error> in new code.
  • NO .unwrap() / .expect() in prod paths. Allowed in tests and one-shot scripts flagged // SCRIPT.
  • Benchmarks live under benches/ with cargo bench (Criterion) and the documented number is ALWAYS from cargo test --release / cargo bench — never debug timings.

CI gate:

cargo fmt --check && cargo clippy --all-targets -- -D warnings && cargo test --release

Pre-commit: cargo fmt && cargo clippy --fix --allow-dirty && cargo test.

Forbidden: Rc<RefCell<...>> in hot paths (use &mut or Arc<Mutex<_>>); unsafe without a // SAFETY: comment explaining the invariant; panic-on-parse in library crates.