Claude/evaluate monorepo structure l lwpe#100
Merged
Conversation
We re-monorepo'd in 2026-05 (PR #25) only to host the dashboard UI's Vite build alongside the runner; once the dashboard was deleted the monorepo lost its reason to exist and we flattened back. This doc audits the current shape, looks at four restructuring options, and recommends staying flat — the seven src/ subdirs already form a clean DAG and per-file module docs cover discoverability. Concrete follow-ups proposed (not done here): codify the boundaries as an oxlint no-restricted-imports rule (the code already respects every edge), delete the untracked apps/ + packages/ debris dirs, and note the decision in CLAUDE.md so the next agent doesn't re-litigate.
`patterns.md` is the inverse of `comparison.md` (which lists gaps): subsystem-by-subsystem tables of what we deliberately inherited from Turbo or Nx, every row anchored to a source-file citation. `grep -rn "Turbo\|Nx parity\|turborepo" src/` returns ~20 explicit parity comments — the doc indexes each one so a reader can audit "is this really how Turbo does it" without a tour. `benchmarks.md` captures the latest 100-project × 3-task numbers: vx adds 2.95 s of overhead vs raw shell on cold runs and 159 ms on full restore, against Turbo's 11.38 s / 589 ms and Nx's 20.62 s / 858 ms. Includes a per-task overhead breakdown, a "why it's fast" section pointing at the architectural choices that move the needle (no daemon, xxHash3, hardlink restore, in-process tar parser, Bun I/O), and a headroom section listing the next things worth profiling. README index gains two rows for the new pages.
PR #100's CI failed on format-check because the new docs (patterns.md, benchmarks.md) used inconsistent column padding in markdown tables. PR #96 / #97's monorepo-structure.md regressed the same way. `bun src/bin.ts run format` rewrites all three to oxfmt's canonical table alignment. No content changes.
Exelord
pushed a commit
that referenced
this pull request
May 17, 2026
PR #100's CI failed on format-check because the new docs (patterns.md, benchmarks.md) used inconsistent column padding in markdown tables. PR #96 / #97's monorepo-structure.md regressed the same way. `bun src/bin.ts run format` rewrites all three to oxfmt's canonical table alignment. No content changes.
4 tasks
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
No description provided.