vipcare 0.1.0

package/README.md

@@ -0,0 +1,98 @@
+# VIPCare
+
+Auto-build VIP person profiles from Twitter/LinkedIn public data.
+
+## Install
+
+```bash
+npm install -g vipcare
+```
+
+Or run directly:
+
+```bash
+npx vipcare --help
+```
+
+## Quick Start
+
+```bash
+# Add a person by name
+vip add "Sam Altman" --company "OpenAI"
+
+# Add from Twitter URL
+vip add https://twitter.com/sama
+
+# List all profiles
+vip list
+
+# Show a profile
+vip show sam-altman
+
+# Search across profiles
+vip search "AI"
+
+# Edit a profile
+vip edit sam-altman --note "Met at conference"
+
+# Delete a profile
+vip rm sam-altman -y
+
+# Refresh a profile
+vip update sam-altman
+```
+
+## Features
+
+- **Auto profile building** — Give a name or URL, get a structured profile
+- **Multi-source data** — Twitter (via [bird CLI](https://github.com/nickytonline/bird)), LinkedIn, web search
+- **AI synthesis** — Claude CLI, Anthropic API, or GitHub Copilot CLI
+- **Auto monitoring** — Scheduled profile refresh with change detection (macOS launchd)
+- **Markdown output** — One `.md` file per person
+
+## AI Backend
+
+Auto-detected in this order:
+
+| Backend | Setup |
+|---------|-------|
+| Anthropic API | Set `ANTHROPIC_API_KEY` env var |
+| Claude CLI | Install [Claude Code](https://claude.ai/code) |
+| GitHub Copilot | Install `gh copilot` |
+
+Override: `VIP_AI_BACKEND=anthropic vip add "Name"`
+
+## Claude Code Skill
+
+Install the `/vip` slash command for Claude Code:
+
+```bash
+cp skill/vip.md ~/.claude/commands/vip.md
+```
+
+Then use natural language:
+
+```
+/vip add Jensen Huang from NVIDIA
+/vip who works in AI?
+/vip compare Sam Altman and Elon Musk
+/vip add a note to sam: met at dinner
+```
+
+## Monitoring
+
+```bash
+vip monitor start    # Start auto-refresh (every 24h)
+vip monitor stop     # Stop
+vip monitor status   # Check status
+vip monitor run      # Run once now
+vip digest           # View recent changes
+```
+
+## Config
+
+```bash
+vip config           # View settings
+```
+
+Settings: `~/.vip-crm/config.json` | Profiles: `~/Projects/vip-crm/profiles/`

package/bin/vip.js

@@ -0,0 +1,351 @@
+#!/usr/bin/env node
+
+import { Command } from 'commander';
+import fs from 'fs';
+import os from 'os';
+import { execSync as exec } from 'child_process';
+import { checkTool, getProfilesDir, loadConfig, saveConfig } from '../lib/config.js';
+import { deleteProfile, getProfilePath, listProfiles, loadProfile, profileExists, saveProfile, searchProfiles } from '../lib/profile.js';
+import { isUrl, resolveFromName, resolveFromUrl } from '../lib/resolver.js';
+import * as twitter from '../lib/fetchers/twitter.js';
+import { searchPerson } from '../lib/fetchers/search.js';
+import { synthesizeProfile, getBackendName } from '../lib/synthesizer.js';
+import { readChangelog, runMonitor, unreadCount } from '../lib/monitor.js';
+import { install, uninstall, status } from '../lib/scheduler.js';
+
+// Colors
+const c = {
+  cyan: s => `\x1b[36m${s}\x1b[0m`,
+  green: s => `\x1b[32m${s}\x1b[0m`,
+  yellow: s => `\x1b[33m${s}\x1b[0m`,
+  red: s => `\x1b[31m${s}\x1b[0m`,
+  dim: s => `\x1b[90m${s}\x1b[0m`,
+  bold: s => `\x1b[1m${s}\x1b[0m`,
+};
+
+function spinner(msg) {
+  const chars = ['⠋','⠙','⠹','⠸','⠼','⠴','⠦','⠧','⠇','⠏'];
+  let i = 0;
+  const id = setInterval(() => {
+    process.stdout.write(`\r${chars[i++ % chars.length]} ${msg}`);
+  }, 100);
+  return () => { clearInterval(id); process.stdout.write(`\r${' '.repeat(msg.length + 4)}\r`); };
+}
+
+function gatherData(person) {
+  const rawParts = [];
+  const sources = [];
+
+  if (person.twitterHandle) {
+    console.log(c.dim(`  Fetching Twitter @${person.twitterHandle}...`));
+    const data = twitter.fetchProfile(person.twitterHandle);
+    if (data?.rawOutput) {
+      rawParts.push(`=== Twitter (@${person.twitterHandle}) ===\n${data.rawOutput}`);
+      sources.push(`https://twitter.com/${person.twitterHandle}`);
+    } else if (!twitter.isAvailable()) {
+      console.log(c.yellow('  (bird CLI not found, skipping Twitter)'));
+    }
+  }
+
+  if (person.linkedinUrl) sources.push(person.linkedinUrl);
+
+  if (person.rawSnippets.length) {
+    rawParts.push('=== Web Search Results ===');
+    rawParts.push(...person.rawSnippets);
+  }
+
+  if (rawParts.length < 2 && person.name) {
+    console.log(c.dim(`  Searching the web for ${person.name}...`));
+    const results = searchPerson(person.name);
+    for (const r of results) {
+      rawParts.push(`${r.title}\n${r.body}`);
+      if (!sources.includes(r.url)) sources.push(r.url);
+    }
+  }
+
+  return [rawParts.join('\n\n'), sources];
+}
+
+// Show unread count
+try {
+  const count = unreadCount();
+  if (count > 0) console.log(c.yellow(`[${count} new change(s) - run 'vip digest' to view]`));
+} catch {}
+
+const program = new Command();
+program.name('vip').description('VIP Profile Builder - Auto-build VIP person profiles from public data').version('0.1.0');
+
+// --- add ---
+program.command('add')
+  .description('Add a new VIP profile')
+  .argument('<query>', 'Name or URL')
+  .option('-c, --company <company>', 'Company name')
+  .option('--dry-run', 'Print without saving')
+  .option('--no-ai', 'Skip AI synthesis')
+  .option('-f, --force', 'Overwrite existing')
+  .action(async (query, opts) => {
+    console.log(c.cyan(`Resolving ${query}...`));
+
+    let person;
+    if (isUrl(query)) {
+      const stop = spinner('Searching for profile...');
+      person = resolveFromUrl(query);
+      stop();
+      if (person.name) {
+        console.log(c.green(`  Found: ${person.name}`));
+        if (person.twitterHandle) console.log(`  Twitter: @${person.twitterHandle}`);
+        const stop2 = spinner('Enriching profile data...');
+        const enriched = resolveFromName(person.name);
+        stop2();
+        person.linkedinUrl = person.linkedinUrl || enriched.linkedinUrl;
+        const existing = new Set(person.rawSnippets);
+        for (const s of enriched.rawSnippets) if (!existing.has(s)) person.rawSnippets.push(s);
+        for (const u of enriched.otherUrls) if (!person.otherUrls.includes(u)) person.otherUrls.push(u);
+      }
+    } else {
+      const stop = spinner('Searching for profile...');
+      person = resolveFromName(query, opts.company);
+      stop();
+    }
+
+    if (!person.name) { console.error(c.red('Could not identify person.')); process.exit(1); }
+
+    console.log(c.green(`  Name: ${person.name}`));
+    if (person.twitterHandle) console.log(`  Twitter: @${person.twitterHandle}`);
+    if (person.linkedinUrl) console.log(`  LinkedIn: ${person.linkedinUrl}`);
+
+    if (!opts.force && profileExists(person.name)) {
+      console.log(`Profile for '${person.name}' already exists. Use -f to overwrite.`);
+      return;
+    }
+
+    console.log(c.cyan('Gathering data...'));
+    const [rawData, sources] = gatherData(person);
+    if (!rawData.trim()) { console.error(c.red('No data found.')); process.exit(1); }
+
+    let profile;
+    if (opts.ai === false) {
+      profile = `# ${person.name}\n\n## Raw Data\n\n${rawData}`;
+    } else {
+      const stop = spinner('Synthesizing profile with AI...');
+      try {
+        profile = await synthesizeProfile(rawData, sources);
+      } finally { stop(); }
+    }
+
+    if (opts.dryRun) {
+      console.log('\n' + '='.repeat(60));
+      console.log(profile);
+    } else {
+      const filepath = saveProfile(person.name, profile);
+      console.log(c.green(`\nProfile saved: ${filepath}`));
+    }
+  });
+
+// --- list ---
+program.command('list')
+  .description('List all VIP profiles')
+  .action(() => {
+    const profiles = listProfiles();
+    if (!profiles.length) { console.log(c.dim('No profiles yet. Use "vip add" to create one.')); return; }
+
+    const cols = process.stdout.columns || 80;
+    const nameW = Math.min(30, Math.max(15, cols / 4 | 0));
+    const dateW = 12;
+    const sumW = Math.max(20, cols - nameW - dateW - 4);
+
+    console.log(c.bold(c.cyan(`\n${'Name'.padEnd(nameW)} ${'Summary'.padEnd(sumW)} ${'Updated'.padEnd(dateW)}`)));
+    console.log('─'.repeat(nameW + sumW + dateW + 2));
+    for (const p of profiles) {
+      const name = p.name.slice(0, nameW - 1).padEnd(nameW);
+      const summary = c.dim(p.summary.slice(0, sumW - 1).padEnd(sumW));
+      console.log(`${name} ${summary} ${p.updated}`);
+    }
+    console.log(`\nTotal: ${profiles.length} profile(s)`);
+  });
+
+// --- show ---
+program.command('show')
+  .description('Show a VIP profile')
+  .argument('<name>')
+  .action((name) => {
+    const content = loadProfile(name);
+    if (!content) { console.error(c.red(`Profile not found: ${name}`)); process.exit(1); }
+
+    for (const line of content.split('\n')) {
+      if (line.startsWith('# ')) console.log(c.bold(c.cyan(line)));
+      else if (line.startsWith('## ')) console.log(c.bold(c.green(line)));
+      else if (line.startsWith('> ')) console.log(c.yellow(line));
+      else if (line.startsWith('---') || line.startsWith('*Last') || line.startsWith('*Sources')) console.log(c.dim(line));
+      else console.log(line);
+    }
+  });
+
+// --- search ---
+program.command('search')
+  .description('Search across all profiles')
+  .argument('<keyword>')
+  .action((keyword) => {
+    const results = searchProfiles(keyword);
+    if (!results.length) { console.log(c.dim(`No matches for '${keyword}'.`)); return; }
+
+    console.log(c.green(`Found ${results.length} profile(s) matching '${keyword}':\n`));
+    for (const r of results) {
+      console.log(c.bold(c.cyan(`  ${r.name}`)));
+      for (const m of r.matches) console.log(`    > ${m}`);
+      console.log();
+    }
+  });
+
+// --- open ---
+program.command('open')
+  .description('Open a profile in editor')
+  .argument('<name>')
+  .action((name) => {
+    const p = getProfilePath(name);
+    if (!fs.existsSync(p)) { console.error(c.red(`Profile not found: ${name}`)); process.exit(1); }
+    const editor = process.env.EDITOR || 'open';
+    exec(`${editor} "${p}"`);
+  });
+
+// --- update ---
+program.command('update')
+  .description('Refresh an existing profile')
+  .argument('<name>')
+  .option('--no-ai', 'Skip AI synthesis')
+  .action(async (name, opts) => {
+    const content = loadProfile(name);
+    if (!content) { console.error(c.red(`Profile not found: ${name}`)); process.exit(1); }
+
+    const { extractMetadata } = await import('../lib/monitor.js');
+    const meta = extractMetadata(content);
+    const personName = meta.name || name;
+
+    console.log(c.cyan(`Refreshing profile for ${personName}...`));
+    const stop = spinner('Resolving...');
+    const person = resolveFromName(personName);
+    stop();
+
+    if (meta.twitterHandle) person.twitterHandle = person.twitterHandle || meta.twitterHandle;
+    if (meta.linkedinUrl) person.linkedinUrl = person.linkedinUrl || meta.linkedinUrl;
+
+    const [rawData, sources] = gatherData(person);
+    if (!rawData.trim()) { console.log(c.yellow('No new data found.')); return; }
+
+    let profile;
+    if (opts.ai === false) {
+      profile = `# ${personName}\n\n## Raw Data\n\n${rawData}`;
+    } else {
+      const stop2 = spinner('Re-synthesizing profile...');
+      try { profile = await synthesizeProfile(rawData, sources); } finally { stop2(); }
+    }
+
+    const filepath = saveProfile(personName, profile);
+    console.log(c.green(`Profile updated: ${filepath}`));
+  });
+
+// --- rm ---
+program.command('rm')
+  .description('Delete a VIP profile')
+  .argument('<name>')
+  .option('-y, --yes', 'Skip confirmation')
+  .action((name, opts) => {
+    if (!loadProfile(name)) { console.error(c.red(`Profile not found: ${name}`)); process.exit(1); }
+    if (!opts.yes) { console.log('Use -y to confirm deletion.'); return; }
+    deleteProfile(name);
+    console.log(c.green(`Profile deleted: ${name}`));
+  });
+
+// --- edit ---
+program.command('edit')
+  .description('Edit profile fields')
+  .argument('<name>')
+  .option('--title <title>', 'Set job title')
+  .option('--company <company>', 'Set company')
+  .option('--twitter <handle>', 'Set Twitter handle')
+  .option('--linkedin <url>', 'Set LinkedIn URL')
+  .option('--note <note>', 'Append a note')
+  .action((name, opts) => {
+    let content = loadProfile(name);
+    if (!content) { console.error(c.red(`Profile not found: ${name}`)); process.exit(1); }
+
+    let modified = false;
+
+    if (opts.title) { content = content.replace(/(\*\*Title:\*\*) .+/, `$1 ${opts.title}`); modified = true; }
+    if (opts.company) { content = content.replace(/(\*\*Company:\*\*) .+/, `$1 ${opts.company}`); modified = true; }
+    if (opts.twitter) {
+      const handle = opts.twitter.replace(/^@/, '');
+      content = content.replace(/(Twitter:) .+/, `$1 https://twitter.com/${handle}`);
+      modified = true;
+    }
+    if (opts.linkedin) { content = content.replace(/(LinkedIn:) .+/, `$1 ${opts.linkedin}`); modified = true; }
+    if (opts.note) {
+      if (content.includes('## Notes')) {
+        content = content.replace('## Notes\n', `## Notes\n- ${opts.note}\n`);
+      } else if (content.includes('\n---\n')) {
+        content = content.replace('\n---\n', `\n## Notes\n- ${opts.note}\n\n---\n`);
+      } else {
+        content = content.trimEnd() + `\n\n## Notes\n- ${opts.note}\n`;
+      }
+      modified = true;
+    }
+
+    if (modified) { saveProfile(name, content); console.log(c.green('Profile updated.')); }
+    else console.log(c.yellow('No changes. Use --title, --company, --twitter, --linkedin, or --note.'));
+  });
+
+// --- digest ---
+program.command('digest')
+  .description('Show recent changes')
+  .action(() => {
+    const entries = readChangelog(30);
+    if (!entries.length) { console.log(c.dim('No recent changes.')); return; }
+
+    console.log(c.bold(c.cyan('Changes in the last 30 days:\n')));
+    for (const e of entries.reverse()) {
+      console.log(c.green(`  [${(e.timestamp || '').slice(0, 10)}] ${e.name}`));
+      console.log(`    ${e.summary}`);
+      console.log();
+    }
+  });
+
+// --- monitor ---
+const mon = program.command('monitor').description('Manage automatic monitoring');
+
+mon.command('start').description('Start monitoring').action(() => {
+  try { install(); const s = status(); console.log(c.green(`Monitor started (every ${s.intervalHours}h)`)); }
+  catch (e) { console.error(c.red(e.message)); process.exit(1); }
+});
+
+mon.command('stop').description('Stop monitoring').action(() => { uninstall(); console.log(c.green('Monitor stopped.')); });
+
+mon.command('status').description('Show status').action(() => {
+  const s = status();
+  console.log(`Status: ${s.running ? c.green('running') : c.red('stopped')}`);
+  console.log(`Interval: every ${s.intervalHours}h`);
+  console.log(`Installed: ${s.installed}`);
+  if (s.installed) console.log(`Plist: ${s.plistPath}`);
+});
+
+mon.command('run').description('Run monitoring now').option('-v, --verbose', 'Verbose').action(async (opts) => {
+  console.log(c.cyan('Running monitor...'));
+  const changes = await runMonitor(null, opts.verbose);
+  if (changes.length) {
+    console.log(c.green(`\n${changes.length} profile(s) updated:`));
+    for (const ch of changes) console.log(`  - ${ch.name}: ${ch.summary}`);
+  } else console.log(c.dim('No significant changes detected.'));
+});
+
+// --- config ---
+program.command('config')
+  .description('View/edit settings')
+  .action(() => {
+    const cfg = loadConfig();
+    console.log(c.bold(c.cyan('Current config:')));
+    console.log(`  Profiles dir: ${cfg.profiles_dir}`);
+    console.log(`  Monitor interval: ${cfg.monitor_interval_hours}h`);
+    console.log(`  Bird CLI: ${checkTool('bird') ? c.green('available') : c.red('not found')}`);
+    console.log(`  AI backend: ${(() => { const b = getBackendName(); return b !== 'none' ? c.green(b) : c.red('not found'); })()}`);
+  });
+
+program.parse();

package/lib/config.js

@@ -0,0 +1,48 @@
+import fs from 'fs';
+import path from 'path';
+import os from 'os';
+import { execSync } from 'child_process';
+
+const CONFIG_DIR = path.join(os.homedir(), '.vip-crm');
+const CONFIG_FILE = path.join(CONFIG_DIR, 'config.json');
+const CHANGELOG_FILE = path.join(CONFIG_DIR, 'changelog.jsonl');
+
+const DEFAULT_CONFIG = {
+  profiles_dir: path.join(os.homedir(), 'Projects', 'vip-crm', 'profiles'),
+  monitor_interval_hours: 24,
+};
+
+export { CONFIG_DIR, CONFIG_FILE, CHANGELOG_FILE };
+
+export function loadConfig() {
+  fs.mkdirSync(CONFIG_DIR, { recursive: true });
+
+  if (fs.existsSync(CONFIG_FILE)) {
+    const config = JSON.parse(fs.readFileSync(CONFIG_FILE, 'utf-8'));
+    return { ...DEFAULT_CONFIG, ...config };
+  }
+
+  saveConfig(DEFAULT_CONFIG);
+  return { ...DEFAULT_CONFIG };
+}
+
+export function saveConfig(config) {
+  fs.mkdirSync(CONFIG_DIR, { recursive: true });
+  fs.writeFileSync(CONFIG_FILE, JSON.stringify(config, null, 2));
+}
+
+export function getProfilesDir() {
+  const config = loadConfig();
+  const dir = config.profiles_dir.replace(/^~/, os.homedir());
+  fs.mkdirSync(dir, { recursive: true });
+  return dir;
+}
+
+export function checkTool(name) {
+  try {
+    execSync(`which ${name}`, { stdio: 'ignore' });
+    return true;
+  } catch {
+    return false;
+  }
+}

package/lib/fetchers/search.js

@@ -0,0 +1,73 @@
+import { execSync } from 'child_process';
+import { checkTool } from '../config.js';
+
+export function search(query, maxResults = 5) {
+  // Use ddgs CLI (installed via npm or pip)
+  if (checkTool('ddgs')) {
+    try {
+      const output = execSync(
+        `ddgs text "${query.replace(/"/g, '\\"')}" -m ${maxResults} -o json`,
+        { encoding: 'utf-8', timeout: 15000, stdio: ['pipe', 'pipe', 'pipe'] }
+      );
+
+      const results = JSON.parse(output);
+      return results.map(r => ({
+        title: r.title || '',
+        url: r.href || r.url || '',
+        body: r.body || '',
+      }));
+    } catch {
+      // fall through
+    }
+  }
+
+  // Fallback: use curl with DuckDuckGo lite
+  try {
+    const encoded = encodeURIComponent(query);
+    const output = execSync(
+      `curl -s "https://lite.duckduckgo.com/lite/?q=${encoded}" -H "User-Agent: VIPCare/0.1"`,
+      { encoding: 'utf-8', timeout: 10000, stdio: ['pipe', 'pipe', 'pipe'] }
+    );
+
+    // Basic parsing of DDG lite HTML results
+    const results = [];
+    const linkRegex = /<a[^>]+href="([^"]+)"[^>]*class="result-link"[^>]*>([^<]+)<\/a>/g;
+    const snippetRegex = /<td class="result-snippet">([^<]+)<\/td>/g;
+
+    let match;
+    while ((match = linkRegex.exec(output)) && results.length < maxResults) {
+      results.push({ title: match[2].trim(), url: match[1], body: '' });
+    }
+
+    let i = 0;
+    while ((match = snippetRegex.exec(output)) && i < results.length) {
+      results[i].body = match[1].trim();
+      i++;
+    }
+
+    return results;
+  } catch {
+    return [];
+  }
+}
+
+export function searchPerson(name, company) {
+  const queries = [`"${name}"`];
+  if (company) queries.push(`"${name}" "${company}"`);
+  queries.push(`"${name}" site:twitter.com OR site:x.com`);
+  queries.push(`"${name}" site:linkedin.com/in`);
+
+  const allResults = [];
+  const seenUrls = new Set();
+
+  for (const q of queries) {
+    for (const r of search(q, 5)) {
+      if (!seenUrls.has(r.url)) {
+        seenUrls.add(r.url);
+        allResults.push(r);
+      }
+    }
+  }
+
+  return allResults;
+}

package/lib/fetchers/twitter.js

@@ -0,0 +1,74 @@
+import { execSync } from 'child_process';
+import { checkTool } from '../config.js';
+
+export function isAvailable() {
+  return checkTool('bird');
+}
+
+export function parseTweets(output) {
+  const tweets = [];
+  let current = [];
+
+  for (const line of output.split('\n')) {
+    const stripped = line.trim();
+
+    if (/^[─━═]+$/.test(stripped) || !stripped) {
+      if (current.length) {
+        const text = current.join(' ').trim();
+        if (text.length > 5) tweets.push(text);
+        current = [];
+      }
+      continue;
+    }
+
+    if (/^\d+ (retweets?|likes?|replies|views)/i.test(stripped)) continue;
+    if (/^\d{4}-\d{2}-\d{2}/.test(stripped)) continue;
+
+    current.push(stripped);
+  }
+
+  if (current.length) {
+    const text = current.join(' ').trim();
+    if (text.length > 5) tweets.push(text);
+  }
+
+  return tweets;
+}
+
+export function fetchProfile(handle) {
+  if (!isAvailable()) return null;
+
+  handle = handle.replace(/^@/, '');
+  const data = { handle, bio: '', displayName: '', tweets: [], rawOutput: '' };
+
+  try {
+    const output = execSync(`bird search "from:${handle}" --count 10`, {
+      encoding: 'utf-8',
+      timeout: 30000,
+      stdio: ['pipe', 'pipe', 'pipe'],
+    });
+
+    if (output.trim()) {
+      data.rawOutput = output;
+      data.tweets = parseTweets(output);
+    }
+  } catch {
+    // timeout or not found
+  }
+
+  return data;
+}
+
+export function fetchTweetsByUrl(url) {
+  if (!isAvailable()) return null;
+
+  try {
+    return execSync(`bird read "${url}"`, {
+      encoding: 'utf-8',
+      timeout: 30000,
+      stdio: ['pipe', 'pipe', 'pipe'],
+    });
+  } catch {
+    return null;
+  }
+}

package/lib/fetchers/web.js

@@ -0,0 +1,29 @@
+export async function fetchPageText(url, timeout = 15000) {
+  try {
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), timeout);
+
+    const resp = await fetch(url, {
+      headers: { 'User-Agent': 'Mozilla/5.0 (compatible; VIPCare/0.1)' },
+      signal: controller.signal,
+    });
+
+    clearTimeout(timer);
+
+    if (!resp.ok) return '';
+
+    const html = await resp.text();
+    // Strip tags
+    let text = html
+      .replace(/<script[^>]*>[\s\S]*?<\/script>/gi, '')
+      .replace(/<style[^>]*>[\s\S]*?<\/style>/gi, '')
+      .replace(/<[^>]+>/g, ' ')
+      .replace(/\s+/g, ' ')
+      .trim();
+
+    if (text.length > 5000) text = text.slice(0, 5000) + '...';
+    return text;
+  } catch {
+    return '';
+  }
+}