openads-ai 0.1.1 → 0.2.1

package/README.md

@@ -39,6 +39,16 @@ OpenAds is an **open-source CLI tool** that turns any AI model into a marketing
 
 ---
 
+## 📸 Screenshots
+
+Here is a look at OpenAds in action:
+
+<p align="center">
+  <img src="docs/images/screenshot.png" alt="OpenAds Welcome Screen" width="600" />
+</p>
+
+---
+
 ## ⚡ Quick Start
 
 ### 1. Install
@@ -108,6 +118,52 @@ Here are some real examples — just type what you need:
 
 ---
 
+## 🧠 Memory — Gets Smarter Every Session
+
+OpenAds remembers what it learns about your business. After each conversation, the AI appends key insights to a plain markdown file at `~/.openads/context/my-business.md`:
+
+- Your best-performing campaigns and creative angles
+- Audience segments and buying triggers
+- Budget constraints and seasonal patterns
+- Competitor insights and positioning gaps
+
+You can open and edit this file anytime — it's your data, not a black box. The longer you use OpenAds, the better its advice gets.
+
+---
+
+## ⏰ Scheduled Automations
+
+Set up automated campaign checks that run in the background — no server required.
+
+```bash
+openads schedule
+```
+
+| Preset | Frequency |
+|---|---|
+| 📊 Daily campaign health check | Every day at 8 AM |
+| 💸 Budget pacing alert | Every 6 hours |
+| 📉 Performance drop alert | Twice daily (9 AM & 5 PM) |
+| 📋 Weekly performance report | Every Monday at 9 AM |
+| ⏰ Custom (describe in plain English) | You choose |
+
+Reports are saved to `~/.openads/reports/` in both Markdown and premium HTML dashboard formats. You can view, list, and open your reports directly:
+
+```bash
+openads report            # List all generated reports
+openads report [name]     # Open a beautiful HTML dashboard in your browser
+```
+
+Manage your schedules:
+
+```bash
+openads schedule          # Open the schedule manager
+openads schedule list     # See active schedules
+openads schedule remove   # Remove a schedule
+```
+
+Uses your OS scheduler (macOS `launchd` / Linux `crontab`) — works even when your terminal is closed.
+
 ## 🔒 Security & Privacy
 
 - **Runs 100% locally.** OpenAds is not a cloud service. Nothing leaves your machine except the API calls you authorize.
@@ -136,9 +192,13 @@ This verifies your config file, API keys, platform connections (live token check
 - [x] Interactive setup wizard with live token verification
 - [x] 12 pre-built skills: Ads, CRO, Copywriting, Analytics, Email, Video, Research, Strategy
 - [x] Autonomous research loops
+- [x] Published to npm (`npm install -g openads-ai`)
+- [x] Memory system — AI learns about your business over time
+- [x] Scheduled automations — daily health checks, budget alerts, weekly reports
+- [ ] Telegram bot gateway — talk to your ads from your phone
 - [ ] LinkedIn Ads integration
-- [ ] Pinterest Ads integration
-- [ ] Publish to npm registry
+- [ ] TikTok Ads integration (leveraging their new [TikTok Ads MCP Server](https://digiday.com/media/tiktok-world-ads-mcp-server/))
+- [ ] Pinterest Ads integration (leveraging lessons/patterns from their [MCP Ecosystem](https://medium.com/pinterest-engineering/building-an-mcp-ecosystem-at-pinterest-c3b6b1b9e0f6))
 
 ---
 
@@ -162,4 +222,4 @@ Read [CONTRIBUTING.md](CONTRIBUTING.md) to get started.
 
 MIT.
 
-*Built on [Pi](https://github.com/earendil-works/pi) (MIT). Includes tools derived from [adloop](https://github.com/kLOsk/adloop) (MIT) by kLOsk. Marketing skills inspired by [marketingskills](https://github.com/coreyhaines31/marketingskills) (MIT) by Corey Haines.*
+*Built on [Pi](https://github.com/earendil-works/pi) (MIT). Includes tools derived from [adloop](https://github.com/kLOsk/adloop) (MIT) by kLOsk. Marketing skills inspired by [marketingskills](https://github.com/coreyhaines31/marketingskills) (MIT) by Corey Haines. Memory and background automation concepts inspired by [Hermes Agent](https://github.com/NousResearch/hermes-agent) by Nous Research.*

package/dist/cli.js

@@ -10,6 +10,7 @@ import gradient from 'gradient-string';
 import ora from 'ora';
 import { runSetup } from './setup.js';
 import { runDoctor } from './doctor.js';
+import { runScheduleManager, runScheduledTask, openReportInBrowser, listReports } from './schedule.js';
 import enquirer from 'enquirer';
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
@@ -44,9 +45,11 @@ function loadConfig() {
 function resolveModel(provider) {
     return DEPRECATED_MODELS[provider] || provider;
 }
-// ─── Product Context Injection ──────────────────────────────────────
-// Writes the user's product context as a skill file so the agent always
-// knows what the user sells, who their customer is, etc.
+// ─── Product Context & Memory ───────────────────────────────────────
+// The business context file grows over time. The agent appends learnings
+// (audience insights, campaign results, winning creative angles, etc.)
+// after each session. We only create the initial file if it doesn't exist
+// so accumulated knowledge is never overwritten.
 function injectProductContext(config) {
     if (!config?.productContext)
         return null;
@@ -55,7 +58,9 @@ function injectProductContext(config) {
         fs.mkdirSync(contextDir, { recursive: true });
     }
     const contextPath = path.join(contextDir, 'my-business.md');
-    const content = `---
+    // Only create the initial file — never overwrite accumulated learnings
+    if (!fs.existsSync(contextPath)) {
+        const content = `---
 name: my-business
 description: The user's business context — always read this first.
 ---
@@ -63,15 +68,19 @@ description: The user's business context — always read this first.
 
 ${config.productContext}
 
-Use this context to personalize all recommendations, ad copy, and strategy outputs.
-Always reference this when applying any marketing skill.
+## Learnings
+
+_The AI will automatically add insights here as it learns about your business._
+_You can also edit this file manually at: ${contextPath}_
 `;
-    fs.writeFileSync(contextPath, content);
+        fs.writeFileSync(contextPath, content);
+    }
     return contextDir;
 }
 // ─── System Prompt ──────────────────────────────────────────────────
 // Makes the agent behave as "OpenAds" instead of generic Pi.
 function buildSystemPrompt(config) {
+    const contextPath = path.join(CONFIG_DIR, 'context', 'my-business.md');
     const parts = [
         'You are OpenAds, an AI marketing assistant built for digital marketers.',
         'You specialize in Google Ads, Meta Ads, copywriting, analytics, CRO, and go-to-market strategy.',
@@ -79,6 +88,17 @@ function buildSystemPrompt(config) {
         'Address the user as a marketing professional.',
         'When writing ad copy or recommendations, always reference the user\'s product context first.',
         'For any write operation (creating campaigns, changing budgets), always preview the change and ask for explicit confirmation before executing.',
+        '',
+        '## Memory',
+        '',
+        `Your business context file is at: ${contextPath}`,
+        'This file contains everything you have learned about the user\'s business across sessions.',
+        'At the START of every conversation, read this file to recall past context.',
+        'At the END of a conversation (or when you learn something significant), APPEND new insights to the "## Learnings" section of that file.',
+        'Things worth remembering: product details, audience segments, campaign performance benchmarks, winning ad angles, competitor insights, budget constraints, seasonal patterns, and any preferences the user expresses.',
+        'Format each learning as a bullet point with a date, e.g.: "- (2026-05-24) Best-performing Meta creative uses customer testimonial videos."',
+        'Never overwrite existing learnings — only append new ones.',
+        'If the learnings section grows beyond 50 items, summarize the oldest 25 into a "## Summary" section at the top and remove the individual bullets.',
     ];
     if (config?.productContext) {
         parts.push(`\nThe user's business: ${config.productContext}`);
@@ -193,6 +213,26 @@ async function main() {
         await runDoctor();
         return;
     }
+    if (args[0] === 'schedule') {
+        await runScheduleManager(args[1]);
+        return;
+    }
+    if (args[0] === 'run-schedule') {
+        await runScheduledTask(args[1]);
+        return;
+    }
+    if (args[0] === 'report') {
+        if (args[1] === 'list') {
+            listReports();
+        }
+        else if (args[1]) {
+            await openReportInBrowser(args[1]);
+        }
+        else {
+            listReports();
+        }
+        return;
+    }
     // ─── First-Run Detection ────────────────────────────────────────
     const config = loadConfig();
     if (!config || !config.provider) {
@@ -241,6 +281,7 @@ async function main() {
                 { name: 'autoresearch', message: `${chalk.cyan('🔄')}  Test and improve ideas automatically ${chalk.gray('(autoresearch)')}` },
                 { name: 'gtm', message: `${chalk.cyan('📈')}  Build a go-to-market plan ${chalk.gray('(strategy)')}` },
                 { name: 'skills', message: `${chalk.cyan('📚')}  Browse available skills` },
+                { name: 'schedule', message: `${chalk.cyan('⏰')}  Schedule automations` },
                 { name: 'setup', message: `${chalk.gray('⚙️')}   Settings` },
                 { name: 'doctor', message: `${chalk.gray('🩺')}  Diagnostics` },
                 { name: 'exit', message: `${chalk.gray('❌')}  Exit` }
@@ -262,6 +303,10 @@ async function main() {
             showSkills();
             return;
         }
+        if (action === 'schedule') {
+            await runScheduleManager();
+            return;
+        }
         const actionMap = {
             chat: [],
             audit: ['audit-google-ads'],

package/dist/report-template.js

@@ -0,0 +1,628 @@
+/**
+ * Custom inline style parser that converts standard markdown styling
+ * (bold, italic, code, checkbox) and typical keywords into premium HTML components/badges.
+ */
+function parseInlineStyles(text) {
+    let res = text;
+    // Escape basic HTML characters to prevent breaking layout
+    res = res
+        .replace(/&/g, '&')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;');
+    // Bold (**text** or __text__)
+    res = res.replace(/\*\*(.*?)\*\*/g, '<strong>$1</strong>');
+    res = res.replace(/__(.*?)__/g, '<strong>$1</strong>');
+    // Italic (*text* or _text_)
+    res = res.replace(/\*(.*?)\*/g, '<em>$1</em>');
+    res = res.replace(/_(.*?)_/g, '<em>$1</em>');
+    // Inline code (`code`)
+    res = res.replace(/`(.*?)`/g, '<code class="inline-code">$1</code>');
+    // Keywords -> High-fidelity badges with strict bracket matching to avoid double replacements
+    res = res.replace(/\[(Alert|Warning|Caution|Anomaly|Drop|Spike)\]/gi, '<span class="badge badge-warning">$1</span>');
+    res = res.replace(/\[(Critical|Error|Failed|High Risk)\]/gi, '<span class="badge badge-danger">$1</span>');
+    res = res.replace(/\[(Success|On Track|Active|Passed|Resolved)\]/gi, '<span class="badge badge-success">$1</span>');
+    res = res.replace(/\[(Info|Daily|Weekly|Monthly|Report|Recommended|Notice)\]/gi, '<span class="badge badge-info">$1</span>');
+    return res;
+}
+/**
+ * Builds a beautifully styled HTML table from markdown table rows.
+ */
+function buildTableHtml(rows) {
+    if (rows.length < 2)
+        return '';
+    const headerRow = rows[0];
+    const dataRows = rows.slice(1).filter(r => !r.match(/^\|\s*[-|:\s]+\s*\|$/));
+    const parseRow = (row) => {
+        return row
+            .split('|')
+            .slice(1, -1)
+            .map(cell => cell.trim());
+    };
+    const headers = parseRow(headerRow);
+    const thead = `<thead><tr>${headers.map(h => `<th>${parseInlineStyles(h)}</th>`).join('')}</tr></thead>`;
+    const tbody = `<tbody>${dataRows.map(row => {
+        const cells = parseRow(row);
+        return `<tr>${cells.map(c => `<td>${parseInlineStyles(c)}</td>`).join('')}</tr>`;
+    }).join('')}</tbody>`;
+    return `<div class="table-container"><table>${thead}${tbody}</table></div>`;
+}
+/**
+ * Core Markdown-to-HTML parser optimized for OpenAds reports.
+ * Uses a robust line-by-line state machine for exact output representation.
+ */
+export function parseMarkdown(md) {
+    let html = md.replace(/\r\n/g, '\n');
+    // 1. Fenced code blocks
+    const codeBlocks = [];
+    html = html.replace(/```([\s\S]*?)```/g, (_, code) => {
+        const id = `___CODE_BLOCK_${codeBlocks.length}___`;
+        const escapedCode = code
+            .replace(/&/g, '&amp;')
+            .replace(/</g, '&lt;')
+            .replace(/>/g, '&gt;');
+        codeBlocks.push(`<pre class="code-block"><code>${escapedCode.trim()}</code></pre>`);
+        return id;
+    });
+    // 2. Identify tables
+    const tables = [];
+    const lines = html.split('\n');
+    const linesWithTables = [];
+    let inTable = false;
+    let tableRows = [];
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i].trim();
+        if (line.startsWith('|') && line.endsWith('|')) {
+            inTable = true;
+            tableRows.push(line);
+        }
+        else {
+            if (inTable) {
+                const tableHtml = buildTableHtml(tableRows);
+                const id = `___TABLE_${tables.length}___`;
+                tables.push(tableHtml);
+                linesWithTables.push(id);
+                tableRows = [];
+                inTable = false;
+            }
+            linesWithTables.push(lines[i]);
+        }
+    }
+    if (inTable && tableRows.length > 0) {
+        const tableHtml = buildTableHtml(tableRows);
+        const id = `___TABLE_${tables.length}___`;
+        tables.push(tableHtml);
+        linesWithTables.push(id);
+    }
+    // 3. Process line-by-line
+    const processedHtml = [];
+    let inList = false;
+    let isOrdered = false;
+    const closeListIfNeeded = () => {
+        if (inList) {
+            processedHtml.push(isOrdered ? '</ol>' : '</ul>');
+            inList = false;
+        }
+    };
+    for (let i = 0; i < linesWithTables.length; i++) {
+        const line = linesWithTables[i].trim();
+        if (!line) {
+            closeListIfNeeded();
+            continue;
+        }
+        // Fenced code blocks / table placeholders
+        if (line.startsWith('___CODE_BLOCK_') && line.endsWith('___')) {
+            closeListIfNeeded();
+            processedHtml.push(line);
+            continue;
+        }
+        if (line.startsWith('___TABLE_') && line.endsWith('___')) {
+            closeListIfNeeded();
+            processedHtml.push(line);
+            continue;
+        }
+        // Headings
+        if (line.startsWith('#')) {
+            closeListIfNeeded();
+            const match = line.match(/^(#{1,6})\s+(.*)$/);
+            if (match) {
+                const level = match[1].length;
+                const text = parseInlineStyles(match[2]);
+                if (level === 1) {
+                    processedHtml.push(`<h1>${text}</h1>`);
+                }
+                else if (level === 2) {
+                    processedHtml.push(`</section><section class="report-card"><h2>${text}</h2>`);
+                }
+                else {
+                    processedHtml.push(`<h${level}>${text}</h${level}>`);
+                }
+            }
+            continue;
+        }
+        // Horizontal rule / dividers
+        if (line === '---' || line === '***') {
+            closeListIfNeeded();
+            processedHtml.push('<hr class="report-divider">');
+            continue;
+        }
+        // Lists (unordered)
+        const ulMatch = line.match(/^[-*]\s+(.*)$/);
+        if (ulMatch) {
+            if (!inList || isOrdered) {
+                closeListIfNeeded();
+                processedHtml.push('<ul>');
+                inList = true;
+                isOrdered = false;
+            }
+            let content = ulMatch[1];
+            const hasChecked = content.startsWith('[x] ');
+            const hasUnchecked = content.startsWith('[ ] ');
+            if (hasChecked || hasUnchecked) {
+                content = content.slice(4);
+            }
+            // Parse inline styles on text only before wrapping in custom elements
+            content = parseInlineStyles(content);
+            if (hasChecked) {
+                content = `<span class="checkbox checked">✓</span> <span class="checkbox-text">${content}</span>`;
+            }
+            else if (hasUnchecked) {
+                content = `<span class="checkbox unchecked"></span> <span class="checkbox-text">${content}</span>`;
+            }
+            processedHtml.push(`<li>${content}</li>`);
+            continue;
+        }
+        // Lists (ordered)
+        const olMatch = line.match(/^(\d+)\.\s+(.*)$/);
+        if (olMatch) {
+            if (!inList || !isOrdered) {
+                closeListIfNeeded();
+                processedHtml.push('<ol>');
+                inList = true;
+                isOrdered = true;
+            }
+            let content = olMatch[2];
+            content = parseInlineStyles(content);
+            processedHtml.push(`<li>${content}</li>`);
+            continue;
+        }
+        // If it's a plain line, it is a paragraph
+        closeListIfNeeded();
+        processedHtml.push(`<p>${parseInlineStyles(line)}</p>`);
+    }
+    closeListIfNeeded();
+    let finalHtml = processedHtml.join('\n');
+    // Clean sections wrap
+    finalHtml = '<section class="report-card intro-card">\n' + finalHtml;
+    finalHtml += '\n</section>';
+    finalHtml = finalHtml.replace(/<section class="report-card intro-card">\s*<\/section>/g, '');
+    finalHtml = finalHtml.replace(/<section class="report-card">\s*<\/section>/g, '');
+    // 4. Restore placeholders
+    codeBlocks.forEach((code, idx) => {
+        finalHtml = finalHtml.replace(`___CODE_BLOCK_${idx}___`, code);
+    });
+    tables.forEach((table, idx) => {
+        finalHtml = finalHtml.replace(`___TABLE_${idx}___`, table);
+    });
+    return finalHtml;
+}
+/**
+ * Wraps parsed HTML body in a complete, premium styled HTML page template.
+ */
+export function compileHtmlReport(title, markdownContent) {
+    const parsedBody = parseMarkdown(markdownContent);
+    const formattedTitle = title.split('-').map(w => w.charAt(0).toUpperCase() + w.slice(1)).join(' ');
+    return `<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>OpenAds Report — ${formattedTitle}</title>
+  <!-- Modern Premium Typography -->
+  <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&family=Outfit:wght@500;600;700;800&display=swap" rel="stylesheet">
+  
+  <style>
+    /* ─── Premium Modern CSS variables ─────────────────────────────────── */
+    :root {
+      --bg-color: #0b0f19;
+      --card-bg: rgba(23, 28, 41, 0.6);
+      --card-border: rgba(255, 255, 255, 0.08);
+      --text-main: #a4b0be;
+      --text-bright: #ffffff;
+      --text-muted: #747d8c;
+      
+      /* Glowing Gradients */
+      --primary-gradient: linear-gradient(135deg, #00d2ff 0%, #3a7bd5 100%);
+      --accent-color: #00d2ff;
+      
+      /* Status Colors */
+      --color-success: #2ed573;
+      --bg-success: rgba(46, 213, 115, 0.15);
+      --color-warning: #ffa502;
+      --bg-warning: rgba(255, 165, 2, 0.15);
+      --color-danger: #ff4757;
+      --bg-danger: rgba(255, 71, 87, 0.15);
+      --color-info: #00d2ff;
+      --bg-info: rgba(0, 210, 255, 0.15);
+      
+      --shadow-premium: 0 12px 40px rgba(0, 0, 0, 0.5);
+      --transition-smooth: all 0.3s cubic-bezier(0.25, 0.8, 0.25, 1);
+    }
+
+    /* ─── Global Reset & Styling ────────────────────────────────────────── */
+    * {
+      box-sizing: border-box;
+      margin: 0;
+      padding: 0;
+    }
+    
+    body {
+      font-family: 'Inter', sans-serif;
+      background-color: var(--bg-color);
+      color: var(--text-main);
+      line-height: 1.6;
+      padding: 3rem 1.5rem;
+      min-height: 100vh;
+      background-image: 
+        radial-gradient(circle at 10% 20%, rgba(0, 210, 255, 0.04) 0%, transparent 40%),
+        radial-gradient(circle at 90% 80%, rgba(58, 123, 213, 0.04) 0%, transparent 40%);
+      background-attachment: fixed;
+    }
+
+    .container {
+      max-width: 900px;
+      margin: 0 auto;
+    }
+
+    /* ─── Premium Header ────────────────────────────────────────────────── */
+    header {
+      margin-bottom: 3.5rem;
+      text-align: center;
+      position: relative;
+    }
+
+    .logo-badge {
+      display: inline-flex;
+      align-items: center;
+      gap: 0.5rem;
+      background: rgba(255, 255, 255, 0.03);
+      border: 1px solid rgba(255, 255, 255, 0.05);
+      padding: 0.4rem 1rem;
+      border-radius: 100px;
+      font-family: 'Outfit', sans-serif;
+      font-size: 0.85rem;
+      letter-spacing: 1px;
+      text-transform: uppercase;
+      color: var(--accent-color);
+      margin-bottom: 1.5rem;
+      backdrop-filter: blur(10px);
+    }
+    
+    .logo-badge svg {
+      width: 14px;
+      height: 14px;
+      fill: currentColor;
+    }
+
+    header h1 {
+      font-family: 'Outfit', sans-serif;
+      font-weight: 800;
+      font-size: 2.8rem;
+      color: var(--text-bright);
+      line-height: 1.2;
+      background: var(--primary-gradient);
+      -webkit-background-clip: text;
+      -webkit-text-fill-color: transparent;
+      margin-bottom: 0.5rem;
+      letter-spacing: -0.5px;
+    }
+
+    header .report-subtitle {
+      font-size: 1.1rem;
+      color: var(--text-muted);
+      margin-bottom: 1.5rem;
+    }
+
+    /* ─── Premium Card Layout ───────────────────────────────────────────── */
+    .report-card {
+      background: var(--card-bg);
+      border: 1px solid var(--card-border);
+      border-radius: 20px;
+      padding: 2.5rem;
+      margin-bottom: 2.5rem;
+      box-shadow: var(--shadow-premium);
+      backdrop-filter: blur(12px);
+      transition: var(--transition-smooth);
+      position: relative;
+      overflow: hidden;
+    }
+    
+    .report-card:hover {
+      transform: translateY(-4px);
+      border-color: rgba(0, 210, 255, 0.2);
+      box-shadow: 0 16px 48px rgba(0, 210, 255, 0.08);
+    }
+    
+    .report-card::before {
+      content: '';
+      position: absolute;
+      top: 0;
+      left: 0;
+      width: 4px;
+      height: 100%;
+      background: var(--primary-gradient);
+    }
+
+    /* Card Typography */
+    .report-card h2 {
+      font-family: 'Outfit', sans-serif;
+      font-weight: 700;
+      font-size: 1.6rem;
+      color: var(--text-bright);
+      margin-bottom: 1.5rem;
+      display: flex;
+      align-items: center;
+      gap: 0.75rem;
+    }
+    
+    .report-card h3 {
+      font-family: 'Outfit', sans-serif;
+      font-weight: 600;
+      font-size: 1.25rem;
+      color: var(--text-bright);
+      margin: 1.5rem 0 1rem 0;
+    }
+
+    .report-card p {
+      margin-bottom: 1.2rem;
+      font-size: 1.05rem;
+      color: var(--text-main);
+    }
+    
+    .report-card p strong {
+      color: var(--text-bright);
+      font-weight: 600;
+    }
+
+    /* Divider */
+    .report-divider {
+      border: none;
+      height: 1px;
+      background: rgba(255, 255, 255, 0.06);
+      margin: 2rem 0;
+    }
+
+    /* ─── Lists & Checkboxes ────────────────────────────────────────────── */
+    .report-card ul, .report-card ol {
+      margin-bottom: 1.5rem;
+      padding-left: 0.5rem;
+    }
+
+    .report-card li {
+      margin-bottom: 0.8rem;
+      font-size: 1.05rem;
+      list-style: none;
+      display: flex;
+      align-items: flex-start;
+      gap: 0.75rem;
+    }
+    
+    .report-card ul li::before {
+      content: "•";
+      color: var(--accent-color);
+      font-weight: bold;
+      font-size: 1.2rem;
+      line-height: 1.4rem;
+      display: inline-block;
+      flex-shrink: 0;
+    }
+
+    .report-card ol {
+      list-style-type: decimal;
+      padding-left: 1.5rem;
+    }
+    
+    .report-card ol li {
+      display: list-item;
+      list-style-position: outside;
+    }
+
+    /* Styled Checkboxes */
+    .checkbox {
+      display: inline-flex;
+      align-items: center;
+      justify-content: center;
+      width: 18px;
+      height: 18px;
+      border-radius: 4px;
+      margin-top: 0.2rem;
+      flex-shrink: 0;
+    }
+    
+    .checkbox.checked {
+      background: var(--color-success);
+      color: #0b0f19;
+      font-size: 0.75rem;
+      font-weight: bold;
+    }
+    
+    .checkbox.unchecked {
+      border: 2px solid var(--text-muted);
+    }
+    
+    .checkbox-text {
+      flex: 1;
+    }
+
+    /* ─── Premium Tables ────────────────────────────────────────────────── */
+    .table-container {
+      width: 100%;
+      overflow-x: auto;
+      margin: 2rem 0;
+      border-radius: 12px;
+      border: 1px solid rgba(255, 255, 255, 0.05);
+      background: rgba(0, 0, 0, 0.15);
+    }
+
+    table {
+      width: 100%;
+      border-collapse: collapse;
+      text-align: left;
+      font-size: 0.95rem;
+    }
+
+    th {
+      font-family: 'Outfit', sans-serif;
+      font-weight: 600;
+      color: var(--text-bright);
+      background: rgba(255, 255, 255, 0.02);
+      padding: 1rem 1.25rem;
+      border-bottom: 1px solid rgba(255, 255, 255, 0.08);
+      font-size: 0.85rem;
+      text-transform: uppercase;
+      letter-spacing: 0.5px;
+    }
+
+    td {
+      padding: 1rem 1.25rem;
+      border-bottom: 1px solid rgba(255, 255, 255, 0.04);
+      color: var(--text-main);
+      vertical-align: middle;
+    }
+
+    tr:last-child td {
+      border-bottom: none;
+    }
+
+    tr:hover td {
+      background: rgba(255, 255, 255, 0.015);
+      color: var(--text-bright);
+    }
+
+    /* ─── High-Fidelity Badges ──────────────────────────────────────────── */
+    .badge {
+      display: inline-flex;
+      align-items: center;
+      padding: 0.25rem 0.65rem;
+      border-radius: 100px;
+      font-size: 0.75rem;
+      font-weight: 600;
+      letter-spacing: 0.3px;
+      text-transform: uppercase;
+      font-family: 'Outfit', sans-serif;
+    }
+
+    .badge-success {
+      background: var(--bg-success);
+      color: var(--color-success);
+      border: 1px solid rgba(46, 213, 115, 0.3);
+    }
+
+    .badge-warning {
+      background: var(--bg-warning);
+      color: var(--color-warning);
+      border: 1px solid rgba(255, 165, 2, 0.3);
+    }
+
+    .badge-danger {
+      background: var(--bg-danger);
+      color: var(--color-danger);
+      border: 1px solid rgba(255, 71, 87, 0.3);
+    }
+
+    .badge-info {
+      background: var(--bg-info);
+      color: var(--color-info);
+      border: 1px solid rgba(0, 210, 255, 0.3);
+    }
+
+    /* ─── Code Blocks ───────────────────────────────────────────────────── */
+    .code-block {
+      background: #060911;
+      border: 1px solid rgba(255, 255, 255, 0.05);
+      border-radius: 12px;
+      padding: 1.5rem;
+      margin: 1.5rem 0;
+      overflow-x: auto;
+    }
+
+    .code-block code {
+      font-family: 'Courier New', Courier, monospace;
+      color: #00d2ff;
+      font-size: 0.9rem;
+    }
+    
+    .inline-code {
+      font-family: 'Courier New', Courier, monospace;
+      background: rgba(255, 255, 255, 0.05);
+      color: var(--accent-color);
+      padding: 0.15rem 0.35rem;
+      border-radius: 4px;
+      font-size: 0.9em;
+    }
+
+    /* ─── Footer ────────────────────────────────────────────────────────── */
+    footer {
+      text-align: center;
+      margin-top: 5rem;
+      padding-top: 2rem;
+      border-top: 1px solid rgba(255, 255, 255, 0.05);
+      color: var(--text-muted);
+      font-size: 0.85rem;
+    }
+
+    footer a {
+      color: var(--accent-color);
+      text-decoration: none;
+      transition: var(--transition-smooth);
+    }
+    
+    footer a:hover {
+      text-decoration: underline;
+    }
+
+    /* ─── Responsive Adjustments ────────────────────────────────────────── */
+    @media (max-width: 768px) {
+      body {
+        padding: 2rem 1rem;
+      }
+      
+      header h1 {
+        font-size: 2.2rem;
+      }
+      
+      .report-card {
+        padding: 1.75rem;
+      }
+      
+      th, td {
+        padding: 0.75rem 1rem;
+      }
+    }
+  </style>
+</head>
+<body>
+  <div class="container">
+    <header>
+      <div class="logo-badge">
+        <svg viewBox="0 0 24 24">
+          <path d="M12 2C6.48 2 2 6.48 2 12s4.48 10 10 10 10-4.48 10-10S17.52 2 12 2zm1 15h-2v-6h2v6zm0-8h-2V7h2v2z"/>
+        </svg>
+        OpenAds AI
+      </div>
+      <h1>${formattedTitle}</h1>
+      <div class="report-subtitle">Autonomous Campaign Performance Report</div>
+    </header>
+
+    <main>
+      ${parsedBody}
+    </main>
+
+    <footer>
+      <p>Report compiled autonomously by <a href="https://github.com/lamorim-net/openads-ai" target="_blank">OpenAds AI Command Center</a>.</p>
+    </footer>
+  </div>
+</body>
+</html>`;
+}

package/dist/schedule.js

@@ -0,0 +1,511 @@
+import enquirer from 'enquirer';
+import chalk from 'chalk';
+import fs from 'fs';
+import path from 'path';
+import os from 'os';
+import { spawnSync } from 'child_process';
+import gradient from 'gradient-string';
+import open from 'open';
+import { compileHtmlReport } from './report-template.js';
+const openadsGradient = gradient(['#00d2ff', '#3a7bd5', '#00d2ff']);
+const CONFIG_DIR = path.join(os.homedir(), '.openads');
+const SCHEDULES_DIR = path.join(CONFIG_DIR, 'schedules');
+const REPORTS_DIR = path.join(CONFIG_DIR, 'reports');
+const PRESETS = [
+    {
+        name: 'daily-health',
+        label: '📊  Daily campaign health check',
+        prompt: 'Run a health check on all my connected ad campaigns. Flag any anomalies: budget pacing issues, sudden CPA spikes, quality score drops, disapproved ads, or campaigns that spent more than 20% above/below their daily budget. Give me a concise summary with action items.',
+        cron: '0 8 * * *',
+        description: 'Every day at 8:00 AM',
+    },
+    {
+        name: 'budget-pacing',
+        label: '💸  Budget pacing alert (every 6 hours)',
+        prompt: 'Check my ad campaign spend pacing against daily/monthly budgets. Flag any campaign that is on track to overspend by more than 15% or underspend by more than 25%. Include the current spend, projected spend, and budget for each flagged campaign.',
+        cron: '0 */6 * * *',
+        description: 'Every 6 hours',
+    },
+    {
+        name: 'performance-drop',
+        label: '📉  Performance drop alert (twice daily)',
+        prompt: 'Compare my ad campaign performance (ROAS, CPA, CTR, conversion rate) for the last 24 hours against the 7-day average. Flag any metric that shifted more than 15% in either direction. For each flag, suggest a possible cause and a recommended action.',
+        cron: '0 9,17 * * *',
+        description: 'At 9:00 AM and 5:00 PM',
+    },
+    {
+        name: 'weekly-report',
+        label: '📋  Weekly performance report (Monday 9am)',
+        prompt: 'Generate a comprehensive weekly performance report for all my connected ad campaigns. Include: total spend, ROAS, CPA, impressions, clicks, conversions, top 3 performing campaigns, bottom 3 performing campaigns, and 3 actionable recommendations for next week.',
+        cron: '0 9 * * 1',
+        description: 'Every Monday at 9:00 AM',
+    },
+];
+// ─── Platform Detection ──────────────────────────────────────────────
+function isMacOS() {
+    return os.platform() === 'darwin';
+}
+function ensureDirs() {
+    if (!fs.existsSync(SCHEDULES_DIR))
+        fs.mkdirSync(SCHEDULES_DIR, { recursive: true });
+    if (!fs.existsSync(REPORTS_DIR))
+        fs.mkdirSync(REPORTS_DIR, { recursive: true });
+}
+function loadSchedules() {
+    ensureDirs();
+    const indexPath = path.join(SCHEDULES_DIR, 'schedules.json');
+    if (!fs.existsSync(indexPath))
+        return [];
+    try {
+        return JSON.parse(fs.readFileSync(indexPath, 'utf8'));
+    }
+    catch {
+        return [];
+    }
+}
+function saveSchedules(schedules) {
+    ensureDirs();
+    fs.writeFileSync(path.join(SCHEDULES_DIR, 'schedules.json'), JSON.stringify(schedules, null, 2));
+}
+// ─── macOS launchd ───────────────────────────────────────────────────
+function cronToLaunchdCalendar(cron) {
+    const parts = cron.split(' ');
+    const [minute, hour, day, _month, weekday] = parts;
+    const cal = {};
+    if (minute !== '*') {
+        if (minute.startsWith('*/')) {
+            cal.Minute = parseInt(minute.slice(2));
+        }
+        else {
+            cal.Minute = parseInt(minute);
+        }
+    }
+    if (hour !== '*') {
+        if (hour.startsWith('*/')) {
+            // launchd doesn't support */N for hours directly, use Interval instead
+        }
+        else if (hour.includes(',')) {
+            // Multiple hours — return array of calendars
+            return hour.split(',').map((h) => ({
+                ...cal,
+                Hour: parseInt(h),
+                Minute: cal.Minute ?? 0,
+            }));
+        }
+        else {
+            cal.Hour = parseInt(hour);
+        }
+    }
+    if (day !== '*')
+        cal.Day = parseInt(day);
+    if (weekday !== '*')
+        cal.Weekday = parseInt(weekday);
+    return cal;
+}
+function installLaunchd(schedule, openadsPath) {
+    const label = `com.openads.schedule.${schedule.name}`;
+    const plistPath = path.join(os.homedir(), 'Library', 'LaunchAgents', `${label}.plist`);
+    const reportFile = path.join(REPORTS_DIR, `${schedule.name}-latest.md`);
+    const calendar = cronToLaunchdCalendar(schedule.cron);
+    const calendarEntries = Array.isArray(calendar) ? calendar : [calendar];
+    // Check if */N hour pattern — use StartInterval instead
+    const parts = schedule.cron.split(' ');
+    const hourPart = parts[1];
+    let useInterval = false;
+    let intervalSeconds = 0;
+    if (hourPart.startsWith('*/')) {
+        useInterval = true;
+        intervalSeconds = parseInt(hourPart.slice(2)) * 3600;
+    }
+    let schedulingXml;
+    if (useInterval) {
+        schedulingXml = `    <key>StartInterval</key>\n    <integer>${intervalSeconds}</integer>`;
+    }
+    else {
+        const calXml = calendarEntries.map((cal) => {
+            let entries = '';
+            if (cal.Minute !== undefined)
+                entries += `          <key>Minute</key>\n          <integer>${cal.Minute}</integer>\n`;
+            if (cal.Hour !== undefined)
+                entries += `          <key>Hour</key>\n          <integer>${cal.Hour}</integer>\n`;
+            if (cal.Day !== undefined)
+                entries += `          <key>Day</key>\n          <integer>${cal.Day}</integer>\n`;
+            if (cal.Weekday !== undefined)
+                entries += `          <key>Weekday</key>\n          <integer>${cal.Weekday}</integer>\n`;
+            return `        <dict>\n${entries}        </dict>`;
+        }).join('\n');
+        schedulingXml = `    <key>StartCalendarInterval</key>\n    <array>\n${calXml}\n    </array>`;
+    }
+    const plist = `<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+    <key>Label</key>
+    <string>${label}</string>
+    <key>ProgramArguments</key>
+    <array>
+        <string>${openadsPath}</string>
+        <string>run-schedule</string>
+        <string>${schedule.name}</string>
+    </array>
+${schedulingXml}
+    <key>StandardOutPath</key>
+    <string>${reportFile}</string>
+    <key>StandardErrorPath</key>
+    <string>${path.join(REPORTS_DIR, `${schedule.name}-error.log`)}</string>
+    <key>RunAtLoad</key>
+    <false/>
+    <key>EnvironmentVariables</key>
+    <dict>
+        <key>PATH</key>
+        <string>/usr/local/bin:/usr/bin:/bin:/opt/homebrew/bin</string>
+    </dict>
+</dict>
+</plist>`;
+    const agentsDir = path.join(os.homedir(), 'Library', 'LaunchAgents');
+    if (!fs.existsSync(agentsDir))
+        fs.mkdirSync(agentsDir, { recursive: true });
+    fs.writeFileSync(plistPath, plist);
+    // Unload if already loaded, then load
+    spawnSync('launchctl', ['bootout', `gui/${process.getuid()}`, plistPath], { stdio: 'ignore' });
+    const result = spawnSync('launchctl', ['bootstrap', `gui/${process.getuid()}`, plistPath]);
+    return result.status === 0;
+}
+function uninstallLaunchd(name) {
+    const label = `com.openads.schedule.${name}`;
+    const plistPath = path.join(os.homedir(), 'Library', 'LaunchAgents', `${label}.plist`);
+    if (fs.existsSync(plistPath)) {
+        spawnSync('launchctl', ['bootout', `gui/${process.getuid()}`, plistPath], { stdio: 'ignore' });
+        fs.unlinkSync(plistPath);
+    }
+}
+// ─── Linux/Generic crontab ───────────────────────────────────────────
+function installCrontab(schedule, openadsPath) {
+    const marker = `# openads:${schedule.name}`;
+    const reportFile = path.join(REPORTS_DIR, `${schedule.name}-latest.md`);
+    const cronLine = `${schedule.cron} ${openadsPath} run-schedule ${schedule.name} > ${reportFile} 2>&1 ${marker}`;
+    // Read current crontab
+    const current = spawnSync('crontab', ['-l'], { encoding: 'utf8' });
+    let lines = (current.stdout || '').split('\n').filter((l) => !l.includes(marker));
+    lines.push(cronLine);
+    // Write back
+    const result = spawnSync('crontab', ['-'], {
+        input: lines.join('\n') + '\n',
+        encoding: 'utf8',
+    });
+    return result.status === 0;
+}
+function uninstallCrontab(name) {
+    const marker = `# openads:${name}`;
+    const current = spawnSync('crontab', ['-l'], { encoding: 'utf8' });
+    const lines = (current.stdout || '').split('\n').filter((l) => !l.includes(marker));
+    spawnSync('crontab', ['-'], {
+        input: lines.join('\n') + '\n',
+        encoding: 'utf8',
+    });
+}
+// ─── Run a Scheduled Task ────────────────────────────────────────────
+export async function runScheduledTask(name) {
+    const schedules = loadSchedules();
+    const schedule = schedules.find(s => s.name === name);
+    if (!schedule) {
+        console.error(`Schedule "${name}" not found.`);
+        process.exit(1);
+    }
+    // Load config for API key and model
+    const configPath = path.join(CONFIG_DIR, 'openads.config.json');
+    if (!fs.existsSync(configPath)) {
+        console.error('OpenAds is not configured. Run `openads setup` first.');
+        process.exit(1);
+    }
+    const config = JSON.parse(fs.readFileSync(configPath, 'utf8'));
+    // Print header and accumulate markdown
+    const now = new Date().toISOString().slice(0, 19).replace('T', ' ');
+    let fullMarkdown = '';
+    fullMarkdown += `# OpenAds Scheduled Report: ${schedule.name}\n`;
+    fullMarkdown += `_Generated: ${now}_\n\n`;
+    fullMarkdown += `**Prompt:** ${schedule.prompt}\n\n`;
+    fullMarkdown += '---\n\n';
+    console.log(fullMarkdown.trim() + '\n');
+    // Find the pi CLI
+    const pkgDir = path.resolve(path.dirname(new URL(import.meta.url).pathname), '..');
+    const piCliPath = path.resolve(pkgDir, 'node_modules', '@earendil-works', 'pi-coding-agent', 'dist', 'cli.js');
+    // Build environment
+    const env = { ...process.env, NODE_NO_WARNINGS: '1' };
+    if (config.apiKey && config.apiKey !== 'dummy-key') {
+        if (config.provider.startsWith('google/'))
+            env.GOOGLE_API_KEY = config.apiKey;
+        else if (config.provider.startsWith('openai/'))
+            env.OPENAI_API_KEY = config.apiKey;
+        else if (config.provider.startsWith('anthropic/'))
+            env.ANTHROPIC_API_KEY = config.apiKey;
+        else
+            env.OPENAI_API_KEY = config.apiKey;
+    }
+    if (config.localBaseUrl)
+        env.OPENAI_BASE_URL = config.localBaseUrl;
+    const skillsDir = path.resolve(pkgDir, 'skills');
+    const contextDir = path.join(CONFIG_DIR, 'context');
+    const args = [
+        piCliPath,
+        '--model', config.provider,
+        '--skill', skillsDir,
+        ...(fs.existsSync(contextDir) ? ['--skill', contextDir] : []),
+        '--print',
+        schedule.prompt,
+    ];
+    const result = spawnSync('node', args, {
+        env,
+        encoding: 'utf8',
+        timeout: 300000, // 5 minute timeout
+        stdio: ['ignore', 'pipe', 'pipe'],
+    });
+    if (result.stdout) {
+        console.log(result.stdout);
+        fullMarkdown += result.stdout;
+    }
+    if (result.stderr) {
+        console.error(result.stderr);
+    }
+    // Compile and save the HTML report
+    try {
+        const reportHtmlFile = path.join(REPORTS_DIR, `${schedule.name}-latest.html`);
+        const htmlContent = compileHtmlReport(schedule.name, fullMarkdown);
+        fs.writeFileSync(reportHtmlFile, htmlContent, 'utf8');
+    }
+    catch (err) {
+        console.error(`Failed to generate HTML report: ${err.message}`);
+    }
+}
+// ─── Interactive Schedule Setup ──────────────────────────────────────
+export async function runScheduleManager(subcommand) {
+    // Handle sub-commands
+    if (subcommand === 'list') {
+        return listSchedules();
+    }
+    if (subcommand === 'remove') {
+        return removeSchedule();
+    }
+    console.log(openadsGradient('\n  OpenAds Scheduler ⏰\n'));
+    console.log(chalk.gray('  Automate campaign checks, reports, and alerts.\n'));
+    const presetChoices = PRESETS.map(p => ({
+        name: p.name,
+        message: `${p.label} ${chalk.gray(`(${p.description})`)}`,
+    }));
+    presetChoices.push({
+        name: 'custom',
+        message: `${chalk.cyan('⏰')}  Custom schedule (describe in plain English)`,
+    });
+    presetChoices.push({
+        name: 'list',
+        message: `${chalk.gray('📋')}  View active schedules`,
+    });
+    presetChoices.push({
+        name: 'remove',
+        message: `${chalk.gray('🗑️')}   Remove a schedule`,
+    });
+    presetChoices.push({
+        name: 'view-reports',
+        message: `${chalk.green('📊')}  View latest HTML reports in browser`,
+    });
+    const { action } = await enquirer.prompt({
+        type: 'select',
+        name: 'action',
+        message: chalk.bold('What would you like to automate?'),
+        choices: presetChoices,
+    });
+    if (action === 'list')
+        return listSchedules();
+    if (action === 'remove')
+        return removeSchedule();
+    if (action === 'view-reports')
+        return chooseAndOpenReport();
+    let schedule;
+    if (action === 'custom') {
+        const answers = await enquirer.prompt([
+            {
+                type: 'input',
+                name: 'prompt',
+                message: 'What should OpenAds check or report on?',
+                validate: (v) => v.trim() ? true : 'Please describe what to automate.',
+            },
+            {
+                type: 'select',
+                name: 'cron',
+                message: 'How often?',
+                choices: [
+                    { name: '0 8 * * *', message: 'Every day at 8:00 AM' },
+                    { name: '0 */6 * * *', message: 'Every 6 hours' },
+                    { name: '0 9,17 * * *', message: 'Twice daily (9 AM & 5 PM)' },
+                    { name: '0 9 * * 1', message: 'Weekly (Monday 9 AM)' },
+                    { name: '0 9 1 * *', message: 'Monthly (1st at 9 AM)' },
+                ],
+            },
+        ]);
+        const safeName = 'custom-' + Date.now();
+        const cronDesc = {
+            '0 8 * * *': 'Every day at 8:00 AM',
+            '0 */6 * * *': 'Every 6 hours',
+            '0 9,17 * * *': 'Twice daily (9 AM & 5 PM)',
+            '0 9 * * 1': 'Weekly (Monday 9 AM)',
+            '0 9 1 * *': 'Monthly (1st at 9 AM)',
+        }[answers.cron] || answers.cron;
+        schedule = {
+            name: safeName,
+            prompt: answers.prompt,
+            cron: answers.cron,
+            description: cronDesc,
+            createdAt: new Date().toISOString(),
+        };
+    }
+    else {
+        const preset = PRESETS.find(p => p.name === action);
+        schedule = {
+            name: preset.name,
+            prompt: preset.prompt,
+            cron: preset.cron,
+            description: preset.description,
+            createdAt: new Date().toISOString(),
+        };
+    }
+    // Find openads executable
+    const openadsPath = process.argv[1];
+    // Install the schedule
+    console.log('');
+    let installed = false;
+    if (isMacOS()) {
+        console.log(chalk.cyan('Installing schedule via macOS launchd...'));
+        installed = installLaunchd(schedule, openadsPath);
+    }
+    else {
+        console.log(chalk.cyan('Installing schedule via crontab...'));
+        installed = installCrontab(schedule, openadsPath);
+    }
+    if (installed) {
+        // Save to our index
+        const schedules = loadSchedules().filter(s => s.name !== schedule.name);
+        schedules.push(schedule);
+        saveSchedules(schedules);
+        console.log(chalk.green(`\n✓ Schedule "${schedule.name}" installed!`));
+        console.log(chalk.gray(`  Frequency: ${schedule.description}`));
+        console.log(chalk.gray(`  Reports saved to: ${REPORTS_DIR}`));
+        console.log(chalk.gray(`\n  Manage with: openads schedule list | openads schedule remove\n`));
+    }
+    else {
+        console.log(chalk.red('\n✗ Failed to install schedule. Check permissions and try again.\n'));
+    }
+}
+// ─── List / Remove ───────────────────────────────────────────────────
+function listSchedules() {
+    const schedules = loadSchedules();
+    if (schedules.length === 0) {
+        console.log(chalk.yellow('\n  No active schedules. Run `openads schedule` to create one.\n'));
+        return;
+    }
+    console.log(chalk.bold.cyan('\n  Active Schedules'));
+    console.log(chalk.gray('  ─────────────────────────────────────────────────────\n'));
+    for (const s of schedules) {
+        console.log(`  ${chalk.cyan(s.name.padEnd(25))} ${chalk.white(s.description)}`);
+        console.log(`  ${' '.repeat(25)} ${chalk.gray(s.prompt.slice(0, 80))}${s.prompt.length > 80 ? '...' : ''}`);
+        console.log('');
+    }
+    console.log(chalk.gray(`  Reports saved to: ${REPORTS_DIR}\n`));
+}
+async function removeSchedule() {
+    const schedules = loadSchedules();
+    if (schedules.length === 0) {
+        console.log(chalk.yellow('\n  No active schedules to remove.\n'));
+        return;
+    }
+    const choices = schedules.map(s => ({
+        name: s.name,
+        message: `${s.name} — ${s.description}`,
+    }));
+    const { name } = await enquirer.prompt({
+        type: 'select',
+        name: 'name',
+        message: 'Which schedule do you want to remove?',
+        choices,
+    });
+    // Uninstall from OS
+    if (isMacOS()) {
+        uninstallLaunchd(name);
+    }
+    else {
+        uninstallCrontab(name);
+    }
+    // Remove from index
+    const updated = schedules.filter(s => s.name !== name);
+    saveSchedules(updated);
+    console.log(chalk.green(`\n✓ Schedule "${name}" removed.\n`));
+}
+export async function openReportInBrowser(name) {
+    const reportHtmlFile = path.join(REPORTS_DIR, `${name}-latest.html`);
+    if (!fs.existsSync(reportHtmlFile)) {
+        // If HTML doesn't exist but MD does, let's compile it on the fly!
+        const reportMdFile = path.join(REPORTS_DIR, `${name}-latest.md`);
+        if (fs.existsSync(reportMdFile)) {
+            const mdContent = fs.readFileSync(reportMdFile, 'utf8');
+            const htmlContent = compileHtmlReport(name, mdContent);
+            fs.writeFileSync(reportHtmlFile, htmlContent, 'utf8');
+        }
+        else {
+            console.error(chalk.red(`\n✗ Report for "${name}" not found. Run the schedule first or select another report.\n`));
+            return;
+        }
+    }
+    console.log(chalk.cyan(`\nOpening HTML report for "${name}" in your default browser...`));
+    await open(reportHtmlFile);
+}
+async function chooseAndOpenReport() {
+    const schedules = loadSchedules();
+    if (schedules.length === 0) {
+        console.log(chalk.yellow('\n  No active schedules. Run `openads schedule` to create one.\n'));
+        return;
+    }
+    // Find all schedules that have reports
+    const choices = schedules.map(s => {
+        const reportMdFile = path.join(REPORTS_DIR, `${s.name}-latest.md`);
+        const hasReport = fs.existsSync(reportMdFile);
+        return {
+            name: s.name,
+            message: `${s.name} ${chalk.gray(`(${s.description})`)} ${hasReport ? chalk.green('[Report Available]') : chalk.red('[No Report Yet]')}`,
+            disabled: !hasReport,
+        };
+    });
+    if (choices.every(c => c.disabled)) {
+        console.log(chalk.yellow('\n  No reports have been generated yet. Please wait for schedules to run.\n'));
+        return;
+    }
+    const { name } = await enquirer.prompt({
+        type: 'select',
+        name: 'name',
+        message: 'Select a report to open:',
+        choices: choices.filter(c => !c.disabled),
+    });
+    await openReportInBrowser(name);
+}
+export function listReports() {
+    ensureDirs();
+    const files = fs.readdirSync(REPORTS_DIR);
+    const reports = files.filter(f => f.endsWith('-latest.md'));
+    if (reports.length === 0) {
+        console.log(chalk.yellow('\n  No reports found in your reports directory. Please wait for schedules to run.\n'));
+        return;
+    }
+    console.log(chalk.bold.cyan('\n  Generated Reports'));
+    console.log(chalk.gray('  ──────────────────────────────────────────────────────────────────────────'));
+    for (const file of reports) {
+        const filePath = path.join(REPORTS_DIR, file);
+        const stats = fs.statSync(filePath);
+        const name = file.replace('-latest.md', '');
+        const date = stats.mtime.toISOString().slice(0, 19).replace('T', ' ');
+        const sizeKb = (stats.size / 1024).toFixed(1);
+        // Check if HTML version exists
+        const htmlExists = fs.existsSync(path.join(REPORTS_DIR, `${name}-latest.html`));
+        const formatSupport = htmlExists ? chalk.green('MD + HTML') : chalk.yellow('MD Only');
+        console.log(`  ${chalk.cyan(name.padEnd(25))} ${chalk.white(`${sizeKb} KB`)}   ${chalk.gray(date)}   ${formatSupport}`);
+    }
+    console.log(chalk.gray(`\n  Reports saved to: ${REPORTS_DIR}`));
+    console.log(chalk.gray(`  To view a report in your browser, run: ${chalk.white('openads report [name]')}\n`));
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openads-ai",
-  "version": "0.1.1",
+  "version": "0.2.1",
   "description": "Open-source AI command center for digital marketers. Audit campaigns, write ad copy, and build strategies — from your terminal.",
   "main": "dist/cli.js",
   "bin": {