pcbjam/docs/features
Repository files (latest commit first)
Filename Latest commit message Latest commit date
Gergő Törcsvári 23c636dced
docs: doc 22 (absorb libcontext) + honest scoreboard on doc 20
Doc 20 gets a status table instead of a narrative: D-1/D0/D1 done, D2
reverted, D3's goal met but its MEANS skipped (waits still park in
place — only the stack they park on changed), D4/D5/D6 not started. Plus
an explicit "what was skipped and is still owed" list, so nothing quietly
reads as delivered: dispatch contexts, waits-as-yields, bridges,
real-park-site buffer sizing, the both-EH CI matrix.

Doc 22 is the handoff plan a fresh session can implement from:
- the bug it targets is the BLUE SCREEN (a context recovered twice or by
  the wrong fiber), not doc 19's hang, which is fixed and was only one
  ingredient;
- the diagnosis that matters: bookkeeping is already centralised
  (currData is single-writer, the shim sees every swap) but the DECISION
  is not — libcontext decides swaps and never tells anyone, so three
  layers each invented heuristics. Centralising means moving the
  decision;
- why D2/D3 knotted, with the measurements, so nobody retries that order;
- phases A-F with estimates (~4-6 wk): A absorbs libcontext behaviour-
  preservingly and is landable ALONE (the de-risking step D2 never had),
  B+C+D must land as one commit, E bridges, F deletes the guards only
  once they are provably silent;
- gates including the crash's own repro, since the batteries never
  reproduced it and therefore cannot certify it;
- the traps this run paid for: 16-byte fiber stack alignment, the
  per-fiber stack-limits gotcha, host-side asyncify buffers, the
  stack-ownership rule, partial migration, and the gitignored-artifact
  triage trick;
- measured build/test cycle costs, so the estimates are grounded.

README: index rows for 21 and 22, doc 19 marked FIXED, and the stale
2026-06 "single decisive next step" folded away behind the current one.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01TEHGiiXMShNXbBr7gSJ7iz
2026-08-10 10:14:17 +02:00
..
3d-raytracer fix: 🐛 raytrace deadlock - pre-warm 2N+8 pthread Workers 2026-07-02 13:01:02 +02:00
archive docs: ✏️ cleanup and organize docs 2026-06-05 12:16:13 +02:00
async docs: doc 22 (absorb libcontext) + honest scoreboard on doc 20 2026-08-10 10:14:17 +02:00
asyncify-arbiter test(asyncify): red-green race harness + ablation flags, unwind-catch shim, spec tightening, decisions docs 2026-06-12 17:02:59 +02:00
browser-tools config: 🔧 move submodules to ee 2026-06-05 13:36:44 +02:00
editor-unification docs(wasm): Part 2 record — rebase onto main done, 3d-viewer drag deadlock resolved (7630c7e pool pre-warm), rerun green 2026-07-02 17:56:02 +02:00
fix-asyncify-O2-and-modal-promise-rejection docs: ✏️ cleanup and organize docs 2026-06-05 12:16:13 +02:00
fork-cleanup eeschema simulator: lazy ngspice_service worker — static sharedspice (XSPICE registry + CIDER), init_dll ifdef, e2e both engines 2026-07-19 15:59:21 +02:00
gerbview docs: ✏️ cleanup and organize docs 2026-06-05 12:16:13 +02:00
hoist-cpp-catches-simplification docs(hoist): pass-simplification dossier; bump binaryen (FindAll/BranchUtils refactor) 2026-07-01 16:52:17 +02:00
libraries docs: library management feature design notes 2026-06-11 07:50:57 +02:00
ngspice-split eeschema simulator: lazy ngspice_service worker — static sharedspice (XSPICE registry + CIDER), init_dll ifdef, e2e both engines 2026-07-19 15:59:21 +02:00
occ-split feat(wasm): occ-split — lazy occ_service worker; kicad_editor drops OCC (−31%) 2026-07-03 12:39:58 +02:00
perf feat(wasm-eh): migrate the WASM build to native wasm exceptions (+ 3D viewer default-on) 2026-06-30 09:40:26 +02:00
pl-editor docs: ✏️ cleanup and organize docs 2026-06-05 12:16:13 +02:00
schematic docs: ✏️ cleanup and organize docs 2026-06-05 12:16:13 +02:00
symbol-editor docs: ✏️ cleanup and organize docs 2026-06-05 12:16:13 +02:00
threading feat(wasm-eh): migrate the WASM build to native wasm exceptions (+ 3D viewer default-on) 2026-06-30 09:40:26 +02:00
wasm-exceptions docs(wasm-eh): add native-EH vs JS-EH runtime benchmark report 2026-07-01 14:43:54 +02:00
web-e2e-rot e2e/CI: dual-engine suites, per-engine screenshots, SwiftShader retired, prod web suite, CI-coverage gate 2026-07-17 12:21:54 +02:00
web-init docs: ✏️ cleanup and organize docs 2026-06-05 12:16:13 +02:00
wx-dom-port fix: 🐛 kicad aui resize 2026-06-22 08:49:22 +02:00
wx-parity-bugs e2e/CI: dual-engine suites, per-engine screenshots, SwiftShader retired, prod web suite, CI-coverage gate 2026-07-17 12:21:54 +02:00
ysync-review feat(collab): local-ops-only undo — remote applies skip the undo stack (ysync miss 09) 2026-07-08 11:09:26 +02:00