@timmeck/marketing-brain 0.2.0

package/src/cli/commands/status.ts

@@ -0,0 +1,73 @@
+import { Command } from 'commander';
+import fs from 'node:fs';
+import path from 'node:path';
+import { getDataDir } from '../../utils/paths.js';
+import { withIpc } from '../ipc-helper.js';
+import { c, icons, header, keyValue, divider } from '../colors.js';
+
+export function statusCommand(): Command {
+  return new Command('status')
+    .description('Show Marketing Brain daemon status')
+    .action(async () => {
+      const pidPath = path.join(getDataDir(), 'marketing-brain.pid');
+
+      if (!fs.existsSync(pidPath)) {
+        console.log(`${icons.megaphone}  Marketing Brain Daemon: ${c.red.bold('NOT RUNNING')}`);
+        return;
+      }
+
+      const pid = parseInt(fs.readFileSync(pidPath, 'utf8').trim(), 10);
+      let running = false;
+      try {
+        process.kill(pid, 0);
+        running = true;
+      } catch { /* not running */ }
+
+      if (!running) {
+        console.log(`${icons.megaphone}  Marketing Brain Daemon: ${c.red.bold('NOT RUNNING')} ${c.dim('(stale PID file)')}`);
+        return;
+      }
+
+      console.log(header('Marketing Brain Status', icons.megaphone));
+      console.log(`  ${c.green(`${icons.dot} RUNNING`)} ${c.dim(`(PID ${pid})`)}`);
+
+      // eslint-disable-next-line @typescript-eslint/no-explicit-any
+      await withIpc(async (client) => {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const summary: any = await client.request('analytics.summary', {});
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const network: any = await client.request('synapse.stats', {});
+
+        const dbPath = path.join(getDataDir(), 'marketing-brain.db');
+        let dbSize = '?';
+        try {
+          const stat = fs.statSync(dbPath);
+          dbSize = `${(stat.size / 1024 / 1024).toFixed(1)} MB`;
+        } catch { /* ignore */ }
+
+        console.log(keyValue('Database', `${dbPath} (${dbSize})`));
+        console.log();
+
+        console.log(`  ${icons.post}  ${c.purple.bold('Content')}`);
+        console.log(`     ${c.label('Posts:')}       ${c.value(summary.posts?.total ?? 0)} total`);
+        console.log(`     ${c.label('Campaigns:')}   ${c.value(summary.campaigns?.total ?? 0)}`);
+        console.log(`     ${c.label('Templates:')}   ${c.value(summary.templates?.total ?? 0)}`);
+        console.log();
+
+        console.log(`  ${icons.rule}  ${c.blue.bold('Learning')}`);
+        console.log(`     ${c.label('Strategies:')}  ${c.value(summary.strategies?.total ?? 0)}`);
+        console.log(`     ${c.label('Rules:')}       ${c.green(summary.rules?.active ?? 0)} active`);
+        console.log();
+
+        console.log(`  ${icons.synapse}  ${c.cyan.bold('Synapse Network')}`);
+        console.log(`     ${c.label('Synapses:')}    ${c.value(network.totalSynapses ?? 0)}`);
+        console.log(`     ${c.label('Avg weight:')}  ${c.value((network.avgWeight ?? 0).toFixed(2))}`);
+        console.log();
+
+        console.log(`  ${icons.insight}  ${c.orange.bold('Research')}`);
+        console.log(`     ${c.label('Insights:')}    ${c.value(summary.insights?.active ?? 0)} active`);
+
+        console.log(`\n${divider()}`);
+      });
+    });
+}

package/src/cli/commands/stop.ts

@@ -0,0 +1,33 @@
+import { Command } from 'commander';
+import fs from 'node:fs';
+import path from 'node:path';
+import { getDataDir } from '../../utils/paths.js';
+import { c, icons } from '../colors.js';
+
+export function stopCommand(): Command {
+  return new Command('stop')
+    .description('Stop the Marketing Brain daemon')
+    .action(() => {
+      const pidPath = path.join(getDataDir(), 'marketing-brain.pid');
+
+      if (!fs.existsSync(pidPath)) {
+        console.log(`${icons.megaphone}  ${c.dim('Marketing Brain daemon is not running (no PID file found).')}`);
+        return;
+      }
+
+      const pid = parseInt(fs.readFileSync(pidPath, 'utf8').trim(), 10);
+
+      try {
+        process.kill(pid, 'SIGTERM');
+        console.log(`${icons.megaphone}  ${c.success('Marketing Brain daemon stopped')} ${c.dim(`(PID: ${pid})`)}`);
+      } catch (err) {
+        if ((err as NodeJS.ErrnoException).code === 'ESRCH') {
+          console.log(`${icons.megaphone}  ${c.dim('Marketing Brain daemon was not running (stale PID file removed).')}`);
+        } else {
+          console.error(`${icons.error}  ${c.error(`Failed to stop daemon: ${err}`)}`);
+        }
+      }
+
+      try { fs.unlinkSync(pidPath); } catch { /* ignore */ }
+    });
+}

package/src/cli/commands/suggest.ts

@@ -0,0 +1,64 @@
+import { Command } from 'commander';
+import { withIpc } from '../ipc-helper.js';
+import { c, icons } from '../colors.js';
+
+export function suggestCommand(): Command {
+  return new Command('suggest')
+    .description('Get content suggestions for a topic')
+    .argument('<topic>', 'Topic to get suggestions for')
+    .option('-p, --platform <platform>', 'Target platform')
+    .action(async (topic, opts) => {
+      await withIpc(async (client) => {
+        // Get matching strategies
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const strategies: any[] = await client.request('strategy.suggest', { query: topic, limit: 3 }) as any[];
+
+        // Get matching templates
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const templates: any[] = (opts.platform
+          ? await client.request('template.byPlatform', { platform: opts.platform, limit: 3 })
+          : await client.request('template.find', { query: topic, limit: 3 })) as any[];
+
+        // Check rules
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const ruleCheck: any = await client.request('rule.check', {
+          content: topic,
+          platform: opts.platform ?? 'any',
+        });
+
+        console.log(`  ${icons.insight}  ${c.heading(`Suggestions for: ${topic}`)}`);
+        console.log();
+
+        if (strategies.length > 0) {
+          console.log(`  ${c.blue.bold('Strategies:')}`);
+          for (const s of strategies) {
+            console.log(`     ${icons.arrow} ${s.description} ${c.dim(`(${(s.confidence * 100).toFixed(0)}% confidence)`)}`);
+          }
+          console.log();
+        }
+
+        if (templates.length > 0) {
+          console.log(`  ${c.purple.bold('Templates:')}`);
+          for (const t of templates) {
+            console.log(`     ${icons.arrow} ${t.name} ${c.dim(`(${t.platform ?? 'any'}, used ${t.use_count}x)`)}`);
+          }
+          console.log();
+        }
+
+        if (ruleCheck.recommendations?.length > 0) {
+          console.log(`  ${c.orange.bold('Rules to consider:')}`);
+          for (const r of ruleCheck.recommendations) {
+            console.log(`     ${icons.arrow} ${r.suggestion}`);
+          }
+          console.log();
+        }
+
+        if (ruleCheck.violations?.length > 0) {
+          console.log(`  ${c.red.bold('Warnings:')}`);
+          for (const v of ruleCheck.violations) {
+            console.log(`     ${icons.warn} ${v.reason}`);
+          }
+        }
+      });
+    });
+}

package/src/cli/ipc-helper.ts

@@ -0,0 +1,22 @@
+import { IpcClient } from '../ipc/client.js';
+import { getPipeName } from '../utils/paths.js';
+import { c, icons } from './colors.js';
+
+export async function withIpc<T>(fn: (client: IpcClient) => Promise<T>): Promise<T> {
+  const client = new IpcClient(getPipeName(), 5000);
+  try {
+    await client.connect();
+    return await fn(client);
+  } catch (err) {
+    if (err instanceof Error && err.message.includes('ENOENT')) {
+      console.error(`${icons.error}  ${c.error('Marketing Brain daemon is not running.')} Start it with: ${c.cyan('marketing start')}`);
+    } else if (err instanceof Error && err.message.includes('ECONNREFUSED')) {
+      console.error(`${icons.error}  ${c.error('Marketing Brain daemon is not responding.')} Try: ${c.cyan('marketing stop && marketing start')}`);
+    } else {
+      console.error(`${icons.error}  ${c.error(err instanceof Error ? err.message : String(err))}`);
+    }
+    process.exit(1);
+  } finally {
+    client.disconnect();
+  }
+}

package/src/cli/update-check.ts

@@ -0,0 +1,63 @@
+import https from 'node:https';
+import { c, icons } from './colors.js';
+
+// Read current version from package.json at build time
+import { createRequire } from 'node:module';
+const require = createRequire(import.meta.url);
+const pkg = require('../../package.json');
+const CURRENT_VERSION: string = pkg.version;
+
+export function getCurrentVersion(): string {
+  return CURRENT_VERSION;
+}
+
+function fetchLatestVersion(): Promise<string | null> {
+  return new Promise((resolve) => {
+    const timeout = setTimeout(() => resolve(null), 3000);
+
+    const req = https.get(
+      'https://registry.npmjs.org/@timmeck/marketing-brain/latest',
+      { headers: { Accept: 'application/json' } },
+      (res) => {
+        let data = '';
+        res.on('data', (chunk) => { data += chunk; });
+        res.on('end', () => {
+          clearTimeout(timeout);
+          try {
+            const json = JSON.parse(data);
+            resolve(json.version ?? null);
+          } catch {
+            resolve(null);
+          }
+        });
+      },
+    );
+    req.on('error', () => {
+      clearTimeout(timeout);
+      resolve(null);
+    });
+  });
+}
+
+function isNewer(latest: string, current: string): boolean {
+  const l = latest.split('.').map(Number);
+  const cur = current.split('.').map(Number);
+  for (let i = 0; i < 3; i++) {
+    if ((l[i] ?? 0) > (cur[i] ?? 0)) return true;
+    if ((l[i] ?? 0) < (cur[i] ?? 0)) return false;
+  }
+  return false;
+}
+
+export async function checkForUpdate(): Promise<void> {
+  try {
+    const latest = await fetchLatestVersion();
+    if (latest && isNewer(latest, CURRENT_VERSION)) {
+      console.log();
+      console.log(`  ${icons.star}  ${c.orange.bold(`Update available: v${CURRENT_VERSION} → v${latest}`)}`);
+      console.log(`     Run: ${c.cyan('npm update -g @timmeck/marketing-brain')}`);
+    }
+  } catch {
+    // silently ignore — update check is best-effort
+  }
+}

package/src/config.ts

@@ -0,0 +1,110 @@
+import path from 'node:path';
+import fs from 'node:fs';
+import type { MarketingBrainConfig } from './types/config.types.js';
+import { getDataDir, getPipeName } from './utils/paths.js';
+
+const defaults: MarketingBrainConfig = {
+  dataDir: getDataDir(),
+  dbPath: path.join(getDataDir(), 'marketing-brain.db'),
+  ipc: {
+    pipeName: getPipeName(),
+    timeout: 5000,
+  },
+  api: {
+    port: 7780,
+    enabled: true,
+  },
+  mcpHttp: {
+    port: 7781,
+    enabled: true,
+  },
+  dashboard: {
+    port: 7782,
+    enabled: true,
+  },
+  learning: {
+    intervalMs: 900_000, // 15 min
+    minOccurrences: 3,
+    minConfidence: 0.60,
+    pruneThreshold: 0.20,
+    decayHalfLifeDays: 30,
+  },
+  matching: {
+    similarityThreshold: 0.8,
+    maxResults: 10,
+  },
+  synapses: {
+    initialWeight: 0.1,
+    learningRate: 0.15,
+    decayHalfLifeDays: 45,
+    pruneThreshold: 0.05,
+    decayAfterDays: 14,
+    maxDepth: 3,
+    minActivationWeight: 0.2,
+  },
+  research: {
+    intervalMs: 3_600_000, // 1 hour
+    initialDelayMs: 300_000, // 5 min
+    minDataPoints: 5,
+    trendWindowDays: 7,
+    insightExpiryDays: 30,
+  },
+  log: {
+    level: 'info',
+    file: path.join(getDataDir(), 'marketing-brain.log'),
+    maxSize: 10 * 1024 * 1024,
+    maxFiles: 3,
+  },
+  retention: {
+    postDays: 365,
+    strategyDays: 365,
+    insightDays: 30,
+  },
+};
+
+function applyEnvOverrides(config: MarketingBrainConfig): void {
+  if (process.env['MARKETING_BRAIN_DATA_DIR']) {
+    config.dataDir = process.env['MARKETING_BRAIN_DATA_DIR'];
+    config.dbPath = path.join(config.dataDir, 'marketing-brain.db');
+    config.log.file = path.join(config.dataDir, 'marketing-brain.log');
+  }
+  if (process.env['MARKETING_BRAIN_DB_PATH']) config.dbPath = process.env['MARKETING_BRAIN_DB_PATH'];
+  if (process.env['MARKETING_BRAIN_LOG_LEVEL']) config.log.level = process.env['MARKETING_BRAIN_LOG_LEVEL'];
+  if (process.env['MARKETING_BRAIN_PIPE_NAME']) config.ipc.pipeName = process.env['MARKETING_BRAIN_PIPE_NAME'];
+  if (process.env['MARKETING_BRAIN_API_PORT']) config.api.port = Number(process.env['MARKETING_BRAIN_API_PORT']);
+  if (process.env['MARKETING_BRAIN_API_KEY']) config.api.apiKey = process.env['MARKETING_BRAIN_API_KEY'];
+}
+
+function deepMerge(target: Record<string, unknown>, source: Record<string, unknown>): void {
+  for (const key of Object.keys(source)) {
+    const val = source[key];
+    if (val && typeof val === 'object' && !Array.isArray(val) && target[key] && typeof target[key] === 'object') {
+      deepMerge(target[key] as Record<string, unknown>, val as Record<string, unknown>);
+    } else if (val !== undefined) {
+      target[key] = val;
+    }
+  }
+}
+
+export function loadConfig(configPath?: string): MarketingBrainConfig {
+  const config = structuredClone(defaults);
+
+  if (configPath) {
+    const filePath = path.resolve(configPath);
+    if (fs.existsSync(filePath)) {
+      const raw = fs.readFileSync(filePath, 'utf-8');
+      const fileConfig = JSON.parse(raw) as Partial<MarketingBrainConfig>;
+      deepMerge(config as unknown as Record<string, unknown>, fileConfig as unknown as Record<string, unknown>);
+    }
+  } else {
+    const defaultConfigPath = path.join(getDataDir(), 'config.json');
+    if (fs.existsSync(defaultConfigPath)) {
+      const raw = fs.readFileSync(defaultConfigPath, 'utf-8');
+      const fileConfig = JSON.parse(raw) as Partial<MarketingBrainConfig>;
+      deepMerge(config as unknown as Record<string, unknown>, fileConfig as unknown as Record<string, unknown>);
+    }
+  }
+
+  applyEnvOverrides(config);
+  return config;
+}

package/src/dashboard/renderer.ts

@@ -0,0 +1,136 @@
+import type { AnalyticsService } from '../services/analytics.service.js';
+import type { InsightService } from '../services/insight.service.js';
+import type { RuleService } from '../services/rule.service.js';
+import type { SynapseService } from '../services/synapse.service.js';
+
+function escapeHtml(str: string): string {
+  return str.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;').replace(/"/g, '&quot;');
+}
+
+export interface DashboardServices {
+  analytics: AnalyticsService;
+  insight: InsightService;
+  rule: RuleService;
+  synapse: SynapseService;
+}
+
+export function renderDashboard(template: string, services: DashboardServices): string {
+  let html = template;
+
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  const summary: any = services.analytics.getSummary();
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  const dashData: any = services.analytics.getDashboardData();
+  const insights = services.insight.listActive(200);
+  const rules = services.rule.listRules();
+  const strongest = services.synapse.getStrongest(50);
+
+  const s = summary;
+
+  // Stats
+  html = html.replace('{{POSTS}}', String(s.posts?.total ?? 0));
+  html = html.replace('{{CAMPAIGNS}}', String(s.campaigns?.total ?? 0));
+  html = html.replace('{{STRATEGIES}}', String(s.strategies?.total ?? 0));
+  html = html.replace('{{RULES}}', String(s.rules?.total ?? 0));
+  html = html.replace('{{TEMPLATES}}', String(s.templates?.total ?? 0));
+  html = html.replace('{{SYNAPSES}}', String(s.network?.synapses ?? 0));
+
+  // Activity score
+  const activity = Math.min(100, Math.round(
+    ((s.posts?.total ?? 0) * 5 +
+     (s.campaigns?.total ?? 0) * 10 +
+     (s.strategies?.total ?? 0) * 3 +
+     (s.rules?.active ?? 0) * 15 +
+     (s.insights?.active ?? 0) * 5) / 2
+  ));
+  html = html.replace(/\{\{ACTIVITY\}\}/g, String(activity));
+
+  // Version
+  html = html.replace('{{VERSION}}', '0.1.0');
+
+  // Platform chart
+  const platforms = s.posts?.byPlatform ?? {};
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  const maxCount = Math.max(1, ...Object.values(platforms as Record<string, number>));
+  let platformHtml = '';
+  for (const [platform, count] of Object.entries(platforms as Record<string, number>)) {
+    const width = Math.round((count / maxCount) * 100);
+    const barClass = `${platform}-bar`;
+    platformHtml += `<div class="platform-row"><span class="platform-name">${escapeHtml(platform)}</span><div class="platform-bar-bg"><div class="platform-bar ${barClass}" data-width="${width}"></div></div><span class="platform-count">${count}</span></div>\n`;
+  }
+  if (!platformHtml) platformHtml = '<p class="empty">No posts tracked yet.</p>';
+  html = html.replace('{{PLATFORM_CHART}}', platformHtml);
+
+  // Top posts
+  const topPosts = dashData.topPerformers?.topPosts ?? [];
+  let postsHtml = '';
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  for (const post of topPosts.slice(0, 10) as any[]) {
+    const score = (post.likes ?? 0) + (post.comments ?? 0) * 3 + (post.shares ?? 0) * 5 + (post.clicks ?? 0) * 2;
+    const preview = escapeHtml((post.content ?? '').slice(0, 140));
+    postsHtml += `<div class="post-card ${post.platform}"><div class="post-meta"><span class="post-platform ${post.platform}">${escapeHtml(post.platform)}</span><strong>${escapeHtml(post.format ?? 'text')}</strong></div><p>${preview}</p><div class="post-engagement"><span>&#10084; ${post.likes ?? 0}</span><span>&#128172; ${post.comments ?? 0}</span><span>&#128257; ${post.shares ?? 0}</span><span>Score: ${score}</span></div></div>\n`;
+  }
+  if (!postsHtml) postsHtml = '<p class="empty">No posts with engagement data yet.</p>';
+  html = html.replace('{{TOP_POSTS}}', postsHtml);
+
+  // Rules
+  const rulesList = Array.isArray(rules) ? rules : [];
+  let rulesHtml = '';
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  for (const rule of rulesList as any[]) {
+    const conf = Math.round((rule.confidence ?? 0) * 100);
+    rulesHtml += `<div class="rule-card"><div class="rule-pattern">${escapeHtml(rule.pattern ?? '')}</div><div class="rule-recommendation">${escapeHtml(rule.recommendation ?? '')}</div><div class="rule-confidence"><span>Confidence:</span><div class="confidence-bar"><div class="confidence-fill" data-width="${conf}"></div></div><span>${conf}%</span></div></div>\n`;
+  }
+  if (!rulesHtml) rulesHtml = '<p class="empty">No rules learned yet. Post more content to discover patterns.</p>';
+  html = html.replace('{{RULES_LIST}}', rulesHtml);
+
+  // Insights by type
+  const allInsights = Array.isArray(insights) ? insights : [];
+  const insightsByType: Record<string, unknown[]> = {
+    trend: [], gap: [], synergy: [], template: [], optimization: [],
+  };
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  for (const ins of allInsights as any[]) {
+    const type = ins.type ?? 'optimization';
+    if (insightsByType[type]) insightsByType[type]!.push(ins);
+    else insightsByType.optimization!.push(ins);
+  }
+
+  const typeColors: Record<string, string> = {
+    trend: 'cyan', gap: 'orange', synergy: 'green', template: 'purple', optimization: 'blue',
+  };
+
+  const pluralMap: Record<string, string> = {
+    trend: 'TRENDS', gap: 'GAPS', synergy: 'SYNERGIES',
+    template: 'TEMPLATES', optimization: 'OPTIMIZATIONS',
+  };
+
+  for (const [type, items] of Object.entries(insightsByType)) {
+    const plural = pluralMap[type] ?? `${type.toUpperCase()}S`;
+    html = html.replace(`{{${plural}_COUNT}}`, String(items.length));
+
+    let insHtml = '';
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    for (const ins of items as any[]) {
+      const prio = ins.priority >= 70 ? 'high' : ins.priority >= 40 ? 'medium' : 'low';
+      insHtml += `<div class="insight-card ${typeColors[type] ?? 'blue'}"><div class="insight-header"><span class="prio prio-${prio}">${ins.priority ?? 0}</span><strong>${escapeHtml(ins.title ?? '')}</strong></div><p>${escapeHtml(ins.description ?? '')}</p></div>\n`;
+    }
+    if (!insHtml) insHtml = '<p class="empty">No insights in this category yet.</p>';
+
+    const placeholder = type === 'template' ? '{{TEMPLATES_INSIGHTS}}' : `{{${plural}}}`;
+    html = html.replace(placeholder, insHtml);
+  }
+
+  // Graph edges
+  const edges = Array.isArray(strongest) ? strongest : [];
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  const graphEdges = edges.map((e: any) => ({
+    s: `${e.source_type}:${e.source_id}`,
+    t: `${e.target_type}:${e.target_id}`,
+    type: e.synapse_type ?? 'related',
+    w: e.weight ?? 0.5,
+  }));
+  html = html.replace('{{GRAPH_EDGES}}', JSON.stringify(graphEdges));
+
+  return html;
+}

package/src/dashboard/server.ts

@@ -0,0 +1,140 @@
+import http from 'node:http';
+import { getEventBus } from '../utils/events.js';
+import { getLogger } from '../utils/logger.js';
+
+export interface DashboardServerOptions {
+  port: number;
+  getDashboardHtml: () => string;
+  getStats: () => unknown;
+}
+
+export class DashboardServer {
+  private server: http.Server | null = null;
+  private clients: Set<http.ServerResponse> = new Set();
+  private logger = getLogger();
+
+  constructor(private options: DashboardServerOptions) {}
+
+  start(): void {
+    const { port, getDashboardHtml, getStats } = this.options;
+    const bus = getEventBus();
+
+    this.server = http.createServer((req, res) => {
+      const url = new URL(req.url ?? '/', `http://localhost:${port}`);
+
+      // CORS
+      res.setHeader('Access-Control-Allow-Origin', '*');
+      res.setHeader('Access-Control-Allow-Methods', 'GET, OPTIONS');
+
+      if (req.method === 'OPTIONS') {
+        res.writeHead(204);
+        res.end();
+        return;
+      }
+
+      if (url.pathname === '/events') {
+        // SSE endpoint
+        res.writeHead(200, {
+          'Content-Type': 'text/event-stream',
+          'Cache-Control': 'no-cache',
+          'Connection': 'keep-alive',
+        });
+        res.write('data: {"type":"connected"}\n\n');
+
+        this.clients.add(res);
+        req.on('close', () => this.clients.delete(res));
+        return;
+      }
+
+      if (url.pathname === '/api/stats') {
+        const stats = getStats();
+        res.writeHead(200, { 'Content-Type': 'application/json' });
+        res.end(JSON.stringify(stats));
+        return;
+      }
+
+      if (url.pathname === '/' || url.pathname === '/dashboard') {
+        const html = getDashboardHtml();
+        // Inject SSE script into the dashboard
+        const sseScript = `
+<script>
+(function(){
+  const evtSource = new EventSource('/events');
+  evtSource.onmessage = function(e) {
+    try {
+      const data = JSON.parse(e.data);
+      if (data.type === 'stats_update') {
+        document.querySelectorAll('.stat-number').forEach(el => {
+          const key = el.parentElement?.querySelector('.stat-label')?.textContent?.toLowerCase();
+          if (key && data.stats[key] !== undefined) {
+            el.textContent = Number(data.stats[key]).toLocaleString();
+          }
+        });
+      }
+      if (data.type === 'event') {
+        const dot = document.querySelector('.activity-dot');
+        if (dot) { dot.style.background = '#ff5577'; setTimeout(() => dot.style.background = '', 500); }
+      }
+    } catch {}
+  };
+  evtSource.onerror = function() { setTimeout(() => location.reload(), 5000); };
+})();
+</script>`;
+        const liveHtml = html.replace('</body>', sseScript + '</body>');
+        res.writeHead(200, { 'Content-Type': 'text/html; charset=utf-8' });
+        res.end(liveHtml);
+        return;
+      }
+
+      res.writeHead(404, { 'Content-Type': 'text/plain' });
+      res.end('Not Found');
+    });
+
+    // Forward Marketing Brain events to SSE clients
+    const eventNames = [
+      'post:created', 'post:published', 'engagement:updated',
+      'strategy:reported', 'rule:learned', 'rule:triggered',
+      'template:created', 'campaign:created',
+      'insight:created', 'synapse:created', 'synapse:strengthened',
+    ] as const;
+
+    for (const eventName of eventNames) {
+      bus.on(eventName, (data: unknown) => {
+        this.broadcast({ type: 'event', event: eventName, data });
+      });
+    }
+
+    // Periodic stats broadcast (every 30s)
+    setInterval(() => {
+      if (this.clients.size > 0) {
+        const stats = getStats();
+        this.broadcast({ type: 'stats_update', stats });
+      }
+    }, 30_000);
+
+    this.server.listen(port, () => {
+      this.logger.info(`Dashboard server started on http://localhost:${port}`);
+    });
+  }
+
+  stop(): void {
+    for (const client of this.clients) {
+      client.end();
+    }
+    this.clients.clear();
+    this.server?.close();
+    this.server = null;
+    this.logger.info('Dashboard server stopped');
+  }
+
+  private broadcast(data: unknown): void {
+    const msg = `data: ${JSON.stringify(data)}\n\n`;
+    for (const client of this.clients) {
+      try {
+        client.write(msg);
+      } catch {
+        this.clients.delete(client);
+      }
+    }
+  }
+}

package/src/db/connection.ts

@@ -0,0 +1,22 @@
+import Database from 'better-sqlite3';
+import fs from 'node:fs';
+import path from 'node:path';
+import { getLogger } from '../utils/logger.js';
+
+export function createConnection(dbPath: string): Database.Database {
+  const logger = getLogger();
+  const dir = path.dirname(dbPath);
+  if (!fs.existsSync(dir)) {
+    fs.mkdirSync(dir, { recursive: true });
+  }
+
+  logger.info(`Opening database at ${dbPath}`);
+  const db = new Database(dbPath);
+
+  db.pragma('journal_mode = WAL');
+  db.pragma('synchronous = NORMAL');
+  db.pragma('cache_size = 10000');
+  db.pragma('foreign_keys = ON');
+
+  return db;
+}