docs: add LANGUAGE-POLICY.adoc — the authority three gates already cite - #563
Merged
Conversation
scripts/check-package-policy.sh names LANGUAGE-POLICY.adoc as its authority in THREE places, including the runtime error message it prints on failure. The file did not exist. The gate has been telling readers to consult a missing document since #534 -- my error, corrected here. Contents are the rules already in force, written down for the first time: §1 JS/TS runtime ordering -- Bun > Deno > pnpm > npm. This is NEW policy and it INVERTS what the estate currently enforces: npm-bun-blocker.yml, in 55 repositories, fails any build carrying bun.lockb with 'Use Deno instead'. That gate blocks the new first choice and mandates the second. §1.2 TypeScript permitted under Bun; the 'use ReScript instead' rule retired. Records that ts-blocker.yml (also 55 repos) cannot fail -- it diffs against HEAD~1 on a depth-1 checkout and swallows the error. 20/20 runs green. §2 Packaging -- Guix primary, sealed container escape hatch, Nix retired 2026-06-01, with the standing 'never mass-delete flake.nix' constraint and the measured guix.scm identity/licence clobber. §3 Banned languages. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
|
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
1 participant
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.
scripts/check-package-policy.shnamesLANGUAGE-POLICY.adocas its authority in three places, including the runtime error message it prints on failure — and the file did not exist. That dangling citation came in with #534; this corrects it.The contents are the rules already in force, written down for the first time, plus one genuinely new section:
§1 — JS/TS runtime ordering: Bun > Deno > pnpm > npm. This inverts what the estate currently enforces.
npm-bun-blocker.yml, in 55 repositories, fails any build carryingbun.lockbwith "Use Deno instead" — blocking the new first choice and mandating the second. That gate must change next.§1.2 — TypeScript permitted under Bun; the "use ReScript instead" rule retired. Records that
ts-blocker.yml(also 55 repos) cannot fail: it diffsHEAD~1on a depth-1 checkout and swallows the error. 20/20 runs green, never once fired.§2 — packaging (Guix primary, sealed-container escape, Nix retired 2026-06-01), including the standing never mass-delete
flake.nixconstraint and the measuredguix.scmidentity/licence clobber.🤖 Generated with Claude Code