Initial BeeOS simulator and asset pipeline

2026-08-25 20:29:05 +00:00
commit 7d4d683a8f
265 changed files with 16676 additions and 0 deletions
@@ -0,0 +1,54 @@
+# BeeOS Phase 3 Notes
+
+## Goal
+
+Phase 3 moves BeeOS from "fake install buttons" toward a real package runtime model.
+
+## New architecture
+
+```text
+beeos/
+├─ packages/                 installed package folders
+├─ sideload/                 local package import area
+├─ data/
+│  ├─ hivestore_index.json
+│  ├─ installed_packages.json
+│  └─ settings.json
+├─ core/
+│  ├─ package_manifest.py
+│  ├─ package_manager.py
+│  ├─ permissions.py
+│  └─ ...
+└─ ui/
+   └─ simulator.py
+```
+
+## Official HiveStore rule
+
+HiveStore only shows curated listings. Sideloading is separate and developer-facing.
+
+## Package manifest shape
+
+```json
+{
+  "id": "beeos.app.example",
+  "name": "Example App",
+  "type": "app",
+  "version": "0.1.0",
+  "author": "BeeOS Community",
+  "description": "Example package.",
+  "entry": "app.py",
+  "permissions": ["time", "battery"]
+}
+```
+
+## Next phase
+
+Phase 4 should likely focus on the BeeOS app runtime API:
+
+- `beeos_api.display`
+- `beeos_api.storage`
+- `beeos_api.notifications`
+- `beeos_api.permissions`
+- simulated package execution sandbox
+- app lifecycle methods: `on_open`, `on_draw`, `on_touch`, `on_close`