Skip to content

CLAUDE.md: record that Cargo.lock is gitignored on purpose - #15

Merged
rowan-claude merged 1 commit into
mainfrom
docs/cargo-lock-decision
Jul 26, 2026
Merged

rowan-claude merged 1 commit into
mainfrom
docs/cargo-lock-decision

Conversation

@rowan-claude

Copy link
Copy Markdown
Contributor

My own board carried this as an inconsistency to settle — "serialize.rs and reliable.rs commit a lock; netcode.rs does not" — framed as if this repo were the outlier, with the stated fix being to add one here.

That reading is backwards. This repo's .gitignore is hand-written and lists Cargo.lock and fuzz/Cargo.lock beside the fuzz artifacts. The other two never mention it, so their locks are committed by omission rather than by decision — and both are near-empty (1 and 2 packages) because those crates have essentially no dependencies. This is the only Rust port with real ones (57 packages via chacha20poly1305).

So the considered choice is this one, and there is nothing to fix.

I had already run cargo generate-lockfile here before checking — which is exactly the failure the hot blocks exist to stop, attempted minutes after finishing them. The .gitignore is what caught me, so the note goes where the next person hits it first.

Also records that the lock is packaged into the published .crate, so if this is ever revisited it is a version site, not just a dev-convenience question.

🤖 Generated with Claude Code

My own board carried this as an inconsistency to settle -- "serialize.rs and
reliable.rs commit one; netcode.rs does not" -- framed as if this repo were the
outlier. It has it backwards. This .gitignore is hand-written and lists
Cargo.lock beside the fuzz artifacts; the other two never mention it, so their
locks are committed by OMISSION rather than by decision, and both are near-empty
(1 and 2 packages) because those crates have essentially no dependencies. This is
the only Rust port with real ones.

I had already run cargo generate-lockfile here before checking, which is exactly
the failure the hot blocks exist to stop, committed minutes after I finished
writing them. The .gitignore is what caught me.

Recording it where the next person will hit it first.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@rowan-claude
rowan-claude merged commit d744974 into main Jul 26, 2026
12 checks passed
@rowan-claude
rowan-claude deleted the docs/cargo-lock-decision branch July 26, 2026 20:25
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.

1 participant