Open-source agentic AI Search Execution Platform. Track AI visibility, find opportunities, and let agents turn signals into prioritized actions and drafted fixes across ChatGPT, Claude, Gemini, Google AI Overviews, Google AI Mode, Perplexity, Grok, and Microsoft Copilot.
TypeScript aeoai-agentai-searchanswer-engine-optimizationbrand-monitoringchatgptclaudecopilotdockergeminigeogoogle-ai-overviewsgrokmcpnextjsopen-sourceperplexityseosupabasetypescript
chore(server): structured logging Phase 2 — lib/config module-level logger (part 1) (#330)
Gökhan Geyikd244a7f38b8c
diff --git a/server/src/config/supabase.js b/server/src/config/supabase.jsindex 2641e2a49..c5b84763e 100644--- a/server/src/config/supabase.js+++ b/server/src/config/supabase.js@@ -1,12 +1,13 @@import 'dotenv/config';import { createClient } from '@supabase/supabase-js';+import { logger } from '../lib/logger.js';const supabaseUrl = process.env.SUPABASE_URL;const supabaseServiceRoleKey = process.env.SUPABASE_SERVICE_ROLE_KEY;const supabaseAnonKey = process.env.SUPABASE_ANON_KEY;if (!supabaseUrl || !supabaseServiceRoleKey) {- console.error('Missing SUPABASE_URL or SUPABASE_SERVICE_ROLE_KEY environment variables');+ logger.fatal('Missing SUPABASE_URL or SUPABASE_SERVICE_ROLE_KEY environment variables');process.exit(1);}diff --git a/server/src/lib/audit/llm-signals.js b/server/src/lib/audit/llm-signals.jsindex 46490085a..3531d21c9 100644--- a/server/src/lib/audit/llm-signals.js+++ b/server/src/lib/audit/llm-signals.js@@ -15,6 +15,7 @@ import { z } from 'zod';import { resolveModel } from '../ai-provider.js';import { signalsByKey } from './rubric.js';import { withRetry } from './retry.js';+import { logger } from '../logger.js';const DEFAULT_MODEL = 'google/gemini-3-flash-preview';@@ -111,7 +112,7 @@ export async function evaluateLlmSignals(ctx) {};});} catch (err) {- console.error('[audit] LLM signals failed:', err.message, { model: modelString });+ logger.error({ err, model: modelString }, '[audit] LLM signals failed');// Degrade gracefully — deterministic signals still score the page.return LLM_SIGNAL_KEYS.map((key) => ({key,diff --git a/server/src/lib/audit/recommendations.js b/server/src/lib/audit/recommendations.jsindex ae05e8976..1c7ad2054 100644--- a/server/src/lib/audit/recommendations.js+++ b/server/src/lib/audit/recommendations.js@@ -15,6 +15,7 @@ import { z } from 'zod';import { resolveModel } from '../ai-provider.js';import { signalsByKey } from './rubric.js';import { withRetry } from './retry.js';+import { logger } from '../logger.js';const DEFAULT_MODEL = 'google/gemini-3-flash-preview';@@ -149,7 +150,7 @@ Return prioritized, page-specific recommendations.`,draft: r.draft || null,}));} catch (err) {- console.error('[audit] recommendations failed:', err.message, { model: modelString });+ logger.error({ err, model: modelString }, '[audit] recommendations failed');return [];}}diff --git a/server/src/lib/audit/retry.js b/server/src/lib/audit/retry.jsindex 1d9e382d7..007a9973d 100644--- a/server/src/lib/audit/retry.js+++ b/server/src/lib/audit/retry.js@@ -11,6 +11,8 @@* @param {{ attempts?: number, baseDelayMs?: number, label?: string }} [opts]* @returns {Promise<T>}*/+import { logger } from '../logger.js';+export async function withRetry(fn, { attempts = 3, baseDelayMs = 500, label = 'llm' } = {}) {let lastErr;for (let i = 0; i < attempts; i += 1) {@@ -20,8 +22,9 @@ export async function withRetry(fn, { attempts = 3, baseDelayMs = 500, label = 'lastErr = err;if (i < attempts - 1) {const delay = baseDelayMs * 2 ** i;- console.warn(- `[audit] ${label} attempt ${i + 1}/${attempts} failed: ${err.message}; retrying in ${delay}ms`,+ logger.warn(+ { label, attempt: i + 1, attempts, delayMs: delay, err: err.message },+ `[audit] ${label} attempt ${i + 1}/${attempts} failed; retrying`,);await new Promise((resolve) => setTimeout(resolve, delay));}diff --git a/server/src/lib/cloro-result-handler.js b/server/src/lib/cloro-result-handler.jsindex dc9c30cf2..5eceedb43 100644--- a/server/src/lib/cloro-result-handler.js+++ b/server/src/lib/cloro-result-handler.js@@ -17,6 +17,7 @@ import supabaseAdmin from '../config/supabase.js';import { analyzeSentimentAI } from './ai-tracker.js';import { parseResponse, countBrandMentions } from './response-parser.js';import { normalizeShoppingCards, matchCardBrand } from './shopping-cards.js';+import { logger } from './logger.js';/*** @param {object} args@@ -69,7 +70,7 @@ export async function handleScraperResult({.single();if (error) {- console.error('[cloro-result] Failed to insert result:', error.message);+ logger.error({ err: error }, '[cloro-result] failed to insert result');throw error;}@@ -150,11 +151,10 @@ export async function persistShoppingCards({.upsert(rows, { onConflict: 'prompt_result_id,position', ignoreDuplicates: true });if (error) {- console.error('[cloro-result] Shopping card normalization failed:', error.message, {- promptResultId,- platform,- cardCount: rows.length,- });+ logger.error(+ { err: error, promptResultId, platform, cardCount: rows.length },+ '[cloro-result] shopping card normalization failed',+ );return 0;}diff --git a/server/src/lib/openai-tracker.js b/server/src/lib/openai-tracker.jsindex 5d19fde84..1e044d844 100644--- a/server/src/lib/openai-tracker.js+++ b/server/src/lib/openai-tracker.js@@ -4,6 +4,7 @@*/import OpenAI from 'openai';+import { logger } from './logger.js';const DEFAULT_MODEL = 'gpt-5-chat-latest';@@ -104,7 +105,7 @@ export async function analyzeSentimentAI(responseText, brandName) {return { sentiment, confidence, reason: json.reason || '' };} catch (err) {- console.error('[sentiment-ai] Failed, falling back to neutral:', err.message);+ logger.error({ err }, '[sentiment-ai] failed, falling back to neutral');return { sentiment: 'neutral', confidence: 0, reason: 'Analysis failed' };}}diff --git a/server/src/lib/opportunity-generator.js b/server/src/lib/opportunity-generator.jsindex 86341aa13..a3239396b 100644--- a/server/src/lib/opportunity-generator.js+++ b/server/src/lib/opportunity-generator.js@@ -7,6 +7,7 @@ import { generateObject } from 'ai';import { z } from 'zod';import { resolveModel } from './ai-provider.js';import supabaseAdmin from '../config/supabase.js';+import { logger } from './logger.js';const opportunitySchema = z.object({opportunities: z@@ -50,7 +51,7 @@ function computeScore(volume, visibility, competitorGap, intent) {}export async function generateContentOpportunities(brandId) {- console.log(`[opportunities] Generating for brand ${brandId}`);+ logger.info({ brandId }, '[opportunities] generating');const { data: brand } = await supabaseAdmin.from('brands')@@ -205,7 +206,8 @@ Generate actionable content opportunities.`;}));if (rows.length > 0) await supabaseAdmin.from('content_opportunities').insert(rows);- console.log(- `[opportunities] Generated ${rows.length} new opportunities for brand ${brandId} (${(existing || []).length} already pending)`,+ logger.info(+ { brandId, generated: rows.length, alreadyPending: (existing || []).length },+ '[opportunities] generated new opportunities',);}diff --git a/server/src/lib/shopping-cards.js b/server/src/lib/shopping-cards.jsindex bb474e73a..d49b59830 100644--- a/server/src/lib/shopping-cards.js+++ b/server/src/lib/shopping-cards.js@@ -22,6 +22,7 @@*/import { URL } from 'node:url';+import { logger } from './logger.js';// Loose set of currency codes Perplexity / Copilot embed in price strings// like "$29.99", "EUR 19,90", "₺499". Anything else falls back to null —@@ -332,7 +333,7 @@ export function normalizeShoppingCards(platform, cards) {return parser(card, i);} catch (err) {// A bad card shouldn't kill the whole batch — log and drop.- console.error('[shopping-cards] parser failed:', err.message, { platform, position: i });+ logger.error({ err, platform, position: i }, '[shopping-cards] parser failed');return null;}})