Make Targets

This page indexes the most useful make entrypoints.

For the full list, run:

make help

Example usage

make quickstart-check
make build
make test

This is the common local loop: a quick smoke verification, a full build, then the standard test suite. Start with make quickstart-check when you want a fast validation path before a larger change.

Beginner / Local Loop

  • make build: everything
  • make quickstart-check: verify the beginner path against examples/first_project.vit
  • make doctor: print local toolchain and environment readiness
  • make test: run tests (std/test)
  • make parse: run parser-level tests
  • make hir-validate: run HIR validator test fixtures

Core Language

  • make grammar-check: fail if grammar generated artifacts are out of sync
  • make grammar-gate: run grammar-check + grammar-test
  • make core-language-gate: run grammar-check + core-language-test + core semantic gates + diagnostics locales lint
  • make core-release-gate: run the protected language contract gate for release-facing work

Modules / Stdlib

  • make modules-tests: run module graph/doctor fixtures
  • make modules-snapshots: assert mod graph/doctor outputs
  • make modules-contract-snapshots: assert modules contract snapshots
  • make packages-gate: run package governance/layout/perf/contract gate

CI / Reports

  • make ci-fast: run fast CI chain for language/compiler snapshots and checks
  • make ci-strict: run strict CI chain with additional diagnostics/highlight checks
  • make ci-completions: run completion check + lint + snapshots + fallback
  • make repo-hygiene-check: verify root-level repository hygiene constraints
  • make docs-paths-check: verify README/docs local path references exist
  • make dx-adoption: run DX/adoption quality gates
  • make public-benchmark-dashboard: generate publication dashboard + KPI (3/3 use cases)
  • make release-proof-notes: generate proof-oriented release notes + tag candidate
  • make all-tests: run full grouped test inventory
  • make reports-index: build target/reports/index.json (unified reports registry)
  • make release-doctor: run the snapshot/release readiness report suite

VitteOS

  • make vitteos-doctor: print VitteOS environment diagnostics
  • make vitteos-quick: run quick local loop (issues + domain + orphan + space + arch-contract + header + targeted + smoke)
  • make vitteos-ci: run VitteOS CI chain (soft scripts + bin gate + issues + domain + orphan + space + arch-contract + header + targeted + smoke + adr)
  • make vitteos-ci-strict: run strict VitteOS CI chain (strict scripts + bin gate + issues + domain + orphan + space + arch-contract + header + targeted + smoke + adr)

Packaging

  • make pkg-debian: build Debian .deb installer (PACKAGE_PROFILE=full, PKG_VERSION=2.1.1)
  • make pkg-debian-audit: audit generated Debian .deb content and largest files
  • make pkg-macos: build macOS installer pkg (PKG_VERSION=2.1.1)
  • make macos-universal-bin: build target/universal/vitte (arm64 + x86_64 via lipo)
  • make pkg-macos-universal: build macOS universal installer pkg (vitte-2.1.1-universal.pkg)
  • make release-check: run build + core-release-gate + ci-fast + ci-completions + pkg build