@021.is/spine-lint

@021.is/spine-lint

Spine-specific AST checks that biome can't express. Runs in CI as the spine-lint job in the quality gate; also runs locally via spine-lint ..

Rules

CLI

spine-lint .                           # run all rules on src/**
spine-lint src/feature/event          # narrow to one path
spine-lint --rule spine/enum-over-string .
spine-lint --github .                   # emit GitHub Actions annotations
spine-lint --list-rules

Exit code 1 on any error-level violation. Used as a required check in the spine-quality-gate workflow.

Disabling for a single line

// spine-lint-disable-next-line spine/no-raw-sql — needed for the pg_stat query
await prisma.$queryRawUnsafe(`SELECT * FROM pg_stat_activity`);

(Disables ALL rules on the next line if no rule id given.) You must always include the WHY comment. PR reviewers + future-you will look there first.

Enum pattern (the rule you'll hit most)

// ❌ inline union
function setStatus(s: "active" | "inactive" | "deleted") { ... }

// ✓ const-as-object enum
export const STATUS = { ACTIVE: "active", INACTIVE: "inactive", DELETED: "deleted" } as const;
export type Status = (typeof STATUS)[keyof typeof STATUS];

function setStatus(s: Status) { ... }

Why const-as-object instead of enum:

• Tree-shakable (TS enum compiles to runtime objects).
• Pure values; no class machinery.
• Plays nice with as const and Object.values().
• Industry standard (TanStack, Next.js codebase, Vercel SDK).