vipcare 0.1.0 → 0.2.0

package/CLAUDE.md

@@ -0,0 +1,58 @@
+# VIPCare
+
+## What is this?
+CLI tool that auto-builds VIP person profiles from Twitter, LinkedIn, and web search data, synthesized by AI into structured Markdown files.
+
+## Tech Stack
+- Node.js ESM, commander CLI
+- No build step, no bundler
+- Single dependency: commander
+
+## Project Structure
+```
+bin/vip.js              — CLI entry point, all command definitions
+lib/
+  config.js             — Config loading (~/.vip-crm/config.json), tool checks
+  profile.js            — CRUD for profile Markdown files in profiles/
+  resolver.js           — Parse input (name vs URL) into person object
+  fetchers/
+    twitter.js          — Twitter data via bird CLI
+    search.js           — Web search for person info
+    youtube.js          — YouTube transcript via yt-dlp + whisper
+  synthesizer.js        — AI synthesis (Claude CLI / Anthropic API / GitHub Copilot)
+  monitor.js            — Change detection and changelog
+  scheduler.js          — macOS launchd for auto-refresh
+  card.js               — H5 baseball card generator
+  templates.js          — Profile templates
+tests/                  — One test file per module
+profiles/               — Generated profile Markdown files
+web/                    — Card HTML output
+skill/                  — Claude Code slash command
+```
+
+## Dev Commands
+- `npm test` — run all tests (uses node:test with --experimental-test-module-mocks)
+- `npm publish` — publish to npm (requires npm auth token)
+- `node bin/vip.js <command>` — run CLI locally without installing
+
+## Architecture
+Input flows through a pipeline: **resolver** parses the input (name or URL) into a person object, **fetchers** (twitter, search, youtube) gather raw data from external sources, **synthesizer** sends the raw data to an AI backend to produce structured fields, **profile** saves the result as a Markdown file, and **card** can render profiles into an H5 baseball card page.
+
+## Conventions
+- All shell commands use `execFileSync` with arg arrays (never `execSync` with string interpolation) for security
+- ESM modules (`"type": "module"` in package.json)
+- Tests use node:test built-in runner with assert
+- Profile data stored as Markdown files in profiles/
+- Config at ~/.vip-crm/config.json
+- AI backends: Claude CLI, Anthropic API, GitHub Copilot (auto-detected in that order)
+
+## Adding a New Command
+1. Add command definition in bin/vip.js using commander
+2. Use existing helpers from lib/profile.js, lib/config.js
+3. Add --json flag for scripting support
+4. Add tests in tests/
+
+## Common Pitfalls
+- Must use --experimental-test-module-mocks flag for tests that mock modules
+- YouTube transcription requires Python + yt-dlp + whisper (optional dependency)
+- The `slugify` function returns 'unnamed' for empty/special-char-only inputs

package/README.md

@@ -42,6 +42,27 @@ vip rm sam-altman -y
 vip update sam-altman
 ```
 
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `vip add <name-or-url>` | Add a new profile (`-c` company, `-f` force, `--no-ai`, `--dry-run`, `-y` YouTube URLs) |
+| `vip list` | List all profiles |
+| `vip show <name>` | Display a profile |
+| `vip search <keyword>` | Search across all profiles |
+| `vip edit <name>` | Edit profile fields (`--title`, `--company`, `--twitter`, `--linkedin`, `--note`) |
+| `vip rm <name>` | Delete a profile (`-y` to confirm) |
+| `vip update <name>` | Refresh a profile with latest data |
+| `vip open <name>` | Open a profile in your editor |
+| `vip youtube <name> <url>` | Add YouTube video transcript to a profile |
+| `vip youtube-search <name>` | Search YouTube for a person's talks (`-n` max results) |
+| `vip card` | Generate H5 baseball card page (`-o` output path) |
+| `vip export` | Export all profiles for backup |
+| `vip import` | Restore profiles from backup |
+| `vip digest` | Show recent profile changes |
+| `vip monitor start\|stop\|status\|run` | Manage automatic profile refresh |
+| `vip config` | View settings |
+
 ## Features
 
 - **Auto profile building** — Give a name or URL, get a structured profile

package/bin/vip.js

@@ -3,15 +3,17 @@
 import { Command } from 'commander';
 import fs from 'fs';
 import os from 'os';
-import { execSync as exec } from 'child_process';
+import { execFileSync } 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 { deleteProfile, getProfilePath, listProfiles, loadProfile, profileExists, saveProfile, searchProfiles, slugify } 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 { appendChangelog, readChangelog, runMonitor, unreadCount } from '../lib/monitor.js';
 import { install, uninstall, status } from '../lib/scheduler.js';
+import * as youtube from '../lib/fetchers/youtube.js';
+import { generateCards, extractVipData } from '../lib/card.js';
 
 // Colors
 const c = {
@@ -73,7 +75,7 @@ try {
 } catch {}
 
 const program = new Command();
-program.name('vip').description('VIP Profile Builder - Auto-build VIP person profiles from public data').version('0.1.0');
+program.name('vip').description('VIP Profile Builder - Auto-build VIP person profiles from public data').version('0.2.0');
 
 // --- add ---
 program.command('add')
@@ -83,6 +85,7 @@ program.command('add')
   .option('--dry-run', 'Print without saving')
   .option('--no-ai', 'Skip AI synthesis')
   .option('-f, --force', 'Overwrite existing')
+  .option('-y, --youtube <urls...>', 'YouTube video URLs to transcribe')
   .action(async (query, opts) => {
     console.log(c.cyan(`Resolving ${query}...`));
 
@@ -120,7 +123,29 @@ program.command('add')
     }
 
     console.log(c.cyan('Gathering data...'));
-    const [rawData, sources] = gatherData(person);
+    let [rawData, sources] = gatherData(person);
+
+    // YouTube transcription
+    if (opts.youtube?.length) {
+      if (!youtube.isAvailable()) {
+        console.log(c.yellow('YouTube transcriber not available. Skipping videos.'));
+      } else {
+        for (const ytUrl of opts.youtube) {
+          const stop = spinner(`Transcribing video: ${ytUrl}...`);
+          try {
+            const yt = youtube.transcribeVideo(ytUrl);
+            stop();
+            console.log(c.green(`  Transcribed: ${yt.title}`));
+            rawData += `\n\n=== YouTube Video: ${yt.title} (${yt.url}) ===\n${yt.transcript}`;
+            sources.push(yt.url);
+          } catch (e) {
+            stop();
+            console.log(c.yellow(`  Failed: ${e.message}`));
+          }
+        }
+      }
+    }
+
     if (!rawData.trim()) { console.error(c.red('No data found.')); process.exit(1); }
 
     let profile;
@@ -139,14 +164,27 @@ program.command('add')
     } else {
       const filepath = saveProfile(person.name, profile);
       console.log(c.green(`\nProfile saved: ${filepath}`));
+      appendChangelog({
+        timestamp: new Date().toISOString(),
+        name: person.name,
+        slug: slugify(person.name),
+        type: 'created',
+        summary: `Profile created for ${person.name}`,
+      });
     }
   });
 
 // --- list ---
 program.command('list')
   .description('List all VIP profiles')
-  .action(() => {
+  .option('--json', 'Output as JSON')
+  .action((opts) => {
     const profiles = listProfiles();
+    if (opts.json) {
+      const data = profiles.map(p => ({ slug: p.slug, name: p.name, summary: p.summary, updated: p.updated, path: p.path }));
+      console.log(JSON.stringify(data, null, 2));
+      return;
+    }
     if (!profiles.length) { console.log(c.dim('No profiles yet. Use "vip add" to create one.')); return; }
 
     const cols = process.stdout.columns || 80;
@@ -168,10 +206,21 @@ program.command('list')
 program.command('show')
   .description('Show a VIP profile')
   .argument('<name>')
-  .action((name) => {
+  .option('--json', 'Output as JSON')
+  .action((name, opts) => {
     const content = loadProfile(name);
     if (!content) { console.error(c.red(`Profile not found: ${name}`)); process.exit(1); }
 
+    if (opts.json) {
+      const slug = slugify(name);
+      const nameMatch = content.match(/^# (.+)$/m);
+      const profileName = nameMatch ? nameMatch[1] : name;
+      const vipData = extractVipData(content);
+      const data = { slug, name: profileName, content, vipData: vipData || null };
+      console.log(JSON.stringify(data, null, 2));
+      return;
+    }
+
     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)));
@@ -185,8 +234,14 @@ program.command('show')
 program.command('search')
   .description('Search across all profiles')
   .argument('<keyword>')
-  .action((keyword) => {
+  .option('--json', 'Output as JSON')
+  .action((keyword, opts) => {
     const results = searchProfiles(keyword);
+    if (opts.json) {
+      const data = results.map(r => ({ slug: r.slug, name: r.name, matches: r.matches }));
+      console.log(JSON.stringify(data, null, 2));
+      return;
+    }
     if (!results.length) { console.log(c.dim(`No matches for '${keyword}'.`)); return; }
 
     console.log(c.green(`Found ${results.length} profile(s) matching '${keyword}':\n`));
@@ -205,7 +260,7 @@ program.command('open')
     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}"`);
+    execFileSync(editor, [p], { stdio: 'inherit' });
   });
 
 // --- update ---
@@ -256,6 +311,16 @@ program.command('rm')
     console.log(c.green(`Profile deleted: ${name}`));
   });
 
+function appendNote(content, note) {
+  if (content.includes('## Notes')) {
+    return content.replace('## Notes\n', `## Notes\n- ${note}\n`);
+  } else if (content.includes('\n---\n')) {
+    return content.replace('\n---\n', `\n## Notes\n- ${note}\n\n---\n`);
+  } else {
+    return content.trimEnd() + `\n\n## Notes\n- ${note}\n`;
+  }
+}
+
 // --- edit ---
 program.command('edit')
   .description('Edit profile fields')
@@ -271,14 +336,43 @@ program.command('edit')
 
     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.title) {
+      const before = content;
+      content = content.replace(/(\*\*Title:\*\*) .+/, `$1 ${opts.title}`);
+      if (content === before) {
+        console.log(c.yellow(`  Warning: Could not find Title field to update. Adding to notes instead.`));
+        content = appendNote(content, `Title: ${opts.title}`);
+      }
+      modified = true;
+    }
+    if (opts.company) {
+      const before = content;
+      content = content.replace(/(\*\*Company:\*\*) .+/, `$1 ${opts.company}`);
+      if (content === before) {
+        console.log(c.yellow(`  Warning: Could not find Company field to update. Adding to notes instead.`));
+        content = appendNote(content, `Company: ${opts.company}`);
+      }
+      modified = true;
+    }
     if (opts.twitter) {
       const handle = opts.twitter.replace(/^@/, '');
+      const before = content;
       content = content.replace(/(Twitter:) .+/, `$1 https://twitter.com/${handle}`);
+      if (content === before) {
+        console.log(c.yellow(`  Warning: Could not find Twitter field to update. Adding to notes instead.`));
+        content = appendNote(content, `Twitter: https://twitter.com/${handle}`);
+      }
+      modified = true;
+    }
+    if (opts.linkedin) {
+      const before = content;
+      content = content.replace(/(LinkedIn:) .+/, `$1 ${opts.linkedin}`);
+      if (content === before) {
+        console.log(c.yellow(`  Warning: Could not find LinkedIn field to update. Adding to notes instead.`));
+        content = appendNote(content, `LinkedIn: ${opts.linkedin}`);
+      }
       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`);
@@ -294,6 +388,75 @@ program.command('edit')
     else console.log(c.yellow('No changes. Use --title, --company, --twitter, --linkedin, or --note.'));
   });
 
+// --- youtube ---
+program.command('youtube')
+  .description('Add YouTube video transcript to existing profile')
+  .argument('<name>', 'Profile name')
+  .argument('<url>', 'YouTube video URL')
+  .action(async (name, url) => {
+    const content = loadProfile(name);
+    if (!content) { console.error(c.red(`Profile not found: ${name}`)); process.exit(1); }
+
+    if (!youtube.isAvailable()) {
+      console.error(c.red('YouTube transcriber not available.'));
+      process.exit(1);
+    }
+
+    const stop = spinner(`Transcribing: ${url}...`);
+    let yt;
+    try { yt = youtube.transcribeVideo(url); } finally { stop(); }
+    console.log(c.green(`  Transcribed: ${yt.title}`));
+
+    const { extractMetadata } = await import('../lib/monitor.js');
+    const meta = extractMetadata(content);
+
+    // Combine existing profile data with new transcript
+    const rawData = content + `\n\n=== YouTube Video: ${yt.title} (${yt.url}) ===\n${yt.transcript}`;
+    const sources = [yt.url];
+
+    const stop2 = spinner('Re-synthesizing profile...');
+    let profile;
+    try { profile = await synthesizeProfile(rawData, sources); } finally { stop2(); }
+
+    const filepath = saveProfile(meta.name || name, profile);
+    console.log(c.green(`Profile updated: ${filepath}`));
+  });
+
+// --- youtube-search ---
+program.command('youtube-search')
+  .description('Find YouTube videos for a person')
+  .argument('<name>', 'Person name')
+  .option('-n, --count <n>', 'Max results', '5')
+  .action((name, opts) => {
+    console.log(c.cyan(`Searching YouTube for ${name}...`));
+    const results = youtube.searchYouTubeVideos(name, parseInt(opts.count));
+
+    if (!results.length) { console.log(c.dim('No YouTube videos found.')); return; }
+
+    console.log(c.green(`Found ${results.length} video(s):\n`));
+    results.forEach((r, i) => {
+      console.log(`  ${c.bold(c.cyan(`${i + 1}.`))} ${r.title}`);
+      console.log(c.dim(`     ${r.url}`));
+      if (r.body) console.log(c.dim(`     ${r.body.slice(0, 100)}`));
+      console.log();
+    });
+    console.log(c.dim('Use: vip youtube <name> <url> to transcribe and add to profile'));
+  });
+
+// --- card ---
+program.command('card')
+  .description('Generate H5 baseball card page from all profiles')
+  .option('-o, --output <path>', 'Output HTML file', 'web/index.html')
+  .action((opts) => {
+    console.log(c.cyan('Generating baseball cards...'));
+    const profiles = listProfiles();
+    if (!profiles.length) { console.log(c.dim('No profiles. Use "vip add" first.')); return; }
+
+    const outputPath = generateCards(profiles, opts.output);
+    console.log(c.green(`Cards generated: ${outputPath}`));
+    console.log(c.dim(`Open in browser: open ${outputPath}`));
+  });
+
 // --- digest ---
 program.command('digest')
   .description('Show recent changes')
@@ -303,7 +466,8 @@ program.command('digest')
 
     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}`));
+      const label = e.type === 'created' ? c.cyan('[created]') : c.green('[updated]');
+      console.log(`  ${label} [${(e.timestamp || '').slice(0, 10)}] ${e.name}`);
       console.log(`    ${e.summary}`);
       console.log();
     }
@@ -348,4 +512,79 @@ program.command('config')
     console.log(`  AI backend: ${(() => { const b = getBackendName(); return b !== 'none' ? c.green(b) : c.red('not found'); })()}`);
   });
 
-program.parse();
+// --- export ---
+program.command('export')
+  .description('Export all profiles as JSON')
+  .option('-o, --output <file>', 'Write JSON to file instead of stdout')
+  .action((opts) => {
+    const profiles = listProfiles();
+    if (!profiles.length) { console.error(c.red('No profiles to export.')); process.exit(1); }
+
+    const exported = profiles.map(p => {
+      const content = loadProfile(p.slug);
+      const vipData = content ? extractVipData(content) : null;
+      return {
+        slug: p.slug,
+        filePath: p.path,
+        name: p.name,
+        summary: p.summary,
+        updated: p.updated,
+        vipData: vipData || null,
+        content: content || '',
+        exportedAt: new Date().toISOString(),
+      };
+    });
+
+    const json = JSON.stringify(exported, null, 2);
+
+    if (opts.output) {
+      fs.writeFileSync(opts.output, json, 'utf-8');
+      console.log(c.green(`Exported ${exported.length} profile(s) to ${opts.output}`));
+    } else {
+      process.stdout.write(json + '\n');
+    }
+  });
+
+// --- import ---
+program.command('import')
+  .description('Import profiles from a JSON export file')
+  .argument('<file>', 'JSON file to import')
+  .option('-f, --force', 'Overwrite existing profiles')
+  .action((file, opts) => {
+    if (!fs.existsSync(file)) { console.error(c.red(`File not found: ${file}`)); process.exit(1); }
+
+    let data;
+    try {
+      data = JSON.parse(fs.readFileSync(file, 'utf-8'));
+    } catch (e) {
+      console.error(c.red(`Invalid JSON: ${e.message}`));
+      process.exit(1);
+    }
+
+    if (!Array.isArray(data)) { console.error(c.red('Expected a JSON array of profiles.')); process.exit(1); }
+
+    let imported = 0;
+    let skipped = 0;
+    for (const entry of data) {
+      if (!entry.content || !entry.slug) {
+        console.log(c.yellow(`  Skipping entry: missing content or slug`));
+        skipped++;
+        continue;
+      }
+
+      const name = entry.name || entry.slug;
+      if (!opts.force && profileExists(name)) {
+        console.log(c.yellow(`  Skipping '${name}': already exists (use -f to overwrite)`));
+        skipped++;
+        continue;
+      }
+
+      saveProfile(name, entry.content);
+      imported++;
+      console.log(c.green(`  Imported: ${name}`));
+    }
+
+    console.log(`\nDone: ${imported} imported, ${skipped} skipped.`);
+  });
+
+program.parseAsync();