intelwatch 1.0.0

package/src/commands/report.js

@@ -0,0 +1,82 @@
+import chalk from 'chalk';
+import { loadTrackers, listSnapshots, loadSnapshot, saveReport } from '../storage.js';
+import { generateMarkdownReport } from '../report/markdown.js';
+import { generateHtmlReport } from '../report/html.js';
+import { generateJsonReport } from '../report/json.js';
+import { error, success, warn } from '../utils/display.js';
+import { writeFileSync } from 'fs';
+import { diffCompetitorSnapshots } from '../trackers/competitor.js';
+import { diffKeywordSnapshots } from '../trackers/keyword.js';
+import { diffBrandSnapshots } from '../trackers/brand.js';
+import { computeThreatScore } from '../trackers/competitor.js';
+
+export async function runReport(options) {
+  const format = options.format || 'md';
+  const trackers = loadTrackers();
+
+  if (trackers.length === 0) {
+    warn('No trackers configured. Use `intelwatch track` to add one.');
+    return;
+  }
+
+  // Build report data
+  const reportData = {
+    generatedAt: new Date().toISOString(),
+    competitors: [],
+    keywords: [],
+    brands: [],
+  };
+
+  for (const tracker of trackers) {
+    const snapshots = listSnapshots(tracker.id);
+    if (snapshots.length === 0) continue;
+
+    const latest = loadSnapshot(snapshots[snapshots.length - 1].filepath);
+    const prev = snapshots.length > 1 ? loadSnapshot(snapshots[snapshots.length - 2].filepath) : null;
+
+    let changes = [];
+    if (tracker.type === 'competitor') {
+      changes = diffCompetitorSnapshots(prev, latest);
+      const threatScore = computeThreatScore(tracker, changes);
+      reportData.competitors.push({
+        tracker,
+        snapshot: latest,
+        changes,
+        threatScore,
+        prevSnapshot: prev,
+      });
+    } else if (tracker.type === 'keyword') {
+      changes = diffKeywordSnapshots(prev, latest);
+      reportData.keywords.push({ tracker, snapshot: latest, changes });
+    } else if (tracker.type === 'brand') {
+      changes = diffBrandSnapshots(prev, latest);
+      reportData.brands.push({ tracker, snapshot: latest, changes });
+    }
+  }
+
+  let content;
+  let ext;
+
+  if (format === 'html') {
+    content = generateHtmlReport(reportData);
+    ext = 'html';
+  } else if (format === 'json') {
+    content = generateJsonReport(reportData);
+    ext = 'json';
+  } else {
+    content = generateMarkdownReport(reportData);
+    ext = 'md';
+  }
+
+  if (options.output) {
+    writeFileSync(options.output, content, 'utf8');
+    success(`Report saved to: ${options.output}`);
+  } else if (format === 'html') {
+    const filename = `report-${new Date().toISOString().slice(0, 10)}.html`;
+    const filepath = saveReport(filename, content);
+    success(`HTML report saved to: ${filepath}`);
+    console.log(chalk.gray('Open in your browser to view.'));
+  } else {
+    console.log(content);
+  }
+}

package/src/commands/track.js

@@ -0,0 +1,94 @@
+import { createTracker } from '../storage.js';
+import { success, warn, error } from '../utils/display.js';
+
+export async function trackPerson(name, options) {
+  const org = options.org || null;
+
+  const { tracker, created } = createTracker('person', {
+    personName: name,
+    name,
+    org,
+  });
+
+  if (created) {
+    success(`Person tracker created: ${tracker.id}`);
+    console.log(`  Person: "${name}"`);
+    if (org) console.log(`  Org   : "${org}"`);
+    console.log(`\nRun ${chalk_cyan('intelwatch check')} to fetch the first snapshot.`);
+  } else {
+    warn(`Tracker already exists: ${tracker.id}`);
+  }
+
+  return tracker;
+}
+
+export async function trackCompetitor(url, options) {
+  let normalizedUrl = url;
+  if (!normalizedUrl.startsWith('http')) {
+    normalizedUrl = 'https://' + normalizedUrl;
+  }
+  try {
+    new URL(normalizedUrl);
+  } catch {
+    error(`Invalid URL: ${url}`);
+    process.exit(1);
+  }
+
+  const name = options.name || new URL(normalizedUrl).hostname.replace('www.', '');
+
+  const { tracker, created } = createTracker('competitor', {
+    url: normalizedUrl,
+    name,
+  });
+
+  if (created) {
+    success(`Competitor tracker created: ${chalk_green(tracker.id)}`);
+    console.log(`  Name : ${tracker.name}`);
+    console.log(`  URL  : ${tracker.url}`);
+    console.log(`\nRun ${chalk_cyan('intelwatch check')} to fetch the first snapshot.`);
+  } else {
+    warn(`Tracker already exists: ${tracker.id}`);
+  }
+
+  return tracker;
+}
+
+export async function trackKeyword(keyword, options) {
+  const engine = options.engine || 'google';
+
+  const { tracker, created } = createTracker('keyword', {
+    keyword,
+    engine,
+  });
+
+  if (created) {
+    success(`Keyword tracker created: ${tracker.id}`);
+    console.log(`  Keyword: "${tracker.keyword}"`);
+    console.log(`  Engine : ${tracker.engine}`);
+    console.log(`\nRun ${chalk_cyan('intelwatch check')} to fetch the first SERP snapshot.`);
+  } else {
+    warn(`Tracker already exists: ${tracker.id}`);
+  }
+
+  return tracker;
+}
+
+export async function trackBrand(brandName, options) {
+  const { tracker, created } = createTracker('brand', {
+    brandName,
+  });
+
+  if (created) {
+    success(`Brand tracker created: ${tracker.id}`);
+    console.log(`  Brand: "${tracker.brandName}"`);
+    console.log(`\nRun ${chalk_cyan('intelwatch check')} to fetch the first mentions snapshot.`);
+  } else {
+    warn(`Tracker already exists: ${tracker.id}`);
+  }
+
+  return tracker;
+}
+
+// Inline chalk helpers to avoid import cycle issues
+function chalk_green(str) { return `\x1b[32m${str}\x1b[0m`; }
+function chalk_cyan(str) { return `\x1b[36m${str}\x1b[0m`; }

package/src/config.js

@@ -0,0 +1,65 @@
+import { readFileSync, writeFileSync, existsSync } from 'fs';
+import { join } from 'path';
+import { parse as parseYaml, stringify as stringifyYaml } from 'yaml';
+import { BASE_DIR, ensureDirectories } from './storage.js';
+
+const CONFIG_FILE = join(BASE_DIR, 'config.yml');
+
+const DEFAULT_CONFIG = {
+  notifications: {
+    webhook: null,
+    email: null,
+    events: [
+      'competitor.new_page',
+      'competitor.price_change',
+      'keyword.position_change',
+      'brand.new_mention',
+    ],
+  },
+  scraping: {
+    delay_min: 1000,
+    delay_max: 2500,
+    retries: 3,
+    user_agent_rotate: true,
+  },
+};
+
+export function loadConfig() {
+  ensureDirectories();
+  if (!existsSync(CONFIG_FILE)) {
+    return { ...DEFAULT_CONFIG };
+  }
+  try {
+    const raw = readFileSync(CONFIG_FILE, 'utf8');
+    const parsed = parseYaml(raw);
+    return deepMerge(DEFAULT_CONFIG, parsed || {});
+  } catch {
+    return { ...DEFAULT_CONFIG };
+  }
+}
+
+export function saveConfig(config) {
+  ensureDirectories();
+  writeFileSync(CONFIG_FILE, stringifyYaml(config), 'utf8');
+}
+
+export function updateConfig(updates) {
+  const current = loadConfig();
+  const merged = deepMerge(current, updates);
+  saveConfig(merged);
+  return merged;
+}
+
+function deepMerge(base, override) {
+  const result = { ...base };
+  for (const [key, value] of Object.entries(override)) {
+    if (value && typeof value === 'object' && !Array.isArray(value) && base[key] && typeof base[key] === 'object') {
+      result[key] = deepMerge(base[key], value);
+    } else {
+      result[key] = value;
+    }
+  }
+  return result;
+}
+
+export { CONFIG_FILE };

package/src/index.js

@@ -0,0 +1,182 @@
+import { Command } from 'commander';
+import { trackCompetitor, trackKeyword, trackBrand, trackPerson } from './commands/track.js';
+import { runDiscover } from './commands/discover.js';
+import { runCheck } from './commands/check.js';
+import { runDigest } from './commands/digest.js';
+import { runDiff } from './commands/diff.js';
+import { runReport } from './commands/report.js';
+import { runHistory } from './commands/history.js';
+import { runCompare } from './commands/compare.js';
+import { setupNotifications } from './commands/notify.js';
+import { listTrackers, removeTrackerCmd } from './commands/list.js';
+import { runAISummary } from './commands/ai-summary.js';
+import { runPitch } from './commands/pitch.js';
+
+const program = new Command();
+
+program
+  .name('intelwatch')
+  .description('Competitive intelligence CLI — track competitors, keywords, and brand mentions from the terminal')
+  .version('1.0.0');
+
+// ─── track ────────────────────────────────────────────────────────────────────
+
+const track = program.command('track')
+  .description('Add a new tracker');
+
+track
+  .command('competitor <url>')
+  .description('Track a competitor website')
+  .option('--name <alias>', 'Friendly name for this competitor')
+  .action(async (url, options) => {
+    await trackCompetitor(url, options);
+  });
+
+track
+  .command('keyword <keyword>')
+  .description('Track keyword rankings in Google SERP')
+  .option('--engine <engine>', 'Search engine (google)', 'google')
+  .action(async (keyword, options) => {
+    await trackKeyword(keyword, options);
+  });
+
+track
+  .command('brand <name>')
+  .description('Track brand mentions across the web')
+  .action(async (name, options) => {
+    await trackBrand(name, options);
+  });
+
+track
+  .command('person <name>')
+  .description('Track press mentions and social presence for a person or public figure')
+  .option('--org <org>', 'Filter results by organization affiliation (for disambiguation)')
+  .action(async (name, options) => {
+    await trackPerson(name, options);
+  });
+
+// ─── list ─────────────────────────────────────────────────────────────────────
+
+program
+  .command('list')
+  .description('List all active trackers')
+  .action(() => {
+    listTrackers();
+  });
+
+// ─── remove ───────────────────────────────────────────────────────────────────
+
+program
+  .command('remove <tracker-id>')
+  .description('Remove a tracker')
+  .action((id) => {
+    removeTrackerCmd(id);
+  });
+
+// ─── check ────────────────────────────────────────────────────────────────────
+
+program
+  .command('check')
+  .description('Run checks for all (or one) tracker(s)')
+  .option('--tracker <id>', 'Only check this specific tracker')
+  .action(async (options) => {
+    await runCheck(options);
+  });
+
+// ─── digest ───────────────────────────────────────────────────────────────────
+
+program
+  .command('digest')
+  .description('Show a summary of all changes across all trackers')
+  .action(async () => {
+    await runDigest();
+  });
+
+// ─── diff ─────────────────────────────────────────────────────────────────────
+
+program
+  .command('diff <tracker-id>')
+  .description('Show detailed diff for one tracker')
+  .option('--days <n>', 'Compare with snapshot from N days ago')
+  .action(async (trackerId, options) => {
+    await runDiff(trackerId, options);
+  });
+
+// ─── report ───────────────────────────────────────────────────────────────────
+
+program
+  .command('report')
+  .description('Generate a full intelligence report')
+  .option('--format <format>', 'Output format: md, html, json', 'md')
+  .option('--output <file>', 'Write report to file')
+  .action(async (options) => {
+    await runReport(options);
+  });
+
+// ─── history ──────────────────────────────────────────────────────────────────
+
+program
+  .command('history <tracker-id>')
+  .description('Show historical snapshots for a tracker')
+  .option('--limit <n>', 'Number of snapshots to show', '20')
+  .action((trackerId, options) => {
+    runHistory(trackerId, options);
+  });
+
+// ─── compare ──────────────────────────────────────────────────────────────────
+
+program
+  .command('compare <tracker1> <tracker2>')
+  .description('Side-by-side comparison of two competitor trackers')
+  .action((id1, id2) => {
+    runCompare(id1, id2);
+  });
+
+// ─── ai-summary ───────────────────────────────────────────────────────────────
+
+program
+  .command('ai-summary')
+  .description('Generate an AI-powered intelligence brief for all competitor trackers')
+  .option('--tracker <id>', 'Only summarize this specific tracker')
+  .action(async (options) => {
+    await runAISummary(options);
+  });
+
+// ─── pitch ────────────────────────────────────────────────────────────────────
+
+program
+  .command('pitch <tracker-id>')
+  .description('Generate a sales-ready competitive pitch document')
+  .option('--for <your-site>', 'Your product or site name', 'your product')
+  .option('--format <format>', 'Output format: md, html', 'md')
+  .option('--output <file>', 'Save pitch to file')
+  .action(async (trackerId, options) => {
+    await runPitch(trackerId, options);
+  });
+
+// ─── discover ─────────────────────────────────────────────────────────────────
+
+program
+  .command('discover <url>')
+  .description('Discover competitors for a given URL using web search and AI scoring')
+  .option('--auto-track', 'Automatically create competitor trackers for top 5 results')
+  .option('--ai', 'Use AI for smarter query generation and relevance scoring (requires API key)')
+  .action(async (url, options) => {
+    await runDiscover(url, options);
+  });
+
+// ─── notify ───────────────────────────────────────────────────────────────────
+
+program
+  .command('notify')
+  .description('Configure notifications')
+  .option('--setup', 'Interactive notification setup')
+  .action(async (options) => {
+    if (options.setup) {
+      await setupNotifications(options);
+    } else {
+      console.log('Use `intelwatch notify --setup` to configure notifications.');
+    }
+  });
+
+export { program };