Expert Code Review (src/)

package.json

@@ -33,23 +33,31 @@
     "chalk": "^5.6.2",
     "chromium-bidi": "^15.0.0",
     "dotenv": "^17.2.4",
+    "fast-json-stable-stringify": "^2.1.0",
     "inquirer": "^13.2.2",
+    "jsonic": "^2.28.0",
+    "p-limit": "^7.3.0",
+    "patchright": "^1.60.1",
     "playwright-core": "^1.58.2",
     "sanitize-filename": "^1.6.3",
     "vectra": "^0.12.3",
-    "zod": "^4.3.6"
+    "write-file-atomic": "^8.0.0",
+    "zod": "^4.3.6",
+    "zod-to-json-schema": "^3.25.2"
   },
   "devDependencies": {
-    "concurrently": "^10.0.0",
     "@commitlint/cli": "^20.4.4",
     "@commitlint/config-conventional": "^20.4.4",
     "@playwright/test": "^1.58.2",
     "@release-it/conventional-changelog": "^10.0.6",
     "@types/inquirer": "^9.0.9",
+    "@types/jsonic": "^2.15.1",
     "@types/node": "^25.2.3",
     "@types/sanitize-filename": "^1.1.28",
+    "@types/write-file-atomic": "^4.0.3",
     "@vitest/coverage-v8": "^4.0.18",
     "@vitest/ui": "^4.0.18",
+    "concurrently": "^10.0.0",
     "esbuild": "^0.27.4",
     "husky": "^9.1.7",
     "lint-staged": "^17.0.5",

src/ai/cross-encoder.ts

@@ -0,0 +1,25 @@
+import { pipeline } from '@huggingface/transformers'
+
+let crossEncoderInstance: any = null
+let isEncoderInitializing = false
+
+export async function getCrossEncoder() {
+  if (crossEncoderInstance) return crossEncoderInstance
+  if (isEncoderInitializing) return null
+
+  isEncoderInitializing = true
+  try {
+    const CROSS_ENCODER_MODEL_IDENTIFIER = 'Xenova/ms-marco-MiniLM-L-6-v2'
+    const transformerPipeline = await (pipeline as any)('feature-extraction', CROSS_ENCODER_MODEL_IDENTIFIER)
+
+    crossEncoderInstance = {
+      tokenizer: transformerPipeline.tokenizer,
+      model: transformerPipeline.model,
+    }
+    return crossEncoderInstance
+  } catch {
+    return null
+  } finally {
+    isEncoderInitializing = false
+  }
+}