phase-6: typescript introduction

server/analyst/LLMAnalyst.ts

@@ -0,0 +1,73 @@
+import Anthropic from '@anthropic-ai/sdk';
+import type { Logger, LLMAnalysis } from '../types.js';
+
+interface Story {
+  title: string;
+  publisher?: string;
+}
+
+const SYSTEM_PROMPT = `You are a professional equity analyst. You will be given a list of today's market news headlines and the tickers already identified as catalysts.
+
+Your job is to:
+1. Write a 2-3 sentence market summary capturing the dominant theme
+2. Identify up to 4 industries that are likely to be secondarily affected (not directly mentioned but impacted by contagion, supply chain, regulation, or macro effects)
+3. Suggest up to 5 related ticker symbols worth screening that are NOT already in the provided list
+4. Assess overall market sentiment as BULLISH, NEUTRAL, or BEARISH based on the news
+
+Return ONLY valid JSON in this exact shape — no markdown, no explanation:
+{
+  "summary": "string",
+  "sentiment": "BULLISH" | "NEUTRAL" | "BEARISH",
+  "affectedIndustries": [
+    { "name": "string", "reason": "string (one sentence)" }
+  ],
+  "relatedTickers": [
+    { "ticker": "string", "reason": "string (one sentence)" }
+  ]
+}`;
+
+export class LLMAnalyst {
+  private logger: Pick<Logger, 'log' | 'warn'>;
+  private client: Anthropic | null;
+
+  constructor({ logger }: { logger?: Pick<Logger, 'log' | 'warn'> } = {}) {
+    this.logger = logger ?? { log: console.log, warn: console.warn };
+    this.client = process.env.ANTHROPIC_API_KEY
+      ? new Anthropic({ apiKey: process.env.ANTHROPIC_API_KEY })
+      : null;
+  }
+
+  async analyze(stories: Story[], existingTickers: string[] = []): Promise<LLMAnalysis | null> {
+    if (!this.client) {
+      this.logger.warn('LLMAnalyst: ANTHROPIC_API_KEY not set — skipping analysis');
+      return null;
+    }
+    if (!stories?.length) return null;
+
+    const headlines = stories
+      .slice(0, 15)
+      .map((s, i) => `${i + 1}. ${s.title} (${s.publisher ?? 'unknown'})`)
+      .join('\n');
+
+    const userMessage = `Today's market news headlines:\n\n${headlines}\n\nAlready identified catalyst tickers: ${existingTickers.join(', ') || 'none'}`;
+
+    try {
+      const response = await this.client.messages.create({
+        model: 'claude-haiku-4-5',
+        max_tokens: 1024,
+        system: SYSTEM_PROMPT,
+        messages: [{ role: 'user', content: userMessage }],
+      });
+
+      const raw = (response.content[0] as { text?: string })?.text ?? '';
+      const cleaned = raw
+        .replace(/^```(?:json)?\s*/i, '')
+        .replace(/```\s*$/i, '')
+        .trim();
+      return JSON.parse(cleaned) as LLMAnalysis;
+    } catch (err) {
+      this.logger.warn('LLMAnalyst: analysis failed —', (err as Error).message);
+      return null;
+    }
+  }
+}