Repository navigation
Releases
Helena Framework 0.21.1-alpha
A fix release over v0.21.0-alpha. Nothing in the interface changed.
A certified surface's QC job was stranded
enqueue_imported_surface_qc read the geometry verdict from the payload it was handed.
An import's payload never carries one, so it fell back to the unmeasured default and
created the QC job in WAITING_GEOMETRY.
That is the right answer for a surface nobody has measured, and the wrong one for a
surface already certified. The promotion out of waiting runs at certification — so
certifying a surface and then enqueuing its job left the job waiting for a verdict
that had already come and gone. The surface's own row held the answer the whole time.
Both the PostgreSQL and SQLite stores had it, and both are fixed: a verdict already
recorded against the surface now outranks the default.
The same call reported a state it had not written
It answered "qc_state": "PENDING" regardless of what it inserted, so a caller was told
a job was claimable while the row said WAITING_GEOMETRY. It now reports what it wrote.
An assertion one function below already forbade a hardcoded PENDING on this path. It
looked for the single-quoted SQL literal; the value was double-quoted. It had passed for
three commits.
Why now
The database tests had never run — not in this project's CI, not locally — because they
skip without HELENA_TEST_DSN, and nothing set one. Giving them a database ran them for
the first time and five failed. Two were the bugs above. Three were the tests' own: a
helper created a task and then claimed whatever the queue held, which in a shared
database was another test's.
The two new regression tests exercise the store rather than reading its source.
Alpha. 1829 tests, coverage 65%.
Helena Framework 0.21.0-alpha
A scroll is one sheet wound outward. Two laminae cannot occupy the same place, and
along any ray the wraps appear in radial order. That is a statement about a pair
of surfaces, which certification of each one separately structurally cannot reach.
The winding invariant
framework/contracts/winding.py reduces a surface to where it sits in the roll —
a median radius, angle and height about the fitted scroll axis — and answers whether
two surfaces can both be laminae of the same roll.
Calibrated on 37 reconstructed wraps of PHerc826 before it was written:
| measured | |
|---|---|
| fitted radius against wrap number | Spearman ρ +0.9993, 35/36 monotone |
| spacing between consecutive wraps | 17 voxels = 0.14 mm, which is papyrus |
| comparable pairs behaving, of 666 | 664 |
The wrap numbers come from the reconstruction, not from geometry, so they are a label
to test against rather than an input. Nothing put sheet thickness into the calculation;
it came out of it.
The check returns WINDING_UNDETERMINED rather than a boolean below three voxels of
separation, because at that distance the ordering is not in the data — on ground truth
it inverted on 35–43% of rays there, and 95–99.6% correct where wraps are 15–25 voxels
apart. Reporting confidently in the ambiguous band would be inventing.
It is deliberately not a gate. It answers a different question from geometry
certification, CT support, model response and human review, so it stands beside them as
a fifth judgement rather than a veto over any of them.
The P8 merge looks at pairs it was not told about
The seam check only ever iterated the edges it was handed, so a collision between two
surfaces nobody declared adjacent passed unseen. COLLISION_QC.json now reports every
pair that meets, declared or not.
Segmentation can grow m7's alternatives
A run that took only the top proposal was discarding candidates that turned out to be
different wraps — m7's second choice differed in seven of eight comparable pairs, five
of them within a hair of that same 0.14 mm spacing. candidate_rank and
reconsider_covered make those reachable, and the seed probe now reaches twenty
candidates where it stopped at three.
Deployment
HELENA_REGISTRY no longer carries an address. Unset, containers/deploy-platform.sh
builds the panel from the checkout; a deployment that wants image pulls names its own
registry.
Alpha. The winding invariant reports evidence and nothing gates on it yet.