forked from molecule-ai/molecule-core
9d50a6dae4
Closes core#116. Brings local-dev iteration parity with the canvas's
Turbopack HMR — edit a Go file, see the platform restart in <5s
instead of running 'docker compose up --build' (~30s) per change.
USAGE
make dev # docker compose with air-driven live reload
make up # production-shape stack (no air, normal Dockerfile)
WHAT THIS ADDS
workspace-server/.air.toml — air watch config
workspace-server/Dockerfile.dev — air-on-golang:1.25-alpine, dev-only
docker-compose.dev.yml — overlay swapping platform service
to Dockerfile.dev + bind-mounting
workspace-server/ source
Makefile — make {dev,up,down,logs,build,test}
WHAT THIS DOES NOT TOUCH
workspace-server/Dockerfile (production multi-stage build)
docker-compose.yml (prod-shape stack)
CI workflows (build prod image directly)
Tenant deployment / SaaS (image swap stays the model)
Pure additive. Existing 'docker compose up' path unchanged; production
stays on the static binary. Air install pinned via go install at image
build time so the dev image is reproducible-enough for local use (we
don't pin air to a SHA — the dev image is rebuilt locally and updates
opportunistically).
PHASE 4 SELF-REVIEW (FIVE-AXIS)
Correctness: No finding — additive change, no existing path modified.
.air.toml watches .go + .yaml under workspace-server/, excludes
_test.go and tests dir so test edits don't trigger rebuild.
Dockerfile.dev mirrors prod's 'go mod download' so first rebuild
is fast.
Readability: No finding — three small files plus a Makefile, each
with header comments explaining the WHY, not just the WHAT. The
Makefile uses the standard ## help-target pattern.
Architecture: No finding — overlay pattern (docker-compose.dev.yml
on top of docker-compose.yml) is the standard compose convention
for env-specific overrides. Doesn't fork the prod path.
Security: No finding because no production code path; dev-only image
isn't built in CI and isn't published to ECR.
Performance: No finding — air debounce=500ms, exclude_unchanged=true
so a save that doesn't change content is a no-op rebuild.
REFS
core#116 — this issue
Companion: core#117 (workspace-side config-watcher for hot-reload of
config.yaml) — different scope; this issue is platform-only.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
29 lines
1.0 KiB
Makefile
29 lines
1.0 KiB
Makefile
# Top-level Makefile — convenience wrappers around docker compose.
|
|
#
|
|
# Most molecule-core dev work happens via these shortcuts. CI doesn't
|
|
# use this Makefile; CI calls docker compose / go test directly so the
|
|
# Makefile can evolve without breaking the build.
|
|
|
|
.PHONY: help dev up down logs build test
|
|
|
|
help: ## Show this help.
|
|
@grep -E '^[a-zA-Z_-]+:.*?## ' $(MAKEFILE_LIST) | awk 'BEGIN {FS = ":.*?## "}; {printf "\033[36m%-12s\033[0m %s\n", $$1, $$2}'
|
|
|
|
dev: ## Start the full stack with air hot-reload for the platform service.
|
|
docker compose -f docker-compose.yml -f docker-compose.dev.yml up
|
|
|
|
up: ## Start the full stack in production-shape mode (no air, normal Dockerfile).
|
|
docker compose up
|
|
|
|
down: ## Stop the stack and remove containers (volumes preserved).
|
|
docker compose down
|
|
|
|
logs: ## Tail logs from all services (Ctrl-C to detach).
|
|
docker compose logs -f
|
|
|
|
build: ## Force a fresh build of the platform image (no cache).
|
|
docker compose build --no-cache platform
|
|
|
|
test: ## Run Go unit tests in workspace-server/.
|
|
cd workspace-server && go test -race ./...
|