beeos/docs/history/PHASE3_NOTES.md

BeeOS Phase 3 Notes

Goal

Phase 3 moves BeeOS from "fake install buttons" toward a real package runtime model.

New architecture

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

{
  "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