badbox
v0.0.1
Published
Deterministic bad-pattern detection for codebases.
Readme
Badbox
Badbox is a deterministic bad-pattern detector for codebases. It reports suspicious structural evidence and leaves the decision to a developer or coding agent.
This repository currently contains the initial Bun/TypeScript scaffold. The
first planned vertical slice is react/multiple-effects; scanning and rule
execution are intentionally not implemented yet.
Install
Badbox requires Bun 1.3.14 or newer.
bun add badboxThe package currently exposes the executable TypeScript rule format. The
badbox scan command remains scaffolded while the first rule is implemented.
Development
Install dependencies:
bun installInspect the initial CLI:
bun run scanType-check the scaffold:
bun run typecheckProject layout
src/cli.ts— CLI entry pointsrc/scanner/— project detection and scanning boundarysrc/rules/— Badbox-owned rule and finding contractssrc/reporters/— terminal and JSON output boundariesrules/— built-in rule packs grouped by scopetests/— tests and future rule fixtures
