Expand description
bynk — the Bynk driver.
A thin orchestrator over the bynkc compiler and the Node toolchain:
bynk is to bynkc what cargo is to rustc. The compiler stays pure
(compile / check / fmt / test); environment orchestration — “is wrangler
installed”, “is your machine ready” — lives here (ADR: introduce the bynk
driver).
v0.46 ships the first command, doctor, an upfront environment check. The
crate is deliberately split into single-concern modules (per ADR 0060):
probe— the portable detection primitive (presence + version + provenance), backed by thewhichcrate so it is not Unix-only.compiler— locatebynkc(override → PATH → sibling-of-bynk) and report driver↔compiler version skew.doctor— the capability model, the checks, and the exit-code contract.report— render adoctor::Reportas a human table,--format short, or--format json.new— scaffold a new project (offline file-writing; no toolchain).dev— build a project and serve it locally withwrangler dev.check/fmt— type-check / format in-process (v0.138, #487).test— delegate to the driver-resolvedbynkc(v0.138, #487).diagnostics— shared flatten-then-delegate rendering for in-process compiles;shell— shelling the resolvedbynkc.
Modules§
- check
bynk check— type-check a.bynkfile or project without writing output.- cli
- The
bynkdriver command-line interface. - compiler
- Locate the
bynkccompiler the driver shells, and report driver↔compiler version skew. - dev
bynk dev— build a project and serve it locally in one step.- diagnostics
- Rendering for in-process compiles — the driver’s flatten-then-delegate layer.
- doctor
bynk doctor— the capability model, the checks, and the exit-code contract.- fmt
bynk fmt— format.bynksource files in place.- new
bynk new— scaffold a new project.- probe
- The shared detection probe: presence + version + provenance.
- report
- Render a
Reportin one of three shapes. - shell
- Shelling the resolved
bynkc— shared by the commands that delegate to it. - test
bynk test— discover and run a project’s test declarations.
Constants§
- DRIVER_
VERSION - The driver’s own version, from Cargo. Compared against the resolved
bynkc’s version to detect skew (compiler::Skew).