Skip to content

Step library release 1: fix certified-step defects, make certificatio… - #59

Merged
NGrech merged 1 commit into
mainfrom
feature/step-lib
Sep 2, 2026
Merged

NGrech merged 1 commit into
mainfrom
feature/step-lib

Conversation

@NGrech

@NGrech NGrech commented Sep 2, 2026

Copy link
Copy Markdown
Collaborator

…n honest

Five certified steps carried real defects, and the reviewed badge asserted something nothing backed. This fixes both and completes the core step set.

Step defects
Fixed five defects in steps already published as certified. All were found while writing each README to the standard template: stating every computed field as an equation, and naming the provenance of every threshold, forced questions that code review had skipped.

Certification levels
reviewed now means a named person approved the pull request that last changed the step. Split into two levels so the automated gate has its own word — gated passes every conformance check, reviewed is gated plus human approval. Method provenance moved from README prose into method.citation, so the machine-readable half agrees with the human half.

Step set
Completed the remaining core utilities. Aligned which options a researcher may configure across steps, and fixed field names that did not survive a change of time grid.

Packaging
No Python environment ships in the built jar — jvmProcessResources excludes in both the demo and steps modules, mirroring StepContentHash.TRANSIENT: what is not part of a step's identity is not part of its package. Committed scripts/eval/pixi.lock; the manifest pins nothing, so the lock is the only record of the resolved environment.

Verification
All 12 steps assert test_reproduces_the_reference_fixture, each checked by perturbing a fixture value and confirming the test fails. Added and registered library-minimal and library-anomaly so run-all-demos covers all three v2 workflows; verified green against real data.

…n honest

Five certified steps carried real defects, and the `reviewed` badge asserted
something nothing backed. This fixes both and completes the core step set.

Step defects
Fixed five defects in steps already published as certified. All were found
while writing each README to the standard template: stating every computed
field as an equation, and naming the provenance of every threshold, forced
questions that code review had skipped.

Certification levels
`reviewed` now means a named person approved the pull request that last
changed the step. Split into two levels so the automated gate has its own
word — `gated` passes every conformance check, `reviewed` is gated plus human
approval. Method provenance moved from README prose into `method.citation`,
so the machine-readable half agrees with the human half.

Step set
Completed the remaining core utilities. Aligned which options a researcher may
configure across steps, and fixed field names that did not survive a change of
time grid.

Packaging
No Python environment ships in the built jar — `jvmProcessResources` excludes
in both the demo and steps modules, mirroring `StepContentHash.TRANSIENT`:
what is not part of a step's identity is not part of its package. Committed
`scripts/eval/pixi.lock`; the manifest pins nothing, so the lock is the only
record of the resolved environment.

Verification
All 12 steps assert `test_reproduces_the_reference_fixture`, each checked by
perturbing a fixture value and confirming the test fails. Added and registered
`library-minimal` and `library-anomaly` so `run-all-demos` covers all three v2
workflows; verified green against real data.
@NGrech NGrech self-assigned this Sep 2, 2026
@github-actions

github-actions Bot commented Sep 2, 2026

Copy link
Copy Markdown

📊 Coverage Report

Coverage reports have been generated and uploaded to Codecov.

Quick Stats

The coverage report will be available once processing completes on Codecov.

@NGrech
NGrech merged commit b979f93 into main Sep 2, 2026
3 checks passed
@codecov

codecov Bot commented Sep 2, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 80.15%. Comparing base (94ea6f5) to head (b5c52d4).
⚠️ Report is 2 commits behind head on main.

Additional details and impacted files

Impacted file tree graph

@@            Coverage Diff             @@
##             main      #59      +/-   ##
==========================================
- Coverage   81.89%   80.15%   -1.75%     
==========================================
  Files          79       91      +12     
  Lines        3330     3688     +358     
  Branches      569      667      +98     
==========================================
+ Hits         2727     2956     +229     
- Misses        392      466      +74     
- Partials      211      266      +55     

see 31 files with indirect coverage changes

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant