Skip to content

style(docs): deno fmt CLAUDE.md and README.md - #6

Open
thedavidmeister wants to merge 3 commits into
2026-08-21-no-vm-skip-tagged-constantsfrom
2026-08-21-denofmt-markdown
Open

style(docs): deno fmt CLAUDE.md and README.md#6
thedavidmeister wants to merge 3 commits into
2026-08-21-no-vm-skip-tagged-constantsfrom
2026-08-21-denofmt-markdown

Conversation

@thedavidmeister

@thedavidmeisterthedavidmeister commented Aug 21, 2026

Copy link
Copy Markdown
Contributor

The failure

rs-static fails, and after #3 removes the vm.skip the only thing left
failing in it is the denofmt pre-commit hook:

denofmt..................................................................Failed
- hook id: denofmt
- files were modified by this hook
/home/runner/work/rain.math.float.deploy/rain.math.float.deploy/README.md
/home/runner/work/rain.math.float.deploy/rain.math.float.deploy/CLAUDE.md
Checked 2 files

Neither file has changed since the initial commit. What changed is the hook:
on the 2026-08-20 runs denofmt reported (no files to check) Skipped, and it
now checks markdown. Both files carry hand-wrapped prose that deno fmt
reflows to its own 80-column wrap, so the hook rewrites them and the job goes
red.

The fix

deno fmt CLAUDE.md README.md, plus one wording change that is not
cosmetic.

CLAUDE.md's Rust/npm paragraph was hand-wrapped so that a line began:

+ `scripts/` + `test_js/` build the `@rainlanguage/float` npm wasm wrapper.

A + at the start of a line is a CommonMark bullet, and a bullet interrupts
an open paragraph. GitHub already renders a stray list item there today. Left
alone, deno fmt accepts that reading and rewrites the whole tail of the
paragraph as list continuation — a six-line indented bullet where prose was
intended. The sentence is instead reworded to

... `crates/float-wasm`,
`scripts/` and `test_js/` build the `@rainlanguage/float` npm wasm wrapper.

which is the meaning the + was standing in for, has no line-initial +, and
formats as one paragraph.

Every other hunk in both files is pure reflow. No claim, path, name or number
changes.

Verification

Ran deno fmt locally with deno 2.9.4 and diffed against what CI printed.
The README.md result is byte-identical to CI's — same git blob hash on both
sides (index 3e40130..abddac0), which is what establishes that the local
formatter matches the one in the job. The CLAUDE.md result differs from CI's
only in the reworded sentence and its consequence, exactly as intended.

deno fmt --check CLAUDE.md README.md then exits 0, so the hook is idempotent
on the committed text rather than merely quiet once.

QA

  • Discriminating tests: n/a — a formatting-only diff has no unit test. The
    discriminating check is the CI hook itself: deno fmt --check on these two
    files exits 1 on main (it is what turns rs-static red) and exits
    0 on this branch. Run both ways locally.
  • Mutations applied: n/a for code mutations. The one behavioural mutation
    available was applied and is the reason the reword exists: leaving the
    line-initial + in place and letting deno fmt decide produces a
    six-line bullet in place of the paragraph — the formatter's own output is the
    evidence that the source was ambiguous, and the reword is what kills it.
    Re-running deno fmt on the reworded text is a fixed point.
  • Oracle:deno fmt itself, cross-checked against CI's printed diff. The
    README blob hash matching CI's on both sides of the diff is an oracle
    independent of my local toolchain choice. For the bullet question the oracle
    is CommonMark: + opens a list item and a list item interrupts a paragraph.
  • Category check: the job reported exactly two files; both are covered.
    denofmt is now the only red hook in rs-static and this is the whole of
    it. rainix-sol / test is red for an unrelated reason — DecimalFloat is not
    deployed on chain — and is untouched here.

Scope and stacking

Deliberately separate from #3 and #5. #3 is the vm.skip removal, #5 is the
[rpc_endpoints] gap; this is a docs reflow that happens to share a job with
#3. Keeping them apart means each PR's red checks stay attributable.

Based on #3's branch, not main.rs-static runs the org
no-ignored-tests gate before pre-commit, so with #3 unmerged the job exits
at the vm.skip in 31 seconds and never reaches the denofmt hook — this PR's
fix would have been unverifiable from CI, and the red check would have read as
this PR's fault. Stacked on #3 the job runs through to the hook, so the green
here is real. GitHub will retarget this to main when #3 merges. Merge #3
first.

rainix-sol / test stays red on this branch and on every branch: DecimalFloat
has no code at its Zoltu address on any chain, which is a deploy that has not
happened, not something a PR can fix.

`rs-static` fails on the `denofmt` pre-commit hook, which now checks markdown:
both files carry hand-wrapped prose that `deno fmt` reflows.
One hunk is not cosmetic. CLAUDE.md's Rust/npm paragraph wrapped onto a line
beginning "+ `scripts/` + `test_js/` ...", and a `+ ` at the start of a line is
a CommonMark bullet, which interrupts the paragraph. GitHub already renders a
stray list item there, and `deno fmt` was going to bless that reading by
rewriting the tail of the paragraph as list continuation. The sentence is
reworded to "`crates/float-wasm`, `scripts/` and `test_js/` build ..." so it
stays one paragraph.
Everything else is reflow only; no claim changes.
@coderabbitai

coderabbitaiBot commented Aug 21, 2026

Copy link
Copy Markdown

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Organization UI

Review profile: ASSERTIVE

Plan: Pro Plus

Run ID: 621eef54-5d7d-40c5-8402-512929dd0732

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • 🔍 Trigger review

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

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

@coderabbitai

Copy link
Copy Markdown

Warning

Review limit reached

@thedavidmeister, you've reached your PR review limit, so we couldn't start this review.

Next review available in:41 minutes

Limit details: You’ve used the included review currently available.

You've used all free OSS reviews for now. Wait for the free limit to reset to keep reviewing this public repository.

How can I continue?

Wait for the limit to reset, then comment @coderabbitai review or push new commits to the PR.

An organization admin can change what happens after included review limits in Billing.

How do review limits work?

CodeRabbit enforces per-developer PR review limits within each organization.

For paid Pro and Pro+ reviews, CodeRabbit uses a developer's included PR review attempts over the past 7 days to set the current hourly allowance. At typical activity levels, the full plan allowance applies. Higher sustained activity can lower the allowance until earlier attempts leave the 7-day window.

Please refer docs for additional details.

Review details
⚙️ Run configuration

Configuration used: Organization UI

Review profile: ASSERTIVE

Plan: Pro Plus

Run ID: 26ce7f3f-8297-4995-969f-09f75bb13c3d

📥 Commits

Reviewing files that changed from the base of the PR and between f724824 and 33c335e.

📒 Files selected for processing (2)
  • CLAUDE.md
  • README.md

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

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

…markdown
Stacking this PR on #3. rs-static runs the org no-ignored-tests gate before
pre-commit, so while #3 is unmerged the job dies on its `vm.skip` and never
reaches the `denofmt` hook this PR fixes. With #3's commit underneath, the
job runs to the hook and the fix is actually exercised.
@thedavidmeister
thedavidmeister changed the base branch from main to 2026-08-21-no-vm-skip-tagged-constantsAugust 21, 2026 18:49
The Releases section claimed "The addresses already exist on-chain
(deterministic Zoltu), so the first release attests existing pins rather
than deploying fresh". That is false for the DecimalFloat half:
eth_getCode at ZOLTU_DEPLOYED_DECIMAL_FLOAT_ADDRESS
(0x799632d282178e770C7465cad54aDA1021A913D6) returns 0x on arbitrum,
base and flare. Only the log tables at 0xc51a...f5F5 are actually
deployed. It is also the same fact the five red testProdDeployment*
tests report.
Beyond being wrong today, it was a statement about deployment status
living in prose that nothing re-checks, so it could only ever go stale.
Replaced with the invariant that does hold — a Zoltu pin is derived from
bytecode, so it is fixed before any broadcast — plus a pointer to
LibDecimalFloatDeployProdTest, which is the thing that actually asserts a
chain carries the code.
deno fmt --check clean (deno 2.9.4, CI's version).
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Sign up for freeto 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

@thedavidmeister