docs(v3): Fisher-z analytic codec ruled THE canonical cosine/centroid replacement; helix : Fisher-2z :: cosine-replacement : Fisher-z

[AdaWorldAPI]

Summary

Operator ruling landed on the V3 substrate (EPIPHANIES E-FISHERZ-CANONICAL-COSINE-REPLACEMENT-1 + an append-only le-contract §3 subsection):

• The canonical cosine/centroid replacement is the analytic Fisher-z codec (bgz-tensor::fisher_z::{FamilyGamma, FisherZTable} — cosine → atanh → 8-byte per-family affine → normalized i8; hydrate via tanh; certified ρ≥0.999, E-PALETTE-NNUE-COSINE-GREEN-1). A materialized k×k table is a cache of the formula, never the canon: ranking compares raw i8 (monotone), distance is |Δi8|·(z_range/254), an L4 ClassView may declare an analytic codebook with zero table materialization. i8 SIMD synergy at 4× f32 density; F16/F32-equivalent rank fidelity is the measured claim (reconstruction-grade beyond certified corpora stays [H]). Honest boundary preserved: this replaces the distance/rank READ, not the semiring COMPOSE.
• The ladder: helix is to Fisher-2z what the cosine-replacement is to Fisher-z — grounded in shipped, tested code, not analogy: helix pins hyperbolic_depth = 2·fisher_z at 1e-15 (crates/helix/src/fisher_z.rs:110-121) and names the Fisher-Z arctanh the residue pipeline's one transcendental (simd.rs, batch_fisher_z); Signed360 is the hemisphere-doubled register. 1z carries similarity, 2z carries hyperbolic location/depth — the same analytic-codec pattern at both rungs.
• Queued follow-up (recorded in the entry): extract the FamilyGamma contract into lance-graph-contract (BBB-safe, 2×f32 + two formulas) so L4 ClassViews, ndarray, thinking-engine lenses, and stockfish-rs speak the canon without the bgz-tensor dep; i8 SIMD kernels stay ndarray-side.

Doc-only, two files, pure prepend/append; no layout or code changed.

🤖 Generated with Claude Code

https://claude.ai/code/session_01K3RyLEbuNSHxxB3NTTrGki

---

Generated by Claude Code

Summary by CodeRabbit

• Documentation
  • Clarified the canonical analytic approach for cosine and centroid replacement using Fisher-z transformations.
  • Documented how normalized integer representations support ranking and distance calculations without requiring full table materialization.
  • Added guidance distinguishing canonical formulas from optional cached palettes.
  • Clarified the relationship between the Fisher-z and helix representations, including boundaries around composition semantics.
  • Added references for follow-up contract documentation and related certification materials.

[cursor]

Bugbot couldn't run - usage limit reached

Bugbot is counted against Cursor usage for this user or team, and this run hit a usage or spend limit.

A user or team admin can review and increase usage limits in the Cursor dashboard.

(requestId: serverGenReqId_d5737c94-1775-49cd-ba0b-9c154fea284c)

[coderabbitai]

Caution

Review failed

The pull request is closed.

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: 0136c440-8963-48f6-b2c3-afe6fe53d119

📥 Commits

Reviewing files that changed from the base of the PR and between 97033e3 and e921b7a.

📒 Files selected for processing (2)

• .claude/board/EPIPHANIES.md
• .claude/v3/soa_layout/le-contract.md

---

📝 Walkthrough

Walkthrough

Documents establish an analytic Fisher-z codec as the canonical cosine/centroid replacement, with raw i8 ranking and distance reads, optional materialized caches, defined composition boundaries, and a helix/Fisher-2z relationship.

Changes

Fisher-z replacement contract

Layer / File(s)	Summary
Canonical codec and operator boundary .claude/v3/soa_layout/le-contract.md, .claude/board/EPIPHANIES.md	Defines the cosine → atanh → affine → normalized i8 → tanh pipeline, direct ranking and distance reads, optional table caches, semiring composition boundaries, helix correspondence, and a FamilyGamma contract follow-up.

Estimated code review effort: 1 (Trivial) | ~3 minutes

Possibly related PRs

• AdaWorldAPI/lance-graph#639: Updates overlapping V3 operator-ruling content in EPIPHANIES.md.

Suggested reviewers: claude

Poem

I’m a rabbit with a Fisher-z chart,
Turning cosine paths to i8 art.
Raw reads hop, caches sleep,
Helix scales the burrow deep.
The canon stands, neat and bright!

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}