Directory map
The migration starts by introducing stable top-level responsibilities while leaving the working package graph in place.
hodos/├── spec/ normative Hodos drafts├── packages/ reference SDK, runtime, models, adapters, and UI├── apps/│ └── demo/ complete working reference world├── site/ Astro + Starlight public site├── docs/ non-normative implementation documents└── src/ Hara distribution and deployment entry pointsWhy packages have not moved yet
Section titled “Why packages have not moved yet”Moving renderer, source, viewer, authoring, and publication packages at the same time as changing the public site would make failures difficult to isolate. The initial arrangement therefore changes ownership and documentation first.
The next extraction can proceed package by package:
- establish source-neutral protocol and world packages;
- make
source-githubconsume the world contract rather than own it; - make the Hara runtime bridge implement the Host ABI;
- classify PlayCanvas, OPFS, Web Audio, Hestia, and wallet support as adapters;
- keep viewer, editor, Studio, and demo applications above those adapters.
Public output
Section titled “Public output”The Astro site is deployed at /hodos/. The existing demo build is copied,
without rebundling, to /hodos/demo/. Its relative assets therefore continue
to resolve inside the demo directory.