[ADD] OneCAD Draft Odoo integration: Rust odoo_bridge (File>Open via Documents explorer, PollWebControl drain), web/odoo glue trio (save air-gap via openCadStudioSaveFile hook, deep-link via ocs_web_drop_file), CustomEvent web-sys features, BUILD-WASM.md build guide; sandbox-constrained opt-level=0 note in release profile

BUILD-WASM.md

@@ -0,0 +1,77 @@
+# Building the OneCAD Draft wasm bundle (`static/onecaddraft`)
+
+The complete source state of this repository (rebrand + Odoo glue + Rust
+bridge) is ready to build. **The wasm compile of the app crate (640k lines of
+Rust across 789 files) needs ~4.5 GB RAM for rustc alone** — it OOM-kills in
+a 4 GB cgroup (verified twice with a memory monitor: rustc peaks at
+~3.7 GB and grows past the ceiling during metadata encoding). Any machine
+with **8 GB+ free RAM** and ~3 GB free disk completes it.
+
+## Build on a roomy machine (the one path that works end-to-end)
+
+```bash
+# 0) deps: rustup target add wasm32-unknown-unknown; cargo install --locked trunk
+#    wasm-bindgen-cli MUST match Cargo.lock (grep wasm-bindgen Cargo.lock)
+
+# 1) OPTIONAL (recommended for production quality): restore opt level
+#    In Cargo.toml [profile.release] remove the opt-level = 0 line added for
+#    the constrained sandbox build. Upstream default (opt 3) is best for CAD.
+
+# 2) build (trunk reads Trunk.toml: target=web-app.html, dist=dist/app,
+#    and runs the [[hooks]] post_build script that builds + wasm-binds
+#    the ocs_web_worker cdylib automatically)
+trunk build --release
+
+# 3) assemble + deploy + version lockstep (compiles web/odoo/*.ts with
+#    esbuild, strips sw.js/app.webmanifest, injects the odoo boot snippet,
+#    deploys to core-components/one_cad_draft/static/onecaddraft/)
+python3 scripts/assemble_onecaddraft_dist.py   # on the one-os-dev sandbox
+
+# 4) install/upgrade the module
+python3 scripts/onecaddraft-install-rpc.py     # XML-RPC 127.0.0.1:18070 db=oneos
+```
+
+`assemble_onecaddraft_dist.py` gates: REQUIRED `index.html`,
+`OpenCADStudio.js`, `OpenCADStudio_bg.wasm`, `worker_pkg/ocs_web_worker.js`,
+`worker_pkg/ocs_web_worker_bg.wasm`, `ocs-parse-worker.js`, `ocs-control.js`,
+`locale-labels.json`, non-empty `fonts/`; FORBIDDEN `sw.js`,
+`app.webmanifest` (stripped with a loud log); no absolute `/app/`-prefixed
+asset refs; version lockstep across `bundleVersion`, `__manifest__.py` and
+the glue `?v=` literals.
+
+## Sandbox lessons that cost us hours (do not re-learn)
+
+1. **`?v=` bump per build.** Odoo serves statics with 7-day max-age; the
+   assembler bumps everything in lockstep. Hard-refresh the browser once.
+2. **wasm-bindgen stack OOM** when the Odoo stack is up: `oneos-dev down`
+   before bindgen, `up` after (the assembler does not build, so this only
+   matters for manual bindgen runs).
+3. **NEVER `wasm-tools strip -a`** (destroys `__wasm_bindgen_unstable`).
+   Use `wasm-opt --strip-dwarf` then `-O1`/`-O2` if hand-optimizing; trunk
+   already runs the wasm-opt pass requested in the HTML tag.
+4. **Overlay rootfs**: only runtime-layer deletions free space; build
+   scratch must be deleted eagerly (`target/release/deps` re-fills on
+   resume — deleting it buys nothing net).
+5. **`NO_COLOR=1` breaks trunk's clap parser** (`--no-color` expects
+   true/false): run trunk with `env -u NO_COLOR`.
+6. **`cargo check` creates a full second (dev-profile) tree** — on a
+   constrained disk it IS the disk-full event. Don't check; build.
+7. **Orphan sweep**: profile-era changes leave stale-hash artifacts forever;
+   `scripts/prune-orphans.py` (in the one-os-dev sandbox) reclaims them.
+8. **Background processes die between tool calls** in the z.ai sandbox —
+   run long builds in ≤9-minute foreground chunks; cargo resumes
+   incrementally.
+
+## What is already wired (no further source work needed)
+
+- `web/odoo/{index.ts,bridge.ts,explorer.js}` — the Documents glue (save
+  air-gap via `window.openCadStudioSaveFile`, deep-link opens via
+  `wasmBindings.ocs_web_drop_file`, explorer dialogs, bind storage).
+- `src/odoo_bridge.rs` — Rust bridge: `File > Open` in the embedded shell
+  dispatches `onecaddraft:host-request {method:"odoo.pickOpen"}` and drains
+  completions in `Message::PollWebControl` (50 ms tick) into
+  `open_web_bytes`. Never touches `window.onecaddraftHostReady`.
+- `src/app/update/file.rs` (intercept) + `src/app/update/mod.rs` (drain) +
+  `src/lib.rs` (module decl) + `Cargo.toml` (CustomEvent features).
+- `core-components/one_cad_draft/` in one-os-dev: the 5-file addon
+  (storage seq 52, menu seq 37, extensions dxf/dwg, fileExtension .dxf).