planning+

Author: subtleGradient

AGENTS.md

@@ -60,6 +60,8 @@ Workflow:
 
 ## "Update tasks" (backlog refresh)
 
+**Primary goal:** identify and unblock the `0.16.300-preview` release.
+
 Meaning: reconcile intended docs/specs vs built reality, then refresh `.tasks/`.
 
 "Delegate work" and "Update tasks" are an adversarial collaboration loop:
@@ -68,7 +70,12 @@ Meaning: reconcile intended docs/specs vs built reality, then refresh `.tasks/`.
 - Gap backlog (`research/zig-cr/92-gap-backlog.md`) is the opposite evergreen handoff (update→delegate).
 
 Do this, in order:
-0. Read the delegate evidence first:
+0. Anchor on the release tracker:
+   - Treat `.tasks/backlog/TASK-209-release-0.16.300-preview.md` as the source of truth.
+   - Any discovered gap must become either:
+     - a checked/unchecked blocker line in TASK-209 **plus** an owning task card, or
+     - a triage task explicitly marked "not a release blocker" with rationale.
+1. Read the delegate evidence first:
    - `.tasks/DELEGATE_WORK_HANDOFF.md`
    - Treat it as *claims to falsify*.
    - Prefer using the captured test output + coverage notes to avoid rerunning expensive tests.
@@ -98,16 +105,19 @@ Output:
 
 ## "Delegate work" (parallel subagents)
 
+**Primary goal:** unblock the `0.16.300-preview` release by executing release-blocker tasks.
+
 Meaning: take a curated subset of `.tasks/backlog/` and run multiple subagents in parallel.
 
 This workflow must produce an evergreen handoff for the adversarial "Update tasks" phase:
 - **Gap backlog** (`research/zig-cr/92-gap-backlog.md`) is update→delegate.
 - **Delegate handoff log** (`.tasks/DELEGATE_WORK_HANDOFF.md`) is delegate→update.
 
 Procedure:
-1. Read `research/zig-cr/92-gap-backlog.md` first (it is the task map).
-2. Pick tasks with disjoint `Files to Modify`.
-3. For each selected task:
+1. Read `.tasks/backlog/TASK-209-release-0.16.300-preview.md` first (release blockers).
+2. Then read `research/zig-cr/92-gap-backlog.md` (task map + historical context).
+3. Pick tasks with disjoint `Files to Modify`.
+4. For each selected task:
    - Move `.tasks/backlog/TASK-*.md` → `.tasks/active/TASK-*.md`.
    - Launch one subagent with the task card as the entire prompt.
    - Instruct it to only touch listed files and to update the task card as it goes.

research/zig-cr/92-gap-backlog.md

@@ -31,6 +31,7 @@
 - **CL merge properties**: ✅ **18/18 PASSING** (Round 75)
 - **Sentinel properties**: ✅ **15/15 PASSING** (Round 75)
 - Parity suite: **367 passed, 4 failed (pre-existing edge cases), 22 skipped**
+- Release focus: **Primary goal is `0.16.300-preview` (Native + WASM + Browser)**
 - Test scripts: **67+ total**
 - Zig implementation: `zig/`
 - Canonical task queue: `.tasks/{backlog,active,done}/`
@@ -40,10 +41,20 @@
 ### Active (0 tasks)
 No active tasks. Core sync functionality is complete and working.
 
-### Backlog (1 task)
+### Backlog (Release focus: `0.16.300-preview`)
 | Task | Priority | Summary | Effort |
 |------|----------|---------|--------|
-| **TASK-207** | BLOCKED | Re-enable CI for release | Medium (blocked on release decision) |
+| **TASK-209** | HIGH | Release tracker: 0.16.300-preview | Large |
+| **TASK-210** | HIGH | Release versioning + tags | Medium |
+| **TASK-211** | HIGH | Native Zig artifacts (darwin + linux) | Medium |
+| **TASK-212** | HIGH | Fix WASM build for release | Medium |
+| **TASK-213** | HIGH | Browser provider uses local WASM (no CDN sql.js) | Medium |
+| **TASK-214** | HIGH | CI oracle strategy | Medium |
+| **TASK-207** | MED | Re-enable CI for release | Medium |
+| **TASK-215** | HIGH | GitHub Release ships Zig artifacts | Medium |
+| **TASK-216** | HIGH | Nix release uses Zig artifacts + preview version | Medium |
+| **TASK-217** | HIGH | effect-native OIDC npm release path | Large |
+| **TASK-218** | HIGH | Upstream 0.16.3 compat checklist | Medium |
 
 ### Triage Inbox (3 items)
 | Task | Priority | Summary | Disposition |
@@ -55,7 +66,7 @@ No active tasks. Core sync functionality is complete and working.
 ### Blocked on Tom
 | Item | Summary |
 |------|---------|
-| **release-readiness-decision.md** | When are we ready for first public release? |
+| **release-readiness-decision.md** | Tom sign-off gate for releasing `0.16.300-preview` |
 
 ### Known Limitations
 - **crsql_changes SELECT perf**: ~2-7x slower on wide tables vs Rust/C (COUNT is fast, SELECT * is slow)