# 1B Space Compositor — Research Worklog

This repo contains the complete raw findings from the 20+ parallel research
agents that investigated:

1. **Greenfield codebase** (10 agents A-J): the existing Wayland-to-HTML5
   compositor at https://github.com/udevbe/greenfield. Each agent read the
   source end-to-end and produced a Stage Summary for one layer
   (architecture, Wayland protocol, rendering, transport, input, clipboard,
   native app bridge, app lifecycle, hardware accel, pitfalls).

2. **MIT alternative approach** (10 agents K-T): research into the building
   blocks for our own MIT-licensed custom compositor — pywayland, wlroots,
   GStreamer Python bindings, modern browser stack (WebGL2, WebCodecs,
   OffscreenCanvas), clean-room legal requirements, Odoo 20 WebSocket
   integration, app sandboxing (bubblewrap + seccomp), license audit.

## File structure

- `WORKLOG.md` — the full append-only worklog from all 20+ agents. Search for
  `Task ID: A`, `Task ID: K`, etc. to jump to each agent's section.

## Related repos

- `one-os-dev-wayland-html5-compositor-greenfield-analysis` — the synthesized
  analysis (14 markdown files, ~80 pages) of Greenfield, derived from these
  agent worklogs.
- `one-os-dev-wayland-html5-compositor-mit-compositor-analysis` — the
  synthesized analysis (14 markdown files, ~80 pages) of our MIT-licensed
  alternative approach.
- `one-os-dev-wayland-html5-compositor-comparison` — the head-to-head
  comparison and recommendation.
- `one-os-dev-wayland-html5-compositor-odoo-addon-core` — the actual Odoo
  20 addon implementing the compositor core.
- `one-os-dev-wayland-html5-compositor-odoo-addon-shell` — the OWL shell UI.
- `one-os-dev-wayland-html5-compositor-dev-env` — Odoo 20 + PostgreSQL 17
  dev environment setup.

## License

Proprietary — 1B Space internal use only.
Author: 1bspace.com
Parent: 1B Global