| name | sheaf-enhance |
| description | Continue Stalks & Sections enhancement work from HANDOFF.md. Use when implementing views (matrix, slice, multiples, spectral), loader polish, HUD honesty, or example datasets. |
| version | 1 |
Sheaf enhance
Read HANDOFF.md before writing code. Work on branch enhancement. One concern per PR.
Invariants (stop if you break one)
- Diffuse does not increase Dirichlet energy; known stalks do not drift.
- Residual scale is diverging teal → terracotta. Size = dim. Hue = ordered level. No rainbow.
select(null) clears mobilePanel. Close / Esc / empty-plane must leave the inspector without leaving the app.- Labels:
pointer-events: none on .sheaf-html-wrap.
- Do not extend
src/lib/auth or src/lib/db.ts.
PR sequence
- Generic JSON loader + kinds/levels as data (#5, #11)
- Wire
docs/examples/discourse-triangle.json as a first-class dataset (#6)
- Kernel-dimension next to energy (#10) + Cobb energy tests in CI (#7)
- Bertin matrix view (#1)
- Small multiples + slice (#2, #4)
- Spectral layout from (L_F) (#9)
- Restriction-kind marks + label collision (#8, #3)
- Example pack: fleet, modules, KG fragment (#12)
If time for only one pair: 1 + 2.
Code map
Algebra stays in src/lib/sheaf/ and stays testable without React.
State lives only in src/store/sheaf.ts.
Every new control needs a HINTS entry in src/components/sheaf/chrome/Hint.tsx.
Definition of done (HANDOFF §10)
A stranger can drop JSON, see energy + uniqueness, switch Strata/Slice/Multiples/Matrix, name a terracotta edge in domain words, Diffuse, Close, export residuals, and do it at 390px.
