apps-host: run Electron apps on the host, show them in the desktop

Edited 2026-10-27apps-host/README.md

Prototype. Python 3 standard library (Pillow for tests only). Design and numbers: ../docs/electron-apps.md.

text

export KS_APPD_HOME=/some/short/dir          # default ~/.kosmos-appd
python3 appd.py install <url-or-path> --sha256 <hex> --allow-adhoc --perm host:files:rw
python3 appd.py approve <id> --workspace /path/to/project
python3 appd.py run <id>                     # supervisor owns the app and its CDP pipe
python3 appd.py pages <id> | probe <id> | shot <id> out.png | dlist <id> outdir
python3 appd.py bridge <id> --port 4566      # stream to the guest on QEMU serial port 4566
python3 appd.py stop <id> | kill <id> | uninstall <id> [--purge]

Files: manifest.py schema, install.py fetch/verify/extract/policy/registry, perms.py approvals and workspace rules, launch.py spawn with a CDP pipe, attach.py targets/display list/screenshot/input, stream.py tile bridge, appd.py CLI and supervisor, tests/ (python3 -m unittest discover -s tests; fidelity.py and stage3_fake_guest.py need a running app). The guest end is ../desk3/03d-electronapp.HC (off until KS_ELECTRON is defined, not yet run in a VM).