docs: document build:ci in migration howto

Adds the build:ci npm script, the build-ci Makefile target, and a corresponding CI workflow step to the MFE migration guide, so newly migrated apps get webpack-build smoke coverage out of the box.

Co-Authored-By: Claude <noreply@anthropic.com>

Author: arbrandes

docs/how_tos/migrate-frontend-app.md

@@ -139,6 +139,7 @@ With the exception of any custom scripts, replace the `scripts` section of your
 ```json
   "scripts": {
     "build": "make build",
+    "build:ci": "make build-ci",
     "clean": "make clean",
     "dev": "PORT=YOUR_PORT PUBLIC_PATH=/YOUR_APP_NAME openedx dev",
     "i18n_extract": "openedx formatjs extract",
@@ -183,10 +184,22 @@ build:
 	    cp "$$f" "$$d"; \
 	  done' sh {} +
 	tsc-alias -p tsconfig.build.json
+
+build-ci:
+	SITE_CONFIG_PATH=site.config.dev.tsx openedx build
 ```
 
 Note that the `find` command copies all files under `assets/` directories regardless of type, so you don't need to enumerate asset extensions.  Also note that `tsc-alias` runs after the copy step so that it can resolve `@src` aliases pointing to asset files.  If it ran before, it wouldn't find them and would omit them from the relative path conversion.
 
+The `build-ci` target is separate from `build` because apps are distributed build-less: `build` compiles only the library `dist/` via `tsc`, which doesn't verify that the app can actually be webpack-bundled as a deployable site. `build:ci` runs `openedx build` against `site.config.dev.tsx` (which imports the real app) so webpack traverses the actual app graph, catching errors such as broken imports in lazy-loaded routes that neither `tsc` nor Jest would surface. Reusing `site.config.dev.tsx` is important because `site.config.test.tsx` typically registers an inline app stub for Jest's sake and therefore never pulls the real app into the webpack graph. The dev config's URLs and `environment` value are inert at build time, since nothing executes the produced bundle.
+
+Add a corresponding step to your GitHub Actions workflow after the existing build step, so CI fails on any breakage that would only surface at webpack bundle time:
+
+```yaml
+- name: Build (CI)
+  run: npm run build:ci
+```
+
 Other package.json edits
 ------------------------