openads-ai 0.2.0 → 0.2.2

package/README.md

@@ -11,10 +11,11 @@
   AI Command Center for Marketers
 ```
 
-> **Talk to your ad campaigns in plain English.** Connect your Google Ads and Meta accounts, pick your favorite AI model, and let OpenAds handle the analysis while you focus on strategy.
+> **Talk to your ad campaigns in plain English.** Connect your Google Ads, Google Analytics (GA4), and Meta accounts, pick your favorite AI model, and let OpenAds handle the analysis while you focus on strategy.
 
 <p align="center">
   <img src="https://img.shields.io/badge/Google%20Ads-MCP-4285F4?style=flat-square&logo=google-ads" />
+  <img src="https://img.shields.io/badge/Google%20Analytics%204-MCP-E37400?style=flat-square&logo=google-analytics" />
   <img src="https://img.shields.io/badge/Meta%20Ads-MCP-1877F2?style=flat-square&logo=meta" />
   <img src="https://img.shields.io/badge/License-MIT-green?style=flat-square" />
 </p>
@@ -32,7 +33,7 @@ OpenAds is an **open-source CLI tool** that turns any AI model into a marketing
 | Feature | What it means for you |
 |---|---|
 | 🧠 **Pre-built marketing skills** | The AI already knows Google Ads best practices, Meta creative formats, CRO frameworks, and copywriting rules. You just ask. |
-| 🔌 **Direct platform access** | Connect your Google Ads and Meta accounts. The AI reads your live data — no more copy-pasting reports. |
+| 🔌 **Direct platform access** | Connect your Google Ads, Google Analytics (GA4), and Meta accounts. The AI reads your live data — no more copy-pasting reports. |
 | 🤖 **Bring your own model** | Use Google Gemini, OpenAI, Claude, or a local model running on your machine. Your choice. |
 | 🛡️ **Nothing goes live without you** | The AI can read freely, but every write operation (campaign change, budget edit) requires your explicit approval. |
 | ⚡ **Autonomous loops** | Let the AI research competitors, test ad variants, and generate hypotheses overnight. Review in the morning. |
@@ -51,33 +52,56 @@ Here is a look at OpenAds in action:
 
 ## ⚡ Quick Start
 
-### 1. Install
+### 👶 New to the terminal? Start here!
 
+OpenAds is a local desktop application that runs in your computer's **Terminal** (a text-based window where you can run commands). Follow these simple steps to get started:
+
+#### Step 1: Install Node.js (Required)
+OpenAds runs on your computer using Node.js. If you don't have it yet, installing it is just like any normal application:
+1. Go to [nodejs.org](https://nodejs.org/) and click the **LTS (Recommended)** button to download it.
+2. Open the downloaded file and run the installer (just click "Next" until it finishes).
+
+#### Step 2: Open your Terminal
+* **Mac:** Press `Cmd + Space` (Spotlight search), type **Terminal**, and press `Enter`.
+* **Windows:** Press the `Windows Key` on your keyboard, type **cmd** (Command Prompt), and press `Enter`.
+
+#### Step 3: Install OpenAds
+Copy the command below, paste it into your Terminal window, and press **Enter**:
 ```bash
 npm install -g openads-ai
 ```
+> 💡 **Permissions Error?** If your Terminal shows a red error about "EACCES" or permissions, copy and paste this command instead:
+> `sudo npm install -g openads-ai` (Mac will ask you to type your computer password and press Enter).
 
-> **Tip:** If you see a permissions error, prefix with `sudo` or [configure npm for global installs](https://docs.npmjs.com/resolving-eacces-permissions-errors-when-installing-packages-globally).
-
-### 2. Set up (one time)
-
+#### Step 4: Run the Setup Wizard
+Paste this command into your Terminal and press **Enter**:
 ```bash
 openads setup
 ```
+This launches a beautiful, step-by-step interactive setup wizard where you can:
+* **Select your favorite AI model** (Google Gemini, OpenAI, Claude, or a free local model)
+* **Link your ad accounts** (Google Ads, GA4, and/or Meta Ads)
+* **Describe your business** (so the AI writes copy tailored exactly to your brand)
+
+#### Step 5: Start using OpenAds!
+Whenever you want to audit your campaigns or write copy, just open your Terminal, type:
+```bash
+openads
+```
+and press **Enter** to open your dashboard.
 
-The setup wizard walks you through three things:
-- **Pick your AI model** — choose from Google Gemini, OpenAI, Claude, a local model, or any OpenAI-compatible provider
-- **Connect your ad accounts** — Google Ads and/or Meta Ads (both optional)
-- **Describe your business** — so the AI can tailor copy and strategy to your product
+---
+
+### 💻 Already know how to use the terminal? Quick commands
 
-### 3. Launch
+If you're already familiar with node packages, just run:
 
 ```bash
+npm install -g openads-ai
+openads setup
 openads
 ```
 
-That's it. You'll see a menu with quick actions. Pick one, or just type your question in plain English.
-
 ---
 
 ## 💡 What can I do with it?
@@ -147,9 +171,17 @@ openads schedule
 | 📋 Weekly performance report | Every Monday at 9 AM |
 | ⏰ Custom (describe in plain English) | You choose |
 
-Reports are saved to `~/.openads/reports/`. Manage your schedules:
+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
 ```
@@ -179,7 +211,7 @@ This verifies your config file, API keys, platform connections (live token check
 
 ## 🗺️ Roadmap
 
-- [x] Google Ads integration via MCP
+- [x] Google Ads & GA4 integration via MCP
 - [x] Meta Ads integration via MCP
 - [x] Interactive setup wizard with live token verification
 - [x] 12 pre-built skills: Ads, CRO, Copywriting, Analytics, Email, Video, Research, Strategy
@@ -189,7 +221,8 @@ This verifies your config file, API keys, platform connections (live token check
 - [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
+- [ ] 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))
 
 ---
 
@@ -213,4 +246,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,8 +10,9 @@ import gradient from 'gradient-string';
 import ora from 'ora';
 import { runSetup } from './setup.js';
 import { runDoctor } from './doctor.js';
-import { runScheduleManager, runScheduledTask } from './schedule.js';
+import { runScheduleManager, runScheduledTask, openReportInBrowser, listReports } from './schedule.js';
 import enquirer from 'enquirer';
+import { hasGlobalRtk } from './token-optimizer.js';
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
 const pkgDir = path.resolve(__dirname, '..');
@@ -81,25 +82,21 @@ _You can also edit this file manually at: ${contextPath}_
 // Makes the agent behave as "OpenAds" instead of generic Pi.
 function buildSystemPrompt(config) {
     const contextPath = path.join(CONFIG_DIR, 'context', 'my-business.md');
+    const isLaunchMode = config.mode === 'launch';
     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.',
         'Always speak in plain marketing language. Never use developer jargon.',
         '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 (isLaunchMode) {
+        parts.push('YOU ARE OPERATING IN LAUNCH MODE (READ-WRITE).', 'You are authorized to execute active write modifications on ad accounts (e.g. pausing campaigns, scaling bids, altering daily budgets, creating ads).', 'CRITICAL SAFETY RULE: For any write operation, you MUST generate a clear visual preview card outlining the exact changes and ask the user for explicit confirmation (Y/N) before executing. NEVER make active changes without their explicit confirmation.');
+    }
+    else {
+        parts.push('YOU ARE OPERATING IN AUDIT MODE (SAFE / READ-ONLY).', 'You are authorized to read campaigns, analyze performance data, find budget waste, and recommend copy or landing page changes.', 'CRITICAL SAFETY RULE: You are NOT authorized to make any active modifications to campaigns, budgets, or ad creative settings under any circumstances.', 'If the user asks you to pause a campaign, change a budget, or execute a write operation, explain politely that OpenAds is currently in Audit Mode (Safe/Read-only). Outline the exact steps you would take, and tell them to toggle to Launch Mode in Settings (`openads setup`) to execute them.');
+    }
+    parts.push('', '## 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}`);
     }
@@ -221,6 +218,18 @@ async function main() {
         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) {
@@ -240,13 +249,15 @@ async function main() {
     const modelName = chalk.cyan.bold(cleanProvider);
     const googleStatus = config.connectGoogle ? chalk.green('● Connected') : chalk.gray('○ Not connected');
     const metaStatus = config.metaToken ? chalk.green('● Connected') : chalk.gray('○ Not connected');
+    const modeName = config.mode === 'launch' ? chalk.red.bold('Launch Mode (Read-Write)') : chalk.green.bold('Audit Mode (Safe / Read-only)');
     // Build compact status panel
     const statusLines = [
         `  ${chalk.bold.white('Model')}       ${modelName}`,
+        `  ${chalk.bold.white('Mode')}        ${modeName}`,
         `  ${chalk.bold.white('Google Ads')}  ${googleStatus}`,
         `  ${chalk.bold.white('Meta Ads')}    ${metaStatus}`,
         '',
-        `  ${chalk.gray('v0.1.0')}  ${chalk.gray('·')}  ${chalk.gray('AI Command Center for Marketers')}`,
+        `  ${chalk.gray('v0.2.1')}  ${chalk.gray('·')}  ${chalk.gray('AI Command Center for Marketers')}`,
     ].join('\n');
     console.log(boxen(statusLines, {
         padding: { top: 1, bottom: 1, left: 2, right: 2 },
@@ -362,12 +373,21 @@ async function main() {
         baseDelayMs: 15000,
         provider: { maxRetryDelayMs: 120000 }
     };
+    // Setup MCP Servers inside settings.json
+    settings.mcpServers = settings.mcpServers || {};
+    const useRtk = hasGlobalRtk();
+    // Google Ads integration
+    if (config.connectGoogle) {
+        settings.mcpServers['google-ads'] = {
+            command: useRtk ? 'rtk' : 'uvx',
+            args: useRtk ? ['uvx', 'adloop'] : ['adloop']
+        };
+    }
     // Inject Meta MCP server if token is present
     if (config.metaToken) {
-        settings.mcpServers = settings.mcpServers || {};
         settings.mcpServers['meta-ads'] = {
-            command: 'npx',
-            args: ['-y', '@meta/mcp-server'],
+            command: useRtk ? 'rtk' : 'npx',
+            args: useRtk ? ['npx', '-y', '@meta/mcp-server'] : ['-y', '@meta/mcp-server'],
             env: { META_ACCESS_TOKEN: config.metaToken }
         };
     }

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

@@ -5,6 +5,9 @@ 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';
+import { optimizeTokenContext } from './token-optimizer.js';
 const openadsGradient = gradient(['#00d2ff', '#3a7bd5', '#00d2ff']);
 const CONFIG_DIR = path.join(os.homedir(), '.openads');
 const SCHEDULES_DIR = path.join(CONFIG_DIR, 'schedules');
@@ -217,12 +220,14 @@ export async function runScheduledTask(name) {
         process.exit(1);
     }
     const config = JSON.parse(fs.readFileSync(configPath, 'utf8'));
-    // Print header
+    // Print header and accumulate markdown
     const now = new Date().toISOString().slice(0, 19).replace('T', ' ');
-    console.log(`# OpenAds Scheduled Report: ${schedule.name}`);
-    console.log(`_Generated: ${now}_\n`);
-    console.log(`**Prompt:** ${schedule.prompt}\n`);
-    console.log('---\n');
+    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');
@@ -256,10 +261,26 @@ export async function runScheduledTask(name) {
         timeout: 300000, // 5 minute timeout
         stdio: ['ignore', 'pipe', 'pipe'],
     });
-    if (result.stdout)
-        console.log(result.stdout);
-    if (result.stderr)
-        console.error(result.stderr);
+    if (result.stdout) {
+        const cleanOutput = optimizeTokenContext(result.stdout);
+        console.log(cleanOutput);
+        fullMarkdown += cleanOutput;
+    }
+    if (result.stderr) {
+        const cleanError = optimizeTokenContext(result.stderr);
+        if (cleanError.trim()) {
+            console.error(cleanError);
+        }
+    }
+    // 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) {
@@ -288,6 +309,10 @@ export async function runScheduleManager(subcommand) {
         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',
@@ -298,6 +323,8 @@ export async function runScheduleManager(subcommand) {
         return listSchedules();
     if (action === 'remove')
         return removeSchedule();
+    if (action === 'view-reports')
+        return chooseAndOpenReport();
     let schedule;
     if (action === 'custom') {
         const answers = await enquirer.prompt([
@@ -417,3 +444,73 @@ async function removeSchedule() {
     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/dist/setup.js

@@ -125,6 +125,7 @@ export async function runSetup() {
     let customModel = '';
     let localModelName = '';
     let localBaseUrl = '';
+    let mode = 'audit';
     if (provider === 'local') {
         console.log(chalk.yellow('\n--- Local AI Setup ---'));
         console.log('You can run models 100% offline using tools like Ollama or LM Studio.');
@@ -209,8 +210,26 @@ export async function runSetup() {
         console.log(chalk.green(`\n✓ Local AI configured — ready to connect to ${localBaseUrl}.\n`));
     }
     console.log(chalk.gray('─────────────────────────────────────────\n'));
-    // Step 2: Google Ads
-    console.log(chalk.cyan('Step 2/4: Connect Google Ads (optional)\n'));
+    // Step 2: Choose operational mode
+    console.log(chalk.cyan('Step 2/5: Choose operational mode\n'));
+    console.log('OpenAds has two operational modes:');
+    console.log(` - ${chalk.green.bold('Audit Mode (Safe / Read-only)')}: AI can analyze performance, find budget waste, and recommend strategies. Zero risk.`);
+    console.log(` - ${chalk.red.bold('Launch Mode (Read-Write)')}: AI is authorized to optimize bids, modify budgets, and launch ads (always requires confirmation).\n`);
+    const modeAnswers = await enquirer.prompt({
+        type: 'select',
+        name: 'selectedMode',
+        message: 'Choose your default operational mode:',
+        choices: [
+            { name: 'audit', message: 'Audit Mode (Safe / Read-only — Recommended)' },
+            { name: 'launch', message: 'Launch Mode (Read-Write — Active campaign changes)' }
+        ],
+        initial: existingConfig.mode === 'launch' ? 1 : 0
+    });
+    mode = modeAnswers.selectedMode;
+    console.log(chalk.green(`\n✓ Operational mode configured: ${mode === 'launch' ? 'Launch Mode (Read-Write)' : 'Audit Mode (Safe / Read-only)'}.\n`));
+    console.log(chalk.gray('─────────────────────────────────────────\n'));
+    // Step 3: Google Ads
+    console.log(chalk.cyan('Step 3/5: Connect Google Ads (optional)\n'));
     console.log('OpenAds can read and analyze your Google Ads campaigns, keywords, and performance.\n');
     const { connectGoogle } = await enquirer.prompt({
         type: 'confirm',
@@ -248,8 +267,8 @@ export async function runSetup() {
         console.log(chalk.green('✓ Google Ads module enabled.\n'));
     }
     console.log(chalk.gray('─────────────────────────────────────────\n'));
-    // Step 3: Meta Ads
-    console.log(chalk.cyan('Step 3/4: Connect Meta Ads (optional)\n'));
+    // Step 4: Meta Ads
+    console.log(chalk.cyan('Step 4/5: Connect Meta Ads (optional)\n'));
     console.log('OpenAds can read your Meta campaigns, creatives, and audience performance.\n');
     let metaToken = '';
     const { connectMeta } = await enquirer.prompt({
@@ -355,8 +374,8 @@ export async function runSetup() {
         }
     }
     console.log(chalk.gray('─────────────────────────────────────────\n'));
-    // Step 4: Business Context
-    console.log(chalk.cyan('Step 4/4: Tell me about your business\n'));
+    // Step 5: Business Context
+    console.log(chalk.cyan('Step 5/5: Tell me about your business\n'));
     const { productContext } = await enquirer.prompt({
         type: 'input',
         name: 'productContext',
@@ -379,6 +398,7 @@ export async function runSetup() {
         provider: finalModel,
         apiKey,
         localBaseUrl,
+        mode,
         connectGoogle,
         metaToken,
         productContext

package/dist/token-optimizer.js

@@ -0,0 +1,66 @@
+import { spawnSync } from 'child_process';
+/**
+ * Checks if the Rust Token Killer (rtk) CLI binary is installed globally on the user's machine.
+ */
+export function hasGlobalRtk() {
+    try {
+        const result = spawnSync('rtk', ['--version'], { stdio: 'ignore' });
+        return result.status === 0;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * TS-native token compression utility. Filters out progress bars, experimental warnings,
+ * download lines, and redundant log noise from CLI processes to optimize AI context windows.
+ */
+export function optimizeTokenContext(text) {
+    if (!text)
+        return '';
+    // 1. Strip ANSI escape sequences (colors, text formatting, control characters)
+    const ansiRegex = /[\u001b\u009b][[()#;?]*(?:[0-9]{1,4}(?:;[0-9]{0,4})*)?[0-9A-ORZcf-nqry=><]/g;
+    let cleanText = text.replace(ansiRegex, '');
+    // 2. Process line-by-line to strip installation/CLI environment noise
+    const lines = cleanText.split('\n');
+    const filteredLines = lines.filter(line => {
+        const l = line.trim();
+        if (!l)
+            return true; // Keep spacing empty lines
+        // Ignore Node, NPM, NPX, UV/UVX experimental warnings & logs
+        if (l.startsWith('ExperimentalWarning:'))
+            return false;
+        if (l.startsWith('npm notice'))
+            return false;
+        if (l.startsWith('npm warn'))
+            return false;
+        if (l.startsWith('npm ERR!'))
+            return false;
+        if (l.includes('npx: installed'))
+            return false;
+        if (l.includes('npm install'))
+            return false;
+        if (l.includes('audited'))
+            return false;
+        if (l.includes('found 0 vulnerabilities'))
+            return false;
+        // Ignore package/tool downloader progress indicators
+        if (l.includes('Retrieving'))
+            return false;
+        if (l.includes('Downloading'))
+            return false;
+        if (l.startsWith('Resolving'))
+            return false;
+        if (l.startsWith('Installed'))
+            return false;
+        if (l.includes('Warning:'))
+            return false;
+        // Ignore progress bar lines
+        if (l.includes('[====='))
+            return false;
+        if (l.includes('========>'))
+            return false;
+        return true;
+    });
+    return filteredLines.join('\n');
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openads-ai",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "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": {