Skip to content

chore: add vendored reference repo subtree sync tooling#2902

Merged
juliusmarminge merged 5 commits into
mainfrom
codex/reference-repo-subtree-sync
Jun 2, 2026
Merged

chore: add vendored reference repo subtree sync tooling#2902
juliusmarminge merged 5 commits into
mainfrom
codex/reference-repo-subtree-sync

Conversation

@juliusmarminge
Copy link
Copy Markdown
Member

@juliusmarminge juliusmarminge commented Jun 2, 2026

Summary

  • add generic bun run sync:repos tooling for vendored reference repositories
  • vendor the matching effect-smol source subtree for the workspace Effect dependency
  • exclude .repos/ from project formatting and linting
  • document that dependency updates must sync configured subtrees in the same change

Verification

  • bun fmt
  • bun fmt:check
  • bun lint
  • bun run test from scripts/
  • bun run sync:repos --repo effect-smol --dry-run
  • bun typecheck (blocked by pre-existing origin/main desktop errors: main imports removed Effect 4 subpaths such as effect/Context)

Open in Devin Review

Note

Low Risk
Mostly vendored reference content and dev-only sync scripts; main risk is repo size and keeping .repos in sync when Effect versions change, not runtime behavior changes.

Overview
This PR introduces vendored reference repositories under .repos/, starting with effect-smol aligned to the workspace Effect catalog version (effect@4.0.0-beta.73 via bun run sync:repos). The checked-in tree is upstream reference material (changesets, CI workflows, agent skills, patterns, specs)—not t3code application logic.

Tooling: Root sync:repos (scripts/sync-reference-repos.ts) plans git subtree add/pull per scripts/lib/reference-repos.ts (ref from catalog version or --latest / --dry-run / --repo).

Hygiene: .oxfmtrc.json and .oxlintrc.json add .repos/** to ignore patterns so format/lint stay scoped to the monorepo.

When bumping Effect catalog versions, run sync and commit the matching subtree in the same change (per PR verification notes).

Reviewed by Cursor Bugbot for commit d956211. Bugbot is set up for automated code reviews on this repo. Configure here.

Note

Add vendored subtree sync tooling and scripts for the effect-smol reference repo

  • Adds scripts/sync-reference-repos.ts and scripts/lib/reference-repos.ts to plan and execute git subtree add/pull for the effect-smol reference repository, resolving the concrete ref from either latest (branch) or a version in a local package.json.
  • Adds a pnpm sync:repos script in package.json that invokes the sync tool, and extends .oxfmtrc.json and .oxlintrc.json to cover .repos/**.
  • The PR also vendors a large snapshot of the effect-smol monorepo under .repos/effect-smol/, including source files, tests, CI workflows, tooling packages, and SQL/AI/platform adapters; these files represent the synced reference content rather than net-new local development.
  • Risk: the .repos/effect-smol/ subtree is large and will grow on every sync; reviewers should verify .gitignore and formatter/linter scope settings are appropriate before merging.

Macroscope summarized d956211.

juliusmarminge and others added 5 commits June 1, 2026 21:31
Co-authored-by: codex <codex@users.noreply.github.com>
git-subtree-dir: .repos/effect-smol
git-subtree-split: 0de3cc2a2d51e98345f4bd37b649ecea3d90b51e
Co-authored-by: codex <codex@users.noreply.github.com>
Co-authored-by: codex <codex@users.noreply.github.com>
@coderabbitai
Copy link
Copy Markdown

coderabbitai Bot commented Jun 2, 2026

Important

Review skipped

Auto reviews are disabled on this repository. 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: Repository UI

Review profile: CHILL

Plan: Pro

Run ID: 3431497a-c820-4568-b15b-42164db5ed00

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
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch codex/reference-repo-subtree-sync

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

@github-actions github-actions Bot added size:XXL 1,000+ changed lines (additions + deletions). vouch:trusted PR author is trusted by repo permissions or the VOUCHED list. labels Jun 2, 2026
@juliusmarminge juliusmarminge marked this pull request as ready for review June 2, 2026 04:37
@macroscopeapp
Copy link
Copy Markdown
Contributor

macroscopeapp Bot commented Jun 2, 2026

Approvability

Verdict: Needs human review

Diff is too large for automated approval analysis. A human reviewer should evaluate this PR.

You can customize Macroscope's approvability policy. Learn more.

@juliusmarminge juliusmarminge merged commit e3f1405 into main Jun 2, 2026
18 checks passed
@juliusmarminge juliusmarminge deleted the codex/reference-repo-subtree-sync branch June 2, 2026 04:44
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

size:XXL 1,000+ changed lines (additions + deletions). vouch:trusted PR author is trusted by repo permissions or the VOUCHED list.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant