Skip to content

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.

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.js
index 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.js
index 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.js
index 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.js
index 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.js
index 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.js
index 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.js
index 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.js
index 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;
}
})