2.5 KiB
2.5 KiB
id, title, status, wave, depends_on, plan, spec
| id | title | status | wave | depends_on | plan | spec | |
|---|---|---|---|---|---|---|---|
| 06-makefile-cutover | Makefile cutover to the Go dev launcher | done | 3 |
|
plan.md | ../../specs/platform/requirements/go-dev-launcher.md |
Task 06: Makefile cutover to the Go dev launcher
Point make dev at the native launcher and drop the Node and root winjob steps.
Acceptance
make devprebuilds onlyapps/backend/bin/kandev, copies it to a distinct launcher path, andexecs that copy withdevplus the existingDEV_FLAGS. The supervised backenddevtarget builds the native agentctl and, on hosts other than Linux/amd64, one Linux/amd64 helper. It no longer invokespnpmortsxdirectly.make dev PORT=… WEB_PORT=…still forwards--port/--web-internal-portunchanged, andmake dev-prod-dbstill exportsKANDEV_DATABASE_PATHand delegates tomake dev.- The copied launcher path is git-ignored and removed by
make clean. apps/backend/Makefile:156's comment no longer points atapps/cli/src/dev.tsfor winjob usage.
Verification
make dev
Confirm by hand: backend and Vite both start, the browser opens on the backend port, the
banner shows the .kandev-dev DB path, and Ctrl-C leaves nothing behind
(pgrep -af 'kandev|vite' || echo clean). Then repeat with
make dev PORT=38500 WEB_PORT=37500 and with make dev-prod-db, checking that a
dev-prod-db-*.db file appears in ~/.kandev/data/backups/.
Files
Makefile— thedevtarget (currently lines 187-195) andcleanapps/backend/Makefile— the lean dev build targets andbuild-winjobdoc comment.gitignore— the copied launcher binary
Inputs
Makefile:277—make start's@exec $(BACKEND_DIR)/bin/kandev start …, the shape to mirror.Makefile:60-62—DEV_PORT_FLAG,DEV_WEB_PORT_FLAG,DEV_FLAGS, unchanged.apps/backend/Makefile:30—EXEis defined in the backend Makefile, not the root one. The rootdevtarget needs its own suffix handling for thecp, or should delegate the copy to a backend target.
Risks
- The copy exists because the child
makerebuildsbin/kandevunderneath the running launcher. Do not "simplify" it away by exec'ingbin/kandevdirectly — that breaks backend restart on Windows and is fragile everywhere. build-winjobleavingmake devis the one behavior change with no automated coverage on Windows. Either verify a real Windowsmake devCtrl-C, or keep thebuild-winjobline for one release and remove it in a follow-up; say which in the PR.