From b27c7613cc934ea7ec34aa546fe4e65e39a4fd3d Mon Sep 17 00:00:00 2001 From: "Jonathan D.A. Jewell" <6759885+hyperpolymath@users.noreply.github.com> Date: Wed, 26 Aug 2026 23:42:08 +0100 Subject: [PATCH 1/3] =?UTF-8?q?policy:=20Bun=20is=20tier=201,=20Deno=20is?= =?UTF-8?q?=20being=20removed=20=E2=80=94=20correct=20local=20CLAUDE.md?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 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. 2 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. --- dipstick/.claude/CLAUDE.md | 17 ++++++++--------- polygraph/.claude/CLAUDE.md | 19 +++++++++---------- 2 files changed, 17 insertions(+), 19 deletions(-) diff --git a/dipstick/.claude/CLAUDE.md b/dipstick/.claude/CLAUDE.md index ce34367..06ec2e0 100644 --- a/dipstick/.claude/CLAUDE.md +++ b/dipstick/.claude/CLAUDE.md @@ -24,13 +24,13 @@ The following files in `.machine_readable/` contain structured project metadata: | Language/Tool | Use Case | Notes | |---------------|----------|-------| | **AffineScript** | Primary application code | Compiles to JS, type-safe | -| **Deno** | Runtime & package management | Replaces Node/npm/bun | +| **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. | | **Rust** | Performance-critical, systems, WASM | Preferred for CLI tools | | **Tauri 2.0+** | Mobile apps (iOS/Android) | Rust backend + web UI | | **Dioxus** | Mobile apps (native UI) | Pure Rust, React-like | | **Gleam** | Backend services | Runs on BEAM or compiles to JS | | **Bash/POSIX Shell** | Scripts, automation | Keep minimal | -| **JavaScript** | Only where AffineScript cannot | MCP protocol glue, Deno APIs | +| **JavaScript** | Only where AffineScript cannot | MCP protocol glue, Bun APIs | | **Nickel** | Configuration language | For complex configs | | **Guile Scheme** | State/meta files | STATE.scm, META.scm, ECOSYSTEM.scm | | **Julia** | Batch scripts, data processing | Per RSR | @@ -42,10 +42,9 @@ The following files in `.machine_readable/` contain structured project metadata: | Banned | Replacement | |--------|-------------| | TypeScript | AffineScript | -| Node.js | Deno | -| npm | Deno | -| Bun | Deno | -| pnpm/yarn | Deno | +| Node.js | Bun | +| npm | Bun | +| pnpm/yarn | Bun | | Go | Rust | | Python | Julia/Rust/AffineScript | | Java/Kotlin | Rust/Tauri/Dioxus | @@ -65,8 +64,8 @@ Both are FOSS with independent governance (no Big Tech). ### Enforcement Rules 1. **No new TypeScript files** - Convert existing TS to AffineScript -2. **No package.json - use deno.json deps** - Use deno.json imports -3. **No node_modules in production** - Deno caches deps automatically +2. **Use `package.json` + `bun.lock` for JS runtime deps** - Bun is npm-compatible; a manifest is REQUIRED +3. **`bun install --production` for production deps** - resolved from `package.json`, pinned via `bun.lock` 4. **No Go code** - Use Rust instead 5. **No Python anywhere** - Use Julia for data/batch, Rust for systems, AffineScript for apps 6. **No Kotlin/Swift for mobile** - Use Tauri 2.0+ or Dioxus @@ -75,7 +74,7 @@ Both are FOSS with independent governance (no Big Tech). - **Primary**: Guix (guix.scm) - **Fallback**: Nix (flake.nix) -- **JS deps**: Deno (deno.json imports) +- **JS deps**: Bun (`package.json` + `bun.lock`); `bunx ` for one-off tooling ### Security Requirements diff --git a/polygraph/.claude/CLAUDE.md b/polygraph/.claude/CLAUDE.md index 0bca5a3..488ca24 100644 --- a/polygraph/.claude/CLAUDE.md +++ b/polygraph/.claude/CLAUDE.md @@ -7,13 +7,13 @@ | Language/Tool | Use Case | Notes | |---------------|----------|-------| | **ReScript** | Primary application code | Compiles to JS, type-safe | -| **Deno** | Runtime & package management | Replaces Node/npm/bun | +| **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. | | **Rust** | Performance-critical, systems, WASM | Preferred for CLI tools | | **Tauri 2.0+** | Mobile apps (iOS/Android) | Rust backend + web UI | | **Dioxus** | Mobile apps (native UI) | Pure Rust, React-like | | **Gleam** | Backend services | Runs on BEAM or compiles to JS | | **Bash/POSIX Shell** | Scripts, automation | Keep minimal | -| **JavaScript** | Only where ReScript cannot | MCP protocol glue, Deno APIs | +| **JavaScript** | Only where AffineScript cannot | MCP protocol glue, Bun APIs | | **Nickel** | Configuration language | For complex configs | | **Guile Scheme** | State/meta files | STATE.scm, META.scm, ECOSYSTEM.scm | | **Julia** | Batch scripts, data processing | Per RSR | @@ -25,10 +25,9 @@ | Banned | Replacement | |--------|-------------| | TypeScript | ReScript | -| Node.js | Deno | -| npm | Deno | -| Bun | Deno | -| pnpm/yarn | Deno | +| Node.js | Bun | +| npm | Bun | +| pnpm/yarn | Bun | | Go | Rust | | Python | Julia/Rust/AffineScript | | Java/Kotlin | Rust/Tauri/Dioxus | @@ -47,9 +46,9 @@ Both are FOSS with independent governance (no Big Tech). ### Enforcement Rules -1. **No new TypeScript files** - Convert existing TS to ReScript -2. **No package.json for runtime deps** - Use deno.json imports -3. **No node_modules in production** - Deno caches deps automatically +1. **No new TypeScript files** - Convert existing TS to AffineScript +2. **Use `package.json` + `bun.lock` for JS runtime deps** - Bun is npm-compatible; a manifest is REQUIRED +3. **`bun install --production` for production deps** - resolved from `package.json`, pinned via `bun.lock` 4. **No Go code** - Use Rust instead 5. **No Python anywhere** - Use Julia for data/batch, Rust for systems, ReScript for apps 6. **No Kotlin/Swift for mobile** - Use Tauri 2.0+ or Dioxus @@ -58,7 +57,7 @@ Both are FOSS with independent governance (no Big Tech). - **Primary**: Guix (guix.scm) - **Fallback**: Nix (flake.nix) -- **JS deps**: Deno (deno.json imports) +- **JS deps**: Bun (`package.json` + `bun.lock`); `bunx ` for one-off tooling ### Security Requirements From 549eae839eddf3e78d788cfe2e3338b6f2254bcc Mon Sep 17 00:00:00 2001 From: "Jonathan D.A. Jewell" <6759885+hyperpolymath@users.noreply.github.com> Date: Thu, 27 Aug 2026 00:35:16 +0100 Subject: [PATCH 2/3] =?UTF-8?q?policy:=20address=20review=20=E2=80=94=20dr?= =?UTF-8?q?op=20the=20.ts=20contradiction,=20ban=20Deno,=20pin=20bunx?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 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 ` 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 `. 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). --- dipstick/.claude/CLAUDE.md | 5 +++-- polygraph/.claude/CLAUDE.md | 5 +++-- 2 files changed, 6 insertions(+), 4 deletions(-) diff --git a/dipstick/.claude/CLAUDE.md b/dipstick/.claude/CLAUDE.md index 06ec2e0..a519b0e 100644 --- a/dipstick/.claude/CLAUDE.md +++ b/dipstick/.claude/CLAUDE.md @@ -24,7 +24,7 @@ The following files in `.machine_readable/` contain structured project metadata: | Language/Tool | Use Case | Notes | |---------------|----------|-------| | **AffineScript** | Primary application code | Compiles to JS, type-safe | -| **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 runtime & package management (tier 1) | Default for all new work. Runs compiled ESM/JS directly — no bundler step. Uses an npm-compatible `package.json` plus `bun.lock` — both are expected, not anti-patterns. | | **Rust** | Performance-critical, systems, WASM | Preferred for CLI tools | | **Tauri 2.0+** | Mobile apps (iOS/Android) | Rust backend + web UI | | **Dioxus** | Mobile apps (native UI) | Pure Rust, React-like | @@ -42,6 +42,7 @@ The following files in `.machine_readable/` contain structured project metadata: | Banned | Replacement | |--------|-------------| | TypeScript | AffineScript | +| Deno | Bun | | Node.js | Bun | | npm | Bun | | pnpm/yarn | Bun | @@ -74,7 +75,7 @@ Both are FOSS with independent governance (no Big Tech). - **Primary**: Guix (guix.scm) - **Fallback**: Nix (flake.nix) -- **JS deps**: Bun (`package.json` + `bun.lock`); `bunx ` for one-off tooling +- **JS deps**: Bun (`package.json` + `bun.lock`). Declare tooling as a devDependency and run `bunx --no-install --bun ` — a bare `bunx ` can fetch an unpinned package and may start Node via its shebang. ### Security Requirements diff --git a/polygraph/.claude/CLAUDE.md b/polygraph/.claude/CLAUDE.md index 488ca24..506dc5f 100644 --- a/polygraph/.claude/CLAUDE.md +++ b/polygraph/.claude/CLAUDE.md @@ -7,7 +7,7 @@ | Language/Tool | Use Case | Notes | |---------------|----------|-------| | **ReScript** | Primary application code | Compiles to JS, type-safe | -| **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 runtime & package management (tier 1) | Default for all new work. Runs compiled ESM/JS directly — no bundler step. Uses an npm-compatible `package.json` plus `bun.lock` — both are expected, not anti-patterns. | | **Rust** | Performance-critical, systems, WASM | Preferred for CLI tools | | **Tauri 2.0+** | Mobile apps (iOS/Android) | Rust backend + web UI | | **Dioxus** | Mobile apps (native UI) | Pure Rust, React-like | @@ -25,6 +25,7 @@ | Banned | Replacement | |--------|-------------| | TypeScript | ReScript | +| Deno | Bun | | Node.js | Bun | | npm | Bun | | pnpm/yarn | Bun | @@ -57,7 +58,7 @@ Both are FOSS with independent governance (no Big Tech). - **Primary**: Guix (guix.scm) - **Fallback**: Nix (flake.nix) -- **JS deps**: Bun (`package.json` + `bun.lock`); `bunx ` for one-off tooling +- **JS deps**: Bun (`package.json` + `bun.lock`). Declare tooling as a devDependency and run `bunx --no-install --bun ` — a bare `bunx ` can fetch an unpinned package and may start Node via its shebang. ### Security Requirements From 6f33f1f862e1173fd3f280f0f84aade3a4a5067b Mon Sep 17 00:00:00 2001 From: "Jonathan D.A. Jewell" <6759885+hyperpolymath@users.noreply.github.com> Date: Thu, 27 Aug 2026 06:07:27 +0100 Subject: [PATCH 3/3] policy: AffineScript is primary, ReScript is banned; pin production installs Two separate corrections in this repo's nested CLAUDE.md files. polygraph/ was left half-migrated. It named ReScript as "Primary application code" while the Bun/Deno swap correctly left the language axis alone, so the file would have landed on main directing new application code at a language canon bans. Aligned with ratified canon (ReScript banned, destination AffineScript): primary language, the `TypeScript | ReScript` banned row, the Tauri web-UI note, and Enforcement Rule 5 all now say AffineScript, and ReScript gains its own banned row. The last two were found by grepping every remaining mention after the table edits - stopping at the tables would have left ReScript prescribed as a destination in the prose. dipstick/ and polygraph/ also had not received the two fleet findings: ReScript was absent from the BANNED table, and Enforcement Rule 3 omitted `--frozen-lockfile`, so a lockfile mismatch silently re-resolved instead of failing. Both applied. The root .claude/CLAUDE.md carries neither anchor - a different file shape - and is deliberately untouched. This is also why an earlier sweep recorded this repo as having no anchors at all: it checked only the root copy. Enforcement Rule 1 is untouched: standards#655 records that collision as not resolvable unilaterally. Co-Authored-By: Claude Opus 5 --- dipstick/.claude/CLAUDE.md | 3 ++- polygraph/.claude/CLAUDE.md | 11 ++++++----- 2 files changed, 8 insertions(+), 6 deletions(-) diff --git a/dipstick/.claude/CLAUDE.md b/dipstick/.claude/CLAUDE.md index a519b0e..c3354ca 100644 --- a/dipstick/.claude/CLAUDE.md +++ b/dipstick/.claude/CLAUDE.md @@ -42,6 +42,7 @@ The following files in `.machine_readable/` contain structured project metadata: | Banned | Replacement | |--------|-------------| | TypeScript | AffineScript | +| ReScript | AffineScript | | Deno | Bun | | Node.js | Bun | | npm | Bun | @@ -66,7 +67,7 @@ Both are FOSS with independent governance (no Big Tech). 1. **No new TypeScript files** - Convert existing TS to AffineScript 2. **Use `package.json` + `bun.lock` for JS runtime deps** - Bun is npm-compatible; a manifest is REQUIRED -3. **`bun install --production` for production deps** - resolved from `package.json`, pinned via `bun.lock` +3. **`bun install --production --frozen-lockfile` for production deps** - resolved from `package.json` and pinned via `bun.lock`; `--frozen-lockfile` makes a lockfile mismatch a build failure rather than a silent re-resolve 4. **No Go code** - Use Rust instead 5. **No Python anywhere** - Use Julia for data/batch, Rust for systems, AffineScript for apps 6. **No Kotlin/Swift for mobile** - Use Tauri 2.0+ or Dioxus diff --git a/polygraph/.claude/CLAUDE.md b/polygraph/.claude/CLAUDE.md index 506dc5f..669806b 100644 --- a/polygraph/.claude/CLAUDE.md +++ b/polygraph/.claude/CLAUDE.md @@ -6,7 +6,7 @@ | Language/Tool | Use Case | Notes | |---------------|----------|-------| -| **ReScript** | Primary application code | Compiles to JS, type-safe | +| **AffineScript** | Primary application code | Affine-typed, compiles to typed-wasm or ESM | | **Bun** | JS runtime & package management (tier 1) | Default for all new work. Runs compiled ESM/JS directly — no bundler step. Uses an npm-compatible `package.json` plus `bun.lock` — both are expected, not anti-patterns. | | **Rust** | Performance-critical, systems, WASM | Preferred for CLI tools | | **Tauri 2.0+** | Mobile apps (iOS/Android) | Rust backend + web UI | @@ -24,7 +24,8 @@ | Banned | Replacement | |--------|-------------| -| TypeScript | ReScript | +| TypeScript | AffineScript | +| ReScript | AffineScript | | Deno | Bun | | Node.js | Bun | | npm | Bun | @@ -40,7 +41,7 @@ **No exceptions for Kotlin/Swift** - use Rust-first approach: -1. **Tauri 2.0+** - Web UI (ReScript) + Rust backend, MIT/Apache-2.0 +1. **Tauri 2.0+** - Web UI (AffineScript) + Rust backend, MIT/Apache-2.0 2. **Dioxus** - Pure Rust native UI, MIT/Apache-2.0 Both are FOSS with independent governance (no Big Tech). @@ -49,9 +50,9 @@ Both are FOSS with independent governance (no Big Tech). 1. **No new TypeScript files** - Convert existing TS to AffineScript 2. **Use `package.json` + `bun.lock` for JS runtime deps** - Bun is npm-compatible; a manifest is REQUIRED -3. **`bun install --production` for production deps** - resolved from `package.json`, pinned via `bun.lock` +3. **`bun install --production --frozen-lockfile` for production deps** - resolved from `package.json` and pinned via `bun.lock`; `--frozen-lockfile` makes a lockfile mismatch a build failure rather than a silent re-resolve 4. **No Go code** - Use Rust instead -5. **No Python anywhere** - Use Julia for data/batch, Rust for systems, ReScript for apps +5. **No Python anywhere** - Use Julia for data/batch, Rust for systems, AffineScript for apps 6. **No Kotlin/Swift for mobile** - Use Tauri 2.0+ or Dioxus ### Package Management