Off-Nominal/ndb2

domain-kebab-case

Requires kebab-case filenames for modules under app/src/domain. Use when adding, renaming, or importing files in app/src/domain, or when a PR touches domain layout or @domain/* path aliases.

domain-operations

Extracts multi-step business rules from Express handlers into app/src/domain/<area>/ modules: DomainFailure + typed API error codes (no HTTP), success metadata only, reload/events at transports. Use when adding or refactoring domain functions (e.g. placeBet),…

input-validation

Prefer Zod for runtime validation of env vars, HTTP inputs, and parsed external data. Instructs checking the installed library version (e.g. Zod 3 vs 4) and matching official docs and examples to that version so APIs are not outdated or deprecated. Covers…

kitajs-html-web

NDB2 web rendering with @kitajs/html: PascalCase Kitajs components, kebab-case component files in one folder per component (name/name.tsx, name.css, name.test.tsx, index.ts), feature folders (page.tsx, handler.tsx, tests/), HTMX. Query parsing uses…

v2-api-endpoints

Describes how to add Express routes under app/src/api/v2: validate middleware with Zod, shared @shared/validation (domain + http), server errors via the v2 errorHandler, responseUtils for JSON bodies, colocated supertest suites, extracting domain operations…

ndb2-web-design

NDB2 web visual design: futuristic terminal / HUD, glassy screen-overlay feel, space-named colour palettes (Neptune, Aurora, etc.), how light/dark and accent schemes combine, and semantic tokens. Use when choosing colours, describing look and feel, or styling…

web-breakpoints

Canonical ndb2 viewport tiers: narrow base, breakpoint.mobile (36rem), tablet, desktop, wide — rem cut `min-width` @media patterns, and how they relate to shell/nav layout. Use when writing or reviewing responsive CSS, choosing min-width queries, or…

ndb2-denormalized-data

PostgreSQL triggers and functions that maintain derived columns on predictions, bets, and seasons. Use when writing migrations, editing db/schema-affecting SQL, or changing INSERT/UPDATE paths that touch wager, status, ratios, payouts, season_id,…

ndb2-game-mechanics

NDB2 prediction lifecycle, drivers (date vs event), statuses, snooze checks, monitors, and public betting rules. Use when changing domain behavior around predictions, triggers/closes, snooze/votes, monitors under app/src/domain, or API/schema fields tied to…

ndb2-scoring-seasons

NDB2 wagers, endorse/undorse ratios, payout vs season_payout, seasons, wager_cap, bets.valid vs predictions.season_applicable. Use when changing scoring, payouts, seasons, or SQL/TS that reads bet or season points; read docs/scoring.md first.

v2-database-queries

Describes how the API writes PostgreSQL access in v2 using PgTyped SQL files, generated query modules, and curried wrappers in index.ts. Use when adding or changing queries under app/src/data/queries, wiring PoolClient, transactions, or composing multiple…

cube-css-authoring

CUBE CSS authoring for ndb2: which layer (globals, compositions, utilities, colocated block). Colocated block CSS must use one root selector (e.g. `.form-field`) and native `&` nesting for children and states — not multiple parallel top-level `.block-*`…

css-build

Describes ndb2 web CSS end-to-end: CUBE CSS via Vite (cube-entry.css → cube.css), design tokens (JSON → src/web/generated/design-tokens.css), hud-shadows.css (HUD glow custom properties), generate-cube-blocks-manifest.mjs + build-cube-css.mjs, HtmlHead single…

web-client-js

ndb2 browser client scripts: `*.client.ts` (preferred) or `*.client.js` under app/src/web/routes or shared/components, Vite via build-client-js.mjs, generated routeClientScripts.ts, /assets/routes. Use when adding or changing deferred browser scripts or the…

express-route-map

Describes the Express router dependency-injection pattern used in ndb2: a Route function receives a Router, registers handlers, and mapRoutes aggregates Route modules under path prefixes. Covers both app/src/api/v2 and app/src/web. Use when adding or…

middleware-naming

ndb2 web Express middleware: kebab-case filenames without redundant "web" or "middleware" segments; camelCase exported function names. Helpers under middleware/auth use kebab-case. Use when adding or renaming web middleware.

middleware-patterns

ndb2 guidance for Express middleware on the web app: prefer Node AsyncLocalStorage for request-scoped context instead of mutating Express Request. Use when adding middleware, request-scoped values, or refactoring handlers that set custom fields on req.

app-config

Single Zod-validated runtime configuration from process.env at app/src/config.ts, imported via @config. Use when adding or changing env vars, boot validation, or wiring new features to configuration.

events-manager

Describes the NDB2 Events Manager (eventsManager) as the root typed game-event bus for user/game-engine actions. Use when adding a new game event, emitting events from routes/monitors, or wiring downstream consumers like v2 webhooks.

ndb2-api-types

Describes the @offnominal/ndb2-api-types package (types/src/v2): Entities, Endpoints, Webhooks, Errors, Utils, and semver bumps in package.json for npm releases. Use when editing shared API TypeScript types, adding entities or endpoint namespaces, webhook…