# Make Targets

This page indexes the most useful `make` entrypoints.

For the full list, run:

```sh
make help
```

## Exemples d'usage
```sh
make quickstart-check
make build
make test
```
- `make quickstart-check` vérifie rapidement le chemin de démarrage avec les exemples de base.
- `make build` construit l'ensemble du projet et génère les artefacts principaux.
- `make test` exécute la suite de tests standard du compilateur.

<!-- AUTO-GENERATED by tools/generate_make_targets_doc.py -->

## 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