Expand description
Pure-Rust analysis core for pounce-studio.
Loads pounce.solve-report/v1 JSON (see
crates/pounce-cli/src/solve_report.rs for the writer) and parses
POUNCEIT v1 binary iter-dumps (see tools/iter-dump/FORMAT.md),
then exposes derived series: convergence-stall detection, restoration
window extraction, common-failure-mode diagnostics, side-by-side
comparisons, and a Markdown summary renderer.
The library is intentionally WASM-clean: it takes byte slices and
returns owned data, never touching std::fs. The bundled
pounce-studio binary in src/bin/ is the file-I/O front-end.
§Versioning
The JSON schema is pinned to SOLVE_REPORT_SCHEMA; loading any
other tag is rejected with Error::SchemaMismatch. The binary
format is pinned to iter_dump::FORMAT_VERSION. Both can be
widened additively (new optional fields) without bumping; breaking
changes bump the major version and add a new branch here.
Re-exports§
pub use analysis::compare_runs;pub use analysis::convergence_trace;pub use analysis::diagnose;pub use analysis::find_stalls;pub use analysis::get_iterate;pub use analysis::restoration_windows;pub use analysis::summarize;pub use analysis::Finding;pub use analysis::Severity;pub use analysis::Stall;pub use analysis::Summary;pub use iter_dump::IterDumpHeader;pub use iter_dump::IterDumpRecord;pub use iter_dump::IterDumpTrace;pub use report::Error;pub use report::IterRecord;pub use report::SolveReport;pub use report::SOLVE_REPORT_SCHEMA;
Modules§
- analysis
- Derived series and diagnostics over a
SolveReport. - glossary
- Static glossary for solve-report column names, diagnose finding codes,
and citation metadata. Backs the
explainandcitationsCLI tools. - iter_
dump - POUNCEIT v1 binary iter-dump parser.
- markdown
- Markdown renderer for solve-report summaries.
- preflight
- Pre-flight problem inspection: builtin metadata, AMPL
.nlheader parsing, GAMS.gmsheader / Solve-directive parsing, and.lstSOLVE SUMMARY extraction. - report
pounce.solve-report/v1JSON types.