Struct CompilerPackage 

pub struct CompilerPackage {

    pub schema: String,
    pub schema_version: String,
    pub producer: Producer,
    pub package_id: Option<String>,
    pub created_at: Option<String>,
    pub model_kind: ModelKind,
    pub model: ModelPayload,
    pub origin: Origin,
    pub sources: Vec<SourceDescriptor>,
    pub source_maps: Vec<SourceMapEntry>,
    pub diagnostics: Vec<StructuredDiagnostic>,
    pub validation: ValidationSummary,
    pub summary: ObjectSummary,
    pub lowering_history: Vec<LoweringRecord>,
    pub derived: DerivedMetadata,
}

The compiler package: a versioned envelope around one IR payload plus the provenance, diagnostics, validation, and lowering history that make the artifact trustworthy. Serializes to .pio.json.

model_kind is stored explicitly and is authoritative; the payload is also self-describing (tagged by kind). CompilerPackage::kind_is_consistent asserts the two agree. Unknown future top-level fields are tolerated on read (ignored) so a newer producer’s package still deserializes here.

Fields

schema: String

The schema URL identifying this package format.

schema_version: String

The package schema version (semver).

producer: Producer

package_id: Option<String>

Stable content id, e.g. "sha256:...". The scaffold leaves it None.

created_at: Option<String>

RFC 3339 build timestamp. Left None by default for deterministic, round-trip-stable output; set explicitly when a timestamp is wanted.

model_kind: ModelKind

Explicit model kind. Authoritative; never inferred from field presence.

model: ModelPayload

origin: Origin

sources: Vec<SourceDescriptor>

source_maps: Vec<SourceMapEntry>

diagnostics: Vec<StructuredDiagnostic>

validation: ValidationSummary

summary: ObjectSummary

lowering_history: Vec<LoweringRecord>

derived: DerivedMetadata

Implementations

impl CompilerPackage

pub fn from_balanced(net: BalancedNetwork) -> Self

Wrap a balanced network. Origin is inferred from its source format: InMemory / Derived (normalized) / File (a parsed text format, recording whether source was retained; the path is not captured here).

pub fn from_multiconductor(net: MulticonductorNetwork) -> Self

Wrap a multiconductor network. Parse warnings are lifted into structured diagnostics, and defaulted fields are lifted into source maps with mapping_kind = defaulted, so the package surfaces that provenance even though those parser-side fields are not part of the IR payload.

pub fn model_kind(&self) -> ModelKind

The explicit model kind.

pub fn kind_is_consistent(&self) -> bool

Whether the explicit model_kind agrees with the payload variant. A reader should reject a package where this is false.

pub fn as_balanced(&self) -> Option<&BalancedNetwork>

The balanced payload, if this package carries one.

pub fn as_multiconductor(&self) -> Option<&MulticonductorNetwork>

The multiconductor payload, if this package carries one.

pub fn to_json(&self) -> Result<String>

Serialize to compact .pio.json.

pub fn to_json_pretty(&self) -> Result<String>

Serialize to pretty .pio.json.

pub fn from_json(text: &str) -> Result<Self>

Deserialize from .pio.json.

pub fn supports_schema_version(version: &str) -> bool

Whether this reader accepts the envelope schema version.

The .pio.json compatibility contract is envelope scoped: unknown future top-level fields are ignored, additive same major versions load, and a different major version is rejected before payload use.

pub fn with_origin(self, origin: Origin) -> Self

pub fn with_package_id(self, id: impl Into<String>) -> Self

pub fn with_created_at(self, created_at: impl Into<String>) -> Self

pub fn with_sources(self, sources: Vec<SourceDescriptor>) -> Self

pub fn with_source_maps(self, source_maps: Vec<SourceMapEntry>) -> Self

pub fn push_lowering(&mut self, record: LoweringRecord)

Append a lowering record to the history.

pub fn attach_normalized_solver_table_metadata(&mut self) -> Result<bool, Error>

Attach compact metadata for the normalized dense solver table lowering.

Returns Ok(false) for non-balanced packages. The full table rows stay outside the package payload; this records the pass name, row counts, units, dense identities, and source row provenance a compiler cache needs to validate external table artifacts.

pub fn with_normalized_solver_table_metadata(self) -> Result<Self, Error>

Return a package with normalized solver table metadata attached.

pub fn check_multiconductor_to_balanced_lowering( &self, ) -> Option<MulticonductorToBalancedReadiness>

Check whether this package’s multiconductor payload is ready for the explicit multiconductor to balanced lowering pass.

pub fn lower_multiconductor_to_balanced( &self, options: MulticonductorToBalancedOptions, ) -> Result<Self, MulticonductorToBalancedError>

Explicitly lower a multiconductor package to a derived balanced package.

This method only accepts packages whose payload is ModelKind::Multiconductor. It does not mutate the input package.

pub fn run_sane_validation(&mut self)

Run the package semantic validation profile and record its findings.

This pass is non mutating: it reports structural and semantic issues in diagnostics and validation.passes, but it never repairs or rewrites the payload.

Trait Implementations

impl Clone for CompilerPackage

fn clone(&self) -> CompilerPackage

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for CompilerPackage

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for CompilerPackage

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for CompilerPackage

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.