chore(release): prepare public source release

2026-07-18 15:33:01 +08:00
commit 34d6a57f38
510 changed files with 163501 additions and 0 deletions
@@ -0,0 +1,49 @@
+# Contributing
+
+Mercury Toolbox is currently proprietary and distributed under the terms in
+[LICENSE](LICENSE). Do not submit third-party code or assets unless their
+licensing terms permit this repository's intended use.
+
+## Commits
+
+Use Conventional Commits for every non-merge commit:
+
+```text
+type(scope): imperative summary
+```
+
+Scopes are optional. Supported types are `build`, `chore`, `ci`, `docs`,
+`feat`, `fix`, `perf`, `refactor`, `revert`, `style`, and `test`. Use `!`
+before the colon for a breaking change, for example:
+
+```text
+feat(sqlshape)!: replace legacy output fields
+fix(ci): preserve DuckDB runtime in portable packages
+```
+
+Check the current commit locally with:
+
+```powershell
+just commit-check
+```
+
+## Versions and Releases
+
+Versions follow [Semantic Versioning 2.0.0](https://semver.org/):
+
+- `MAJOR` for incompatible command-line or output-contract changes.
+- `MINOR` for backward-compatible commands, options, and capabilities.
+- `PATCH` for backward-compatible fixes and maintenance.
+
+Set `[workspace.package].version` in `Cargo.toml`, create an annotated `vX.Y.Z`
+tag with the exact same version, and add release notes under
+`docs/releases/vX.Y.Z.md`. Validate a release candidate with:
+
+```powershell
+just release-version-check vX.Y.Z
+just changelog
+```
+
+`git-cliff` generates `CHANGELOG.md` from Conventional Commits. The existing
+`v0.1.0` release is retained as the baseline; new entries are generated from
+the commit history after that release.