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,58 @@
+# BeeOS Phase 9 Notes
+
+## Completed in this phase
+
+Phase 9 adds multi-repo HiveStore support.
+
+New files:
+
+```text
+beeos/core/hivestore_sources.py
+beeos/data/hivestore_sources.json
+beeos/data/community_hivestore_index.json
+tools/create_hivestore_repo.py
+tools/import_hivestore_repo.py
+```
+
+## Behavior
+
+HiveStore now loads enabled sources from:
+
+```text
+beeos/data/hivestore_sources.json
+```
+
+The official repo and a community demo repo are enabled by default.
+
+Package listings are merged into one HiveStore list. If two sources publish the same package id, the first enabled source wins.
+
+## GitHub support
+
+A normal GitHub repo URL can be normalized into:
+
+```text
+https://github.com/owner/repo/raw/main/hivestore_index.json
+```
+
+A raw JSON URL can also be used.
+
+## Simulator limitation
+
+The simulator does not fetch remote repos every time it opens HiveStore. Remote fetching is handled by:
+
+```text
+tools/import_hivestore_repo.py
+```
+
+This keeps the watch-side runtime simple and allows cached repo indexes later.
+
+## Next possible phase
+
+Phase 10 should probably add:
+
+- HiveStore repo update/check workflow
+- source trust labels
+- source signing/checksums
+- package download/cache simulation
+- install transaction log
+- repo search/filtering