From d576bb272367acebb496d4f537ab753eb770f6a4 Mon Sep 17 00:00:00 2001 From: Vernon Stinebaker Date: Mon, 28 Sep 2026 22:11:16 +0800 Subject: [PATCH 1/2] docs: add CONTRIBUTING.md with commit gates and API-contract obligations --- CONTRIBUTING.md | 15 +++++++++++++++ 1 file changed, 15 insertions(+) create mode 100644 CONTRIBUTING.md diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md new file mode 100644 index 0000000..6599689 --- /dev/null +++ b/CONTRIBUTING.md @@ -0,0 +1,15 @@ +# Contributing to nullTickets + +1. **Read [AGENTS.md](AGENTS.md)** first — it defines the engineering protocol, + module map, and conventions for this repository. +2. One concern per PR. No drive-by refactors. +3. Before every commit: + - `zig build test --summary all` — 0 failures, 0 leaks + - `bash tests/test_e2e.sh` — end-to-end API flow must pass + - `zig fmt --check src/` +4. Every PR runs the 4-target CI matrix (linux-x86_64, linux-aarch64, + macos-aarch64, windows-x86_64). Keep it green. +5. Bug fixes must include a regression test citing the issue number. +6. REST API changes must keep `/openapi.json` and `/.well-known/openapi.json` + exports in sync — the tracker contract is consumed by agents and + orchestrators that depend on it. From 0a769bf4dedc9892604a76630cd98840e1883343 Mon Sep 17 00:00:00 2001 From: Vernon Stinebaker Date: Sun, 4 Oct 2026 00:46:10 +0800 Subject: [PATCH 2/2] =?UTF-8?q?docs(contributing):=20describe=20what=20CI?= =?UTF-8?q?=20actually=20runs=20=E2=80=94=203=20test=20jobs=20+=202=20buil?= =?UTF-8?q?d-only=20cross-compiles=20(DonPrus=20review)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- CONTRIBUTING.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 6599689..7fe0dc0 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -7,8 +7,8 @@ - `zig build test --summary all` — 0 failures, 0 leaks - `bash tests/test_e2e.sh` — end-to-end API flow must pass - `zig fmt --check src/` -4. Every PR runs the 4-target CI matrix (linux-x86_64, linux-aarch64, - macos-aarch64, windows-x86_64). Keep it green. +4. Every PR runs unit tests on Linux, macOS and Windows, plus Linux + aarch64/riscv64 cross-compilation. Keep it green. 5. Bug fixes must include a regression test citing the issue number. 6. REST API changes must keep `/openapi.json` and `/.well-known/openapi.json` exports in sync — the tracker contract is consumed by agents and