Task: Adopt the Volga prototype as projects/ores.web
Table of Contents
This page documents a task in the Integrate the Volga TypeScript UI as ores.web story. It captures the goal, current status, acceptance, and any notes or results.
1. Goal
projects/ores.web holds the Volga prototype under ORE Studio naming, and the component typechecks and passes its tests.
2. Status
| Field | Value |
|---|---|
| State | DONE |
| Parent story | Integrate the Volga TypeScript UI as ores.web |
| Now | Nothing. |
| Waiting on | Nothing. |
| Next | Nothing. |
| Last touched | 2026-09-19 |
3. Acceptance
- The prototype's packages live under projects/ores.web/packages with the npm scope @ores.
- No committed node_modules, .runtime, .env, screenshot or cache files remain.
- New source files carry the ORE Studio licence header.
- npm run typecheck and npm test pass for the component.
4. Plan
(Implementation strategy. Written when work starts; key decisions
are distilled into the parent story's * Decisions at close, but the
plan itself stays — it is the historical record of what we did.)
5. Notes
6. Test Scenarios
Manual QA scenarios (scaffolded via compass add test_scenario)
that verify this task. Link
new ones here as they're created; the scenario doc itself links back
via its "Verifies task" field.
| Scenario | State | Notes |
|---|---|---|
7. PRs
| PR | Title |
|---|---|
| #2108 | [web] Integrate the Volga TypeScript UI as ores.web |
8. Review
| Comment summary | File | Decision | Notes |
|---|---|---|---|
9. Result
Adopted. projects/ores.web holds the four npm workspace packages (bff,
contracts, web, wire-protocol), the configuration, the scripts and the
design notes. The npm scope is @ores/*; the component's own process
variables are ORES_WEB_*; the broker variables reuse the ORES_NATS_*
names the checkout's .env already provides.
npm run typecheck, npm test (34 tests) and npm run build all pass.
node_modules, dist, .runtime, .env, the stale connections package
and every screenshot and cache were left out. Every hand-written TypeScript
and shell file carries the GPL header.
The README was rewritten for the adopted component and the markdown design
notes were converted to org; validate_docs.sh passes for all 42
components.