Skip to main content

Crate pounce_studio_core

Crate pounce_studio_core 

Source
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 explain and citations CLI tools.
iter_dump
POUNCEIT v1 binary iter-dump parser.
markdown
Markdown renderer for solve-report summaries.
preflight
Pre-flight problem inspection: builtin metadata, AMPL .nl header parsing, GAMS .gms header / Solve-directive parsing, and .lst SOLVE SUMMARY extraction.
report
pounce.solve-report/v1 JSON types.