@rm30/stack 0.1.0

package/README.md

@@ -0,0 +1,51 @@
+# @rm30/stack
+
+The RM30 version manifest, as data. One JSON of pinned versions per package class, read
+by `rm doctor` (to grade a project) and `rm new` (to create one). Bumping the workspace
+stack is one PR to one file.
+
+## Install
+
+```sh
+pnpm add -D @rm30/stack
+```
+
+## Use
+
+```js
+import stack, { classOf, versionOf, bannedReason } from '@rm30/stack'
+
+classOf('expo') // 'platform'
+versionOf('next') // '16.3.4'
+bannedReason('mobx') // 'Zustand only. The one project still on it is migrating.'
+stack.updated // '2026-09-08'
+```
+
+The raw file is exported too, for tooling that would rather not import JS:
+
+```js
+import manifest from '@rm30/stack/stack.json' with { type: 'json' }
+```
+
+## The three classes
+
+A single "must be latest" gate over every dependency produces false alarms and then gets
+ignored. So packages are graded by class:
+
+| Class | Examples | Rule | `rm doctor` |
+|---|---|---|---|
+| **platform** | `expo`, `react-native`, `next`, `react`, `expo-router` | Version is set by the SDK, not chosen per package. Upgrade as one atomic move, at most one major behind. Never mix. | error |
+| **toolchain** | `typescript`, `@biomejs/biome`, `pnpm`, `turbo`, `vitest` | Latest minor always. Latest major after a deliberate check — these break plugins. | warning, with the upgrade path named |
+| **library** | `zod`, `zustand`, `drizzle-orm`, `viem`, `wagmi`, `firebase*` | Latest minor always, no ceremony. Majors reviewed. | info |
+
+## `banned`
+
+Packages that must not enter an RM30 project, each with the reason. Some are paradigm
+calls (`redux`, `mobx`, `nativewind`, `styled-components`); the rest are the concrete
+blockers to TypeScript 7 — everything that consumes the TypeScript programmatic API,
+which TS 7.0 does not ship.
+
+## Keeping it current
+
+Versions were read from the npm registry on the date in `updated`. There is no automated
+refresh yet; `rm doctor` will grow one.

package/index.d.ts

@@ -0,0 +1,23 @@
+export type PackageClass = 'platform' | 'toolchain' | 'library'
+
+export interface ClassRule {
+  severity: 'error' | 'warn' | 'info'
+  policy: string
+}
+
+export interface Stack {
+  updated: string
+  rules: Record<PackageClass, ClassRule>
+  platform: Record<string, string>
+  toolchain: Record<string, string>
+  library: Record<string, string>
+  banned: Record<string, string>
+}
+
+export declare const stack: Stack
+export default stack
+
+export declare const CLASSES: readonly PackageClass[]
+export declare function classOf(name: string): PackageClass | null
+export declare function versionOf(name: string): string | null
+export declare function bannedReason(name: string): string | null

package/index.js

@@ -0,0 +1,36 @@
+import stack from './stack.json' with { type: 'json' }
+
+export { stack }
+export default stack
+
+/** The three package classes, in the order `rm doctor` reports them. */
+export const CLASSES = ['platform', 'toolchain', 'library']
+
+/**
+ * The class a package belongs to, or `null` if the manifest does not track it.
+ * @param {string} name
+ * @returns {'platform' | 'toolchain' | 'library' | null}
+ */
+export function classOf(name) {
+  return CLASSES.find((c) => name in stack[c]) ?? null
+}
+
+/**
+ * The pinned version for a package, or `null` if the manifest does not track it.
+ * @param {string} name
+ * @returns {string | null}
+ */
+export function versionOf(name) {
+  const c = classOf(name)
+  return c ? stack[c][name] : null
+}
+
+/**
+ * Why a package is banned from RM30, or `null` if it is not banned.
+ * @param {string} name
+ * @returns {string | null}
+ */
+export function bannedReason(name) {
+  if (name === '$comment') return null
+  return stack.banned[name] ?? null
+}

package/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "@rm30/stack",
+  "version": "0.1.0",
+  "description": "The RM30 stack manifest — pinned versions by package class, read by rm doctor and rm new.",
+  "license": "MIT",
+  "author": "Rafael Miziara",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/rafamiziara/cli.git",
+    "directory": "packages/stack"
+  },
+  "keywords": ["versions", "manifest", "dependencies"],
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./index.d.ts",
+      "default": "./index.js"
+    },
+    "./stack.json": "./stack.json"
+  },
+  "files": ["index.js", "index.d.ts", "stack.json", "README.md"],
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/stack.json

@@ -0,0 +1,66 @@
+{
+  "$comment": "The RM30 stack manifest. Versions read from the npm registry on 2026-09-08. One class per rule: see rules[] for how rm doctor grades each.",
+  "updated": "2026-09-08",
+  "rules": {
+    "platform": {
+      "severity": "error",
+      "policy": "Version is set by the SDK, not chosen per package. Upgrade as one atomic move, at most one major behind. Never mix."
+    },
+    "toolchain": {
+      "severity": "warn",
+      "policy": "Latest minor always. Latest major after a deliberate check — these break plugins."
+    },
+    "library": {
+      "severity": "info",
+      "policy": "Latest minor always, no ceremony. Majors reviewed."
+    }
+  },
+  "platform": {
+    "expo": "57.0.20",
+    "react-native": "0.87.1",
+    "expo-router": "57.0.19",
+    "jest-expo": "57.0.5",
+    "next": "16.3.4",
+    "react": "19.2.8"
+  },
+  "toolchain": {
+    "typescript": "7.0.2",
+    "@biomejs/biome": "2.5.12",
+    "pnpm": "12.3.4",
+    "turbo": "2.10.12",
+    "vitest": "5.0.0",
+    "tailwindcss": "4.3.3",
+    "uniwind": "1.12.0",
+    "@testing-library/react-native": "14.0.1"
+  },
+  "library": {
+    "zod": "4.5.4",
+    "zustand": "5.0.15",
+    "firebase": "12.18.0",
+    "firebase-admin": "14.3.0",
+    "firebase-functions": "7.3.2",
+    "@mastra/core": "1.64.0",
+    "drizzle-orm": "0.45.2",
+    "wagmi": "3.7.7",
+    "viem": "2.56.3",
+    "hardhat": "3.16.0",
+    "ethers": "6.17.0",
+    "motion": "13.2.0"
+  },
+  "banned": {
+    "$comment": "Paradigms and packages that must not enter an RM30 project. rm doctor reports any occurrence as an error.",
+    "redux": "Zustand only.",
+    "@reduxjs/toolkit": "Zustand only.",
+    "mobx": "Zustand only. The one project still on it is migrating.",
+    "mobx-react-lite": "Zustand only. The one project still on it is migrating.",
+    "nativewind": "Uniwind, with web parity via Tailwind v4.",
+    "styled-components": "Tailwind v4.",
+    "moment": "Use the platform Intl APIs or date-fns.",
+    "eslint": "Biome replaces ESLint and Prettier.",
+    "prettier": "Biome replaces ESLint and Prettier.",
+    "@typescript-eslint/eslint-plugin": "Blocks TypeScript 7 — its supported range ends at <6.1.0.",
+    "@typescript-eslint/parser": "Blocks TypeScript 7 — its supported range ends at <6.1.0.",
+    "ts-jest": "Consumes the TypeScript programmatic API, which TS 7 does not ship. Use Vitest.",
+    "ts-node": "Consumes the TypeScript programmatic API, which TS 7 does not ship. Use tsx or Vitest."
+  }
+}