alphalabel

Data-labeling agent. Design docs live in docs/ (see docs/00-OVERVIEW.md).

Develop

bun install
bun run typecheck
bun test
bun run dev        # opens .labeler.db, runs migrations, prints schema version

bun run dev requires LABELER_DB to be set (the script sets it to .labeler.db for local dev). There's no implicit default — missing/empty env var crashes with a message.

Project structure

src/
  main.ts                 # entry point
  database/
    database.ts           # Bun.sqlite wrapper + pragmas
    migration.ts          # forward-only migration runner
    migrations/*.sql      # numbered, applied in order under transactions
test/
  *.test.ts               # bun:test, runs against :memory: SQLite
docs/                     # design docs (~47 files, ~14k lines)

Engineering rules

See CLAUDE.md — crash over limp, no fallbacks, no back-compat, simplest thing, PR-first, tests pair with implementation. Read before contributing.