Skip to content

FeatureGraph 0.2.0b1

Pre-release
Pre-release

Choose a tag to compare

@featuregraph featuregraph released this 03 Sep 19:39
· 36 commits to main since this release
23d79ac

First release of the compiler lineage. main shares no history with the alpha/v0.1.x and beta/v0.1.x branches, and this release is not API-compatible with any 0.1 release. The 0.1 releases remain the authority for the results they archived; nothing here regenerates them.

Added

  • compile_states, a deterministic compiler from a declarative state contract to states, occurrences with identity, and boundary events, with exclusive and exhaustive validation and structured refusals carrying a stable code and locus.
  • state-contract-v2: a derive section so a construction can carry its own rolling windows, shifts, differences and arithmetic inside the fingerprinted contract, and a missing_policy of exclude that keeps undefined edge observations outside the partition and reports them. state-contract-v1 is frozen and refuses everything v2 added.
  • Study contracts with canonical SHA-256 fingerprints, researcher approval that refuses a candidate carrying its own approval record, and load-time re-verification before execution.
  • StudyIntake, a study contract with holes in it, and the bounded conversational study builder over it, with a Cohere proposer and an offline proposer sharing one protocol.
  • The public assistant application under apps/assistant, with per-session and global call budgets.
  • featuregraph.shape: occurrence tables, rise/fall asymmetry and occurrence drift, measures that read compiled output and nothing else.
  • Dataset loaders for BIDMC (with a pinned manifest of 53 file digests, an offline mode and a shared cache), Tennessee Eastman, a synthetic pulse and a synthetic tank fill.
  • Frozen study records under artifacts/studies: the BIDMC multiscale held-out study across 53 subjects, the subject 13 multiscale case, the BIDMC object workflow, the CLaP state-object study, the PhysioNet wearable protocol and NORI interoperability studies, the Tennessee Eastman pressure transfer study and the replica mechanism fidelity study.
  • The BIDMC and Tennessee Eastman constructions expressed entirely as v2 contracts under artifacts/contracts, with scripts/verify_derived_contracts.py recording row-by-row equivalence with the published preprocess-then-compile path: 53 of 53 BIDMC subjects and 10 of 10 Fault 2 runs identical.
  • The BIDMC preprint draft and figures under artifacts/paper/master.

Changed

  • The package version is now 0.2.0b1. main had reported 0.1.0a1 since the lineages diverged, so every provenance stamp written from main before this release carries that string; treat it as "unreleased compiler lineage" rather than as the alpha.
  • CITATION.cff now names this release and the all-versions Zenodo record for the release series, to be replaced by the version DOI once minted.

Migration

There is no migration path from the 0.1 object API. A 0.1 construction is re-expressed as a state contract; the two verified contracts under artifacts/contracts are the worked examples.

Provenance

The held-out BIDMC result was reproduced byte for byte at fedf2c8, the commit immediately preceding this tag, with no source changes between them. See artifacts/studies/bidmc_multiscale_heldout/provenance.json for the commit, the software versions, and the hashes compared.