Skip to content

docs(board): post-merge governance for #459 (helix PR_ARC + LATEST_STATE table row)#460

Merged
AdaWorldAPI merged 1 commit into
mainfrom
claude/gallant-rubin-Y9pQd
Jun 4, 2026
Merged

docs(board): post-merge governance for #459 (helix PR_ARC + LATEST_STATE table row)#460
AdaWorldAPI merged 1 commit into
mainfrom
claude/gallant-rubin-Y9pQd

Conversation

@AdaWorldAPI

@AdaWorldAPI AdaWorldAPI commented Jun 4, 2026

Copy link
Copy Markdown
Owner

Post-merge board-hygiene follow-up for the merged helix PR (#459, merge ef35ff1) — the two PR-number-specific entries that can only be added once the PR has a number + merge commit:

The in-commit board updates (LATEST_STATE blockquote, STATUS_BOARD D-HELIX-1, EPIPHANIES E-HELIX-OVERLAP, TECH_DEBT TD-HELIX-OVERLAP-1, AGENT_LOG) already landed with #459. Docs-only — no code changes.

https://claude.ai/code/session_013rjF2Dvo1DnBACpbpYSffE


Generated by Claude Code

Summary by CodeRabbit

  • Documentation
    • Updated internal project tracking documentation to record completion of architectural codec work.

Note: This release contains only internal documentation updates with no user-facing feature changes.

Board-hygiene follow-up for the merged helix PR (#459, merge ef35ff1):
the PR-number-specific entries that can only be added once the PR has a
number and a merge commit.

- PR_ARC_INVENTORY: prepend the #459 arc entry (Added/Locked/Deferred/
  Docs/Confidence) for crates/helix.
- LATEST_STATE: add the #459 row to the "Recently Shipped PRs" table.

The in-commit board updates (LATEST_STATE blockquote, STATUS_BOARD
D-HELIX-1, EPIPHANIES E-HELIX-OVERLAP, TECH_DEBT TD-HELIX-OVERLAP-1,
AGENT_LOG) already landed with #459.

https://claude.ai/code/session_013rjF2Dvo1DnBACpbpYSffE

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 715dc0e999

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".


**Added:**
- `crates/helix` (NEW standalone crate, zero-dep default, `edition 2021`, empty `[workspace]`, root `Cargo.toml` `exclude`) — the Place/Residue codec from `crates/helix/KNOWLEDGE.md`. Modules: `constants` (φ/γ/e + M=17/stride=4/ln 17), `placement` (`HemispherePoint::lift` — √u equal-area hemisphere), `curve_ruler` (`CurveRuler` — stride-4-over-17 arc from the HHTL place offset), `fisher_z` (`Similarity::{fisher_z,hyperbolic_depth}` — arctanh), `quantize` (`RollingFloor` — 256-palette, occupancy-drift + floor-version stamp), `distance` (`DistanceLut` — metric-safe 256×256 L1), `residue` (`ResidueEncoder::encode → ResidueEdge` 3-byte endpoint pair; `distance_adaptive` metric-safe / `distance_heuristic` non-metric), `prove` (2-D discrepancy companion to `jc::weyl`), `simd` (optional `ndarray-hpc` batch Fisher-Z via `ndarray::simd::simd_ln_f32`).
- `ndarray-hpc` feature (optional `dep:ndarray` → the AdaWorldAPI fork at `../../../ndarray`; the default build needs none of it).

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Avoid claiming the default build needs no ndarray checkout

In a clean checkout where the sibling ../../../ndarray repo is absent, the documented default command still fails before feature selection because Cargo loads the optional path dependency manifest (failed to read /workspace/ndarray/Cargo.toml). This makes the new PR arc misleading for anyone trying to reproduce the stated zero-dep/default validation without the update-script-provided sibling checkout; either the doc should state that the checkout is still required for manifest resolution, or the dependency wiring needs to avoid a mandatory local path.

Useful? React with 👍 / 👎.

@coderabbitai

coderabbitai Bot commented Jun 4, 2026

Copy link
Copy Markdown

Review Change Stack

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: 7d4ed232-8519-47e6-856a-870ec7820b1d

📥 Commits

Reviewing files that changed from the base of the PR and between ef35ff1 and 715dc0e.

📒 Files selected for processing (2)
  • .claude/board/LATEST_STATE.md
  • .claude/board/PR_ARC_INVENTORY.md

📝 Walkthrough

Walkthrough

This PR updates two board-level documentation files to record the completion of PR #459 (helix-place-residue-codec). A one-line entry is added to the recently shipped PRs table in LATEST_STATE.md, and a detailed 25-line inventory entry is added to PR_ARC_INVENTORY.md documenting the merged work's scope, architectural changes, and pre-merge test coverage.

Changes

PR #459 Completion Documentation

Layer / File(s) Summary
Document PR #459 completion in board tracking
.claude/board/LATEST_STATE.md, .claude/board/PR_ARC_INVENTORY.md
LATEST_STATE.md recently shipped table extended with PR #459 row describing the crates/helix Place/Residue codec pipeline and feature gating. PR_ARC_INVENTORY.md updated with full PR #459 entry including Added/Locked/Deferred/Docs subsections and confidence tracking note.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

Poem

🐰 A spiral gleams, so golden bright,
The helix codec takes its flight,
Board and inventory logged with care,
PR #459 sails through the air!

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title accurately describes the main change: it's a post-merge documentation update adding board entries for PR #459, specifically the PR_ARC_INVENTORY and LATEST_STATE table row updates.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch claude/gallant-rubin-Y9pQd

Comment @coderabbitai help to get the list of available commands and usage tips.

@AdaWorldAPI AdaWorldAPI merged commit 4132e77 into main Jun 4, 2026
1 check passed
AdaWorldAPI pushed a commit that referenced this pull request Jun 4, 2026
…ray is mandatory")

Two converging directives:

1. codex P2 (#460): an optional `path` dependency does not make the default
   build self-contained — Cargo reads every dependency manifest (incl. optional)
   during resolution, so `ndarray = { path = "../../../ndarray", optional = true }`
   makes a clean checkout without the sibling fail before feature selection. The
   "default build needs no ndarray checkout" claim was false.
2. Directive: "ndarray is mandatory for lance-graph" (it is The Foundation).

Fix: ndarray is now a mandatory, non-optional GIT dependency:
  ndarray = { git = "https://github.com/AdaWorldAPI/ndarray.git",
              branch = "master", default-features = false, features = ["std"] }

- git source resolves the manifest remotely (no sibling checkout needed);
- non-optional, so the `ndarray-hpc` feature is removed;
- src/simd.rs is now single-impl (always ndarray::simd, no scalar fallback;
  ndarray does its own AVX-512/AVX2/scalar dispatch internally).

No import cycle: helix is standalone (own [workspace] + root exclude) and the
fork is self-contained (only internal subcrate path deps, no lance-graph
back-dependency). [patch] is the wrong tool here (the workspace's
[patch.crates-io] ndarray is separately ineffective: 0.17.2 can't satisfy the
lance-index crates.io 0.16.1).

Verified: 63 unit + 6 doctests green, clippy -D warnings + fmt clean (git source
patched to the local master checkout for the in-sandbox build; github fetch is
validated by CI).

Board: PR_ARC #459 Correction + E-HELIX-NDARRAY-MANDATORY + LATEST_STATE +
STATUS_BOARD D-HELIX-1.

https://claude.ai/code/session_013rjF2Dvo1DnBACpbpYSffE
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.

2 participants