diff --git a/docs/CONSTITUTION.md b/docs/CONSTITUTION.md index 4ef340a..69d11b2 100644 --- a/docs/CONSTITUTION.md +++ b/docs/CONSTITUTION.md @@ -40,12 +40,23 @@ LLM dependencies enter at `runtime` through Planner behavior. HTTP and MCP dependencies enter at `api`. No LLM, HTTP, or MCP dependency may appear in `core`, `driver`, `device`, or `tools`. +## Packaging Boundary + +The repository is a uv workspace with `device-agent-runtime` as the root +member and outer platform packages as separate members. The cloud platform is +owned by `packages/cloud-platform` and may depend on the Runtime through an +explicit workspace source; the Runtime distribution must never depend on or +package `cloud`. + +All Python members share the committed root `uv.lock`. The Vue/Vite `console/` +remains outside the Python workspace and keeps its independent npm lifecycle. + ## Change Discipline Future changes must keep the dependency direction: `core` -> `driver`/`device` -> `tools` -> `perception` -> `storage` -> `runtime` --> `api`. +-> `api` -> optional outer workspace applications. When a change needs a new external integration, add it at the adapter layer that owns that concern, not at the domain or device boundary. diff --git a/docs/ROADMAP.md b/docs/ROADMAP.md index 4220f22..b8b3113 100644 --- a/docs/ROADMAP.md +++ b/docs/ROADMAP.md @@ -80,6 +80,12 @@ coordinated execution while preserving the same device/runtime boundaries. Add device pools, scheduling, plugins, and platform APIs for distributed execution across many devices. +The packaging baseline is complete: `device-agent-runtime` remains the root uv +workspace member, while the existing `cloud` modules and SDK are published by +the one-way dependent `device-cloud-platform` member under +`packages/cloud-platform`. A deployable control plane and Host Agent execution +loop remain separate follow-up work. + ## Long-Term Direction The long-term v2.0 direction is a "DeviceOS" / Universal Device Runtime: one diff --git a/openspec/changes/uv-workspace-packaging/tasks.md b/openspec/changes/uv-workspace-packaging/tasks.md index 462042d..27761d4 100644 --- a/openspec/changes/uv-workspace-packaging/tasks.md +++ b/openspec/changes/uv-workspace-packaging/tasks.md @@ -36,4 +36,4 @@ - [x] 5.1 Run OpenSpec validation for `uv-workspace-packaging` and confirm all workspace-packaging scenarios are covered by automated checks. - Strict OpenSpec validation passed. Sync/lock, member metadata, dependency direction, import compatibility, wheel ownership, isolated installation, Runtime entry points, and frontend independence were covered by automated commands or tests. -- [ ] 5.2 Update the project index and runtime/package documentation to record the new workspace layout and canonical commands. +- [x] 5.2 Update the project index and runtime/package documentation to record the new workspace layout and canonical commands.