# 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`