policy: Bun is tier 1, Deno is being removed — correct local CLAUDE.md - #105
Conversation
Owner ruling 2026-08-26: "deno is to go and bun is the way we are going, put it
first everywhere unless not possible and explain why if not".
This file is what an agent reads FIRST and it listed Bun as BANNED with Deno as
its replacement. Correcting hyperpolymath/standards (#655) fixes one copy of
~372 - agents read the local one. This is that local copy.
ALLOWED **Deno** "Replaces Node/npm/bun" -> **Bun** tier 1
BANNED | Bun | Deno | -> row REMOVED
BANNED Node.js / npm / pnpm/yarn -> Deno -> -> Bun
rule "No package.json for runtime deps - use deno.json imports"
-> Use package.json + bun.lock; a manifest is REQUIRED
rule "No node_modules in production"
-> bun install --production, pinned via bun.lock
pkg JS deps: Deno -> JS deps: Bun (package.json + bun.lock), bunx
WHY THE MANIFEST RULE MATTERS MOST. "No package.json for runtime deps" did not
express a preference - it told repos not to declare their dependencies at all.
hyperpolymath/ubicity imported zod and glob, shipped NO manifest of any kind,
and could not build under ANY toolchain. Fixed in ubicity#107; the rule that
caused it is fixed here.
ALSO REPAIRED - blanking scars from the ReScript purge, which substituted the
token with an EMPTY STRING rather than removing the text:
| | AffineScript | -> | ReScript | AffineScript |
1. **No new files** ... -> **No new ReScript files** ...
| **JavaScript** | Only where cannot | -> Only where AffineScript cannot
Restoring the NAME in a policy table does not reintroduce the language. Same
root cause as the rm -rf /lib found in wordpress-tools#62.
Policy text only - no code, no workflows, no build files. 1 file(s).
NOT FOLDED IN: "Fallback: Nix (flake.nix)" is stale (Guix superseded Nix per
ADR-2026-STACK-MIGRATION) but that is a separate ruling; flagged, not changed.
|
No actionable comments were generated in the recent review. 🎉 ℹ️ Recent review info⚙️ Run configurationConfiguration used: Organization UI Review profile: ASSERTIVE Plan: Pro Plus Run ID: 📒 Files selected for processing (1)
Included review availability: Your plan provides up to 1 included review per hour; 0 remain after this review. 📜 Recent review details⏰ Context from checks skipped due to timeout. (1)
🧰 Additional context used🪛 LanguageTool.claude/CLAUDE.md[misspelling] ~27-~27: Use “a” instead of ‘an’ if the following word doesn’t start with a vowel sound, e.g. ‘a sentence’, ‘a university’. (EN_A_VS_AN) [misspelling] ~27-~27: This word is normally spelled as one. (EN_COMPOUNDS_ANTI_PATTERNS) 🔇 Additional comments (4)
📝 WalkthroughSummary by CodeRabbit
WalkthroughThe project guidance changes JavaScript runtime and package-management policy from Deno to Bun. It updates approved tools, banned-tool replacements, dependency manifests, production installation, and one-off tooling instructions. ChangesBun tooling policy
Estimated code review effort: 1 (Trivial) | ~3 minutes Merge Risk: ⚪ Minimal · up to This policy-only change updates local runtime guidance without introducing a concrete correctness, security, availability, or deployment risk; no actionable merge-blocking risk remains after normal checks and review. Poem
🚥 Pre-merge checks | ✅ 5✅ Passed checks (5 passed)
Full details: Docstring CoverageExplanation No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check. Docstring coverage is scoped to functions touched by this diff. Analyzed 0 functions across 0 files. (1 skipped: 1 unsupported.) 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. Comment |
Up to standards ✅🟢 Issues
|
![codacy-production[bot]](https://avatars.githubusercontent.com/in/56611?s=60&v=4){kind=small}
There was a problem hiding this comment.
Pull Request Overview
While this PR successfully transitions the documentation from Deno to Bun as the Tier 1 runtime, it fails to fulfill the secondary objective mentioned in the requirements: repairing 'blanking scars' from the ReScript purge. Specifically, the word 'ReScript' has not been restored to Rule 1 or the BANNED table as intended.
Additionally, the update to the ALLOWED table introduces a logical inconsistency. By describing Bun as a tool that 'executes .ts directly' with 'no build step', the documentation now contradicts Rule 1 ('No new TypeScript files'). This should be corrected to avoid misleading contributors about the project's compilation requirements.
About this PR
- The PR is missing the implementation for restoring 'ReScript' references in the policy tables and enforcement rules. Although the intent was to repair 'blanking scars' from the ReScript purge, the current diff only modifies the Deno/Bun toolchain configuration.
Test suggestions
- Verify ALLOWED table promotes Bun to Tier 1 and removes the standalone Deno entry
- Verify BANNED table redirects Node/npm/yarn/pnpm to Bun instead of Deno
- Verify Enforcement Rules 2 and 3 mandate package.json and bun.lock usage
- Verify Rule 1 is updated to mention 'ReScript' instead of 'TypeScript' to repair the purge scar
- Verify the BANNED table row for ReScript is restored to fix the empty banned cell scar
Prompt proposal for missing tests
Consider implementing these tests if applicable:
1. Verify Rule 1 is updated to mention 'ReScript' instead of 'TypeScript' to repair the purge scar
2. Verify the BANNED table row for ReScript is restored to fix the empty banned cell scar
TIP Improve review quality by adding custom instructions
TIP How was this review? Give us feedback
| | **AffineScript** | Primary application code | Affine-typed, compiles to typed-wasm or Deno-ESM | | ||
| | **Deno** | Runtime & package management | Replaces Node/npm/bun | | ||
| | **AffineScript** | Primary application code | Affine-typed, compiles to typed-wasm or ESM | | ||
| | **Bun** | JS/TS runtime & package management (tier 1) | Default for all new work. Executes `.ts` directly, no build step. Uses an npm-compatible `package.json` plus `bun.lock` — both are expected, not anti-patterns. | |
There was a problem hiding this comment.
🟡 MEDIUM RISK
Suggestion: This description contradicts Rule 1 ('No new TypeScript files') and the Banned list. Highlighting that Bun 'Executes .ts directly' with 'no build step' is misleading since TypeScript is forbidden and AffineScript requires compilation to ESM. The note should focus on its role as a runtime for the allowed outputs.
| | **Bun** | JS/TS runtime & package management (tier 1) | Default for all new work. Executes `.ts` directly, no build step. Uses an npm-compatible `package.json` plus `bun.lock` — both are expected, not anti-patterns. | | |
| **Bun** | JS/TS runtime & package management (tier 1) | Default for all new work. Fast runtime for AffineScript ESM output and JS glue code. Uses an npm-compatible `package.json` plus `bun.lock` — both are expected, not anti-patterns. | |
![coderabbitai[bot]](https://avatars.githubusercontent.com/in/347564?s=60&v=4){kind=small}
Review feedback from codacy-production and coderabbitai on the policy wave. Three substantive points, all accepted: 1. ".ts CONTRADICTION" (codacy, MEDIUM, raised on most of the wave). The Bun row said "Executes .ts directly, no build step" in a file whose BANNED table bans TypeScript. OWNER RULING: TypeScript "should not exist at all", so advertising Bun's TypeScript capability is wrong regardless of whether it is true. Every .ts reference is removed from the row, including "JS/TS" in its label. 2. "DENO MISSING FROM BANNED" (codacy, raised repeatedly). The wave removed Deno from ALLOWED but never added it to BANNED, so the ruling was only half expressed. Added | Deno | Bun |. 3. "UNPINNED bunx" (coderabbitai, Security & Privacy). A bare `bunx <tool>` can fetch a package outside package.json/bun.lock, and can start Node via a shebang - both contrary to estate SHA-pinning doctrine and the Node ban. Guidance now requires a declared devDependency plus `bunx --no-install --bun <tool>`. NOT taken: "a npm-compatible" (LanguageTool is wrong, "an" is correct before a vowel sound); "--frozen-lockfile is redundant" (correct - no change needed, and none made); the Nix->Guix point (real, but a separate ruling, deliberately not folded into a Deno/Bun change).
1 participant
Owner ruling, 2026-08-26:
This repo's
.claude/CLAUDE.mdis what an agent reads first. Correctinghyperpolymath/standards(#655) fixes one copy of ~372 — agents read the local one.What this PR actually changes
Every line below was verified present in this PR's own diff — nothing is claimed that isn't here.
| Bun | Deno |row removedpackage.json+bun.lock)bun install --productionreplaces the node_modules rulebunx --no-install --bunOnly where cannot→ Only where AffineScript cannot| **** |→ AffineScriptReview feedback addressed
.tsdirectly" inside a file that bans TypeScript. Owner ruling: TypeScript should not exist at all — so every.tsreference is gone from the row, including JS/TS in its label. It now reads JS runtime, running compiled ESM/JS.bunx(coderabbitai, Security & Privacy): a barebunx <tool>can fetch a package outsidebun.lockand can start Node via a shebang. Guidance now requires a declared devDependency plusbunx --no-install --bun.Not taken: "a npm-compatible" (LanguageTool is wrong — "an" is correct before a vowel sound); "
--frozen-lockfileis redundant" (correct, and no such flag was added); the Nix → Guix point (real, but a separate ruling — deliberately not folded into a Deno/Bun change).Scope
Policy text only — no code, no workflows, no build files.
Related: #655 (governing document), #658 (Deno→Bun assessment: 18 repos blocked on
@affinescript/*npm packages that do not exist), #659 (policy duplicated into ~372 copies).