From c486b6ada9f8125e06ad4895971ed8564d2d0ed0 Mon Sep 17 00:00:00 2001
From: Shawn Price <hi@shawnprice.com>
Date: Sun, 5 Oct 2025 17:38:47 -0700
Subject: [PATCH 1/8] Swap neutral to abstain and have LLM judge yes|no|abstain

---
 package.json                                  |   4 +-
 pnpm-lock.yaml                                |  97 +++++++--
 src/app/BillExplorer.tsx                      |  18 +-
 src/app/[id]/edit/page.tsx                    |   2 +-
 src/app/[id]/opengraph-image.tsx              |   7 +-
 src/app/[id]/page.tsx                         |  21 +-
 src/app/bills/[id]/edit/page.tsx              |   2 +-
 src/app/page.tsx                              |   4 +-
 src/app/types.ts                              |   2 +-
 src/components/BillCard.tsx                   |  16 +-
 src/components/BillDetail/BillAnalysis.tsx    |   4 +-
 .../filter-section.component.tsx              |   2 +-
 .../Judgement/judgement.component.tsx         |  36 +---
 src/components/OG                             |   4 +-
 src/components/OpenGraph/BillOgCard.tsx       |  22 +--
 src/components/OpenGraph/QuestionOgCard.tsx   |   7 +-
 src/migrations/1.ts                           |  26 +++
 src/models/Bill.ts                            |   4 +-
 src/prompt/summary-and-vote-prompt.ts         |  26 ++-
 src/scripts/migrate.ts                        |  77 ++++++++
 src/services/billApi.ts                       |  48 +++--
 src/utils/billConverters.ts                   |  20 +-
 .../should-show-determination.test.ts         | 185 +++---------------
 .../should-show-determination.util.ts         |  48 +----
 src/utils/vote-display.ts                     |  35 ----
 25 files changed, 332 insertions(+), 385 deletions(-)
 create mode 100644 src/migrations/1.ts
 create mode 100644 src/scripts/migrate.ts
 delete mode 100644 src/utils/vote-display.ts

diff --git a/package.json b/package.json
index 2cf47d4..99d0eea 100644
--- a/package.json
+++ b/package.json
@@ -13,7 +13,8 @@
     "test:watch": "vitest",
     "test:ui": "vitest --ui",
     "test:coverage": "vitest run --coverage",
-    "prompt": "tsx src/scripts/copy-bill-prompt.ts"
+    "prompt": "tsx src/scripts/copy-bill-prompt.ts",
+    "migrate": "tsx src/scripts/migrate.ts"
   },
   "dependencies": {
     "@auth/core": "0.34.2",
@@ -79,6 +80,7 @@
     "@types/react-dom": "19.1.9",
     "@vitest/ui": "^3.2.4",
     "daisyui": "^5.1.7",
+    "dotenv": "^17.2.3",
     "happy-dom": "^18.0.1",
     "husky": "^9.1.7",
     "tailwindcss": "^4",
diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml
index 0f899d5..fe11e7b 100644
--- a/pnpm-lock.yaml
+++ b/pnpm-lock.yaml
@@ -17,6 +17,9 @@ importers:
       '@google/generative-ai':
         specifier: ^0.24.1
         version: 0.24.1
+      '@next/third-parties':
+        specifier: ^15.5.3
+        version: 15.5.4(next@15.5.3(@babel/core@7.1.6)(react-dom@19.1.1(react@19.1.1))(react@19.1.1))(react@19.1.1)
       '@radix-ui/react-accordion':
         specifier: ^1.2.12
         version: 1.2.12(@types/react-dom@19.1.9(@types/react@19.1.13))(@types/react@19.1.13)(react-dom@19.1.1(react@19.1.1))(react@19.1.1)
@@ -101,6 +104,9 @@ importers:
       cmdk:
         specifier: ^1.1.1
         version: 1.1.1(@types/react-dom@19.1.9(@types/react@19.1.13))(@types/react@19.1.13)(react-dom@19.1.1(react@19.1.1))(react@19.1.1)
+      dayjs:
+        specifier: ^1.11.18
+        version: 1.11.18
       fast-xml-parser:
         specifier: ^5.2.5
         version: 5.2.5
@@ -186,12 +192,21 @@ importers:
       daisyui:
         specifier: ^5.1.7
         version: 5.1.12
+      dotenv:
+        specifier: ^17.2.3
+        version: 17.2.3
       happy-dom:
         specifier: ^18.0.1
         version: 18.0.1
+      husky:
+        specifier: ^9.1.7
+        version: 9.1.7
       tailwindcss:
         specifier: ^4
         version: 4.1.13
+      tsx:
+        specifier: ^4.20.5
+        version: 4.20.6
       tw-animate-css:
         specifier: ^1.3.8
         version: 1.3.8
@@ -200,7 +215,7 @@ importers:
         version: 5.9.2
       vitest:
         specifier: ^3.2.4
-        version: 3.2.4(@types/debug@4.1.12)(@types/node@20.19.16)(@vitest/ui@3.2.4)(happy-dom@18.0.1)(jiti@2.5.1)(jsdom@27.0.0(postcss@8.5.6))(lightningcss@1.30.1)(terser@5.44.0)
+        version: 3.2.4(@types/debug@4.1.12)(@types/node@20.19.16)(@vitest/ui@3.2.4)(happy-dom@18.0.1)(jiti@2.5.1)(jsdom@27.0.0(postcss@8.5.6))(lightningcss@1.30.1)(terser@5.44.0)(tsx@4.20.6)
 
 packages:
 
@@ -1535,6 +1550,12 @@ packages:
     cpu: [x64]
     os: [win32]
 
+  '@next/third-parties@15.5.4':
+    resolution: {integrity: sha512-l3T1M/EA32phPzZx+gkQAWOF3E5iAULL1nX4Ej0JZQOXaBwwJzb/rd2uefr5TAshJj/+HjjwmdFu7olXudvgVg==}
+    peerDependencies:
+      next: ^13.0.0 || ^14.0.0 || ^15.0.0
+      react: ^18.2.0 || 19.0.0-rc-de68d2f4-20241204 || ^19.0.0
+
   '@nodelib/fs.stat@1.1.3':
     resolution: {integrity: sha512-shAmDyaQC4H92APFoIaVDHCx5bStIocgvbwQyxPRrbUY20V1EYTbSDchWbuwlMG3V17cprZhA6+78JfB+3DTPw==}
     engines: {node: '>= 6'}
@@ -3781,6 +3802,9 @@ packages:
   date-fns@4.1.0:
     resolution: {integrity: sha512-Ukq0owbQXxa/U3EGtsdVBkR1w7KOQ5gIBqdH2hkvknzZPYvBxb/aa6E8L7tmjFtkwZBu3UXBbjIgPo/Ez4xaNg==}
 
+  dayjs@1.11.18:
+    resolution: {integrity: sha512-zFBQ7WFRvVRhKcWoUh+ZA1g2HVgUbsZm9sbddh8EC5iv93sui8DVVz1Npvz+r6meo9VKfa8NyLWBsQK1VvIKPA==}
+
   debug@2.6.9:
     resolution: {integrity: sha512-bC7ElrdJaJnPbAP+1EotYvqZsb3ecl5wi6Bfi6BJTUcNowp6cvspg0jXznRTKDjm/E7AdgFBVeAPVMNcKGsHMA==}
     peerDependencies:
@@ -3985,6 +4009,10 @@ packages:
   dotenv-expand@4.2.0:
     resolution: {integrity: sha512-pHWVt6L/YkqbBCMb1hG6e7oO0WdMhlapDIibl+BZ9PncVE3i+G77uvNr8GUxW2ItSituOK8QOYC9oOJjwWD94A==}
 
+  dotenv@17.2.3:
+    resolution: {integrity: sha512-JVUnt+DUIzu87TABbhPmNfVdBDt18BLOWjMUFJMSi/Qqg7NTYtabbvSNJGOJ7afbRuv9D/lngizHtP7QyLQ+9w==}
+    engines: {node: '>=12'}
+
   dotenv@6.0.0:
     resolution: {integrity: sha512-FlWbnhgjtwD+uNLUGHbMykMOYQaTivdHEmYwAKFjn6GKe/CqY0fNae93ZHTd20snh9ZLr8mTzIL9m0APQ1pjQg==}
     engines: {node: '>=6'}
@@ -4643,6 +4671,9 @@ packages:
     resolution: {integrity: sha512-w9UMqWwJxHNOvoNzSJ2oPF5wvYcvP7jUvYzhp67yEhTi17ZDBBC1z9pTdGuzjD+EFIqLSYRweZjqfiPzQ06Ebg==}
     engines: {node: '>= 0.4'}
 
+  get-tsconfig@4.10.1:
+    resolution: {integrity: sha512-auHyJ4AgMz7vgS8Hp3N6HXSmlMdUyhSUrfBF16w153rxtLIEOE+HGqaBppczZvnHLqQJfiHotCYpNhl0lUROFQ==}
+
   get-value@2.0.6:
     resolution: {integrity: sha512-Ln0UQDlxH1BapMu3GPtf7CuYNwRZf2gwCuPqbyG6pB8WfmFpzqcy4xtAaAMUhnNqjMKTiCPZG2oMT3YSx8U2NA==}
     engines: {node: '>=0.10.0'}
@@ -4951,6 +4982,11 @@ packages:
     resolution: {integrity: sha512-vK9P5/iUfdl95AI+JVyUuIcVtd4ofvtrOr3HNtM2yxC9bnMbEdp3x01OhQNnjb8IJYi38VlTE3mBXwcfvywuSw==}
     engines: {node: '>= 14'}
 
+  husky@9.1.7:
+    resolution: {integrity: sha512-5gs5ytaNjBrh5Ow3zrvdUUY+0VxIuWVL4i9irt6friV+BqdCfmV11CQTWMiBYWHbXhco+J1kHfTOUkePhCDvMA==}
+    engines: {node: '>=18'}
+    hasBin: true
+
   iconv-lite@0.4.24:
     resolution: {integrity: sha512-v3MXnZAcvnywkTUEZomIActle7RXXeedOR31wwl7VlyoXO4Qi9arvSenNQWne1TcRwhCL1HwLI21bEqdpj8/rA==}
     engines: {node: '>=0.10.0'}
@@ -7661,6 +7697,9 @@ packages:
     resolution: {integrity: sha512-qYg9KP24dD5qka9J47d0aVky0N+b4fTU89LN9iDnjB5waksiC49rvMB0PrUJQGoTmH50XPiqOvAjDfaijGxYZw==}
     engines: {node: '>=8'}
 
+  resolve-pkg-maps@1.0.0:
+    resolution: {integrity: sha512-seS2Tj26TBVOC2NIc2rOe2y2ZO7efxITtLZcGSOnHHNOQ7CkiUBfw0Iw2ck6xkIhPwLhKNLS8BO+hEpngQlqzw==}
+
   resolve-url@0.2.1:
     resolution: {integrity: sha512-ZuF55hVUQaaczgOIwqWzkEcEidmlD/xl44x1UZnhOXcYuFN2S6+rcxpG+C1N3So0wvNI3DmJICUFfu2SxhBmvg==}
     deprecated: https://github.com/lydell/resolve-url#deprecated
@@ -8326,6 +8365,9 @@ packages:
   text-table@0.2.0:
     resolution: {integrity: sha512-N+8UisAXDGk8PFXP4HAzVR9nbfmVJ3zYLAWiTIoqC5v5isinhr+r5uaO8+7r3BMfuNIufIsA7RdpVgacC2cSpw==}
 
+  third-party-capital@1.0.20:
+    resolution: {integrity: sha512-oB7yIimd8SuGptespDAZnNkzIz+NWaJCu2RMsbs4Wmp9zSDUM8Nhi3s2OOcqYuv3mN4hitXc8DVx+LyUmbUDiA==}
+
   throat@4.1.0:
     resolution: {integrity: sha512-wCVxLDcFxw7ujDxaeJC6nfl2XfHJNYs8yUYJnvMgtPEFlttP9tHSfRUv2vBe6C4hkVFPWoP1P6ZccbYjmSEkKA==}
 
@@ -8461,6 +8503,11 @@ packages:
   tslib@2.8.1:
     resolution: {integrity: sha512-oJFu94HQb+KVduSUQL7wnpmqnfmLsOA/nAh6b6EH0wCEoK0/mPeXU6c3wKDV83MkOuHPRHtSXKKU99IBazS/2w==}
 
+  tsx@4.20.6:
+    resolution: {integrity: sha512-ytQKuwgmrrkDTFP4LjR0ToE2nqgy886GpvRSpU0JAnrdBYppuY5rLkRUYPU1yCryb24SsKBTL/hlDQAEFVwtZg==}
+    engines: {node: '>=18.0.0'}
+    hasBin: true
+
   tty-browserify@0.0.0:
     resolution: {integrity: sha512-JVa5ijo+j/sOoHGjw0sxw734b1LhBkQ3bvUGNdxnVXDCX81Yx7TFgnZygxrIIWn23hbfTaMYLwRmAxFyDuFmIw==}
 
@@ -10926,6 +10973,12 @@ snapshots:
   '@next/swc-win32-x64-msvc@15.5.3':
     optional: true
 
+  '@next/third-parties@15.5.4(next@15.5.3(@babel/core@7.1.6)(react-dom@19.1.1(react@19.1.1))(react@19.1.1))(react@19.1.1)':
+    dependencies:
+      next: 15.5.3(@babel/core@7.1.6)(react-dom@19.1.1(react@19.1.1))(react@19.1.1)
+      react: 19.1.1
+      third-party-capital: 1.0.20
+
   '@nodelib/fs.stat@1.1.3': {}
 
   '@panva/hkdf@1.2.1': {}
@@ -11981,13 +12034,13 @@ snapshots:
       chai: 5.3.3
       tinyrainbow: 2.0.0
 
-  '@vitest/mocker@3.2.4(vite@7.1.5(@types/node@20.19.16)(jiti@2.5.1)(lightningcss@1.30.1)(terser@5.44.0))':
+  '@vitest/mocker@3.2.4(vite@7.1.5(@types/node@20.19.16)(jiti@2.5.1)(lightningcss@1.30.1)(terser@5.44.0)(tsx@4.20.6))':
     dependencies:
       '@vitest/spy': 3.2.4
       estree-walker: 3.0.3
       magic-string: 0.30.19
     optionalDependencies:
-      vite: 7.1.5(@types/node@20.19.16)(jiti@2.5.1)(lightningcss@1.30.1)(terser@5.44.0)
+      vite: 7.1.5(@types/node@20.19.16)(jiti@2.5.1)(lightningcss@1.30.1)(terser@5.44.0)(tsx@4.20.6)
 
   '@vitest/pretty-format@3.2.4':
     dependencies:
@@ -12018,7 +12071,7 @@ snapshots:
       sirv: 3.0.2
       tinyglobby: 0.2.15
       tinyrainbow: 2.0.0
-      vitest: 3.2.4(@types/debug@4.1.12)(@types/node@20.19.16)(@vitest/ui@3.2.4)(happy-dom@18.0.1)(jiti@2.5.1)(jsdom@27.0.0(postcss@8.5.6))(lightningcss@1.30.1)(terser@5.44.0)
+      vitest: 3.2.4(@types/debug@4.1.12)(@types/node@20.19.16)(@vitest/ui@3.2.4)(happy-dom@18.0.1)(jiti@2.5.1)(jsdom@27.0.0(postcss@8.5.6))(lightningcss@1.30.1)(terser@5.44.0)(tsx@4.20.6)
 
   '@vitest/utils@3.2.4':
     dependencies:
@@ -13593,6 +13646,8 @@ snapshots:
 
   date-fns@4.1.0: {}
 
+  dayjs@1.11.18: {}
+
   debug@2.6.9(supports-color@5.5.0):
     dependencies:
       ms: 2.0.0
@@ -13798,6 +13853,8 @@ snapshots:
 
   dotenv-expand@4.2.0: {}
 
+  dotenv@17.2.3: {}
+
   dotenv@6.0.0: {}
 
   dunder-proto@1.0.1:
@@ -14665,6 +14722,10 @@ snapshots:
       es-errors: 1.3.0
       get-intrinsic: 1.3.0
 
+  get-tsconfig@4.10.1:
+    dependencies:
+      resolve-pkg-maps: 1.0.0
+
   get-value@2.0.6: {}
 
   getpass@0.1.7:
@@ -15066,6 +15127,8 @@ snapshots:
     transitivePeerDependencies:
       - supports-color
 
+  husky@9.1.7: {}
+
   iconv-lite@0.4.24:
     dependencies:
       safer-buffer: 2.1.2
@@ -18664,6 +18727,8 @@ snapshots:
 
   resolve-from@5.0.0: {}
 
+  resolve-pkg-maps@1.0.0: {}
+
   resolve-url@0.2.1: {}
 
   resolve@1.1.7: {}
@@ -19531,6 +19596,8 @@ snapshots:
 
   text-table@0.2.0: {}
 
+  third-party-capital@1.0.20: {}
+
   throat@4.1.0: {}
 
   throat@5.0.0: {}
@@ -19646,6 +19713,13 @@ snapshots:
 
   tslib@2.8.1: {}
 
+  tsx@4.20.6:
+    dependencies:
+      esbuild: 0.25.9
+      get-tsconfig: 4.10.1
+    optionalDependencies:
+      fsevents: 2.3.3
+
   tty-browserify@0.0.0: {}
 
   tunnel-agent@0.6.0:
@@ -19948,13 +20022,13 @@ snapshots:
       '@types/unist': 3.0.3
       vfile-message: 4.0.3
 
-  vite-node@3.2.4(@types/node@20.19.16)(jiti@2.5.1)(lightningcss@1.30.1)(terser@5.44.0):
+  vite-node@3.2.4(@types/node@20.19.16)(jiti@2.5.1)(lightningcss@1.30.1)(terser@5.44.0)(tsx@4.20.6):
     dependencies:
       cac: 6.7.14
       debug: 4.4.3(supports-color@5.5.0)
       es-module-lexer: 1.7.0
       pathe: 2.0.3
-      vite: 7.1.5(@types/node@20.19.16)(jiti@2.5.1)(lightningcss@1.30.1)(terser@5.44.0)
+      vite: 7.1.5(@types/node@20.19.16)(jiti@2.5.1)(lightningcss@1.30.1)(terser@5.44.0)(tsx@4.20.6)
     transitivePeerDependencies:
       - '@types/node'
       - jiti
@@ -19969,7 +20043,7 @@ snapshots:
       - tsx
       - yaml
 
-  vite@7.1.5(@types/node@20.19.16)(jiti@2.5.1)(lightningcss@1.30.1)(terser@5.44.0):
+  vite@7.1.5(@types/node@20.19.16)(jiti@2.5.1)(lightningcss@1.30.1)(terser@5.44.0)(tsx@4.20.6):
     dependencies:
       esbuild: 0.25.9
       fdir: 6.5.0(picomatch@4.0.3)
@@ -19983,12 +20057,13 @@ snapshots:
       jiti: 2.5.1
       lightningcss: 1.30.1
       terser: 5.44.0
+      tsx: 4.20.6
 
-  vitest@3.2.4(@types/debug@4.1.12)(@types/node@20.19.16)(@vitest/ui@3.2.4)(happy-dom@18.0.1)(jiti@2.5.1)(jsdom@27.0.0(postcss@8.5.6))(lightningcss@1.30.1)(terser@5.44.0):
+  vitest@3.2.4(@types/debug@4.1.12)(@types/node@20.19.16)(@vitest/ui@3.2.4)(happy-dom@18.0.1)(jiti@2.5.1)(jsdom@27.0.0(postcss@8.5.6))(lightningcss@1.30.1)(terser@5.44.0)(tsx@4.20.6):
     dependencies:
       '@types/chai': 5.2.2
       '@vitest/expect': 3.2.4
-      '@vitest/mocker': 3.2.4(vite@7.1.5(@types/node@20.19.16)(jiti@2.5.1)(lightningcss@1.30.1)(terser@5.44.0))
+      '@vitest/mocker': 3.2.4(vite@7.1.5(@types/node@20.19.16)(jiti@2.5.1)(lightningcss@1.30.1)(terser@5.44.0)(tsx@4.20.6))
       '@vitest/pretty-format': 3.2.4
       '@vitest/runner': 3.2.4
       '@vitest/snapshot': 3.2.4
@@ -20006,8 +20081,8 @@ snapshots:
       tinyglobby: 0.2.15
       tinypool: 1.1.1
       tinyrainbow: 2.0.0
-      vite: 7.1.5(@types/node@20.19.16)(jiti@2.5.1)(lightningcss@1.30.1)(terser@5.44.0)
-      vite-node: 3.2.4(@types/node@20.19.16)(jiti@2.5.1)(lightningcss@1.30.1)(terser@5.44.0)
+      vite: 7.1.5(@types/node@20.19.16)(jiti@2.5.1)(lightningcss@1.30.1)(terser@5.44.0)(tsx@4.20.6)
+      vite-node: 3.2.4(@types/node@20.19.16)(jiti@2.5.1)(lightningcss@1.30.1)(terser@5.44.0)(tsx@4.20.6)
       why-is-node-running: 2.3.0
     optionalDependencies:
       '@types/debug': 4.1.12
diff --git a/src/app/BillExplorer.tsx b/src/app/BillExplorer.tsx
index 47f4aad..9a47068 100644
--- a/src/app/BillExplorer.tsx
+++ b/src/app/BillExplorer.tsx
@@ -107,22 +107,14 @@ function BillExplorer({ bills }: BillExplorerProps) {
   // Filter bills
   const filteredBills = useMemo(() => {
     const filtered = bills.filter((bill) => {
-      const judgementParams: Parameters<
-        typeof shouldShowDetermination
-      >[0] = {
-        vote: bill.final_judgment,
-        isSocialIssue: bill.isSocialIssue,
-        tenetEvaluations: bill.tenet_evaluations,
-      };
-
-      const shouldDisplayDetermination = shouldShowDetermination(judgementParams);
+      const shouldDisplayDetermination = shouldShowDetermination(bill.final_judgment);
       const normalizedFinalJudgement: JudgementValue =
-        judgementParams.vote === "yes" || judgementParams.vote === "no"
-          ? judgementParams.vote
-          : "neutral";
+        bill.final_judgment === "yes" || bill.final_judgment === "no"
+          ? bill.final_judgment
+          : "abstain";
       const displayJudgement: JudgementValue = shouldDisplayDetermination
         ? normalizedFinalJudgement
-        : "neutral";
+        : "abstain";
 
       // Search
       if (filters.search.trim()) {
diff --git a/src/app/[id]/edit/page.tsx b/src/app/[id]/edit/page.tsx
index 496d35f..54022a9 100644
--- a/src/app/[id]/edit/page.tsx
+++ b/src/app/[id]/edit/page.tsx
@@ -73,7 +73,7 @@ export default async function EditBillPage({ params }: Params) {
         </div>
         <div className="space-y-2">
           <label className="block text-sm font-medium" htmlFor="final_judgment">
-            Final Judgment (yes/no/neutral)
+            Final Judgment (yes/no/abstain)
           </label>
           <textarea
             id="final_judgment"
diff --git a/src/app/[id]/opengraph-image.tsx b/src/app/[id]/opengraph-image.tsx
index 30a4321..959dfa9 100644
--- a/src/app/[id]/opengraph-image.tsx
+++ b/src/app/[id]/opengraph-image.tsx
@@ -40,12 +40,9 @@ export default async function OpengraphImage({
   params: { id: string };
 }) {
   const bill = await getUnifiedBillById(params.id);
+  const status = (bill?.final_judgment || "abstain").toLowerCase();
   const voteText =
-    bill?.final_judgment === "yes"
-      ? "Vote: Yes"
-      : bill?.final_judgment === "no"
-        ? "Vote: No"
-        : "Vote: Neutral";
+    status === "yes" ? "Vote: Yes" : status === "no" ? "Vote: No" : "Vote: Abstain";
   const textForFont = `${bill?.short_title || bill?.title || params.id} ${voteText} ${PROJECT_NAME} Build Canada Policy Tracker Powered by The Civics Project`;
   let interRegular: ArrayBuffer | undefined;
   let interBold: ArrayBuffer | undefined;
diff --git a/src/app/[id]/page.tsx b/src/app/[id]/page.tsx
index 0c7100d..15c2794 100644
--- a/src/app/[id]/page.tsx
+++ b/src/app/[id]/page.tsx
@@ -78,18 +78,13 @@ export default async function BillDetail({ params }: Params) {
     );
   }
 
-  const isSocialIssue = unifiedBill.isSocialIssue;
-  const judgementParams = {
-    vote: unifiedBill.final_judgment,
-    isSocialIssue,
-    tenetEvaluations: unifiedBill.tenet_evaluations,
-  } as const;
-  const shouldDisplayDetermination = shouldShowDetermination(judgementParams);
+  const shouldDisplayDetermination = shouldShowDetermination(
+    unifiedBill.final_judgment
+  );
   const normalizedFinalJudgement: JudgementValue =
-    judgementParams.vote === "yes" || judgementParams.vote === "no"
-      ? judgementParams.vote
-      : "neutral";
-  const showAnalysis = shouldDisplayDetermination;
+    unifiedBill.final_judgment === "yes" || unifiedBill.final_judgment === "no"
+      ? unifiedBill.final_judgment
+      : "abstain";
 
   return (
     <div className="mx-auto max-w-[1100px] px-6 py-8">
@@ -118,13 +113,13 @@ export default async function BillDetail({ params }: Params) {
           <BillSummary bill={unifiedBill} />
           <BillAnalysis
             bill={unifiedBill}
-            showAnalysis={showAnalysis}
+            showAnalysis={shouldDisplayDetermination}
             displayJudgement={{
               value: normalizedFinalJudgement,
               shouldDisplay: shouldDisplayDetermination,
             }}
           />
-          {showAnalysis && unifiedBill.question_period_questions && unifiedBill.question_period_questions.length > 0 && (
+          {shouldDisplayDetermination && unifiedBill.question_period_questions && unifiedBill.question_period_questions.length > 0 && (
             <BillQuestions
               bill={unifiedBill}
               billUrl={buildAbsoluteUrl(shareOrigin, id)}
diff --git a/src/app/bills/[id]/edit/page.tsx b/src/app/bills/[id]/edit/page.tsx
index 5760b8c..9d04bd0 100644
--- a/src/app/bills/[id]/edit/page.tsx
+++ b/src/app/bills/[id]/edit/page.tsx
@@ -61,7 +61,7 @@ export default async function EditBillPage({ params }: Params) {
         </div>
         <div className="space-y-2">
           <label className="block text-sm font-medium" htmlFor="final_judgment">
-            Final Judgment (yes/no/neutral)
+            Final Judgment (yes/no/abstain)
           </label>
           <textarea
             id="final_judgment"
diff --git a/src/app/page.tsx b/src/app/page.tsx
index 825cca1..15afba3 100644
--- a/src/app/page.tsx
+++ b/src/app/page.tsx
@@ -124,7 +124,7 @@ async function getMergedBills(): Promise<BillSummary[]> {
       ).length;
       const displayFinal: BillSummary["final_judgment"] =
         alignCount === 1 && conflictCount === 0
-          ? "neutral"
+          ? "abstain"
           : (dbBill.final_judgment as BillSummary["final_judgment"]);
       // Merge API bill with DB data (DB data takes precedence for analysis fields)
       return {
@@ -159,7 +159,7 @@ async function getMergedBills(): Promise<BillSummary[]> {
       ).length;
       const displayFinal: BillSummary["final_judgment"] =
         alignCount === 1 && conflictCount === 0
-          ? "neutral"
+          ? "abstain"
           : (dbBill.final_judgment as BillSummary["final_judgment"]);
       const billSummary: BillSummary = {
         billID: dbBill.billId,
diff --git a/src/app/types.ts b/src/app/types.ts
index c5c7d04..03fbc1e 100644
--- a/src/app/types.ts
+++ b/src/app/types.ts
@@ -22,7 +22,7 @@ export interface BillSummary {
   alignment?: "Economy" | "Health" | "Environment" | "Security" | "Other";
   // Additional fields from MongoDB/analysis
   summary?: string;
-  final_judgment?: "yes" | "no" | "neutral";
+  final_judgment?: "yes" | "no" | "abstain";
   rationale?: string;
   needs_more_info?: boolean;
   missing_details?: string[];
diff --git a/src/components/BillCard.tsx b/src/components/BillCard.tsx
index 87962ae..3e0437f 100644
--- a/src/components/BillCard.tsx
+++ b/src/components/BillCard.tsx
@@ -20,19 +20,14 @@ function BillCard({ bill }: BillCardProps) {
     ? dayjs(lastUpdated).format("MMM D, YYYY")
     : "N/A";
 
-  const judgementParams = {
-    vote: bill.final_judgment,
-    isSocialIssue: bill.isSocialIssue,
-    tenetEvaluations: bill.tenet_evaluations,
-  } as const;
-  const shouldDisplayDetermination = shouldShowDetermination(judgementParams);
+  const shouldDisplayDetermination = shouldShowDetermination(bill.final_judgment);
   const normalizedFinalJudgement: JudgementValue =
-    judgementParams.vote === "yes" || judgementParams.vote === "no"
-      ? judgementParams.vote
-      : "neutral";
+    bill.final_judgment === "yes" || bill.final_judgment === "no"
+      ? bill.final_judgment
+      : "abstain";
   const judgementValue: JudgementValue = shouldDisplayDetermination
     ? normalizedFinalJudgement
-    : "neutral";
+    : "abstain";
 
   return (
     <li className="group rounded-lg border   bg-[var(--panel)] shadow-sm   duration-200 overflow-hidden">
@@ -50,7 +45,6 @@ function BillCard({ bill }: BillCardProps) {
             {bill.final_judgment && (
               <Judgement
                 judgement={judgementValue}
-                isSocialIssue={bill.isSocialIssue}
               />
             )}
           </div>
diff --git a/src/components/BillDetail/BillAnalysis.tsx b/src/components/BillDetail/BillAnalysis.tsx
index ec8251f..49abcaa 100644
--- a/src/components/BillDetail/BillAnalysis.tsx
+++ b/src/components/BillDetail/BillAnalysis.tsx
@@ -49,7 +49,7 @@ export function BillAnalysis({
 }: BillAnalysisProps) {
   const judgementValue: JudgementValue = displayJudgement.shouldDisplay
     ? displayJudgement.value
-    : "neutral";
+    : "abstain";
 
   if (!showAnalysis) {
     return (
@@ -62,7 +62,6 @@ export function BillAnalysis({
         <CardContent>
           <div>
             <Judgement
-              isSocialIssue={bill.isSocialIssue}
               judgement={judgementValue}
             />
           </div>
@@ -80,7 +79,6 @@ export function BillAnalysis({
               <CardTitle className="mb-2">Builder Assessment</CardTitle>
               <div>
                 <Judgement
-                  isSocialIssue={bill.isSocialIssue}
                   judgement={judgementValue}
                 />
               </div>
diff --git a/src/components/FilterSection/filter-section.component.tsx b/src/components/FilterSection/filter-section.component.tsx
index 619eba6..b483fdd 100644
--- a/src/components/FilterSection/filter-section.component.tsx
+++ b/src/components/FilterSection/filter-section.component.tsx
@@ -182,7 +182,7 @@ export function FilterSidebar({
           <div className="space-y-3 ">
             <Label>Judgement</Label>
             <div className="space-y-2">
-              {["yes", "no", "neutral"].map((j) => (
+              {["yes", "no", "abstain"].map((j) => (
                 <div key={j} className="flex items-start space-x-2">
                   <Checkbox
                     id={`judgement-${j}`}
diff --git a/src/components/Judgement/judgement.component.tsx b/src/components/Judgement/judgement.component.tsx
index 83544b7..c5f3007 100644
--- a/src/components/Judgement/judgement.component.tsx
+++ b/src/components/Judgement/judgement.component.tsx
@@ -1,7 +1,7 @@
-import { CheckCircle2, XCircle, CircleHelp } from "lucide-react";
+import { CheckCircle2, XCircle, CircleMinus } from "lucide-react";
 import React from "react";
 
-export type JudgementValue = "yes" | "no" | "neutral";
+export type JudgementValue = "yes" | "no" | "abstain";
 type Size = "sm" | "md";
 
 const stylesByJudgement: Record<
@@ -30,7 +30,7 @@ const stylesByJudgement: Record<
     iconWrap: "bg-rose-100 text-rose-700 border-rose-200",
     icon: "text-rose-700",
   },
-  neutral: {
+  abstain: {
     wrap: {
       subtle: "bg-slate-50 text-slate-900 border-slate-200 ring-slate-600/10",
       outline: "bg-white text-slate-900 border-slate-300 ring-slate-600/10",
@@ -52,28 +52,16 @@ interface JudgementProps {
   judgement: JudgementValue;
   size?: Size;
   className?: string;
-  isSocialIssue?: boolean;
-  onlySingleIssueVarying?: boolean;
 }
 
-function verdictCopy(
-  j: JudgementValue,
-  isSocialIssue?: boolean,
-  onlySingleIssueVarying?: boolean,
-) {
-  if (isSocialIssue) {
-    return "Neutral";
-  }
-  if (onlySingleIssueVarying) {
-    return "Neutral";
-  }
+function verdictCopy(j: JudgementValue) {
   switch (j) {
     case "yes":
       return "Vote Yes";
     case "no":
       return "Vote No";
     default:
-      return "Neutral";
+      return "Abstain";
   }
 }
 
@@ -81,20 +69,12 @@ export function Judgement({
   judgement,
   size = "sm",
   className,
-  isSocialIssue,
-  onlySingleIssueVarying,
 }: JudgementProps) {
-  const effectiveJudgement =
-    isSocialIssue || onlySingleIssueVarying ? "neutral" : judgement;
-  const s = stylesByJudgement[effectiveJudgement];
+  const s = stylesByJudgement[judgement];
   const sz = sizes[size];
 
   const Icon =
-    effectiveJudgement === "yes"
-      ? CheckCircle2
-      : effectiveJudgement === "no"
-        ? XCircle
-        : CircleHelp;
+    judgement === "yes" ? CheckCircle2 : judgement === "no" ? XCircle : CircleMinus;
 
   return (
     <article
@@ -121,7 +101,7 @@ export function Judgement({
         </span>
 
         <span className={`font-medium leading-none ${sz.text}`}>
-          {verdictCopy(effectiveJudgement, isSocialIssue, onlySingleIssueVarying)}
+          {verdictCopy(judgement)}
         </span>
       </div>
     </article>
diff --git a/src/components/OG b/src/components/OG
index db012fb..0c3ba67 100644
--- a/src/components/OG
+++ b/src/components/OG
@@ -4,7 +4,7 @@ import React from "react";
 
 export function BillOgCard({ bill }) {
   const title = bill.short_title || bill.title;
-  const judgement = bill.final_judgment || "neutral";
+  const judgement = bill.final_judgment || "abstain";
   const badgeColor = judgement === "yes" ? "#16a34a" : judgement === "no" ? "#dc2626" : "#4b5563";
 
   return (
@@ -64,7 +64,7 @@ export function BillOgCard({ bill }) {
             textTransform: "uppercase",
             letterSpacing: 1,
           }}>
-            {judgement === "yes" ? "Supports" : judgement === "no" ? "Opposes" : "Neutral"}
+            {judgement === "yes" ? "Supports" : judgement === "no" ? "Opposes" : "Abstain"}
           </div>
           {bill.rationale ? (
             <div style={{ marginTop: 16, fontSize: 22, color: "#d1d5db", textAlign: "right" }}>
diff --git a/src/components/OpenGraph/BillOgCard.tsx b/src/components/OpenGraph/BillOgCard.tsx
index b4ff280..448413b 100644
--- a/src/components/OpenGraph/BillOgCard.tsx
+++ b/src/components/OpenGraph/BillOgCard.tsx
@@ -8,30 +8,20 @@ type BillSubset = Pick<
   | "title"
   | "short_title"
   | "summary"
-  | "final_judgment"
   | "rationale"
   | "genres"
-  | "isSocialIssue"
 > & {
+  final_judgment?: "yes" | "no" | "abstain";
   fallbackId?: string;
 };
 
 export function BillOgCard({ bill }: { bill: BillSubset }) {
   const title = bill.short_title || bill.title || bill.fallbackId || "Bill";
-  const voteLabel = bill.isSocialIssue
-    ? "Vote: Neutral"
-    : bill.final_judgment === "yes"
-      ? "Vote: Yes"
-      : bill.final_judgment === "no"
-        ? "Vote: No"
-        : "Vote: Neutral";
-  const voteBg = bill.isSocialIssue
-    ? "#4b5563"
-    : bill.final_judgment === "yes"
-      ? "#166534"
-      : bill.final_judgment === "no"
-        ? "#b91c1c"
-        : "#4b5563";
+  const status = (bill.final_judgment || "abstain").toLowerCase();
+  const voteLabel =
+    status === "yes" ? "Vote: Yes" : status === "no" ? "Vote: No" : "Vote: Abstain";
+  const voteBg =
+    status === "yes" ? "#166534" : status === "no" ? "#b91c1c" : "#4b5563";
 
   // the first sentence that isn't quoted
   let summaryText = bill.summary ? bill.summary.split(".")[0] : "";
diff --git a/src/components/OpenGraph/QuestionOgCard.tsx b/src/components/OpenGraph/QuestionOgCard.tsx
index 6455d47..5faf800 100644
--- a/src/components/OpenGraph/QuestionOgCard.tsx
+++ b/src/components/OpenGraph/QuestionOgCard.tsx
@@ -3,8 +3,9 @@ import type { UnifiedBill } from "@/utils/billConverters";
 
 type QuestionSubset = Pick<
   UnifiedBill,
-  "billId" | "title" | "short_title" | "final_judgment" | "isSocialIssue"
+  "billId" | "title" | "short_title" | "isSocialIssue"
 > & {
+  final_judgment?: "yes" | "no" | "abstain";
   question: string;
   index: number;
   fallbackId?: string;
@@ -13,12 +14,12 @@ type QuestionSubset = Pick<
 export function QuestionOgCard({ bill }: { bill: QuestionSubset }) {
   const title = bill.short_title || bill.title || bill.fallbackId || "Bill";
   const voteLabel = bill.isSocialIssue
-    ? "Vote: Neutral"
+    ? "Vote: Abstain"
     : bill.final_judgment === "yes"
       ? "Vote: Yes"
       : bill.final_judgment === "no"
         ? "Vote: No"
-        : "Vote: Neutral";
+        : "Vote: Abstain";
   const voteBg = bill.isSocialIssue
     ? "#4b5563"
     : bill.final_judgment === "yes"
diff --git a/src/migrations/1.ts b/src/migrations/1.ts
new file mode 100644
index 0000000..e2f5723
--- /dev/null
+++ b/src/migrations/1.ts
@@ -0,0 +1,26 @@
+/**
+ * Migration 1: Update final_judgment from "neutral" to "abstain" for social issue bills
+ *
+ * This migration updates all bills where isSocialIssue is true and changes their
+ * final_judgment from "neutral" to "abstain".
+ */
+
+import { Bill } from "@/models/Bill";
+
+export async function up() {
+  console.log("Starting migration: Update neutral to abstain for social issues");
+
+  const result = await Bill.updateMany(
+    {
+      isSocialIssue: true,
+    },
+    {
+      $set: {
+        final_judgment: "abstain",
+      },
+    },
+  );
+
+  console.log(`Updated ${result.modifiedCount} bills from neutral to abstain`);
+  console.log(`Matched ${result.matchedCount} bills with the criteria`);
+}
diff --git a/src/models/Bill.ts b/src/models/Bill.ts
index bf0aa37..38185ea 100644
--- a/src/models/Bill.ts
+++ b/src/models/Bill.ts
@@ -38,7 +38,7 @@ export interface BillDocument extends mongoose.Document {
 
   // Replaced the old 'analysis' object with new, top-level fields
   tenet_evaluations: TenetEvaluation[];
-  final_judgment: string; // "yes", "no", or "neutral"
+  final_judgment: string; // "yes", "no", or "abstain"
   rationale: string;
   needs_more_info: boolean;
   missing_details: string[];
@@ -111,7 +111,7 @@ const BillSchema = new Schema<BillDocument>(
 
     // Replaced the old 'analysis' sub-schema with new fields
     tenet_evaluations: { type: [TenetEvaluationSchema], default: [] },
-    final_judgment: { type: String, enum: ["yes", "no", "neutral"] },
+    final_judgment: { type: String, enum: ["yes", "no", "abstain"] },
     rationale: { type: String },
     needs_more_info: { type: Boolean, default: false },
     missing_details: { type: [String], default: [] },
diff --git a/src/prompt/summary-and-vote-prompt.ts b/src/prompt/summary-and-vote-prompt.ts
index c2c63f4..ce92140 100644
--- a/src/prompt/summary-and-vote-prompt.ts
+++ b/src/prompt/summary-and-vote-prompt.ts
@@ -30,6 +30,8 @@ For social issue grading:
 `;
 
 export const SUMMARY_AND_VOTE_PROMPT = `
+## Your Role
+
 You are analyzing Canadian legislation. You must assess whether the bill aligns with Build Canada's Core Tenets:
   1. ${TENETS[1]}
   2. ${TENETS[2]}
@@ -40,8 +42,12 @@ You are analyzing Canadian legislation. You must assess whether the bill aligns
   7. ${TENETS[7]}
   8. ${TENETS[8]}
 
+## Social Issue Grading
+
   ${SOCIAL_ISSUE_GRADING}
 
+## General Guidelines
+
   For general guidelines:
   - Be critical.
   - Bias to the overall wellbeing of Canadians.
@@ -54,18 +60,24 @@ You are analyzing Canadian legislation. You must assess whether the bill aligns
   - Never self reference Build Canada, or use "We" or "Our", use the idea of "Builders" instead.
   - Never self reference the tenents outside of the tenet evaluations.
 
-  Task:
+  ## Your Task
+
   1. Read the bill.
   2. Provide a concise summary of what the bill does in plain language (3-5 sentences).
   3. Evaluate the bill against the 8 tenets above:
     3.1 Does it clearly support one or more tenets?
     3.2 Does it conflict with one or more tenets?
     3.3 Is its impact neutral or unclear?
-  4. Give a final judgment:
-    4.1 Output “Yes” if the bill aligns overall with Build Canada's tenets.
-    4.2 Output “No” if it conflicts overall with Build Canada's tenets.
+  4. Give a final judgment (choose exactly one; output in lowercase):
+    4.1 Output "abstain" if the bill is primarily a social issue (per the social-issue criteria above).
+    4.2 Output “yes” if the bill aligns overall with Build Canada's tenets.
+    4.3 Output “no” if it conflicts overall with Build Canada's tenets.
   5. Generate 3 critical questions, pertaining to this and only about this bill, for Question Period in the House of Commons phrased in a way that a Member of Parliament might actually ask in Question Period. Omit any prefix like "Mr. Speaker" or "Madam Speaker".
- 
+
+  Important: All enum values must be lowercase exactly as specified.
+  - tenet_evaluations.alignment: aligns|conflicts|neutral
+  - final_judgment: yes|no|abstain
+  - is_social_issue: yes|no
 
   Output format (return valid JSON only):
 
@@ -133,9 +145,9 @@ You are analyzing Canadian legislation. You must assess whether the bill aligns
       {
         "question": "A crticial question, pertaining to this and only about this bill, for Question Period in the House of Commons phrased in a way that a Member of Parliament might actually ask in Question Period. Omit any prefix like "Mr. Speaker" or "Madam Speaker""
       },
-      
+
     ],
-    "final_judgment": "yes|no",
+    "final_judgment": "yes|no|abstain",
     "rationale": "2 sentences explaining the overall judgment and then bullet points explaining the rationale for the judgment and suggestions for what we might change. Use markdown formatting.",
     "is_social_issue": "yes|no"
   }
diff --git a/src/scripts/migrate.ts b/src/scripts/migrate.ts
new file mode 100644
index 0000000..b9a4aa7
--- /dev/null
+++ b/src/scripts/migrate.ts
@@ -0,0 +1,77 @@
+#!/usr/bin/env tsx
+
+/**
+ * Database Migration Script
+ *
+ * Usage:
+ *   tsx src/scripts/migrate.ts <migration-filename>
+ *
+ * Examples:
+ *   tsx src/scripts/migrate.ts 1.ts
+ *   tsx src/scripts/migrate.ts 2-add-indexes.ts
+ *   npm run migrate -- 1.ts
+ */
+
+import dotenv from "dotenv";
+import path from "node:path";
+
+// Load environment variables from .env.local (Next.js convention)
+dotenv.config({ path: path.join(process.cwd(), ".env.local") });
+
+async function runMigration(filename: string) {
+  console.log(`Running migration: ${filename}`);
+
+  // Dynamic imports to ensure dotenv loads first
+  const { connectToDatabase } = await import("@/lib/mongoose");
+  const { env } = await import("@/env");
+
+  // Validate MongoDB connection
+  const uri = env.MONGO_URI || "";
+  const hasValidMongoUri =
+    uri.startsWith("mongodb://") || uri.startsWith("mongodb+srv://");
+
+  if (!hasValidMongoUri) {
+    throw new Error("No valid MongoDB URI found in environment");
+  }
+
+  // Connect to database
+  await connectToDatabase();
+
+  // Import and run the migration
+  const migrationPath = path.join(process.cwd(), "src/migrations", filename);
+  try {
+    const migration = await import(migrationPath);
+
+    if (!migration.up || typeof migration.up !== "function") {
+      throw new Error(
+        `Migration ${filename} must export an 'up' function`,
+      );
+    }
+
+    await migration.up();
+    console.log(`Migration ${filename} completed successfully`);
+  } catch (error) {
+    console.error(`Migration ${filename} failed:`, error);
+    throw error;
+  }
+}
+
+// Get migration filename from command line arguments
+const filename = process.argv[2];
+
+if (!filename) {
+  console.error("Usage: tsx src/scripts/migrate.ts <migration-filename>");
+  console.error("Example: tsx src/scripts/migrate.ts 1.ts");
+  process.exit(1);
+}
+
+// Run the migration
+runMigration(filename)
+  .then(() => {
+    console.log("Migration completed");
+    process.exit(0);
+  })
+  .catch((error) => {
+    console.error("Migration failed:", error);
+    process.exit(1);
+  });
diff --git a/src/services/billApi.ts b/src/services/billApi.ts
index e0ed4ce..fe5a69e 100644
--- a/src/services/billApi.ts
+++ b/src/services/billApi.ts
@@ -37,6 +37,24 @@ export type ApiBillDetail = {
 
 const CANADIAN_PARLIAMENT_NUMBER = 45;
 
+/** Types for AI analysis results */
+export interface BillAnalysis {
+  summary: string;
+  short_title?: string;
+  tenet_evaluations: Array<{
+    id: number;
+    title: string;
+    alignment: "aligns" | "conflicts" | "neutral";
+    explanation: string;
+  }>;
+  final_judgment: "yes" | "no" | "abstain";
+  rationale: string;
+  needs_more_info: boolean;
+  missing_details: string[];
+  steel_man: string;
+  question_period_questions?: Array<{ question: string }>;
+}
+
 export async function getBillFromCivicsProjectApi(
   billId: string,
 ): Promise<ApiBillDetail | null> {
@@ -68,23 +86,6 @@ export async function getBillFromCivicsProjectApi(
   return data;
 }
 
-export interface BillAnalysis {
-  summary: string;
-  short_title?: string;
-  tenet_evaluations: Array<{
-    id: number;
-    title: string;
-    alignment: "aligns" | "conflicts" | "neutral";
-    explanation: string;
-  }>;
-  final_judgment: "yes" | "no" | "neutral";
-  rationale: string;
-  needs_more_info: boolean;
-  missing_details: string[];
-  steel_man: string;
-  question_period_questions?: Array<{ question: string }>;
-}
-
 export async function summarizeBillText(input: string): Promise<BillAnalysis> {
   if (!process.env.OPENAI_API_KEY) {
     console.log("No OPENAI API key, using fallback analysis");
@@ -149,7 +150,7 @@ export async function summarizeBillText(input: string): Promise<BillAnalysis> {
           explanation: "Unable to analyze without AI",
         },
       ],
-      final_judgment: "no",
+      final_judgment: "abstain",
       rationale: "Analysis requires AI capabilities",
       needs_more_info: true,
       missing_details: ["AI analysis capabilities required"],
@@ -176,11 +177,16 @@ export async function summarizeBillText(input: string): Promise<BillAnalysis> {
     // Parse JSON response
     try {
       const parsed = JSON.parse(responseText);
+      const rawFj = String(parsed.final_judgment || "").trim().toLowerCase();
+      const normalizedFj: "yes" | "no" | "abstain" =
+        rawFj === "yes" || rawFj === "no" || rawFj === "abstain"
+          ? rawFj
+          : "abstain";
       const analysis: BillAnalysis = {
         summary: parsed.summary ?? "",
         short_title: parsed.short_title ?? undefined,
         tenet_evaluations: parsed.tenet_evaluations ?? [],
-        final_judgment: parsed.final_judgment ?? "no",
+        final_judgment: normalizedFj,
         rationale: parsed.rationale ?? "",
         needs_more_info: parsed.needs_more_info ?? false,
         missing_details: parsed.missing_details ?? [],
@@ -261,7 +267,7 @@ export async function summarizeBillText(input: string): Promise<BillAnalysis> {
             explanation: "JSON parse failed",
           },
         ],
-        final_judgment: "no",
+        final_judgment: "abstain",
         rationale: "Analysis parsing failed",
         needs_more_info: true,
         missing_details: ["Valid AI response format"],
@@ -332,7 +338,7 @@ export async function summarizeBillText(input: string): Promise<BillAnalysis> {
           explanation: "Analysis failed",
         },
       ],
-      final_judgment: "no",
+      final_judgment: "abstain",
       rationale: "Technical error during analysis",
       needs_more_info: true,
       missing_details: ["Technical issue resolution"],
diff --git a/src/utils/billConverters.ts b/src/utils/billConverters.ts
index 0bc43e7..a035a62 100644
--- a/src/utils/billConverters.ts
+++ b/src/utils/billConverters.ts
@@ -40,7 +40,7 @@ export interface UnifiedBill {
     alignment: "aligns" | "conflicts" | "neutral";
     explanation: string;
   }>;
-  final_judgment?: "yes" | "no" | "neutral";
+  final_judgment: "yes" | "no" | "abstain";
   rationale?: string;
   needs_more_info?: boolean;
   missing_details?: string[];
@@ -80,7 +80,11 @@ export function fromBuildCanadaDbBill(bill: BillDocument): UnifiedBill {
       alignment: te.alignment,
       explanation: te.explanation,
     })),
-    final_judgment: bill.final_judgment as "yes" | "no" | "neutral" | undefined,
+    final_judgment:
+      ((bill.final_judgment ?? "").toString().trim().toLowerCase() === "yes" ||
+        (bill.final_judgment ?? "").toString().trim().toLowerCase() === "no")
+        ? (bill.final_judgment as "yes" | "no")
+        : "abstain",
     rationale: bill.rationale,
     needs_more_info: bill.needs_more_info,
     missing_details: bill.missing_details
@@ -194,9 +198,15 @@ export async function fromCivicsProjectApiBill(
           summary: existingBill.summary,
           tenet_evaluations:
             existingBill.tenet_evaluations || analysis.tenet_evaluations,
-          final_judgment:
-            (existingBill.final_judgment as "yes" | "no" | "neutral") ||
-            analysis.final_judgment,
+          final_judgment: (() => {
+            const raw = String(existingBill.final_judgment || "")
+              .trim()
+              .toLowerCase();
+            if (raw === "yes" || raw === "no") return raw as "yes" | "no";
+            // Treat legacy "neutral" and any unknown value as "abstain"
+            if (raw === "abstain" || raw === "neutral") return "abstain";
+            return analysis.final_judgment;
+          })(),
           rationale: existingBill.rationale || analysis.rationale,
           needs_more_info:
             existingBill.needs_more_info || analysis.needs_more_info,
diff --git a/src/utils/should-show-determination/should-show-determination.test.ts b/src/utils/should-show-determination/should-show-determination.test.ts
index 84d5b14..d18d377 100644
--- a/src/utils/should-show-determination/should-show-determination.test.ts
+++ b/src/utils/should-show-determination/should-show-determination.test.ts
@@ -1,201 +1,64 @@
 import { describe, expect, it } from "vitest";
 import { shouldShowDetermination } from "./should-show-determination.util";
 
-const ALIGN = { alignment: "aligns" as const };
-const CONFLICT = { alignment: "conflicts" as const };
-const NEUTRAL = { alignment: "neutral" as const };
-const UNSET = { alignment: undefined };
-const NULL_ALIGNMENT = { alignment: null };
-const NO_ALIGNMENT = {} as const;
-
 describe("shouldShowDetermination", () => {
-  it("returns true when vote is yes and not a social issue", () => {
-    const result = shouldShowDetermination({
-      vote: "yes",
-      isSocialIssue: false,
-      tenetEvaluations: [ALIGN, ALIGN],
-    });
-
+  it("returns true when vote is yes", () => {
+    const result = shouldShowDetermination("yes");
     expect(result).toBe(true);
   });
 
   it("returns true when vote is no", () => {
-    const result = shouldShowDetermination({
-      vote: "no",
-      isSocialIssue: false,
-      tenetEvaluations: [CONFLICT, CONFLICT],
-    });
-
+    const result = shouldShowDetermination("no");
     expect(result).toBe(true);
   });
 
-  it("returns false when vote is neutral", () => {
-    const result = shouldShowDetermination({
-      vote: "neutral",
-      isSocialIssue: false,
-      tenetEvaluations: [NEUTRAL, NEUTRAL],
-    });
-
+  it("returns false when vote is abstain", () => {
+    const result = shouldShowDetermination("abstain");
     expect(result).toBe(false);
   });
 
-  it("returns false when social issue", () => {
-    const result = shouldShowDetermination({
-      vote: "yes",
-      isSocialIssue: true,
-      tenetEvaluations: [ALIGN, ALIGN],
-    });
-
+  it("returns false when vote is abstain with different casing", () => {
+    const result = shouldShowDetermination("AbStAiN");
     expect(result).toBe(false);
   });
 
-  it("returns true when social issue is false", () => {
-    const result = shouldShowDetermination({
-      vote: "yes",
-      isSocialIssue: false,
-      tenetEvaluations: [ALIGN, ALIGN],
-    });
-
-    expect(result).toBe(true);
-  });
-
-  it("returns false when vote forced to neutral by single alignment", () => {
-    const result = shouldShowDetermination({
-      vote: "yes",
-      isSocialIssue: false,
-      tenetEvaluations: [ALIGN, NEUTRAL, NEUTRAL],
-    });
-
+  it("returns false when vote is abstain with whitespace", () => {
+    const result = shouldShowDetermination("  abstain  ");
     expect(result).toBe(false);
   });
 
-  it("returns false when vote forced to neutral by single conflict", () => {
-    const result = shouldShowDetermination({
-      vote: "no",
-      isSocialIssue: false,
-      tenetEvaluations: [CONFLICT, NEUTRAL, NEUTRAL],
-    });
-
-    expect(result).toBe(false);
-  });
-
-  it("returns true when multiple non-neutral alignments", () => {
-    const result = shouldShowDetermination({
-      vote: "yes",
-      isSocialIssue: false,
-      tenetEvaluations: [ALIGN, ALIGN, NEUTRAL],
-    });
-
+  it("returns true when vote is uppercase YES", () => {
+    const result = shouldShowDetermination("YES");
     expect(result).toBe(true);
   });
 
-  it("returns true when vote is uppercase", () => {
-    const result = shouldShowDetermination({
-      vote: "YES",
-      isSocialIssue: false,
-      tenetEvaluations: [ALIGN, CONFLICT, NEUTRAL],
-    });
-
+  it("returns true when vote is uppercase NO", () => {
+    const result = shouldShowDetermination("NO");
     expect(result).toBe(true);
   });
 
-  it("returns false when vote is neutral regardless of casing", () => {
-    const result = shouldShowDetermination({
-      vote: "NeUtRaL",
-      isSocialIssue: false,
-      tenetEvaluations: [NEUTRAL, NEUTRAL],
-    });
-
-    expect(result).toBe(false);
-  });
-
-  it("returns true when vote is non-standard but not forced neutral", () => {
-    const result = shouldShowDetermination({
-      vote: "abstain",
-      isSocialIssue: false,
-      tenetEvaluations: [ALIGN, CONFLICT, NEUTRAL],
-    });
-
+  it("returns true when vote is null", () => {
+    const result = shouldShowDetermination(null);
     expect(result).toBe(true);
   });
 
-  it("returns true when tenet evaluations are empty", () => {
-    const result = shouldShowDetermination({
-      vote: "yes",
-      isSocialIssue: false,
-      tenetEvaluations: [],
-    });
-
-    expect(result).toBe(true);
-  });
-
-  it("returns true when tenet evaluations is undefined", () => {
-    const result = shouldShowDetermination({
-      vote: "yes",
-      isSocialIssue: false,
-      tenetEvaluations: undefined,
-    });
-
+  it("returns true when vote is undefined", () => {
+    const result = shouldShowDetermination(undefined);
     expect(result).toBe(true);
   });
 
-  it("returns true when tenet evaluations is null", () => {
-    const result = shouldShowDetermination({
-      vote: "yes",
-      isSocialIssue: false,
-      tenetEvaluations: null,
-    });
-
+  it("returns true when vote is empty string", () => {
+    const result = shouldShowDetermination("");
     expect(result).toBe(true);
   });
 
-  it("returns true when vote is undefined and not forced neutral", () => {
-    const result = shouldShowDetermination({
-      vote: undefined,
-      isSocialIssue: false,
-      tenetEvaluations: [ALIGN, CONFLICT],
-    });
-
+  it("returns true when vote is whitespace only", () => {
+    const result = shouldShowDetermination("   ");
     expect(result).toBe(true);
   });
 
-  it("returns true when vote is null and not forced neutral", () => {
-    const result = shouldShowDetermination({
-      vote: null,
-      isSocialIssue: false,
-      tenetEvaluations: [ALIGN, CONFLICT],
-    });
-
+  it("returns true when vote is non-standard value", () => {
+    const result = shouldShowDetermination("maybe");
     expect(result).toBe(true);
   });
-
-  it("returns false when tenet evaluations contain single defined alignment with undefined entries", () => {
-    const result = shouldShowDetermination({
-      vote: "yes",
-      isSocialIssue: false,
-      tenetEvaluations: [UNSET, ALIGN, NULL_ALIGNMENT, undefined],
-    });
-
-    expect(result).toBe(false);
-  });
-
-  it("returns false when tenet evaluations contain null entries with one non-neutral", () => {
-    const result = shouldShowDetermination({
-      vote: "no",
-      isSocialIssue: false,
-      tenetEvaluations: [null, CONFLICT, null],
-    });
-
-    expect(result).toBe(false);
-  });
-
-  it("returns false when tenet evaluations include object without alignment", () => {
-    const result = shouldShowDetermination({
-      vote: "no",
-      isSocialIssue: false,
-      tenetEvaluations: [NO_ALIGNMENT, CONFLICT],
-    });
-
-    expect(result).toBe(false);
-  });
-});
\ No newline at end of file
+});
diff --git a/src/utils/should-show-determination/should-show-determination.util.ts b/src/utils/should-show-determination/should-show-determination.util.ts
index 34e18de..78484f0 100644
--- a/src/utils/should-show-determination/should-show-determination.util.ts
+++ b/src/utils/should-show-determination/should-show-determination.util.ts
@@ -1,43 +1,7 @@
-import { TenetEvaluation } from "@/models/Bill";
-import { isSingleTenet } from "@/utils/vote-display";
-
-type TenetAlignmentLike = TenetEvaluation["alignment"] | null | undefined;
-
-type TenetEvaluationLike = {
-  alignment?: TenetAlignmentLike;
-};
-
-type ShouldShowDeterminationParams = {
-  vote: string | null | undefined;
-  isSocialIssue?: boolean | null;
-  tenetEvaluations?: (TenetEvaluationLike | null | undefined)[] | null;
-};
-
-export const shouldShowDetermination = ({
-  vote,
-  isSocialIssue,
-  tenetEvaluations,
-}: ShouldShowDeterminationParams): boolean => {
-  const normalizedVote = vote?.toString?.().toLowerCase?.() ?? "";
-  const isVoteNeutral = normalizedVote === "neutral";
-  const normalizedIsSocialIssue = Boolean(isSocialIssue);
-  const normalizedEvaluations: Parameters<typeof isSingleTenet>[0] = (
-    tenetEvaluations ?? []
-  )
-    .filter((evaluation): evaluation is TenetEvaluationLike => Boolean(evaluation))
-    .map((evaluation) => ({
-      alignment:
-        evaluation.alignment === "aligns" ||
-          evaluation.alignment === "conflicts" ||
-          evaluation.alignment === "neutral"
-          ? evaluation.alignment
-          : undefined,
-    }));
-  const forceNeutral = isSingleTenet(normalizedEvaluations);
-
-  if (isVoteNeutral) return false;
-  if (normalizedIsSocialIssue) return false;
-  if (forceNeutral) return false;
-
-  return true;
+export const shouldShowDetermination = (
+  vote: string | null | undefined
+): boolean => {
+  if (vote === null) return true;
+  const normalized = (vote ?? "").toString().trim().toLowerCase();
+  return normalized !== "abstain";
 };
\ No newline at end of file
diff --git a/src/utils/vote-display.ts b/src/utils/vote-display.ts
deleted file mode 100644
index f148e32..0000000
--- a/src/utils/vote-display.ts
+++ /dev/null
@@ -1,35 +0,0 @@
-type Alignment = "aligns" | "conflicts" | "neutral" | null | undefined;
-
-interface TenetEvaluation {
-  alignment?: Alignment;
-}
-
-/**
- * Checks whether the vote should be forced to "neutral"
- * when there is only a single non-neutral evaluation
- * (either one "aligns" or one "conflicts") and all others are neutral.
- */
-export function isSingleTenet(evaluations: TenetEvaluation[]): boolean {
-  if (!evaluations || evaluations.length === 0) return false;
-
-  const counts = evaluations.reduce(
-    (acc, t) => {
-      switch (t?.alignment) {
-        case "aligns":
-          acc.aligns++;
-          break;
-        case "conflicts":
-          acc.conflicts++;
-          break;
-        default:
-          acc.neutral++;
-      }
-      return acc;
-    },
-    { aligns: 0, conflicts: 0, neutral: 0 }
-  );
-
-  const nonNeutralCount = counts.aligns + counts.conflicts;
-  return nonNeutralCount === 1 && counts.neutral === evaluations.length - 1;
-}
-

From 9ae58f24b017721edc78978b2bff1e8cec89ee98 Mon Sep 17 00:00:00 2001
From: Shawn Price <hi@shawnprice.com>
Date: Wed, 8 Oct 2025 17:03:39 -0700
Subject: [PATCH 2/8] Empty commit to trigger Github Action for CI


From 985fc9dd3c1135d33adbd6c7a00251b45db45766 Mon Sep 17 00:00:00 2001
From: Shawn Price <hi@shawnprice.com>
Date: Wed, 8 Oct 2025 18:00:58 -0700
Subject: [PATCH 3/8] Fix issue with _id from mongo document being rendered

---
 src/utils/billConverters.ts | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/src/utils/billConverters.ts b/src/utils/billConverters.ts
index 1f63b87..419904b 100644
--- a/src/utils/billConverters.ts
+++ b/src/utils/billConverters.ts
@@ -60,7 +60,14 @@ export function fromBuildCanadaDbBill(bill: BillDocument): UnifiedBill {
     supportedRegion: bill.supportedRegion,
     introducedOn: bill.introducedOn,
     lastUpdatedOn: bill.lastUpdatedOn,
-    stages: bill.stages ? [...bill.stages] : [],
+    stages: bill.stages
+      ? bill.stages.map((stage) => ({
+          stage: stage.stage,
+          state: stage.state,
+          house: stage.house,
+          date: stage.date,
+        }))
+      : [],
     genres: bill.genres ? [...bill.genres] : undefined,
     parliamentNumber: bill.parliamentNumber,
     sessionNumber: bill.sessionNumber,

From 20e6e1356daa50da5b14a01d32b368cfe07d661f Mon Sep 17 00:00:00 2001
From: Shawn Price <hi@shawnprice.com>
Date: Wed, 8 Oct 2025 18:59:01 -0700
Subject: [PATCH 4/8] Simplify some logic

---
 src/app/BillExplorer.tsx    | 12 +-----------
 src/app/[id]/page.tsx       |  7 ++-----
 src/components/BillCard.tsx | 12 +-----------
 3 files changed, 4 insertions(+), 27 deletions(-)

diff --git a/src/app/BillExplorer.tsx b/src/app/BillExplorer.tsx
index f90c48e..27fd9bb 100644
--- a/src/app/BillExplorer.tsx
+++ b/src/app/BillExplorer.tsx
@@ -9,7 +9,6 @@ import {
   FilterOptions,
 } from "@/components/FilterSection/filter-section.component";
 import { useIsMobile } from "@/components/ui/use-mobile";
-import { shouldShowDetermination } from "@/utils/should-show-determination/should-show-determination.util";
 import type { JudgementValue } from "@/components/Judgement/judgement.component";
 import { TenetEvaluation } from "@/models/Bill";
 
@@ -107,16 +106,7 @@ function BillExplorer({ bills }: BillExplorerProps) {
   // Filter bills
   const filteredBills = useMemo(() => {
     const filtered = bills.filter((bill) => {
-      const shouldDisplayDetermination = shouldShowDetermination(
-        bill.final_judgment,
-      );
-      const normalizedFinalJudgement: JudgementValue =
-        bill.final_judgment === "yes" || bill.final_judgment === "no"
-          ? bill.final_judgment
-          : "abstain";
-      const displayJudgement: JudgementValue = shouldDisplayDetermination
-        ? normalizedFinalJudgement
-        : "abstain";
+      const displayJudgement: JudgementValue = bill.final_judgment || "abstain";
 
       // Search
       if (filters.search.trim()) {
diff --git a/src/app/[id]/page.tsx b/src/app/[id]/page.tsx
index bec809c..18a2234 100644
--- a/src/app/[id]/page.tsx
+++ b/src/app/[id]/page.tsx
@@ -81,10 +81,7 @@ export default async function BillDetail({ params }: Params) {
   const shouldDisplayDetermination = shouldShowDetermination(
     unifiedBill.final_judgment,
   );
-  const normalizedFinalJudgement: JudgementValue =
-    unifiedBill.final_judgment === "yes" || unifiedBill.final_judgment === "no"
-      ? unifiedBill.final_judgment
-      : "abstain";
+  const judgementValue: JudgementValue = unifiedBill.final_judgment;
 
   return (
     <div className="mx-auto max-w-[1100px] px-6 py-8">
@@ -115,7 +112,7 @@ export default async function BillDetail({ params }: Params) {
             bill={unifiedBill}
             showAnalysis={shouldDisplayDetermination}
             displayJudgement={{
-              value: normalizedFinalJudgement,
+              value: judgementValue,
               shouldDisplay: shouldDisplayDetermination,
             }}
           />
diff --git a/src/components/BillCard.tsx b/src/components/BillCard.tsx
index 254c59b..2426933 100644
--- a/src/components/BillCard.tsx
+++ b/src/components/BillCard.tsx
@@ -8,7 +8,6 @@ import dayjs from "dayjs";
 import { getCategoryIcon } from "@/utils/bill-category-to-icon/bill-category-to-icon.util";
 import { getBillStageDates } from "@/utils/stages-to-dates/stages-to-dates";
 import { TenetEvaluation } from "@/models/Bill";
-import { shouldShowDetermination } from "@/utils/should-show-determination/should-show-determination.util";
 
 interface BillCardProps {
   bill: BillSummary & { tenet_evaluations?: TenetEvaluation[] };
@@ -20,16 +19,7 @@ function BillCard({ bill }: BillCardProps) {
     ? dayjs(lastUpdated).format("MMM D, YYYY")
     : "N/A";
 
-  const shouldDisplayDetermination = shouldShowDetermination(
-    bill.final_judgment,
-  );
-  const normalizedFinalJudgement: JudgementValue =
-    bill.final_judgment === "yes" || bill.final_judgment === "no"
-      ? bill.final_judgment
-      : "abstain";
-  const judgementValue: JudgementValue = shouldDisplayDetermination
-    ? normalizedFinalJudgement
-    : "abstain";
+  const judgementValue: JudgementValue = bill.final_judgment || "abstain";
 
   return (
     <li className="group rounded-lg border   bg-[var(--panel)] shadow-sm   duration-200 overflow-hidden">

From a2ecf4888394e2a3cdb37269a8ec35c40de4fdcf Mon Sep 17 00:00:00 2001
From: Shawn Price <hi@shawnprice.com>
Date: Sun, 12 Oct 2025 10:31:12 -0700
Subject: [PATCH 5/8] Add db sync script. Memory cache only in production

---
 .env.example           |   3 +
 .gitignore             |   5 +-
 src/app/page.tsx       |   7 +
 src/lib/mongoose.ts    |   2 +-
 src/scripts/sync-db.ts | 542 +++++++++++++++++++++++++++++++++++++++++
 5 files changed, 557 insertions(+), 2 deletions(-)
 create mode 100755 src/scripts/sync-db.ts

diff --git a/.env.example b/.env.example
index 6e11dc0..93fda00 100644
--- a/.env.example
+++ b/.env.example
@@ -20,6 +20,9 @@ GOOGLE_CLIENT_SECRET=your-google-client-secret
 # Required for database connection
 MONGO_URI=mongodb://localhost:27017/billstracker
 
+# Production DB connection used with local development
+PROD_MONGO_URI=
+
 # Civics Project API
 # Required for fetching bill data
 CIVICS_PROJECT_API_KEY=your-civics-project-api-key
diff --git a/.gitignore b/.gitignore
index b44f737..797217f 100644
--- a/.gitignore
+++ b/.gitignore
@@ -44,4 +44,7 @@ next-env.d.ts
 # Claude Code
 .claude
 .plans
-.mcp.json
\ No newline at end of file
+.mcp.json
+
+# DB Backups
+db-backups
\ No newline at end of file
diff --git a/src/app/page.tsx b/src/app/page.tsx
index 55ebc3b..bbd5fa3 100644
--- a/src/app/page.tsx
+++ b/src/app/page.tsx
@@ -69,6 +69,7 @@ export async function generateMetadata(): Promise<Metadata> {
   };
 }
 
+const shouldUseLocalCache = process.env.NODE_ENV === "production";
 let mergedBillsCache: { data: BillSummary[]; expiresAt: number } | null = null;
 
 async function getApiBills(): Promise<BillSummary[]> {
@@ -202,6 +203,12 @@ async function getMergedBills(): Promise<BillSummary[]> {
 }
 
 async function getMergedBillsCached(): Promise<BillSummary[]> {
+  if (!shouldUseLocalCache) {
+    // Avoid stale data while iterating locally; always hit the backing store.
+    mergedBillsCache = null;
+    return getMergedBills();
+  }
+
   const now = Date.now();
   const ttlMs = 300 * 1000; // 5 minutes
   if (mergedBillsCache && mergedBillsCache.expiresAt > now) {
diff --git a/src/lib/mongoose.ts b/src/lib/mongoose.ts
index ca5b22f..71ea27b 100644
--- a/src/lib/mongoose.ts
+++ b/src/lib/mongoose.ts
@@ -3,7 +3,7 @@ import { env } from "@/env";
 
 const MONGO_URI = env.MONGO_URI || "";
 
-const DATABASE_NAME = "bills";
+export const DATABASE_NAME = "bills";
 
 if (!MONGO_URI) {
   // In dev we don't throw to avoid crashing builds without env; callers can decide
diff --git a/src/scripts/sync-db.ts b/src/scripts/sync-db.ts
new file mode 100755
index 0000000..e51478b
--- /dev/null
+++ b/src/scripts/sync-db.ts
@@ -0,0 +1,542 @@
+#!/usr/bin/env tsx
+
+/**
+ * Database Sync Script
+ *
+ * Manage MongoDB dumps and restores for both dev and prod databases.
+ *
+ * Available Actions:
+ *
+ * 1. Dump entire local database
+ *    tsx src/scripts/sync-db.ts dump --from dev
+ *
+ * 2. Dump entire production database
+ *    tsx src/scripts/sync-db.ts dump --from prod
+ *
+ * 3. Dump single collection from local
+ *    tsx src/scripts/sync-db.ts dump --from dev --collection users
+ *
+ * 4. Dump single collection from production
+ *    tsx src/scripts/sync-db.ts dump --from prod --collection bills
+ *
+ * 5. Replace entire local database with a dump
+ *    tsx src/scripts/sync-db.ts restore --dump db-backups/dev/2025-10-12_14-30-00 --to dev
+ *
+ * 6. Replace entire production database with a dump
+ *    tsx src/scripts/sync-db.ts restore --dump db-backups/dev/2025-10-12_14-30-00 --to prod
+ *
+ * 7. Replace single collection on local from a dump
+ *    tsx src/scripts/sync-db.ts restore --dump db-backups/dev/2025-10-12_14-30-00 --to dev --collection users
+ *
+ * 8. Replace single collection on production from a dump
+ *    tsx src/scripts/sync-db.ts restore --dump db-backups/prod/2025-10-12_14-30-00 --to prod --collection bills
+ *
+ * Global Options:
+ *   --dry-run    Preview actions without executing (available for all commands)
+ *
+ * Example with dry-run:
+ *   tsx src/scripts/sync-db.ts --dry-run restore --dump db-backups/dev/2025-10-12_14-30-00 --to prod
+ *
+ * Notes:
+ * - All actions require confirmation before executing
+ * - Production writes require an additional confirmation
+ * - Dumps are stored in db-backups/<source>/<timestamp>/
+ */
+
+import dotenv from "dotenv";
+import path from "node:path";
+
+// Load environment variables from .env.local (Next.js convention)
+dotenv.config({ path: path.join(process.cwd(), ".env.local") });
+
+import { spawnSync } from "node:child_process";
+import { mkdir, access, readdir } from "node:fs/promises";
+import { createInterface } from "node:readline";
+
+type Environment = "dev" | "prod";
+
+interface ParsedArgs {
+  dryRun: boolean;
+  command: "dump" | "restore" | null;
+  from?: Environment;
+  to?: Environment;
+  dumpPath?: string;
+  collection?: string;
+  dbName?: string;
+}
+
+function parseArgs(): ParsedArgs {
+  const args = process.argv.slice(2);
+  const parsed: ParsedArgs = {
+    dryRun: false,
+    command: null,
+  };
+
+  for (let i = 0; i < args.length; i++) {
+    const arg = args[i];
+
+    if (arg === "--dry-run") {
+      parsed.dryRun = true;
+    } else if (arg === "dump") {
+      parsed.command = "dump";
+    } else if (arg === "restore") {
+      parsed.command = "restore";
+    } else if (arg === "--from") {
+      const value = args[++i];
+      if (value !== "dev" && value !== "prod") {
+        throw new Error(
+          `Invalid --from value: ${value}. Must be 'dev' or 'prod'.`,
+        );
+      }
+      parsed.from = value;
+    } else if (arg === "--to") {
+      const value = args[++i];
+      if (value !== "dev" && value !== "prod") {
+        throw new Error(
+          `Invalid --to value: ${value}. Must be 'dev' or 'prod'.`,
+        );
+      }
+      parsed.to = value;
+    } else if (arg === "--dump") {
+      parsed.dumpPath = args[++i];
+      if (!parsed.dumpPath) {
+        throw new Error("--dump requires a path argument");
+      }
+    } else if (arg === "--collection") {
+      parsed.collection = args[++i];
+      if (!parsed.collection) {
+        throw new Error("--collection requires a name argument");
+      }
+    } else if (arg === "--db" || arg === "--database") {
+      parsed.dbName = args[++i];
+      if (!parsed.dbName) {
+        throw new Error("--db/--database requires a name argument");
+      }
+    } else {
+      throw new Error(`Unknown argument: ${arg}`);
+    }
+  }
+
+  return parsed;
+}
+
+type EnvConfig = typeof import("@/env")["env"];
+
+let envConfigPromise: Promise<EnvConfig> | null = null;
+
+function loadEnvConfig(): Promise<EnvConfig> {
+  if (!envConfigPromise) {
+    envConfigPromise = import("@/env").then((module) => module.env);
+  }
+  return envConfigPromise;
+}
+
+type MongooseModule = typeof import("@/lib/mongoose");
+
+let mongooseModulePromise: Promise<MongooseModule> | null = null;
+
+async function loadDefaultDatabaseName(): Promise<string | null> {
+  if (!mongooseModulePromise) {
+    mongooseModulePromise = import("@/lib/mongoose");
+  }
+  const { DATABASE_NAME } = await mongooseModulePromise;
+  if (typeof DATABASE_NAME !== "string") {
+    return null;
+  }
+  const trimmed = DATABASE_NAME.trim();
+  return trimmed === "" ? null : trimmed;
+}
+
+async function getMongoUri(env: Environment): Promise<string> {
+  if (env === "prod") {
+    const prodUri = process.env.PROD_MONGO_URI;
+    if (!prodUri || prodUri.trim() === "") {
+      throw new Error(
+        "PROD_MONGO_URI is not set in environment. Cannot connect to production database.",
+      );
+    }
+    return prodUri.trim();
+  }
+
+  const envConfig = await loadEnvConfig();
+  const devUri = envConfig.MONGO_URI;
+  if (!devUri || devUri.trim() === "") {
+    throw new Error(
+      "MONGO_URI is not set in environment. Cannot connect to dev database.",
+    );
+  }
+  return devUri.trim();
+}
+
+function formatTimestamp(): string {
+  const now = new Date();
+  const year = now.getFullYear();
+  const month = String(now.getMonth() + 1).padStart(2, "0");
+  const day = String(now.getDate()).padStart(2, "0");
+  const hours = String(now.getHours()).padStart(2, "0");
+  const minutes = String(now.getMinutes()).padStart(2, "0");
+  const seconds = String(now.getSeconds()).padStart(2, "0");
+  return `${year}-${month}-${day}_${hours}-${minutes}-${seconds}`;
+}
+
+async function promptForConfirmation(message: string): Promise<boolean> {
+  const rl = createInterface({
+    input: process.stdin,
+    output: process.stdout,
+  });
+
+  return new Promise((resolve) => {
+    rl.question(`${message}\n`, (answer) => {
+      rl.close();
+      const normalized = answer.trim().toLowerCase();
+      resolve(normalized === "y" || normalized === "yes");
+    });
+  });
+}
+
+async function ensureDirectoryExists(
+  dirPath: string,
+  dryRun: boolean,
+): Promise<void> {
+  if (dryRun) {
+    console.log(`[DRY RUN] Would create directory: ${dirPath}`);
+    return;
+  }
+
+  try {
+    await access(dirPath);
+  } catch {
+    await mkdir(dirPath, { recursive: true });
+  }
+}
+
+async function verifyDirectoryExists(dirPath: string): Promise<void> {
+  try {
+    await access(dirPath);
+  } catch {
+    throw new Error(`Dump directory does not exist: ${dirPath}`);
+  }
+}
+
+async function inferDumpDatabaseName(dumpDir: string): Promise<string | null> {
+  try {
+    const entries = await readdir(dumpDir, { withFileTypes: true });
+    const directories = entries.filter((entry) => entry.isDirectory());
+    if (directories.length === 1) {
+      return directories[0]?.name ?? null;
+    }
+  } catch {
+    // ignore; handled by caller
+  }
+  return null;
+}
+
+function extractDatabaseNameFromUri(uri: string): string | null {
+  const schemeSeparator = uri.indexOf("://");
+  if (schemeSeparator === -1) {
+    return null;
+  }
+  const pathStart = uri.indexOf("/", schemeSeparator + 3);
+  if (pathStart === -1) {
+    return null;
+  }
+  const path = uri.slice(pathStart + 1).split("?")[0];
+  if (!path || path.includes("@") || path.includes(",")) {
+    return null;
+  }
+  return path;
+}
+
+function describeDumpAction(from: Environment, collection?: string): string {
+  if (collection) {
+    return `Dump collection '${collection}' from ${from} database`;
+  }
+  return `Dump entire ${from} database`;
+}
+
+function describeRestoreAction(to: Environment, collection?: string): string {
+  if (collection) {
+    return `Replace collection '${collection}' on ${to} database`;
+  }
+  return `Replace entire ${to} database`;
+}
+
+function resolveDatabaseName({
+  uri,
+  providedDbName,
+  envDbName,
+  context,
+}: {
+  uri: string;
+  providedDbName?: string;
+  envDbName?: string | null;
+  context: string;
+}): string {
+  if (providedDbName && providedDbName.trim() !== "") {
+    return providedDbName.trim();
+  }
+
+  const dbFromUri = extractDatabaseNameFromUri(uri);
+  if (dbFromUri) {
+    return dbFromUri;
+  }
+
+  if (envDbName && envDbName.trim() !== "") {
+    return envDbName.trim();
+  }
+
+  throw new Error(
+    `Unable to determine database name for ${context}. Include the database in the connection string, export it via DATABASE_NAME in src/lib/mongoose.ts, or provide it with --db.`,
+  );
+}
+
+async function dumpDatabase(
+  from: Environment,
+  collection: string | undefined,
+  dryRun: boolean,
+  dbNameOverride?: string,
+): Promise<void> {
+  const mongoUri = await getMongoUri(from);
+
+  // Show action description
+  const action = describeDumpAction(from, collection);
+  console.log(`\nAction: ${action}`);
+  console.log(`Source: ${from}`);
+  if (collection) {
+    console.log(`Collection: ${collection}`);
+  }
+  console.log("");
+
+  // First confirmation: what is about to happen
+  const confirmed = await promptForConfirmation("Press Y + Enter to continue");
+  if (!confirmed) {
+    console.log("Operation cancelled.");
+    process.exit(0);
+  }
+
+  const timestamp = formatTimestamp();
+  const backupDir = path.join(process.cwd(), "db-backups", from, timestamp);
+
+  console.log(`Dumping to: ${backupDir}`);
+
+  await ensureDirectoryExists(backupDir, dryRun);
+
+  const command = "mongodump";
+  const args = ["--uri", mongoUri, "--out", backupDir];
+
+  if (collection) {
+    const envDbName =
+      dbNameOverride && dbNameOverride.trim() !== ""
+        ? undefined
+        : await loadDefaultDatabaseName();
+    const dbName = resolveDatabaseName({
+      uri: mongoUri,
+      providedDbName: dbNameOverride,
+      envDbName,
+      context: `dumping collection '${collection}' from ${from}`,
+    });
+    args.push("--db", dbName, "--collection", collection);
+  }
+
+  const redactedCommand = `${command} --uri <REDACTED> --out ${backupDir}${collection ? ` --db <db> --collection ${collection}` : ""}`;
+  console.log(`Command: ${redactedCommand}`);
+
+  if (dryRun) {
+    console.log("[DRY RUN] Would execute mongodump command");
+    return;
+  }
+
+  const result = spawnSync(command, args, {
+    stdio: "inherit",
+  });
+
+  if (result.error) {
+    throw new Error(`Failed to execute mongodump: ${result.error.message}`);
+  }
+
+  if (result.status !== 0) {
+    throw new Error(`mongodump exited with code ${result.status}`);
+  }
+
+  console.log(`Successfully dumped to: ${backupDir}`);
+}
+
+async function restoreDatabase(
+  dumpPath: string,
+  to: Environment,
+  collection: string | undefined,
+  dryRun: boolean,
+  dbNameOverride?: string,
+): Promise<void> {
+  // Resolve dump path (relative to repo root unless absolute)
+  const resolvedPath = path.isAbsolute(dumpPath)
+    ? dumpPath
+    : path.join(process.cwd(), dumpPath);
+
+  // Verify dump directory exists
+  await verifyDirectoryExists(resolvedPath);
+
+  const mongoUri = await getMongoUri(to);
+
+  // Show action description
+  const action = describeRestoreAction(to, collection);
+  console.log(`\nAction: ${action}`);
+  console.log(`Source dump: ${resolvedPath}`);
+  console.log(`Target: ${to}`);
+  if (collection) {
+    console.log(`Collection: ${collection}`);
+  }
+  console.log("");
+
+  // First confirmation: what is about to happen
+  const confirmed = await promptForConfirmation("Press Y + Enter to continue");
+  if (!confirmed) {
+    console.log("Operation cancelled.");
+    process.exit(0);
+  }
+
+  // Second confirmation if writing to prod
+  if (to === "prod") {
+    const prodConfirmed = await promptForConfirmation(
+      "This will modify the production DB. Press Y + Enter to continue",
+    );
+    if (!prodConfirmed) {
+      console.log("Operation cancelled.");
+      process.exit(0);
+    }
+  }
+
+  console.log(`Restoring to ${to} database from: ${resolvedPath}`);
+
+  const command = "mongorestore";
+  const args = ["--uri", mongoUri, "--drop"];
+
+  if (collection) {
+    const dumpDbName = await inferDumpDatabaseName(resolvedPath);
+    const envDbName =
+      dbNameOverride && dbNameOverride.trim() !== ""
+        ? undefined
+        : await loadDefaultDatabaseName();
+    const dbName = resolveDatabaseName({
+      uri: mongoUri,
+      providedDbName: dbNameOverride,
+      envDbName,
+      context: `restoring collection '${collection}' to ${to}`,
+    });
+    const collectionDirName = dumpDbName ?? dbName;
+    // For collection restore, point to the specific collection's BSON file
+    const collectionPath = path.join(
+      resolvedPath,
+      collectionDirName,
+      `${collection}.bson`,
+    );
+    try {
+      await access(collectionPath);
+    } catch {
+      throw new Error(`Collection dump not found at ${collectionPath}`);
+    }
+    args.push("--db", dbName, "--collection", collection, collectionPath);
+  } else {
+    args.push(resolvedPath);
+  }
+
+  const redactedCommand = collection
+    ? `${command} --uri <REDACTED> --drop --db <db> --collection ${collection} <path>`
+    : `${command} --uri <REDACTED> --drop ${resolvedPath}`;
+  console.log(`Command: ${redactedCommand}`);
+
+  if (dryRun) {
+    console.log("[DRY RUN] Would execute mongorestore command");
+    return;
+  }
+
+  const result = spawnSync(command, args, {
+    stdio: "inherit",
+  });
+
+  if (result.error) {
+    throw new Error(`Failed to execute mongorestore: ${result.error.message}`);
+  }
+
+  if (result.status !== 0) {
+    throw new Error(`mongorestore exited with code ${result.status}`);
+  }
+
+  console.log(`Successfully restored to ${to} database`);
+}
+
+async function main() {
+  try {
+    const args = parseArgs();
+
+    if (!args.command) {
+      console.error(
+        "Usage: tsx src/scripts/sync-db.ts [--dry-run] <command> <options>",
+      );
+      console.error("");
+      console.error("Commands:");
+      console.error(
+        "  dump --from <dev|prod> [--collection <name>] [--db <name>]",
+      );
+      console.error("    Dump database or collection");
+      console.error("");
+      console.error(
+        "  restore --dump <path> --to <dev|prod> [--collection <name>] [--db <name>]",
+      );
+      console.error("    Restore database or collection");
+      console.error("");
+      console.error("Global options:");
+      console.error("  --dry-run    Log actions without executing");
+      console.error("");
+      console.error("Examples:");
+      console.error("  tsx src/scripts/sync-db.ts dump --from dev");
+      console.error(
+        "  tsx src/scripts/sync-db.ts dump --from prod --collection users",
+      );
+      console.error(
+        "  tsx src/scripts/sync-db.ts restore --dump db-backups/dev/2025-10-12_14-30-00 --to dev",
+      );
+      console.error(
+        "  tsx src/scripts/sync-db.ts --dry-run restore --dump db-backups/dev/2025-10-12_14-30-00 --to prod",
+      );
+      process.exit(1);
+    }
+
+    if (args.dryRun) {
+      console.log("[DRY RUN MODE ENABLED]");
+    }
+
+    if (args.command === "dump") {
+      if (!args.from) {
+        throw new Error("--from <dev|prod> is required for dump command");
+      }
+      await dumpDatabase(args.from, args.collection, args.dryRun, args.dbName);
+    } else if (args.command === "restore") {
+      if (!args.dumpPath) {
+        throw new Error("--dump <path> is required for restore command");
+      }
+      if (!args.to) {
+        throw new Error("--to <dev|prod> is required for restore command");
+      }
+      await restoreDatabase(
+        args.dumpPath,
+        args.to,
+        args.collection,
+        args.dryRun,
+        args.dbName,
+      );
+    }
+
+    console.log("\nOperation completed successfully");
+    process.exit(0);
+  } catch (error) {
+    if (error instanceof Error) {
+      console.error("Error:", error.message);
+    } else {
+      console.error("Unexpected error:", error);
+    }
+    process.exit(1);
+  }
+}
+
+main();

From 301e76f506af9a22582ca097df2c781e970ca560 Mon Sep 17 00:00:00 2001
From: Shawn Price <hi@shawnprice.com>
Date: Sun, 12 Oct 2025 10:57:36 -0700
Subject: [PATCH 6/8] Refactor sync and migrate scripts. Add cache busting
 option to prod

---
 package.json           |   1 +
 src/app/page.tsx       |  10 +-
 src/scripts/migrate.ts | 237 ++++++++++++++++++++++++++++++++++-------
 src/scripts/sync-db.ts |  51 +--------
 src/scripts/utils.ts   |  58 ++++++++++
 5 files changed, 270 insertions(+), 87 deletions(-)
 create mode 100644 src/scripts/utils.ts

diff --git a/package.json b/package.json
index c92b906..11beb9d 100644
--- a/package.json
+++ b/package.json
@@ -10,6 +10,7 @@
     "format": "biome check --write",
     "test": "vitest run",
     "type-check": "tsc --noEmit",
+    "check": "npm run type-check && npm run format && npx biome check --error-on-warnings",
     "test:watch": "vitest",
     "test:ui": "vitest --ui",
     "test:coverage": "vitest run --coverage",
diff --git a/src/app/page.tsx b/src/app/page.tsx
index bbd5fa3..e78488e 100644
--- a/src/app/page.tsx
+++ b/src/app/page.tsx
@@ -12,6 +12,7 @@ import { BUILD_CANADA_TWITTER_HANDLE, PROJECT_NAME } from "@/consts/general";
 import FAQModalTrigger from "./FAQModalTrigger";
 
 const CANADIAN_PARLIAMENT_NUMBER = 45;
+type HomeSearchParams = { cache?: string };
 
 // Force runtime generation (avoid build-time pre-render) and cache in-memory for 5 minutes
 export const dynamic = "force-dynamic";
@@ -219,7 +220,14 @@ async function getMergedBillsCached(): Promise<BillSummary[]> {
   return data;
 }
 
-export default async function Home() {
+export default async function Home({
+  searchParams,
+}: {
+  searchParams?: HomeSearchParams;
+}) {
+  if (searchParams?.cache === "clear") {
+    mergedBillsCache = null; // Allow manual cache busting with ?cache=clear
+  }
   const bills = await getMergedBillsCached();
   return (
     <div className="min-h-screen">
diff --git a/src/scripts/migrate.ts b/src/scripts/migrate.ts
index a4c003b..9ecd660 100644
--- a/src/scripts/migrate.ts
+++ b/src/scripts/migrate.ts
@@ -1,72 +1,237 @@
 #!/usr/bin/env tsx
 
 /**
- * Database Migration Script
+ * Database Migration Runner
  *
- * Usage:
- *   tsx src/scripts/migrate.ts <migration-filename>
+ * Run or preview migrations against the dev or production MongoDB databases.
  *
- * Examples:
- *   tsx src/scripts/migrate.ts 1.ts
- *   tsx src/scripts/migrate.ts 2-add-indexes.ts
- *   npm run migrate -- 1.ts
+ * Available Actions:
+ *
+ * 1. Run a migration against the dev database (default)
+ *    tsx src/scripts/migrate.ts 1.ts
+ *
+ * 2. Explicitly target dev
+ *    tsx src/scripts/migrate.ts 2-add-indexes.ts --env dev
+ *
+ * 3. Run a migration against production (requires confirmation)
+ *    tsx src/scripts/migrate.ts 3-new-field.ts --env prod
+ *
+ * 4. Preview without executing
+ *    tsx src/scripts/migrate.ts 3-new-field.ts --env prod --dry-run
+ *
+ * Global Options:
+ *   --env <dev|prod>   Target environment (default: dev)
+ *   --dry-run          Log actions without connecting or mutating data
  */
 
 import dotenv from "dotenv";
 import path from "node:path";
+import {
+  Environment,
+  getMongoUri,
+  promptForConfirmation,
+  redactMongoUri,
+} from "./utils";
 
 // Load environment variables from .env.local (Next.js convention)
 dotenv.config({ path: path.join(process.cwd(), ".env.local") });
 
-async function runMigration(filename: string) {
-  console.log(`Running migration: ${filename}`);
+interface ParsedArgs {
+  filename: string | null;
+  environment: Environment;
+  dryRun: boolean;
+}
 
-  // Dynamic imports to ensure dotenv loads first
-  const { connectToDatabase } = await import("@/lib/mongoose");
-  const { env } = await import("@/env");
+function defaultParsedArgs(): ParsedArgs {
+  return {
+    filename: null,
+    environment: "dev",
+    dryRun: false,
+  };
+}
 
-  // Validate MongoDB connection
-  const uri = env.MONGO_URI || "";
-  const hasValidMongoUri =
-    uri.startsWith("mongodb://") || uri.startsWith("mongodb+srv://");
+function parseArgs(argv: string[]): ParsedArgs {
+  const parsed = defaultParsedArgs();
+
+  for (let i = 0; i < argv.length; i++) {
+    const arg = argv[i];
+
+    if (arg === "--dry-run") {
+      parsed.dryRun = true;
+      continue;
+    }
+
+    if (arg === "--env" || arg === "--environment" || arg === "--target") {
+      const value = argv[++i];
+      if (!value) {
+        throw new Error(`${arg} requires a value (dev|prod)`);
+      }
+      parsed.environment = parseEnvironment(value);
+      continue;
+    }
+
+    if (
+      arg.startsWith("--env=") ||
+      arg.startsWith("--environment=") ||
+      arg.startsWith("--target=")
+    ) {
+      const [, value] = arg.split("=", 2);
+      if (!value) {
+        throw new Error(`Invalid argument format: ${arg}`);
+      }
+      parsed.environment = parseEnvironment(value);
+      continue;
+    }
 
-  if (!hasValidMongoUri) {
-    throw new Error("No valid MongoDB URI found in environment");
+    if (arg === "--prod") {
+      parsed.environment = "prod";
+      continue;
+    }
+
+    if (arg === "--dev") {
+      parsed.environment = "dev";
+      continue;
+    }
+
+    if (!arg.startsWith("-") && parsed.filename === null) {
+      parsed.filename = arg;
+      continue;
+    }
+
+    if (!arg.startsWith("-") && parsed.filename !== null) {
+      throw new Error(`Unexpected extra argument: ${arg}`);
+    }
+
+    throw new Error(`Unknown argument: ${arg}`);
   }
 
-  // Connect to database
-  await connectToDatabase();
+  return parsed;
+}
+
+function parseEnvironment(value: string): Environment {
+  const normalized = value.toLowerCase();
+  if (normalized === "dev") return "dev";
+  if (normalized === "prod" || normalized === "production") return "prod";
+  throw new Error(`Invalid environment '${value}'. Use 'dev' or 'prod'.`);
+}
+
+function usage(): void {
+  console.error(
+    "Usage: tsx src/scripts/migrate.ts <migration-filename> [--env <dev|prod>] [--dry-run]",
+  );
+  console.error("Examples:");
+  console.error("  tsx src/scripts/migrate.ts 1.ts");
+  console.error("  tsx src/scripts/migrate.ts 1.ts --env prod");
+  console.error("  tsx src/scripts/migrate.ts 1.ts --env prod --dry-run");
+}
 
-  // Import and run the migration
+async function loadMigrationModule(filename: string) {
   const migrationPath = path.join(process.cwd(), "src/migrations", filename);
   try {
     const migration = await import(migrationPath);
+    return migration as { up?: () => unknown };
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    throw new Error(`Failed to load migration ${filename}: ${message}`);
+  }
+}
+
+async function runMigration({
+  filename,
+  environment,
+  dryRun,
+}: {
+  filename: string;
+  environment: Environment;
+  dryRun: boolean;
+}): Promise<void> {
+  const mongoUri = await getMongoUri(environment);
+  const redactedUri = redactMongoUri(mongoUri);
+  const action = `Run migration '${filename}' on ${environment} database`;
+
+  console.log(`\nAction: ${action}`);
+  console.log(`Target environment: ${environment}`);
+  console.log(`Mongo URI: ${redactedUri}`);
+  console.log(`Migration file: ${filename}`);
+  console.log("");
+
+  const migrationModule = await loadMigrationModule(filename);
+  if (typeof migrationModule.up !== "function") {
+    throw new Error(`Migration ${filename} must export an 'up' function`);
+  }
 
-    if (!migration.up || typeof migration.up !== "function") {
-      throw new Error(`Migration ${filename} must export an 'up' function`);
+  if (dryRun) {
+    console.log("[DRY RUN] Migration module loaded successfully.");
+    console.log(
+      "[DRY RUN] Would connect to the database and execute migration.up().",
+    );
+    return;
+  }
+
+  const confirmed = await promptForConfirmation("Press Y + Enter to continue");
+  if (!confirmed) {
+    console.log("Migration cancelled.");
+    return;
+  }
+
+  if (environment === "prod") {
+    const prodConfirmed = await promptForConfirmation(
+      "This will modify the production database. Press Y + Enter to continue",
+    );
+    if (!prodConfirmed) {
+      console.log("Migration cancelled.");
+      return;
     }
+  }
+
+  process.env.MONGO_URI = mongoUri;
+  process.env.MONGODB_URI = mongoUri;
+
+  const { connectToDatabase } = await import("@/lib/mongoose");
+
+  console.log("Connecting to MongoDB...");
+  await connectToDatabase();
 
-    await migration.up();
-    console.log(`Migration ${filename} completed successfully`);
+  console.log("Executing migration...");
+  try {
+    await migrationModule.up();
   } catch (error) {
-    console.error(`Migration ${filename} failed:`, error);
-    throw error;
+    if (error instanceof Error) {
+      error.message = `Migration ${filename} failed: ${error.message}`;
+      throw error;
+    }
+    throw new Error(`Migration ${filename} failed: ${String(error)}`);
   }
+
+  console.log(`Migration ${filename} completed successfully`);
 }
 
-// Get migration filename from command line arguments
-const filename = process.argv[2];
+async function main(): Promise<void> {
+  let parsed: ParsedArgs;
+  try {
+    parsed = parseArgs(process.argv.slice(2));
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    console.error(message);
+    console.error("");
+    usage();
+    process.exit(1);
+  }
+
+  if (!parsed.filename) {
+    usage();
+    process.exit(1);
+  }
 
-if (!filename) {
-  console.error("Usage: tsx src/scripts/migrate.ts <migration-filename>");
-  console.error("Example: tsx src/scripts/migrate.ts 1.ts");
-  process.exit(1);
+  await runMigration({
+    filename: parsed.filename,
+    environment: parsed.environment,
+    dryRun: parsed.dryRun,
+  });
 }
 
-// Run the migration
-runMigration(filename)
+main()
   .then(() => {
-    console.log("Migration completed");
     process.exit(0);
   })
   .catch((error) => {
diff --git a/src/scripts/sync-db.ts b/src/scripts/sync-db.ts
index e51478b..cc92095 100755
--- a/src/scripts/sync-db.ts
+++ b/src/scripts/sync-db.ts
@@ -51,9 +51,7 @@ dotenv.config({ path: path.join(process.cwd(), ".env.local") });
 
 import { spawnSync } from "node:child_process";
 import { mkdir, access, readdir } from "node:fs/promises";
-import { createInterface } from "node:readline";
-
-type Environment = "dev" | "prod";
+import { Environment, getMongoUri, promptForConfirmation } from "./utils";
 
 interface ParsedArgs {
   dryRun: boolean;
@@ -120,17 +118,6 @@ function parseArgs(): ParsedArgs {
   return parsed;
 }
 
-type EnvConfig = typeof import("@/env")["env"];
-
-let envConfigPromise: Promise<EnvConfig> | null = null;
-
-function loadEnvConfig(): Promise<EnvConfig> {
-  if (!envConfigPromise) {
-    envConfigPromise = import("@/env").then((module) => module.env);
-  }
-  return envConfigPromise;
-}
-
 type MongooseModule = typeof import("@/lib/mongoose");
 
 let mongooseModulePromise: Promise<MongooseModule> | null = null;
@@ -147,27 +134,6 @@ async function loadDefaultDatabaseName(): Promise<string | null> {
   return trimmed === "" ? null : trimmed;
 }
 
-async function getMongoUri(env: Environment): Promise<string> {
-  if (env === "prod") {
-    const prodUri = process.env.PROD_MONGO_URI;
-    if (!prodUri || prodUri.trim() === "") {
-      throw new Error(
-        "PROD_MONGO_URI is not set in environment. Cannot connect to production database.",
-      );
-    }
-    return prodUri.trim();
-  }
-
-  const envConfig = await loadEnvConfig();
-  const devUri = envConfig.MONGO_URI;
-  if (!devUri || devUri.trim() === "") {
-    throw new Error(
-      "MONGO_URI is not set in environment. Cannot connect to dev database.",
-    );
-  }
-  return devUri.trim();
-}
-
 function formatTimestamp(): string {
   const now = new Date();
   const year = now.getFullYear();
@@ -179,21 +145,6 @@ function formatTimestamp(): string {
   return `${year}-${month}-${day}_${hours}-${minutes}-${seconds}`;
 }
 
-async function promptForConfirmation(message: string): Promise<boolean> {
-  const rl = createInterface({
-    input: process.stdin,
-    output: process.stdout,
-  });
-
-  return new Promise((resolve) => {
-    rl.question(`${message}\n`, (answer) => {
-      rl.close();
-      const normalized = answer.trim().toLowerCase();
-      resolve(normalized === "y" || normalized === "yes");
-    });
-  });
-}
-
 async function ensureDirectoryExists(
   dirPath: string,
   dryRun: boolean,
diff --git a/src/scripts/utils.ts b/src/scripts/utils.ts
new file mode 100644
index 0000000..f8a383c
--- /dev/null
+++ b/src/scripts/utils.ts
@@ -0,0 +1,58 @@
+import { createInterface } from "node:readline";
+
+export type Environment = "dev" | "prod";
+
+type EnvConfig = typeof import("@/env")["env"];
+
+let envConfigPromise: Promise<EnvConfig> | null = null;
+
+export function loadEnvConfig(): Promise<EnvConfig> {
+  if (!envConfigPromise) {
+    envConfigPromise = import("@/env").then((module) => module.env);
+  }
+  return envConfigPromise;
+}
+
+export async function getMongoUri(env: Environment): Promise<string> {
+  if (env === "prod") {
+    const prodUri = process.env.PROD_MONGO_URI;
+    if (!prodUri || prodUri.trim() === "") {
+      throw new Error(
+        "PROD_MONGO_URI is not set in environment. Cannot connect to production database.",
+      );
+    }
+    return prodUri.trim();
+  }
+
+  const envConfig = await loadEnvConfig();
+  const devUri = envConfig.MONGO_URI;
+  if (!devUri || devUri.trim() === "") {
+    throw new Error(
+      "MONGO_URI is not set in environment. Cannot connect to dev database.",
+    );
+  }
+  return devUri.trim();
+}
+
+export function redactMongoUri(uri: string): string {
+  return uri.replace(/\/\/([^@]+)@/, "//<REDACTED>@");
+}
+
+/**
+ * Prompt the user for a yes/no confirmation.
+ * Accepts "y" or "yes" (case-insensitive) as affirmative.
+ */
+export async function promptForConfirmation(message: string): Promise<boolean> {
+  const rl = createInterface({
+    input: process.stdin,
+    output: process.stdout,
+  });
+
+  return new Promise((resolve) => {
+    rl.question(`${message}\n`, (answer) => {
+      rl.close();
+      const normalized = answer.trim().toLowerCase();
+      resolve(normalized === "y" || normalized === "yes");
+    });
+  });
+}

From 6edd40ee84c204f8a5cf967a5ec9712761e99bb9 Mon Sep 17 00:00:00 2001
From: Shawn Price <hi@shawnprice.com>
Date: Sun, 12 Oct 2025 11:32:34 -0700
Subject: [PATCH 7/8] Refactor scripts. Remove vote swapping based on tenet
 count data

---
 package.json           |   1 -
 src/app/page.tsx       |  24 +--------
 src/scripts/migrate.ts | 113 ++++++++++++++++++++++++++++++-----------
 src/scripts/sync-db.ts |  74 +++++++++++++++++++++------
 4 files changed, 143 insertions(+), 69 deletions(-)

diff --git a/package.json b/package.json
index 11beb9d..9aa0926 100644
--- a/package.json
+++ b/package.json
@@ -15,7 +15,6 @@
     "test:ui": "vitest --ui",
     "test:coverage": "vitest run --coverage",
     "prompt": "tsx src/scripts/copy-bill-prompt.ts",
-    "migrate": "tsx src/scripts/migrate.ts",
     "prepare": "husky"
   },
   "dependencies": {
diff --git a/src/app/page.tsx b/src/app/page.tsx
index e78488e..0d42e23 100644
--- a/src/app/page.tsx
+++ b/src/app/page.tsx
@@ -122,16 +122,6 @@ async function getMergedBills(): Promise<BillSummary[]> {
     const dbBill = dbBillsMap.get(apiBill.billID);
 
     if (dbBill) {
-      const alignCount = (dbBill.tenet_evaluations ?? []).filter(
-        (t) => t.alignment === "aligns",
-      ).length;
-      const conflictCount = (dbBill.tenet_evaluations ?? []).filter(
-        (t) => t.alignment === "conflicts",
-      ).length;
-      const displayFinal: BillSummary["final_judgment"] =
-        alignCount === 1 && conflictCount === 0
-          ? "abstain"
-          : (dbBill.final_judgment as BillSummary["final_judgment"]);
       // Merge API bill with DB data (DB data takes precedence for analysis fields)
       return {
         ...dbBill,
@@ -139,7 +129,7 @@ async function getMergedBills(): Promise<BillSummary[]> {
         shortTitle: dbBill.short_title || apiBill.shortTitle,
         summary: dbBill.summary,
         isSocialIssue: dbBill.isSocialIssue,
-        final_judgment: displayFinal,
+        final_judgment: dbBill.final_judgment as BillSummary["final_judgment"],
         rationale: dbBill.rationale,
         needs_more_info: dbBill.needs_more_info,
         missing_details: dbBill.missing_details,
@@ -157,16 +147,6 @@ async function getMergedBills(): Promise<BillSummary[]> {
   for (const [billId, dbBill] of dbBillsMap) {
     if (!mergedBills.find((bill) => bill.billID === billId)) {
       // Convert DB bill to BillSummary format
-      const alignCount = (dbBill.tenet_evaluations ?? []).filter(
-        (t) => t.alignment === "aligns",
-      ).length;
-      const conflictCount = (dbBill.tenet_evaluations ?? []).filter(
-        (t) => t.alignment === "conflicts",
-      ).length;
-      const displayFinal: BillSummary["final_judgment"] =
-        alignCount === 1 && conflictCount === 0
-          ? "abstain"
-          : (dbBill.final_judgment as BillSummary["final_judgment"]);
       const billSummary: BillSummary = {
         billID: dbBill.billId,
         title: dbBill.title,
@@ -185,7 +165,7 @@ async function getMergedBills(): Promise<BillSummary[]> {
           dbBill.lastUpdatedOn?.toISOString() || new Date().toISOString(),
         summary: dbBill.summary,
         isSocialIssue: dbBill.isSocialIssue,
-        final_judgment: displayFinal,
+        final_judgment: dbBill.final_judgment as BillSummary["final_judgment"],
         rationale: dbBill.rationale,
         needs_more_info: dbBill.needs_more_info,
         missing_details: dbBill.missing_details,
diff --git a/src/scripts/migrate.ts b/src/scripts/migrate.ts
index 9ecd660..1d061b4 100644
--- a/src/scripts/migrate.ts
+++ b/src/scripts/migrate.ts
@@ -8,24 +8,31 @@
  * Available Actions:
  *
  * 1. Run a migration against the dev database (default)
- *    tsx src/scripts/migrate.ts 1.ts
+ *    tsx src/scripts/migrate.ts src/migrations/1.ts
  *
  * 2. Explicitly target dev
- *    tsx src/scripts/migrate.ts 2-add-indexes.ts --env dev
+ *    tsx src/scripts/migrate.ts src/migrations/2-add-indexes.ts --env dev
  *
  * 3. Run a migration against production (requires confirmation)
- *    tsx src/scripts/migrate.ts 3-new-field.ts --env prod
+ *    tsx src/scripts/migrate.ts src/migrations/3-new-field.ts --env prod
  *
  * 4. Preview without executing
- *    tsx src/scripts/migrate.ts 3-new-field.ts --env prod --dry-run
+ *    tsx src/scripts/migrate.ts src/migrations/3-new-field.ts --env prod --dry-run
  *
  * Global Options:
  *   --env <dev|prod>   Target environment (default: dev)
  *   --dry-run          Log actions without connecting or mutating data
+ *
+ * Notes:
+ * - Run this script from the repository root so paths resolve correctly.
+ * - Supply a path inside src/migrations (absolute or repo-relative like src/migrations/1.ts).
+ * - Each migration module must export an async `up` function.
+ * - Production targets prompt for a second confirmation before executing.
  */
 
 import dotenv from "dotenv";
 import path from "node:path";
+import { pathToFileURL } from "node:url";
 import {
   Environment,
   getMongoUri,
@@ -36,15 +43,17 @@ import {
 // Load environment variables from .env.local (Next.js convention)
 dotenv.config({ path: path.join(process.cwd(), ".env.local") });
 
+const MIGRATIONS_ROOT = path.join(process.cwd(), "src/migrations");
+
 interface ParsedArgs {
-  filename: string | null;
+  migrationInputPath: string | null;
   environment: Environment;
   dryRun: boolean;
 }
 
 function defaultParsedArgs(): ParsedArgs {
   return {
-    filename: null,
+    migrationInputPath: null,
     environment: "dev",
     dryRun: false,
   };
@@ -93,12 +102,12 @@ function parseArgs(argv: string[]): ParsedArgs {
       continue;
     }
 
-    if (!arg.startsWith("-") && parsed.filename === null) {
-      parsed.filename = arg;
+    if (!arg.startsWith("-") && parsed.migrationInputPath === null) {
+      parsed.migrationInputPath = arg;
       continue;
     }
 
-    if (!arg.startsWith("-") && parsed.filename !== null) {
+    if (!arg.startsWith("-") && parsed.migrationInputPath !== null) {
       throw new Error(`Unexpected extra argument: ${arg}`);
     }
 
@@ -117,47 +126,92 @@ function parseEnvironment(value: string): Environment {
 
 function usage(): void {
   console.error(
-    "Usage: tsx src/scripts/migrate.ts <migration-filename> [--env <dev|prod>] [--dry-run]",
+    "Usage: tsx src/scripts/migrate.ts <path-to-migration> [--env <dev|prod>] [--dry-run]",
   );
   console.error("Examples:");
-  console.error("  tsx src/scripts/migrate.ts 1.ts");
-  console.error("  tsx src/scripts/migrate.ts 1.ts --env prod");
-  console.error("  tsx src/scripts/migrate.ts 1.ts --env prod --dry-run");
+  console.error("  tsx src/scripts/migrate.ts src/migrations/1.ts");
+  console.error("  tsx src/scripts/migrate.ts src/migrations/1.ts --env prod");
+  console.error(
+    "  tsx src/scripts/migrate.ts src/migrations/1.ts --env prod --dry-run",
+  );
 }
 
-async function loadMigrationModule(filename: string) {
-  const migrationPath = path.join(process.cwd(), "src/migrations", filename);
+function ensurePathWithinBase(baseDir: string, candidate: string): string {
+  const relative = path.relative(baseDir, candidate);
+  if (
+    relative === "" ||
+    (!relative.startsWith("..") && !path.isAbsolute(relative))
+  ) {
+    return candidate;
+  }
+  throw new Error(
+    `Migration path must be within ${baseDir}. Received: ${candidate}`,
+  );
+}
+
+function resolveMigrationPath(input: string): {
+  absolutePath: string;
+  displayPath: string;
+} {
+  const normalizedInput = path.normalize(input);
+
+  let candidateAbsolute: string;
+  if (path.isAbsolute(normalizedInput)) {
+    candidateAbsolute = normalizedInput;
+  } else if (normalizedInput.startsWith("src" + path.sep)) {
+    candidateAbsolute = path.resolve(process.cwd(), normalizedInput);
+  } else {
+    candidateAbsolute = path.join(MIGRATIONS_ROOT, normalizedInput);
+  }
+
+  const migrationPath = ensurePathWithinBase(
+    MIGRATIONS_ROOT,
+    candidateAbsolute,
+  );
+  const displayPath = path.relative(process.cwd(), migrationPath);
+  return {
+    absolutePath: migrationPath,
+    displayPath: displayPath || normalizedInput,
+  };
+}
+
+async function loadMigrationModule(absolutePath: string, displayPath: string) {
   try {
-    const migration = await import(migrationPath);
+    const migration = await import(pathToFileURL(absolutePath).href);
     return migration as { up?: () => unknown };
   } catch (error) {
     const message = error instanceof Error ? error.message : String(error);
-    throw new Error(`Failed to load migration ${filename}: ${message}`);
+    throw new Error(`Failed to load migration ${displayPath}: ${message}`);
   }
 }
 
 async function runMigration({
-  filename,
+  migrationInputPath,
   environment,
   dryRun,
 }: {
-  filename: string;
+  migrationInputPath: string;
   environment: Environment;
   dryRun: boolean;
 }): Promise<void> {
+  const { absolutePath, displayPath } =
+    resolveMigrationPath(migrationInputPath);
   const mongoUri = await getMongoUri(environment);
   const redactedUri = redactMongoUri(mongoUri);
-  const action = `Run migration '${filename}' on ${environment} database`;
+  const action = `Run migration '${displayPath}' on ${environment} database`;
 
   console.log(`\nAction: ${action}`);
   console.log(`Target environment: ${environment}`);
   console.log(`Mongo URI: ${redactedUri}`);
-  console.log(`Migration file: ${filename}`);
+  console.log(`Migration file: ${displayPath}`);
   console.log("");
 
-  const migrationModule = await loadMigrationModule(filename);
+  process.env.MONGO_URI = mongoUri;
+  process.env.MONGODB_URI = mongoUri;
+
+  const migrationModule = await loadMigrationModule(absolutePath, displayPath);
   if (typeof migrationModule.up !== "function") {
-    throw new Error(`Migration ${filename} must export an 'up' function`);
+    throw new Error(`Migration ${displayPath} must export an 'up' function`);
   }
 
   if (dryRun) {
@@ -184,9 +238,6 @@ async function runMigration({
     }
   }
 
-  process.env.MONGO_URI = mongoUri;
-  process.env.MONGODB_URI = mongoUri;
-
   const { connectToDatabase } = await import("@/lib/mongoose");
 
   console.log("Connecting to MongoDB...");
@@ -197,13 +248,13 @@ async function runMigration({
     await migrationModule.up();
   } catch (error) {
     if (error instanceof Error) {
-      error.message = `Migration ${filename} failed: ${error.message}`;
+      error.message = `Migration ${displayPath} failed: ${error.message}`;
       throw error;
     }
-    throw new Error(`Migration ${filename} failed: ${String(error)}`);
+    throw new Error(`Migration ${displayPath} failed: ${String(error)}`);
   }
 
-  console.log(`Migration ${filename} completed successfully`);
+  console.log(`Migration ${displayPath} completed successfully`);
 }
 
 async function main(): Promise<void> {
@@ -218,13 +269,13 @@ async function main(): Promise<void> {
     process.exit(1);
   }
 
-  if (!parsed.filename) {
+  if (!parsed.migrationInputPath) {
     usage();
     process.exit(1);
   }
 
   await runMigration({
-    filename: parsed.filename,
+    migrationInputPath: parsed.migrationInputPath,
     environment: parsed.environment,
     dryRun: parsed.dryRun,
   });
diff --git a/src/scripts/sync-db.ts b/src/scripts/sync-db.ts
index cc92095..156cedf 100755
--- a/src/scripts/sync-db.ts
+++ b/src/scripts/sync-db.ts
@@ -53,6 +53,8 @@ import { spawnSync } from "node:child_process";
 import { mkdir, access, readdir } from "node:fs/promises";
 import { Environment, getMongoUri, promptForConfirmation } from "./utils";
 
+const DB_BACKUPS_ROOT = path.join(process.cwd(), "db-backups");
+
 interface ParsedArgs {
   dryRun: boolean;
   command: "dump" | "restore" | null;
@@ -212,6 +214,35 @@ function describeRestoreAction(to: Environment, collection?: string): string {
   return `Replace entire ${to} database`;
 }
 
+function ensurePathWithinBase(baseDir: string, candidate: string): string {
+  const relative = path.relative(baseDir, candidate);
+  if (
+    relative === "" ||
+    (!relative.startsWith("..") && !path.isAbsolute(relative))
+  ) {
+    return candidate;
+  }
+  throw new Error(
+    `Dump path must be within ${baseDir}. Received: ${candidate}`,
+  );
+}
+
+function resolveDumpDirectoryPath(dumpPath: string): string {
+  const normalizedInput = path.normalize(dumpPath);
+
+  if (path.isAbsolute(normalizedInput)) {
+    return ensurePathWithinBase(DB_BACKUPS_ROOT, normalizedInput);
+  }
+
+  const segments = normalizedInput.split(path.sep).filter((segment) => segment);
+  if (segments[0] === "db-backups") {
+    segments.shift();
+  }
+
+  const resolved = path.resolve(DB_BACKUPS_ROOT, ...segments);
+  return ensurePathWithinBase(DB_BACKUPS_ROOT, resolved);
+}
+
 function resolveDatabaseName({
   uri,
   providedDbName,
@@ -266,7 +297,7 @@ async function dumpDatabase(
   }
 
   const timestamp = formatTimestamp();
-  const backupDir = path.join(process.cwd(), "db-backups", from, timestamp);
+  const backupDir = path.join(DB_BACKUPS_ROOT, from, timestamp);
 
   console.log(`Dumping to: ${backupDir}`);
 
@@ -320,9 +351,7 @@ async function restoreDatabase(
   dbNameOverride?: string,
 ): Promise<void> {
   // Resolve dump path (relative to repo root unless absolute)
-  const resolvedPath = path.isAbsolute(dumpPath)
-    ? dumpPath
-    : path.join(process.cwd(), dumpPath);
+  const resolvedPath = resolveDumpDirectoryPath(dumpPath);
 
   // Verify dump directory exists
   await verifyDirectoryExists(resolvedPath);
@@ -374,18 +403,33 @@ async function restoreDatabase(
       envDbName,
       context: `restoring collection '${collection}' to ${to}`,
     });
-    const collectionDirName = dumpDbName ?? dbName;
-    // For collection restore, point to the specific collection's BSON file
-    const collectionPath = path.join(
-      resolvedPath,
-      collectionDirName,
-      `${collection}.bson`,
-    );
-    try {
-      await access(collectionPath);
-    } catch {
-      throw new Error(`Collection dump not found at ${collectionPath}`);
+    const nestedCollectionPath =
+      dumpDbName !== null
+        ? path.join(resolvedPath, dumpDbName, `${collection}.bson`)
+        : path.join(resolvedPath, dbName, `${collection}.bson`);
+    const directCollectionPath = path.join(resolvedPath, `${collection}.bson`);
+    const candidatePaths: string[] = [directCollectionPath];
+    if (!candidatePaths.includes(nestedCollectionPath)) {
+      candidatePaths.push(nestedCollectionPath);
+    }
+
+    let collectionPath: string | null = null;
+    for (const candidate of candidatePaths) {
+      try {
+        await access(candidate);
+        collectionPath = candidate;
+        break;
+      } catch {
+        // try next candidate
+      }
     }
+
+    if (!collectionPath) {
+      throw new Error(
+        `Collection dump not found. Checked: ${candidatePaths.join(", ")}`,
+      );
+    }
+
     args.push("--db", dbName, "--collection", collection, collectionPath);
   } else {
     args.push(resolvedPath);

From 73b7a927fddad6d000c296988dc23464084f8d8f Mon Sep 17 00:00:00 2001
From: Shawn Price <hi@shawnprice.com>
Date: Sun, 12 Oct 2025 11:33:17 -0700
Subject: [PATCH 8/8] Fix formatting

---
 src/scripts/migrate.ts | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/scripts/migrate.ts b/src/scripts/migrate.ts
index 1d061b4..159f7eb 100644
--- a/src/scripts/migrate.ts
+++ b/src/scripts/migrate.ts
@@ -158,7 +158,7 @@ function resolveMigrationPath(input: string): {
   let candidateAbsolute: string;
   if (path.isAbsolute(normalizedInput)) {
     candidateAbsolute = normalizedInput;
-  } else if (normalizedInput.startsWith("src" + path.sep)) {
+  } else if (normalizedInput.startsWith(`src${path.sep}`)) {
     candidateAbsolute = path.resolve(process.cwd(), normalizedInput);
   } else {
     candidateAbsolute = path.join(MIGRATIONS_ROOT, normalizedInput);