Sync alphalib

Author: kvz

.cursor/rules/coding-style.mdc

@@ -0,0 +1,11 @@
+---
+description: Coding Style
+globs: 
+alwaysApply: false
+---
+- Favor `async run() {` over `run = async () => {` inside ES6 classes
+- Favor `if (!(err instanceof Error)) { throw new Error(`Was thrown a non-error: ${err}`) }` inside
+  `catch` blocks to ensure the `error` is always an instance of `Error`
+- Favor using real paths (`../lib/schemas.ts`) over aliases (`@/app/lib/schemas`).
+- Favor `for (const comment of comments) {` over `comments.forEach((comment) => {`
+- Favor named exports over default exports, with the exception of Next.js pages

.cursor/rules/general.mdc

@@ -0,0 +1,9 @@
+---
+description: General
+globs: 
+alwaysApply: true
+---
+- Do not touch `.env` files!
+- Favor Yarn (4) over npm
+- Most of my git commands run through pagers, so pipe their output to `cat` to avoid blocking the
+  terminal

.cursor/rules/next.mdc

@@ -0,0 +1,9 @@
+---
+description: Next.js
+globs: 
+alwaysApply: false
+---
+- In case of Next.js, we use the `./src` directory, version 15, the App Router, and we have
+  shadcn/ui installed (`npx shadcn@latest add <component>`). Assume we have a dev server running so
+  never start one unless specifically prompted.
+- In case of Next.js, our config file is `next.config.ts`. Don't work in js or mjs alternatives.

.cursor/rules/typescript.mdc

@@ -0,0 +1,18 @@
+---
+description: TypeScript
+globs: 
+alwaysApply: false
+---
+- Favor `contentGapItemSchema = z.object()` over `ContentGapItemSchema = z.object()`
+- Favor `from './PosterboyCommand.ts'` over `from './PosterboyCommand'`
+- Favor `return ideas.filter(isPresent)` over `ideas.filter((idea): idea is Idea => idea !== null)`
+- Favor using `.tsx` over `.jsx` file extensions.
+- Favor the `tsx` CLI over `ts-node` for running TypeScript files.
+- Favor `satisfies` over `as`, consider `as` a sin
+- Favor `unknown` over `any`, consider `any` a sin
+- Favor validating data with Zod over using `any` or custom type guards
+- We use the `rewriteRelativeImportExtensions` TS 5.7 compiler option, so for local TypeScript
+  files, import with the `.ts` / `.tsx` extension (not js, not extensionless)
+- Favor defining props as an interface over inline
+- Favor explicit return types over inferring them as it makes typescript a lot faster in the editor
+  on our scale