92 lines
3.1 KiB
Markdown
92 lines
3.1 KiB
Markdown
# Restructure Plan
|
|
|
|
Reorganise from flat `shared/sx/ref/` to layered `spec/` + `hosts/` + `web/` + `sx/`.
|
|
|
|
Recovery point: commit `1a3d7b3` on branch `macros`.
|
|
|
|
## Phase 1: Directory structure
|
|
Create all directories. No file moves.
|
|
```
|
|
spec/tests/
|
|
hosts/python/
|
|
hosts/javascript/
|
|
web/adapters/
|
|
web/tests/
|
|
web/platforms/python/
|
|
web/platforms/javascript/
|
|
sx/platforms/python/
|
|
sx/platforms/javascript/
|
|
```
|
|
|
|
## Phase 2: Spec files (git mv)
|
|
Move from `shared/sx/ref/` to `spec/`:
|
|
- eval.sx, parser.sx, primitives.sx, render.sx
|
|
- cek.sx, frames.sx, special-forms.sx
|
|
- continuations.sx, callcc.sx, types.sx
|
|
Move tests to `spec/tests/`:
|
|
- test-framework.sx, test.sx, test-eval.sx, test-parser.sx
|
|
- test-render.sx, test-cek.sx, test-continuations.sx, test-types.sx
|
|
Remove boundary-core.sx from spec/ (it's a contract doc, not spec)
|
|
|
|
## Phase 3: Host files (git mv)
|
|
Python host - move from `shared/sx/ref/` to `hosts/python/`:
|
|
- bootstrap_py.py → hosts/python/bootstrap.py
|
|
- platform_py.py → hosts/python/platform.py
|
|
- py.sx → hosts/python/transpiler.sx
|
|
- boundary_parser.py → hosts/python/boundary_parser.py
|
|
- run_signal_tests.py, run_cek_tests.py, run_cek_reactive_tests.py,
|
|
run_continuation_tests.py, run_type_tests.py → hosts/python/tests/
|
|
|
|
JS host - move from `shared/sx/ref/` to `hosts/javascript/`:
|
|
- run_js_sx.py → hosts/javascript/bootstrap.py
|
|
- bootstrap_js.py → hosts/javascript/cli.py
|
|
- platform_js.py → hosts/javascript/platform.py
|
|
- js.sx → hosts/javascript/transpiler.sx
|
|
|
|
Generated output stays in place:
|
|
- shared/sx/ref/sx_ref.py (Python runtime)
|
|
- shared/static/scripts/sx-browser.js (JS runtime)
|
|
|
|
## Phase 4: Web framework files (git mv)
|
|
Move from `shared/sx/ref/` to `web/`:
|
|
- signals.sx → web/signals.sx
|
|
- engine.sx, orchestration.sx, boot.sx → web/
|
|
- router.sx, deps.sx, forms.sx, page-helpers.sx → web/
|
|
Move adapters to `web/adapters/`:
|
|
- adapter-dom.sx → web/adapters/dom.sx
|
|
- adapter-html.sx → web/adapters/html.sx
|
|
- adapter-sx.sx → web/adapters/sx.sx
|
|
- adapter-async.sx → web/adapters/async.sx
|
|
Move web tests to `web/tests/`:
|
|
- test-signals.sx, test-aser.sx, test-engine.sx, etc.
|
|
Move boundary-web.sx to `web/boundary.sx`
|
|
Move boundary-app.sx to `web/boundary-app.sx`
|
|
|
|
## Phase 5: Platform bindings
|
|
Web platforms:
|
|
- Extract DOM/browser primitives from platform_js.py → web/platforms/javascript/
|
|
- Extract IO/server primitives from platform_py.py → web/platforms/python/
|
|
App platforms:
|
|
- sx/sxc/pages/helpers.py → sx/platforms/python/helpers.py
|
|
- sx/sxc/init-client.sx.txt → sx/platforms/javascript/init.sx
|
|
|
|
## Phase 6: Update imports
|
|
- All Python imports referencing shared.sx.ref.*
|
|
- Bootstrapper paths (ref_dir, _source_dirs, _find_sx)
|
|
- Docker volume mounts in docker-compose*.yml
|
|
- Test runner paths
|
|
- CLAUDE.md paths
|
|
|
|
## Phase 7: Verify
|
|
- Both bootstrappers build
|
|
- All tests pass
|
|
- Dev container starts
|
|
- Website works
|
|
- Remove duplicate files from shared/sx/ref/
|
|
|
|
## Notes
|
|
- Generated files (sx_ref.py, sx-browser.js) stay where they are
|
|
- The runtime imports from shared.sx.ref.sx_ref — that doesn't change
|
|
- Only the SOURCE .sx files and bootstrapper tools move
|
|
- Each phase is a separate commit for safe rollback
|