placementt-core 1.400.960 → 1.400.962

package/README.md

@@ -0,0 +1,56 @@
+# placementt-core
+
+Shared code (types, Firebase helpers, utilities, shared UI) used by `placementt-web`, `placementt-backend`, and `placementt-app`.
+
+## Testing local changes before publishing
+
+Normally, `placementt-web` and `placementt-backend` depend on published npm versions of this package (via the `dev`/`prod`/`emu` dist-tags). While you're working on a change here, you don't want to publish to npm just to test it — instead, build it locally and link it into the consuming repo with [yalc](https://github.com/wclr/yalc).
+
+### 1. Publish your local changes to the yalc store
+
+From this repo, run:
+
+```
+yarn test-local dev    # or: yarn test-local d
+yarn test-local prod   # or: yarn test-local p
+```
+
+This builds your current working tree (including uncommitted changes) with the chosen config flavor (dev swaps in dev Firebase config/credentials, prod leaves it as-is), then publishes it to your local yalc store under a fixed sentinel version (`0.0.0-local-dev` / `0.0.0-local-prod`). It restores all the swapped files afterward, so your working tree is left clean.
+
+Re-run this command any time you make further changes you want to test — it always re-publishes over the same sentinel version.
+
+### 2. Pull it into placementt-web or placementt-backend
+
+From `placementt-web` or `placementt-backend`, run:
+
+```
+yarn core dev     # or: yarn core d
+yarn core prod    # or: yarn core p
+```
+
+This checks whether a matching local yalc build exists (published in step 1). If it does, it links your local build in via `yalc add` instead of installing from npm. If it doesn't, it falls back to installing the real published `dev`/`prod` dist-tag from npm as normal.
+
+Match the flavor to what you published in step 1 (`dev` ↔ `dev`, `prod` ↔ `prod`).
+
+### 3. Restart the dev server/emulator to pick it up
+
+Neither CRA's dev server nor the Firebase emulator watches `node_modules` for changes, so you need to restart after linking. Add `--restart` (or `-r`) to the same command to do this in one step:
+
+```
+yarn core dev --restart     # or: yarn core d -r
+```
+
+- **placementt-web**: kills whatever's running on port 3000, clears `node_modules/.cache`, and runs `yarn start`.
+- **placementt-backend**: rebuilds the functions bundle (`npm run build`) and starts the functions emulator (`firebase emulators:start --only functions`).
+
+### Full loop
+
+```
+# in placementt-core, after making changes
+yarn test-local dev
+
+# in placementt-web and/or placementt-backend
+yarn core dev --restart
+```
+
+Repeat step 1 + step 3 as you iterate. Once you're happy with the change, commit it here, bump the version, and publish for real (`yarn deploy` / `yarn deploy-all`) — then re-run `yarn core dev` (or `prod`) in the consuming repos without `--restart` to drop back to the real published version instead of the local link.

package/lib/typeDefinitions.d.ts

@@ -3023,6 +3023,17 @@ export type StudentActivity = {
     reflection?: string;
     evidenceFileIds?: string[];
 };
+export type SuggestedFixRepo = "placementt-web" | "placementt-backend" | "placementt-core";
+export type SuggestedFix = {
+    isCodeChange: boolean;
+    summary: string;
+    confidence?: "low" | "medium" | "high";
+    repo?: SuggestedFixRepo;
+    filePath?: string;
+    newContent?: string;
+    diff?: string;
+    generatedAt: string;
+};
 export type SiteErrorLog = {
     created: string;
     email?: string;
@@ -3039,6 +3050,8 @@ export type SiteErrorLog = {
     requestData?: string;
     clickupTaskId?: string;
     clickupTaskName?: string;
+    suggestedFix?: SuggestedFix;
+    prUrl?: string;
 };
 export type Lead = {
     forename?: string;

package/package.json

@@ -2,7 +2,7 @@
   "private": false,
   "name": "placementt-core",
   "author": "Placementt",
-  "version": "1.400.960",
+  "version": "1.400.962",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",
   "scripts": {

package/src/typeDefinitions.ts

@@ -2993,6 +2993,19 @@ export type StudentActivity = {
   evidenceFileIds?: string[];
 };
 
+export type SuggestedFixRepo = "placementt-web"|"placementt-backend"|"placementt-core";
+
+export type SuggestedFix = {
+    isCodeChange: boolean,
+    summary: string,
+    confidence?: "low"|"medium"|"high",
+    repo?: SuggestedFixRepo,
+    filePath?: string,
+    newContent?: string,
+    diff?: string,
+    generatedAt: string,
+}
+
 export type SiteErrorLog = {
     created: string,
     email?: string,
@@ -3009,6 +3022,8 @@ export type SiteErrorLog = {
     requestData?: string,
     clickupTaskId?: string,
     clickupTaskName?: string,
+    suggestedFix?: SuggestedFix,
+    prUrl?: string,
 }
 
 export type Lead = {