Skip to content

Commit 5bfeb9a

Browse files
feat(release): 0.16.300-preview infrastructure (Round 77)
- TASK-210: Version → 0.16.300-preview in package.json, flake.nix - TASK-211: Native build verified, scripts/build-zig.sh release added - TASK-212: WASM build fixed (Zig 0.15 compat) - TASK-213: Browser provider loads local WASM (no CDN) - TASK-215: .github/workflows/publish.yaml rewritten for Zig - TASK-218: Backwards-compat checklist documented - TASK-219: Test suite reviewed (72 tests) - WF-028: Empty BLOB PK encoding parity fixed Build artifacts excluded from commit.
1 parent 4ed6749 commit 5bfeb9a

28 files changed

+2339
-500
lines changed

.github/workflows/publish.yaml

Lines changed: 158 additions & 195 deletions
Large diffs are not rendered by default.

.gitignore

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -24,3 +24,8 @@ zig/*.o
2424
zig/wasm-build/build/
2525
zig/wasm-build/dist/
2626
.tmp/
27+
lib/crsqlite-zig-darwin-aarch64.dylib
28+
lib/crsqlite-zig-darwin-universal.dylib
29+
lib/crsqlite-zig-darwin-x86_64.dylib
30+
lib/crsqlite-zig-linux-aarch64.so
31+
lib/crsqlite-zig-linux-x86_64.so

.tasks/DELEGATE_WORK_HANDOFF.md

Lines changed: 79 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -68,6 +68,85 @@ Artifacts:
6868

6969
---
7070

71+
## Round 2025-12-25 (77) — Release 0.16.300-preview infrastructure (8 tasks in parallel)
72+
73+
**Tasks executed**
74+
- `.tasks/done/TASK-210-release-versioning-and-tags.md` — version alignment
75+
- `.tasks/done/TASK-211-release-native-zig-artifacts.md` — native build verification
76+
- `.tasks/done/TASK-212-fix-wasm-build-for-release.md` — WASM build fix
77+
- `.tasks/done/TASK-213-browser-provider-loads-crsqlite-wasm.md` — browser provider local WASM
78+
- `.tasks/done/TASK-215-github-release-zig-artifacts.md` — GitHub release workflow
79+
- `.tasks/done/TASK-218-compat-checklist-0.16.3.md` — backwards compat checklist
80+
- `.tasks/done/TASK-219-test-suite-review-and-ranking.md` — test suite review
81+
- Empty BLOB PK parity fix (WF-028)
82+
83+
**Commits**
84+
- (pending commit)
85+
86+
**Environment**
87+
- OS: darwin (macOS ARM64)
88+
- Tooling: nix, zig 0.15 (via nix), bun, bash
89+
90+
**Key Changes Made**
91+
92+
| Task | Files Changed | Summary |
93+
|------|---------------|---------|
94+
| TASK-210 | `package.json`, `flake.nix`, `scripts/sync-version.ts` | Version → `0.16.300-preview` |
95+
| TASK-211 | `scripts/build-zig.sh` | Added `release` command, verified all targets build |
96+
| TASK-212 | `zig/src/ffi/api.zig`, `zig/src/fract_index.zig` | Fixed SQLITE_TRANSIENT + WASM allocator |
97+
| TASK-213 | `zig/browser-test/src/provider/worker.ts`, `zig/browser-dist/provider.js` | Removed CDN, local WASM loading |
98+
| TASK-215 | `.github/workflows/publish.yaml` | Complete rewrite for Zig artifacts |
99+
| TASK-218 | Task card | Full compat checklist documented |
100+
| TASK-219 | Task card | 72 tests reviewed, blind spots identified |
101+
| WF-028 | `zig/src/ffi/api.zig` | Fixed empty BLOB PK encoding |
102+
103+
**Commands run (exact)**
104+
```bash
105+
cd zig && nix run nixpkgs#zig -- build -Doptimize=ReleaseFast
106+
cd zig && nix run nixpkgs#zig -- build wasm
107+
bash zig/harness/test-pk-blob-parity.sh
108+
```
109+
110+
<details>
111+
<summary>Build verification</summary>
112+
113+
```text
114+
Native build: SUCCESS
115+
WASM build: SUCCESS
116+
PK blob parity: 9/9 PASS (WF-028 fixed)
117+
```
118+
</details>
119+
120+
<details>
121+
<summary>Native artifacts produced</summary>
122+
123+
```text
124+
lib/crsqlite-zig-darwin-aarch64.dylib 2.7M
125+
lib/crsqlite-zig-darwin-x86_64.dylib 2.6M
126+
lib/crsqlite-zig-darwin-universal.dylib 5.3M
127+
lib/crsqlite-zig-linux-x86_64.so 4.8M
128+
lib/crsqlite-zig-linux-aarch64.so 4.9M
129+
```
130+
</details>
131+
132+
**Reproduction steps (clean checkout)**
133+
1. `git clone <repo> && cd cr-sqlite`
134+
2. `cd zig && nix run nixpkgs#zig -- build -Doptimize=ReleaseFast`
135+
3. `cd zig && nix run nixpkgs#zig -- build wasm`
136+
4. `bash zig/harness/test-pk-blob-parity.sh` — verify 9/9 pass
137+
138+
**Known gaps / unverified claims**
139+
- Browser tests run locally (30/30 pass) but not in CI yet
140+
- Linux cross-compile not verified on actual Linux hardware
141+
- TASK-214 (CI oracle strategy), TASK-207 (CI re-enable), TASK-216 (nix), TASK-217 (npm) still in backlog
142+
143+
**Test Suite Review Findings (TASK-219)**
144+
- 72 total tests, 65 passing (90%)
145+
- **Top blind spot**: Browser/WASM path has no automated tests in CI
146+
- Recommended: Add WASM browser tests before release
147+
148+
---
149+
71150
## Round 2025-12-25 (76) — seq divergence + schema mismatch fixes (2 tasks)
72151

73152
**Tasks executed**

.tasks/backlog/TASK-209-release-0.16.300-preview.md

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -58,6 +58,12 @@ This list is intended to be exhaustive. Each blocker must have an owning task ca
5858
- [ ] **Backwards-compat checklist for upstream `0.16.3` is explicit and checked off** (functions, tables, browser runtime expectations).
5959
- Task: `.tasks/backlog/TASK-218-compat-checklist-0.16.3.md`
6060

61+
### Parity / quality gate
62+
- [ ] **Empty BLOB PK encoding parity (WF-028)** — time-boxed fix attempt; punt to RC if overflow.
63+
- Wish: `.wishes/blocked-on-tom/zig-empty-blob-pk-encoding-parity.md`
64+
- [ ] **Test suite review and ranking** — identify blind spots, stupid tests, missing coverage.
65+
- Task: `.tasks/backlog/TASK-219-test-suite-review-and-ranking.md`
66+
6167
## Files to Modify
6268
- `.tasks/backlog/TASK-209-release-0.16.300-preview.md` (this file)
6369

.tasks/backlog/TASK-210-release-versioning-and-tags.md

Lines changed: 0 additions & 38 deletions
This file was deleted.

.tasks/backlog/TASK-211-release-native-zig-artifacts.md

Lines changed: 0 additions & 35 deletions
This file was deleted.

.tasks/backlog/TASK-212-fix-wasm-build-for-release.md

Lines changed: 0 additions & 33 deletions
This file was deleted.

.tasks/backlog/TASK-213-browser-provider-loads-crsqlite-wasm.md

Lines changed: 0 additions & 38 deletions
This file was deleted.

.tasks/backlog/TASK-215-github-release-zig-artifacts.md

Lines changed: 0 additions & 30 deletions
This file was deleted.

.tasks/backlog/TASK-218-compat-checklist-0.16.3.md

Lines changed: 0 additions & 34 deletions
This file was deleted.

0 commit comments

Comments
 (0)