Files
road-compiler/.trellis/tasks/archive/2026-08/08-26-web-osm-import/implement.md

20 lines
1.2 KiB
Markdown

# Implementation Plan
1. Read frontend/backend project specs and map the current workbench startup contract.
2. Extract small, testable helpers for session workspace creation, default `RoadCompilerInput`, and bounded OSM request handling.
3. Repair `bin/road-workbench.js` to support import-first startup while adapting legacy `--input` files.
4. Add server endpoints for upload/bootstrap and active-session state, preserving all existing edit routes.
5. Add a minimal import screen and transition in the existing client; keep the map/editor UI intact.
6. Add tests for helper validation and an HTTP import smoke path using `test/fixtures/fengshu-er-road.osm`.
7. Run `npm test`, targeted workbench tests, and manual localhost smoke checks; fix issues found.
8. Run Trellis quality check, update relevant specs if a durable convention is discovered, then commit.
Validation commands:
- `npm test`
- `node --check bin/road-workbench.js`
- `node --check workbench/server.js`
- targeted workbench test command added by this task
Rollback points: CLI/server changes can be reverted independently of compiler sources; workspace staging ensures an import failure does not alter an existing session.