v1.2.7

Released: 2026-05-16

What’s changed

Frontend runtime port migrated from 4321 to 6543

The frontend remained reachable on http://localhost:4321 after docker:reset and docker:prod because the port migration was planned but not applied in code. This release applies the migration end-to-end across all active runtime surfaces:

front/astro.config.mjs (server.port)
front/Dockerfile (PORT, EXPOSE, healthcheck target)
docker-compose.yml (front service mapping 6543:6543)
backend/src/main.ts default CORS origin
src-tauri/src/lib.rs sidecar frontend port and ALLOWED_ORIGINS
src-tauri/frontend-dist/index.html fallback redirect/poll URL
front/playwright.config.ts base URL and web server URL
scripts/check-ports.mjs and scripts/check-prereqs.mjs

Result: frontend is now served on http://localhost:6543, while docs remain on http://localhost:8001/docs/.

Documentation and operator guidance updated

Current-behavior docs and instructions were synchronized to the new frontend port, including:

Root/Frontend/Docs READMEs
Architecture, Quickstart, Dev Setup, Frontend, Configuration, Desktop App, Recovery, Backup, Docs Site
.github/copilot-instructions.md

Test-gate stabilization

Frontend e2e gate exposed a deterministic race in front/e2e/theme.spec.ts (click happened before hydration in one test path). Added waitForLoadState('networkidle') before clicking in the second theme test case.

Validation summary

Backend unit coverage: ✅ (npm run test:cov)
Backend e2e: ✅ (npm run test:e2e)
Frontend unit coverage: ✅ (npx vitest run --coverage)
Frontend e2e: ✅ (npm run test:e2e)
Docker front build: ✅ (docker-compose build front)
Docker behavior checks: ✅ 6543 up, 4321 down in reset/prod checks
Docs build: ✅ (cd docs && npm run build)

Commits

23687e5 — fix: migrate frontend port to 6543
64d852a — chore: release v1.2.7