opencandle 0.3.0 → 0.4.0

package/gui/web/dist/assets/logo-CWpt6Y2a.svg

@@ -0,0 +1,187 @@
+<svg xmlns="http://www.w3.org/2000/svg" xmlns:v="https://svgstorm.com"
+viewBox = "0 0 1009 1008"
+width="1009"
+height="1008">
+<g fill="None" fill-opacity="0.0" stroke="#34474E" stroke-opacity="0.00" stroke-width="0.3"><path d="
+M 0.00 1008.00 
+L 1009.00 1008.00
+L 1009.00 0.00
+L 0.00 0.00
+L 0.00 1008.00
+M 893.00 7.00 
+C 912.65 7.48 933.31 16.27 951.00 28.00
+C 960.90 34.53 969.82 43.54 977.00 53.00
+C 987.75 70.16 998.47 88.32 1000.00 109.00
+C 1004.61 172.94 1000.71 239.89 1002.00 305.00 C 1002.00 437.00 1002.00 569.00 1002.00 701.00 C 1000.71 766.09 1004.61 833.14 1000.00 897.00
+C 997.20 915.93 990.73 934.49 979.00 950.00
+C 971.95 960.06 962.97 968.87 953.00 976.00
+C 936.25 987.24 917.87 994.87 898.00 998.00
+C 848.40 1002.63 795.77 998.69 745.00 1000.00 C 537.83 999.33 329.35 1001.34 123.00 999.00
+C 113.93 999.28 105.34 997.59 97.00 995.00
+C 87.29 992.63 76.80 989.30 69.00 983.00
+C 68.57 982.83 68.00 983.00 68.00 983.00
+C 55.21 976.65 44.68 965.81 35.00 955.00
+C -7.40 902.87 14.27 828.97 9.00 765.00 C 9.00 548.67 9.00 332.33 9.00 116.00 C 11.95 60.04 61.08 10.55 117.00 7.00
+C 374.60 5.33 635.47 5.33 893.00 7.00 Z"/>
+</g>
+<g fill="None" fill-opacity="0.0" stroke="#87A188" stroke-opacity="1.00" stroke-width="0.3"><path d="
+M 117.00 7.00 
+C 375.67 7.00 634.33 7.00 893.00 7.00
+C 635.47 5.33 374.60 5.33 117.00 7.00 Z"/>
+</g>
+<g fill="None" fill-opacity="0.0" stroke="#34474E" stroke-opacity="1.00" stroke-width="0.3"><path d="
+M 893.00 7.00 
+C 634.33 7.00 375.67 7.00 117.00 7.00
+C 61.08 10.55 11.95 60.04 9.00 116.00 C 9.00 332.33 9.00 548.67 9.00 765.00 C 14.27 828.97 -7.40 902.87 35.00 955.00
+C 45.51 965.18 56.26 975.41 68.00 983.00
+C 68.00 983.00 68.57 982.83 69.00 983.00
+C 77.85 988.23 88.00 991.10 97.00 995.00
+C 105.34 997.59 113.93 999.28 123.00 999.00
+C 381.25 998.34 640.16 1000.33 898.00 998.00
+C 917.87 994.87 936.25 987.24 953.00 976.00
+C 961.89 967.94 970.70 958.59 979.00 950.00
+C 990.73 934.49 997.20 915.93 1000.00 897.00
+C 1001.66 634.92 1001.67 371.08 1000.00 109.00
+C 998.47 88.32 987.75 70.16 977.00 53.00
+C 968.92 44.28 959.99 35.47 951.00 28.00
+C 933.31 16.27 912.65 7.48 893.00 7.00
+M 515.00 304.00 
+C 539.00 304.00 563.00 304.00 587.00 304.00 C 615.29 302.32 605.38 337.85 607.00 356.00 C 607.00 452.00 607.00 548.00 607.00 644.00 C 605.19 661.97 615.63 698.38 587.00 696.00 C 563.00 696.00 539.00 696.00 515.00 696.00
+C 515.00 728.00 515.00 760.00 515.00 792.00 C 512.34 804.03 522.39 828.07 505.00 830.00 C 487.59 827.79 497.67 804.11 495.00 792.00 C 495.00 760.00 495.00 728.00 495.00 696.00
+C 471.33 696.00 447.67 696.00 424.00 696.00 C 394.53 699.12 406.18 662.06 404.00 644.00 C 404.00 548.33 404.00 452.67 404.00 357.00 C 406.52 338.80 394.21 302.66 423.00 304.00 C 447.00 304.00 471.00 304.00 495.00 304.00
+C 495.00 272.00 495.00 240.00 495.00 208.00 C 497.32 195.66 488.16 173.46 505.01 170.01 C 521.85 173.62 512.68 195.59 515.00 208.00 C 515.00 240.00 515.00 272.00 515.00 304.00 Z"/>
+</g>
+<g fill="None" fill-opacity="0.0" stroke="#87A188" stroke-opacity="0.91" stroke-width="0.3"><path d="
+M 977.00 53.00 
+C 969.82 43.54 960.90 34.53 951.00 28.00
+C 959.99 35.47 968.92 44.28 977.00 53.00 Z"/>
+</g>
+<g fill="None" fill-opacity="0.0" stroke="#87A188" stroke-opacity="1.00" stroke-width="0.3"><path d="
+M 1000.00 897.00 
+C 1004.61 833.14 1000.71 766.09 1002.00 701.00 C 1002.00 569.00 1002.00 437.00 1002.00 305.00 C 1000.71 239.89 1004.61 172.94 1000.00 109.00
+C 1001.67 371.08 1001.66 634.92 1000.00 897.00 Z"/>
+</g>
+<g fill="None" fill-opacity="0.0" stroke="#87A188" stroke-opacity="1.00" stroke-width="0.3"><path d="
+M 515.00 304.00 
+C 515.00 272.00 515.00 240.00 515.00 208.00 C 512.68 195.59 521.85 173.62 505.01 170.01 C 488.16 173.46 497.32 195.66 495.00 208.00 C 495.00 240.00 495.00 272.00 495.00 304.00
+C 471.00 304.00 447.00 304.00 423.00 304.00 C 394.21 302.66 406.52 338.80 404.00 357.00 C 404.00 452.67 404.00 548.33 404.00 644.00 C 406.18 662.06 394.53 699.12 424.00 696.00 C 447.67 696.00 471.33 696.00 495.00 696.00
+C 495.00 728.00 495.00 760.00 495.00 792.00 C 497.67 804.11 487.59 827.79 505.00 830.00 C 522.39 828.07 512.34 804.03 515.00 792.00 C 515.00 760.00 515.00 728.00 515.00 696.00
+C 539.00 696.00 563.00 696.00 587.00 696.00 C 615.63 698.38 605.19 661.97 607.00 644.00 C 607.00 548.00 607.00 452.00 607.00 356.00 C 605.38 337.85 615.29 302.32 587.00 304.00 C 563.00 304.00 539.00 304.00 515.00 304.00 Z"/>
+</g>
+<g fill="None" fill-opacity="0.0" stroke="#87A188" stroke-opacity="0.78" stroke-width="0.3"><path d="
+M 953.00 976.00 
+C 962.97 968.87 971.95 960.06 979.00 950.00
+C 970.70 958.59 961.89 967.94 953.00 976.00 Z"/>
+</g>
+<g fill="None" fill-opacity="0.0" stroke="#87A188" stroke-opacity="0.85" stroke-width="0.3"><path d="
+M 68.00 983.00 
+C 56.26 975.41 45.51 965.18 35.00 955.00
+C 44.68 965.81 55.21 976.65 68.00 983.00 Z"/>
+</g>
+<g fill="None" fill-opacity="0.0" stroke="#87A188" stroke-opacity="0.79" stroke-width="0.3"><path d="
+M 97.00 995.00 
+C 88.00 991.10 77.85 988.23 69.00 983.00
+C 76.80 989.30 87.29 992.63 97.00 995.00 Z"/>
+</g>
+<g fill="None" fill-opacity="0.0" stroke="#87A188" stroke-opacity="0.53" stroke-width="0.3"><path d="
+M 123.00 999.00 
+C 329.35 1001.34 537.83 999.33 745.00 1000.00 C 795.77 998.69 848.40 1002.63 898.00 998.00
+C 640.16 1000.33 381.25 998.34 123.00 999.00 Z"/>
+</g>
+<g fill="#34474E" fill-opacity="0.00" stroke="None">
+<path d="
+M 0.00 1008.00 
+L 1009.00 1008.00
+L 1009.00 0.00
+L 0.00 0.00
+L 0.00 1008.00
+M 893.00 7.00 
+C 912.65 7.48 933.31 16.27 951.00 28.00
+C 960.90 34.53 969.82 43.54 977.00 53.00
+C 987.75 70.16 998.47 88.32 1000.00 109.00
+C 1004.61 172.94 1000.71 239.89 1002.00 305.00 C 1002.00 437.00 1002.00 569.00 1002.00 701.00 C 1000.71 766.09 1004.61 833.14 1000.00 897.00
+C 997.20 915.93 990.73 934.49 979.00 950.00
+C 971.95 960.06 962.97 968.87 953.00 976.00
+C 936.25 987.24 917.87 994.87 898.00 998.00
+C 848.40 1002.63 795.77 998.69 745.00 1000.00 C 537.83 999.33 329.35 1001.34 123.00 999.00
+C 113.93 999.28 105.34 997.59 97.00 995.00
+C 87.29 992.63 76.80 989.30 69.00 983.00
+C 68.57 982.83 68.00 983.00 68.00 983.00
+C 55.21 976.65 44.68 965.81 35.00 955.00
+C -7.40 902.87 14.27 828.97 9.00 765.00 C 9.00 548.67 9.00 332.33 9.00 116.00 C 11.95 60.04 61.08 10.55 117.00 7.00
+C 374.60 5.33 635.47 5.33 893.00 7.00 Z"/>
+</g>
+<g fill="#87A188" fill-opacity="1.00" stroke="None">
+<path d="
+M 117.00 7.00 
+C 375.67 7.00 634.33 7.00 893.00 7.00
+C 635.47 5.33 374.60 5.33 117.00 7.00 Z"/>
+</g>
+<g fill="#34474E" fill-opacity="1.00" stroke="None">
+<path d="
+M 893.00 7.00 
+C 634.33 7.00 375.67 7.00 117.00 7.00
+C 61.08 10.55 11.95 60.04 9.00 116.00 C 9.00 332.33 9.00 548.67 9.00 765.00 C 14.27 828.97 -7.40 902.87 35.00 955.00
+C 45.51 965.18 56.26 975.41 68.00 983.00
+C 68.00 983.00 68.57 982.83 69.00 983.00
+C 77.85 988.23 88.00 991.10 97.00 995.00
+C 105.34 997.59 113.93 999.28 123.00 999.00
+C 381.25 998.34 640.16 1000.33 898.00 998.00
+C 917.87 994.87 936.25 987.24 953.00 976.00
+C 961.89 967.94 970.70 958.59 979.00 950.00
+C 990.73 934.49 997.20 915.93 1000.00 897.00
+C 1001.66 634.92 1001.67 371.08 1000.00 109.00
+C 998.47 88.32 987.75 70.16 977.00 53.00
+C 968.92 44.28 959.99 35.47 951.00 28.00
+C 933.31 16.27 912.65 7.48 893.00 7.00
+M 515.00 304.00 
+C 539.00 304.00 563.00 304.00 587.00 304.00 C 615.29 302.32 605.38 337.85 607.00 356.00 C 607.00 452.00 607.00 548.00 607.00 644.00 C 605.19 661.97 615.63 698.38 587.00 696.00 C 563.00 696.00 539.00 696.00 515.00 696.00
+C 515.00 728.00 515.00 760.00 515.00 792.00 C 512.34 804.03 522.39 828.07 505.00 830.00 C 487.59 827.79 497.67 804.11 495.00 792.00 C 495.00 760.00 495.00 728.00 495.00 696.00
+C 471.33 696.00 447.67 696.00 424.00 696.00 C 394.53 699.12 406.18 662.06 404.00 644.00 C 404.00 548.33 404.00 452.67 404.00 357.00 C 406.52 338.80 394.21 302.66 423.00 304.00 C 447.00 304.00 471.00 304.00 495.00 304.00
+C 495.00 272.00 495.00 240.00 495.00 208.00 C 497.32 195.66 488.16 173.46 505.01 170.01 C 521.85 173.62 512.68 195.59 515.00 208.00 C 515.00 240.00 515.00 272.00 515.00 304.00 Z"/>
+</g>
+<g fill="#87A188" fill-opacity="0.91" stroke="None">
+<path d="
+M 977.00 53.00 
+C 969.82 43.54 960.90 34.53 951.00 28.00
+C 959.99 35.47 968.92 44.28 977.00 53.00 Z"/>
+</g>
+<g fill="#87A188" fill-opacity="1.00" stroke="None">
+<path d="
+M 1000.00 897.00 
+C 1004.61 833.14 1000.71 766.09 1002.00 701.00 C 1002.00 569.00 1002.00 437.00 1002.00 305.00 C 1000.71 239.89 1004.61 172.94 1000.00 109.00
+C 1001.67 371.08 1001.66 634.92 1000.00 897.00 Z"/>
+</g>
+<g fill="#87A188" fill-opacity="1.00" stroke="None">
+<path d="
+M 515.00 304.00 
+C 515.00 272.00 515.00 240.00 515.00 208.00 C 512.68 195.59 521.85 173.62 505.01 170.01 C 488.16 173.46 497.32 195.66 495.00 208.00 C 495.00 240.00 495.00 272.00 495.00 304.00
+C 471.00 304.00 447.00 304.00 423.00 304.00 C 394.21 302.66 406.52 338.80 404.00 357.00 C 404.00 452.67 404.00 548.33 404.00 644.00 C 406.18 662.06 394.53 699.12 424.00 696.00 C 447.67 696.00 471.33 696.00 495.00 696.00
+C 495.00 728.00 495.00 760.00 495.00 792.00 C 497.67 804.11 487.59 827.79 505.00 830.00 C 522.39 828.07 512.34 804.03 515.00 792.00 C 515.00 760.00 515.00 728.00 515.00 696.00
+C 539.00 696.00 563.00 696.00 587.00 696.00 C 615.63 698.38 605.19 661.97 607.00 644.00 C 607.00 548.00 607.00 452.00 607.00 356.00 C 605.38 337.85 615.29 302.32 587.00 304.00 C 563.00 304.00 539.00 304.00 515.00 304.00 Z"/>
+</g>
+<g fill="#87A188" fill-opacity="0.78" stroke="None">
+<path d="
+M 953.00 976.00 
+C 962.97 968.87 971.95 960.06 979.00 950.00
+C 970.70 958.59 961.89 967.94 953.00 976.00 Z"/>
+</g>
+<g fill="#87A188" fill-opacity="0.85" stroke="None">
+<path d="
+M 68.00 983.00 
+C 56.26 975.41 45.51 965.18 35.00 955.00
+C 44.68 965.81 55.21 976.65 68.00 983.00 Z"/>
+</g>
+<g fill="#87A188" fill-opacity="0.79" stroke="None">
+<path d="
+M 97.00 995.00 
+C 88.00 991.10 77.85 988.23 69.00 983.00
+C 76.80 989.30 87.29 992.63 97.00 995.00 Z"/>
+</g>
+<g fill="#87A188" fill-opacity="0.53" stroke="None">
+<path d="
+M 123.00 999.00 
+C 329.35 1001.34 537.83 999.33 745.00 1000.00 C 795.77 998.69 848.40 1002.63 898.00 998.00
+C 640.16 1000.33 381.25 998.34 123.00 999.00 Z"/>
+</g>
+</svg>

package/gui/web/dist/index.html

@@ -0,0 +1,17 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <meta name="theme-color" content="#FFFFFF" />
+    <title>OpenCandle</title>
+    <link rel="preconnect" href="https://fonts.googleapis.com" />
+    <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
+    <link href="https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700&family=JetBrains+Mono:wght@400;500&display=swap" rel="stylesheet" />
+    <script type="module" crossorigin src="/assets/index-RflHaj0y.js"></script>
+    <link rel="stylesheet" crossorigin href="/assets/index-DBrWq43L.css">
+  </head>
+  <body>
+    <div id="root"></div>
+  </body>
+</html>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencandle",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "Financial trading & investing agent",
   "license": "MIT",
   "homepage": "https://github.com/Kahtaf/OpenCandle#readme",
@@ -12,6 +12,9 @@
     "url": "https://github.com/Kahtaf/OpenCandle/issues"
   },
   "type": "module",
+  "workspaces": [
+    "gui/*"
+  ],
   "bin": {
     "opencandle": "dist/cli.js"
   },
@@ -35,6 +38,14 @@
     "./providers": {
       "types": "./dist/providers/index.d.ts",
       "import": "./dist/providers/index.js"
+    },
+    "./tools": {
+      "types": "./dist/tools/index.d.ts",
+      "import": "./dist/tools/index.js"
+    },
+    "./workflows": {
+      "types": "./dist/workflows/index.d.ts",
+      "import": "./dist/workflows/index.js"
     }
   },
   "pi": {
@@ -59,12 +70,24 @@
     "pi-package"
   ],
   "files": [
-    "dist"
+    "assets/logo.svg",
+    "dist",
+    "gui/server",
+    "gui/shared",
+    "gui/web/dist",
+    "src"
   ],
   "scripts": {
+    "check:node": "node scripts/check-node-version.mjs",
+    "prebuild": "npm run check:node",
     "build": "tsc && chmod +x dist/cli.js",
-    "prepare": "npm run build",
+    "prepare": "npm run build && npm run gui:web:build",
+    "prestart": "npm run check:node",
     "start": "tsx src/cli.ts",
+    "gui:web:build": "npm --workspace @opencandle/gui-web run build",
+    "gui": "tsx gui/server/server.ts",
+    "gui:dev": "tsx gui/server/server.ts",
+    "pretest": "npm run check:node",
     "test": "vitest run",
     "test:watch": "vitest",
     "test:e2e": "tsx tests/e2e/tools.test.ts",
@@ -73,8 +96,10 @@
     "test:e2e:credential-snooze": "tsx tests/e2e/credential-snooze.test.ts",
     "test:e2e:credential-soft-fallback": "tsx tests/e2e/credential-soft-fallback.test.ts",
     "test:e2e:credential-per-workflow-cap": "tsx tests/e2e/credential-per-workflow-cap.test.ts",
+    "test:gui:browser": "OPENCANDLE_GUI_BROWSER=1 vitest run --config vitest.config.gui.ts",
     "test:e2e:providers": "tsx tests/e2e/providers.test.ts",
     "test:evals": "vitest run --config vitest.config.evals.ts",
+    "eval:router-live": "tsx tests/scripts/run-live-router-eval.ts",
     "test:evals:usually": "EVAL_TIER=usually vitest run --config vitest.config.evals.ts",
     "version:patch": "npm version patch --no-git-tag-version",
     "version:minor": "npm version minor --no-git-tag-version",
@@ -87,31 +112,32 @@
     "release:major": "node scripts/release.mjs major"
   },
   "engines": {
-    "node": ">=20.0.0"
+    "node": "^20.19.0 || ^22.12.0 || >=24.0.0 <27"
   },
   "dependencies": {
+    "@earendil-works/pi-agent-core": "^0.74.0",
+    "@earendil-works/pi-ai": "^0.74.0",
+    "@earendil-works/pi-coding-agent": "^0.74.0",
     "@the-convocation/twitter-scraper": "^0.22.3",
-    "better-sqlite3": "^12.8.0",
-    "camoufox-js": "^0.9.3",
+    "better-sqlite3": "^12.10.0",
+    "camoufox-js": "^0.10.2",
     "duck-duck-scrape": "^2.2.7",
-    "playwright-core": "^1.58.2"
+    "playwright-core": "^1.60.0",
+    "tsx": "^4.22.0"
   },
   "peerDependencies": {
-    "@mariozechner/pi-agent-core": "*",
-    "@mariozechner/pi-ai": "*",
-    "@mariozechner/pi-coding-agent": "*",
     "@sinclair/typebox": "*"
   },
   "devDependencies": {
-    "@mariozechner/pi-agent-core": "^0.65.0",
-    "@mariozechner/pi-ai": "^0.65.0",
-    "@mariozechner/pi-coding-agent": "^0.65.0",
+    "@mariozechner/pi-agent-core": "^0.73.1",
+    "@mariozechner/pi-ai": "^0.73.1",
+    "@mariozechner/pi-coding-agent": "^0.73.1",
     "@sinclair/typebox": "^0.34.0",
     "@types/better-sqlite3": "^7.6.13",
-    "@types/node": "^22.0.0",
-    "tsx": "^4.19.0",
-    "typescript": "^5.7.0",
-    "vitest": "^3.0.0",
-    "vitest-evals": "^0.7.0"
+    "@types/node": "^22.19.19",
+    "typescript": "^6.0.3",
+    "vite": "^8.0.11",
+    "vitest": "^4.1.6",
+    "vitest-evals": "^0.8.0"
   }
 }

package/src/analysts/contracts.ts

@@ -0,0 +1,189 @@
+import type { AnalystOutput, AnalystSignal, DebateSide, DebateOutput } from "../runtime/workflow-types.js";
+import type { EvidenceRecord } from "../runtime/evidence.js";
+
+/** All analyst roles. */
+export type AnalystRole =
+  | "valuation"
+  | "momentum"
+  | "options"
+  | "contrarian"
+  | "risk";
+
+/** Evidence fields expected per analyst role. */
+export const ROLE_EXPECTED_EVIDENCE: Record<AnalystRole, string[]> = {
+  valuation: ["P/E Ratio", "Forward P/E", "EPS", "Intrinsic Value", "Revenue Growth"],
+  momentum: ["RSI", "MACD", "SMA 50", "SMA 200", "Volume Trend"],
+  options: ["Put/Call Ratio", "IV Level", "Unusual Volume", "Max Pain"],
+  contrarian: ["Fear & Greed Index", "Reddit Sentiment", "Sentiment Score"],
+  risk: ["Annualized Volatility", "Sharpe Ratio", "Max Drawdown", "VaR 95%", "Position Size"],
+};
+
+/**
+ * Parse an LLM response into a structured AnalystOutput.
+ * Falls back to raw text if parsing fails.
+ */
+export function parseAnalystOutput(
+  role: string,
+  responseText: string,
+): AnalystOutput {
+  const signal = extractSignal(responseText);
+  const conviction = extractConviction(responseText);
+  const thesis = extractThesis(responseText);
+
+  return {
+    role,
+    signal: signal ?? "HOLD",
+    conviction: conviction ?? 5,
+    thesis: thesis ?? "",
+    evidence: [],
+    rawText: responseText,
+  };
+}
+
+function extractSignal(text: string): AnalystSignal | null {
+  const match = text.match(/SIGNAL:\s*(BUY|HOLD|SELL)/i);
+  if (match) return match[1].toUpperCase() as AnalystSignal;
+  return null;
+}
+
+function extractConviction(text: string): number | null {
+  const match = text.match(/CONVICTION:\s*(\d+)/i);
+  if (match) {
+    const value = parseInt(match[1], 10);
+    if (value >= 1 && value <= 10) return value;
+  }
+  return null;
+}
+
+function extractThesis(text: string): string | null {
+  const match = text.match(/THESIS:\s*(.+)/i);
+  return match ? match[1].trim() : null;
+}
+
+/** Build a structured vote tally from analyst outputs. */
+export function tallyVotes(outputs: AnalystOutput[]): {
+  buy: number;
+  hold: number;
+  sell: number;
+  weightedConviction: number;
+  verdict: AnalystSignal;
+} {
+  let buy = 0;
+  let hold = 0;
+  let sell = 0;
+  let totalWeight = 0;
+  let weightedSum = 0;
+
+  for (const output of outputs) {
+    switch (output.signal) {
+      case "BUY":
+        buy++;
+        break;
+      case "HOLD":
+        hold++;
+        break;
+      case "SELL":
+        sell++;
+        break;
+    }
+    totalWeight += output.conviction;
+    const signalValue = output.signal === "BUY" ? 1 : output.signal === "SELL" ? -1 : 0;
+    weightedSum += signalValue * output.conviction;
+  }
+
+  const weightedConviction = totalWeight > 0
+    ? Math.round((totalWeight / outputs.length) * 10) / 10
+    : 0;
+
+  let verdict: AnalystSignal;
+  if (weightedSum > 0) verdict = "BUY";
+  else if (weightedSum < 0) verdict = "SELL";
+  else verdict = "HOLD";
+
+  return { buy, hold, sell, weightedConviction, verdict };
+}
+
+/**
+ * Parse an LLM debate response into a structured DebateOutput.
+ * Eval/test helper only — not used in the live workflow path.
+ */
+export function parseDebateOutput(side: DebateSide, responseText: string): DebateOutput {
+  // Detect skipped rebuttal
+  if (/^rebuttal skipped/i.test(responseText.trim())) {
+    return {
+      side,
+      thesis: "",
+      keyRisk: "",
+      concessions: [],
+      remainingConviction: 0,
+      evidence: [],
+      rawText: responseText,
+    };
+  }
+
+  const thesis = extractDebateThesis(side, responseText);
+  const keyRisk = extractKeyRisk(side, responseText);
+  const concessions = extractConcessions(responseText);
+  const remainingConviction = extractRemainingConviction(responseText);
+
+  return {
+    side,
+    thesis,
+    keyRisk,
+    concessions,
+    remainingConviction,
+    evidence: [],
+    rawText: responseText,
+  };
+}
+
+function extractDebateThesis(side: DebateSide, text: string): string {
+  const label = side === "bull" ? "BULL THESIS" : "BEAR THESIS";
+  const match = text.match(new RegExp(`${label}:\\s*(.+)`, "i"));
+  return match ? match[1].trim() : "";
+}
+
+function extractKeyRisk(side: DebateSide, text: string): string {
+  if (side === "bear") {
+    const match = text.match(/WHAT WOULD CHANGE MY MIND:\s*(.+)/i);
+    return match ? match[1].trim() : "";
+  }
+  const match = text.match(/KEY RISK(?:\s+TO THIS THESIS)?:\s*(.+)/i);
+  return match ? match[1].trim() : "";
+}
+
+function extractConcessions(text: string): string[] {
+  const match = text.match(/CONCESSIONS:\s*([\s\S]*?)(?=REMAINING CONVICTION:|$)/i);
+  if (!match) return [];
+  return match[1]
+    .split("\n")
+    .map((line) => line.replace(/^[-*•]\s*/, "").trim())
+    .filter(Boolean);
+}
+
+function extractRemainingConviction(text: string): number {
+  const match = text.match(/REMAINING CONVICTION:\s*(\d+)/i);
+  if (match) {
+    const value = parseInt(match[1], 10);
+    if (value >= 1 && value <= 10) return value;
+  }
+  return 0;
+}
+
+/**
+ * Check whether analysts produced a BUY+SELL split.
+ * Eval/test helper only — not used in the live workflow path.
+ */
+export function isAnalystSplit(outputs: AnalystOutput[]): boolean {
+  const votes = tallyVotes(outputs);
+  return votes.buy > 0 && votes.sell > 0;
+}
+
+/** Collect all evidence from analyst outputs. */
+export function collectEvidence(outputs: AnalystOutput[]): EvidenceRecord[] {
+  const evidence: EvidenceRecord[] = [];
+  for (const output of outputs) {
+    evidence.push(...output.evidence);
+  }
+  return evidence;
+}