feat: add implementation plan and design for JS/TS dependency updates

2026-05-22 17:55:44 +00:00
parent 1994b9ed17
commit 32a034a083
2 changed files with 234 additions and 0 deletions
@@ -0,0 +1,35 @@
+# JS/TS Dependency Update Design
+
+## Scope
+
+Update JavaScript and TypeScript dependencies only. The affected manifests are:
+
+- `package.json`
+- `apps/api/package.json`
+- `apps/web/package.json`
+
+Do not change `Machine_Learning/requirements.txt` or the Python/ML workflow.
+
+## Approach
+
+Use `ncu -u` across the Bun workspace to update dependency version ranges in all JS/TS package manifests. Regenerate `bun.lock` with `bun install` so the lockfile matches the updated manifests.
+
+## Refactor policy
+
+After dependency installation, run workspace verification commands. If breaking changes appear, make the smallest code or config changes needed to restore compatibility. Avoid unrelated refactors and avoid adding new features.
+
+## Verification
+
+Run:
+
+- `bun run typecheck`
+- `bun run build`
+
+If either command fails due to dependency updates, fix the underlying compatibility issue and rerun the relevant verification command.
+
+## Out of scope
+
+- Python dependency updates
+- ML pipeline changes
+- UI redesigns or feature additions
+- Database schema changes unless a dependency update requires a generated type/config compatibility fix