Skip to content

CONTRIBUTING.md

Latest commit

 

History

History
34 lines (27 loc) · 1.44 KB

CONTRIBUTING.md

File metadata and controls

34 lines (27 loc) · 1.44 KB
Raw

Contributing

Thanks for your interest in Corbits Workbench.

vendor/intx is read-only vendored code. Never open a PR that changes anything under vendor/intx — it is hand-copied, ledgered @intx/* source, not code this repo owns. See VENDORED.md for the ledger and how to propose a change upstream instead.

Before you start

  • Contributions are accepted under the terms of the Contributor License Agreement and the project license: the application (GPLv2 with AI Exception), or LGPL-2.1-or-later for contributions to a library under packages/ or workflows/.
  • Read AGENTS.md — the ground rules there apply to human and agent contributors alike.

The short version

  1. bun install && bun run check — everything must be green before and after your change.
  2. Tests first: add failing tests, then the implementation, then docs.
  3. One logical change per commit; write messages for a public audience.
  4. Never commit secrets. .env.example is the only tracked env file.
  5. Never vendor code without a ledger row and kill date in VENDORED.md.
  6. A package that owns its own product tables follows docs/package-migrations.md: literal SQL, a package-owned ledger table, applied transactionally.
  7. Security issues go through SECURITY.md, never a public issue.

This document will grow as the project does.