vipcare 0.1.0 → 0.3.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