# Pent House
[](https://docs.rs/pent_house)
Pent House extends the [`power_house`](https://crates.io/crates/power_house)
toolkit with a reproducible resonance ledger. The crate exposes deterministic
engines for generating proof-backed “resonance shards”, validating them, and
aggregating results into an auditable summary. It retains the zero-dependency
footprint of `power_house` while providing a higher-level integration surface.
## Features
- Deterministic shard generation via `ResonanceEngine`, combining a Power-House
`SumClaim` with transcript-driven orbit traces and quorum silhouettes.
- Validation logic that replays every stimulus, re-checks the embedded proof,
and confirms consensus thresholds before accepting data.
- `ResonanceLedger` for storing validated shards and synthesising aggregate
confidence metrics suitable for downstream audit or analytics pipelines.
## Usage example
```rust
use pent_house::{ResonanceEngine, ResonanceLedger};
let engine = ResonanceEngine::new(1_000_000_007, 12, 9);
let shard = engine.observe("aurora-seed", 4242);
let mut ledger = ResonanceLedger::new(engine.clone());
let report = ledger.ingest(shard.clone()).expect("shard should verify");
println!("energy={}, confidence={}", report.energy, report.confidence);
println!("ledger summary = {:?}", ledger.synthesise());
```
## Project structure
- `src/lib.rs` – library source containing the engine, ledger, and validation
primitives with inline documentation.
- `Cargo.toml` – crate manifest and publish metadata.
- `README.md` – this overview.
- `LICENSE` – Pent House Commercial License terms.
- `docs/LICENSING.md` – detailed guidance for commercial customers.
- Online API reference is published at [`docs.rs/pent_house`](https://docs.rs/pent_house).
## Testing
Pent House ships with unit tests covering shard creation, validation, and
tamper detection. Run `cargo test` to execute the suite.
## License and contact
Pent House is distributed under the proprietary Pent House Commercial License.
Obtain a paid license by contacting lexluger.dev@proton.me before deploying or
redistributing the software. See `LICENSE` and `docs/LICENSING.md` for details.