dimgigov
a23860be3e
ci / build (ubuntu) (push) Has been cancelled
ci / unit + fmt (push) Has been cancelled
ci / examples (push) Has been cancelled
ci / goldens + tools (push) Has been cancelled
ci / apps (push) Has been cancelled
ci / selfhost smoke (push) Has been cancelled
ci / macos smoke (push) Has been cancelled
ci / windows smoke (push) Has been cancelled
ci / CI gate (push) Has been cancelled
selfhost-loop / bootstrap determinism (push) Has been cancelled
Bump compiler banners and package version to 1.0.0, activate SEMVER policy, and add RELEASE_v1.0.0 notes. Fix closure auto-Drop leaking outer Array drops into nested capture bodies (iter_hof). Fmt-clean examples/src for CI.
80 lines
2.4 KiB
Markdown
80 lines
2.4 KiB
Markdown
# Bux Semantic Versioning Policy
|
|
|
|
> Status: **Active** as of **v1.0.0** (language freeze)
|
|
|
|
Bux follows [Semantic Versioning 2.0.0](https://semver.org/) with the
|
|
clarifications below.
|
|
|
|
---
|
|
|
|
## Version numbers
|
|
|
|
```
|
|
MAJOR.MINOR.PATCH[-prerelease]
|
|
```
|
|
|
|
| Component | When it increases |
|
|
|-----------|-------------------|
|
|
| **MAJOR** | Breaking language / stdlib / CLI changes |
|
|
| **MINOR** | Backward-compatible features |
|
|
| **PATCH** | Backward-compatible bug fixes |
|
|
|
|
### Before 1.0 (historical 0.x)
|
|
|
|
During **0.x**, MINOR could still introduce breaking changes (documented in
|
|
release notes and `MIGRATION_*.sh` when needed).
|
|
|
|
### From **1.0.0** (language freeze)
|
|
|
|
- Breaking changes require a **MAJOR** bump and a migration guide.
|
|
- The **Language Reference** (`docs/LanguageRef.md`) is the normative spec;
|
|
compiler bugs that contradict the ref are fixed without a MAJOR bump.
|
|
- New diagnostics and stricter `@[Checked]` are allowed in MINOR when
|
|
documented; prefer gating with attributes when practical.
|
|
|
|
---
|
|
|
|
## What counts as “breaking”
|
|
|
|
- Removing or renaming a public stdlib symbol
|
|
- Changing the type or semantics of a public API
|
|
- Changing CLI flags that scripts rely on (`build`, `test`, `fmt --check`, …)
|
|
- Changing `bux.toml` / `bux.lock` fields in an incompatible way
|
|
- Changing the fat `func` / tuple C ABI in a way that breaks linked code
|
|
|
|
**Not breaking:**
|
|
|
|
- New keywords that were previously valid identifiers only if reserved carefully
|
|
(prefer contextual keywords)
|
|
- New diagnostics / stricter `@[Checked]` (document; may be gated)
|
|
- Formatter whitespace-only changes
|
|
- New optional CLI flags and commands
|
|
|
|
---
|
|
|
|
## Package versions (registry)
|
|
|
|
Registry packages use the same MAJOR.MINOR.PATCH scheme (independent of the
|
|
compiler version).
|
|
|
|
`bux add foo` / `bux add foo 0.1` resolution:
|
|
|
|
| Request | Matches |
|
|
|---------|---------|
|
|
| `*` / omitted | Latest entry for `foo` in the index |
|
|
| `0.1.1` | Exact version |
|
|
| `0.1` | First version with that prefix (e.g. `0.1.1`) |
|
|
|
|
Lockfiles pin the **resolved** version and source path/URL.
|
|
|
|
---
|
|
|
|
## Release checklist (maintainers)
|
|
|
|
1. Update `docs/LanguageRef.md` if behaviour changed
|
|
2. Update `docs/QUALITY_PLAN.md` / release notes
|
|
3. Bump compiler version strings (`bootstrap/cli.nim`, `src/cli.bux`, root `bux.toml`)
|
|
4. Run `make test` (includes `fmt-check`, examples, goldens)
|
|
5. Run `make selfhost` and preferably `make selfhost-loop`
|
|
6. Tag `vMAJOR.MINOR.PATCH` and push the tag
|