# 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