brignano 1.1.0 → 2.0.0

package/LICENSE

@@ -0,0 +1,15 @@
+ISC License
+
+Copyright (c) 2020-2026 Anthony Brignano
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

package/dist/card.js

@@ -1,33 +1,45 @@
 #!/usr/bin/env node
 import chalk from 'chalk';
-import inquirer from 'inquirer';
 import { animateBanner, renderBanner } from './banner.js';
 import { renderCard } from './cardBox.js';
 import { funFacts, pick, profile, taglines } from './data.js';
-import { clearConsole, isInteractive, parseFlags, shouldAnimate, shouldFetchLive, } from './env.js';
+import { clearConsole, isInteractive, parseFlags, readVersion, shouldAnimate, shouldFetchLive, unknownFlags, } from './env.js';
 import { fetchLive } from './live.js';
-import { buildChoices, sendEmail, viewResume } from './menu.js';
+import { promptForAction, sendEmail, viewResume } from './menu.js';
 import { renderQr } from './qrcode.js';
 import { reveal, sleep } from './reveal.js';
 import { writeAndOpenVCard } from './vcard.js';
 function printHelp() {
     console.log('\nUsage: npx brignano [options]\n');
     console.log('Options:');
-    console.log('  -h, --help        Show this help');
-    console.log('  -v, --view        Open my resume in your browser');
-    console.log('  -e, --email       Open your mail client to email me');
-    console.log('      --qr          Print a scannable QR code to my website');
-    console.log('      --vcard       Save my contact card (.vcf) and open it');
+    console.log('  -h, --help          Show this help');
+    console.log('  -v, --version       Print the version and exit');
+    console.log('  -r, --view          Open my resume in your browser');
+    console.log('  -e, --email         Open your mail client to email me');
+    console.log('      --qr            Print a scannable QR code to my website');
+    console.log('      --vcard         Save my contact card (.vcf) and open it');
     console.log('      --no-animation  Render instantly, skip the reveal animation');
-    console.log('      --no-prompt   Show the card only (non-interactive)');
-    console.log('  -d, --download    Deprecated alias for --view\n');
+    console.log('      --no-prompt     Show the card only (non-interactive)');
+    console.log('  -d, --download      Deprecated alias for --view\n');
 }
 async function main() {
     const argv = process.argv.slice(2);
+    // Reject typos loudly rather than silently rendering the default card.
+    const unknown = unknownFlags(argv);
+    if (unknown.length > 0) {
+        console.error(`Unknown option: ${unknown.join(', ')}`);
+        console.error("Run 'npx brignano --help' to see the available options.");
+        process.exitCode = 1;
+        return;
+    }
     const flags = parseFlags(argv);
     // Direct-action flags short-circuit the full experience.
     if (flags.help)
         return printHelp();
+    if (flags.version) {
+        console.log(readVersion());
+        return;
+    }
     if (flags.view || flags.download) {
         if (flags.download) {
             console.warn('Note: --download is deprecated; opening the resume instead.');
@@ -66,18 +78,15 @@ async function main() {
     console.log(chalk.gray(`     ${pick(funFacts)}\n`));
     if (!interactive)
         return;
-    const prompt = inquirer.createPromptModule();
-    const { action } = await prompt([
-        {
-            type: 'list',
-            name: 'action',
-            message: 'What would you like to do?',
-            choices: buildChoices(),
-        },
-    ]);
+    const action = await promptForAction();
     await action();
 }
 main().catch((err) => {
+    // Ctrl+C / Esc at the menu is a normal way to leave, not a crash.
+    if (err instanceof Error && err.name === 'ExitPromptError') {
+        console.log('\nHave a great day!\n');
+        return;
+    }
     const message = err instanceof Error ? err.message : String(err);
     console.error(`Something went wrong: ${message}`);
     process.exitCode = 1;

package/dist/data.js

@@ -29,6 +29,9 @@ export const funFacts = [
     'The live stats above are pulled fresh from GitHub (with a strict timeout).',
 ];
 // Deterministic-enough pick without Math.random (kept simple + dependency-free).
+// The `?? items[0]` fallback is unreachable for a NonEmpty list, but it keeps the
+// return type honest under `noUncheckedIndexedAccess` without an assertion.
 export function pick(items, seed = Date.now()) {
-    return items[Math.floor(seed / 1000) % items.length];
+    const index = Math.floor(seed / 1000) % items.length;
+    return items[index] ?? items[0];
 }

package/dist/env.js

@@ -1,22 +1,59 @@
 // Environment + capability detection. Keeps the render logic free of scattered
 // `process.stdout.isTTY` checks and guarantees CI / piped output never hangs.
+import { readFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+// Every accepted token, grouped by the flag it sets. Also drives unknown-flag
+// detection below, so adding a flag here is the only edit needed.
+const FLAG_ALIASES = {
+    help: ['--help', '-h'],
+    version: ['--version', '-v', '-V'],
+    view: ['--view', '--resume', '-r'],
+    download: ['--download', '-d'],
+    email: ['--email', '-e'],
+    qr: ['--qr'],
+    vcard: ['--vcard', '--save-contact'],
+    noPrompt: ['--no-prompt', '--quiet'],
+    noAnimation: ['--no-animation'],
+};
+const KNOWN_TOKENS = new Set(Object.values(FLAG_ALIASES).flat());
 export function hasFlag(argv, names) {
     return names.some((n) => argv.includes(n));
 }
 export function parseFlags(argv) {
     return {
-        help: hasFlag(argv, ['--help', '-h']),
-        view: hasFlag(argv, ['--view', '-v']),
-        download: hasFlag(argv, ['--download', '-d']),
-        email: hasFlag(argv, ['--email', '-e']),
-        qr: hasFlag(argv, ['--qr']),
-        vcard: hasFlag(argv, ['--vcard', '--save-contact']),
-        noPrompt: hasFlag(argv, ['--no-prompt', '--quiet']),
-        noAnimation: hasFlag(argv, ['--no-animation']),
+        help: hasFlag(argv, FLAG_ALIASES.help),
+        version: hasFlag(argv, FLAG_ALIASES.version),
+        view: hasFlag(argv, FLAG_ALIASES.view),
+        download: hasFlag(argv, FLAG_ALIASES.download),
+        email: hasFlag(argv, FLAG_ALIASES.email),
+        qr: hasFlag(argv, FLAG_ALIASES.qr),
+        vcard: hasFlag(argv, FLAG_ALIASES.vcard),
+        noPrompt: hasFlag(argv, FLAG_ALIASES.noPrompt),
+        noAnimation: hasFlag(argv, FLAG_ALIASES.noAnimation),
     };
 }
+// Anything that looks like a flag but isn't one we accept. Returned rather than
+// thrown so the caller decides how loudly to complain.
+export function unknownFlags(argv) {
+    return argv.filter((arg) => arg.startsWith('-') && !KNOWN_TOKENS.has(arg));
+}
+// Read the version straight from the published package.json. It isn't in the
+// `files` list, but npm always ships package.json, and it sits one level above
+// the compiled dist/ directory.
+export function readVersion() {
+    try {
+        const here = dirname(fileURLToPath(import.meta.url));
+        const raw = readFileSync(join(here, '..', 'package.json'), 'utf8');
+        const pkg = JSON.parse(raw);
+        return typeof pkg.version === 'string' ? pkg.version : 'unknown';
+    }
+    catch {
+        return 'unknown';
+    }
+}
 const isCI = () => Boolean(process.env.CI);
-// True only when we can safely show an interactive inquirer prompt.
+// True only when we can safely show an interactive prompt.
 export function isInteractive(flags) {
     return Boolean(process.stdout.isTTY && process.stdin.isTTY && !isCI() && !flags.noPrompt);
 }

package/dist/live.js

@@ -16,7 +16,10 @@ export async function fetchLive(timeoutMs = 1500) {
                 headers: HEADERS,
                 signal: controller.signal,
             }),
-            fetch(`${API}/users/${profile.username}/repos?sort=updated&per_page=1`, { headers: HEADERS, signal: controller.signal }),
+            fetch(`${API}/users/${profile.username}/repos?sort=updated&per_page=1`, {
+                headers: HEADERS,
+                signal: controller.signal,
+            }),
         ]);
         if (!userRes.ok || !reposRes.ok)
             return null;

package/dist/menu.js

@@ -1,3 +1,4 @@
+import { select } from '@inquirer/prompts';
 import chalk from 'chalk';
 import clipboard from 'clipboardy';
 import open from 'open';
@@ -71,3 +72,15 @@ export function buildChoices() {
         },
     ];
 }
+// Shows the action menu and returns the chosen handler. Ctrl+C / Esc throws an
+// `ExitPromptError`, which the entry point treats as a normal exit.
+export async function promptForAction() {
+    const choices = buildChoices();
+    return select({
+        message: 'What would you like to do?',
+        choices,
+        // Default page size is 7, which would hide the last entry behind a scroll.
+        // Show every action at once — the list is short and fixed.
+        pageSize: choices.length,
+    });
+}

package/package.json

@@ -1,18 +1,22 @@
 {
   "name": "brignano",
-  "version": "1.1.0",
+  "version": "2.0.0",
   "type": "module",
-  "main": "dist/card.js",
   "engines": {
     "node": ">=20"
   },
   "bin": {
     "brignano": "dist/card.js"
   },
+  "files": [
+    "dist"
+  ],
   "scripts": {
     "build": "tsc",
-    "dev": "ts-node --esm src/card.ts",
+    "dev": "tsx src/card.ts",
     "start": "node dist/card.js",
+    "lint": "biome check .",
+    "format": "biome check --write .",
     "test": "node dist/card.js --no-prompt",
     "prepare": "npm run build"
   },
@@ -35,22 +39,25 @@
     "vcard"
   ],
   "description": "A personal card for Anthony Brignano (@brignano)",
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
   "dependencies": {
-    "boxen": "^6.0.0",
-    "chalk": "^5.2.0",
-    "clipboardy": "^5.0.0",
-    "figlet": "^1.11.0",
+    "@inquirer/prompts": "^8.6.0",
+    "boxen": "^8.0.1",
+    "chalk": "^6.0.0",
+    "clipboardy": "^5.3.2",
+    "figlet": "^1.11.4",
     "gradient-string": "^3.0.0",
-    "inquirer": "^9.2.7",
-    "open": "^8.4.0",
+    "open": "^11.0.1",
     "qrcode-terminal": "^0.12.0"
   },
   "devDependencies": {
-    "ts-node": "^10.9.1",
-    "typescript": "^5.1.6",
-    "@types/node": "^20.5.1",
-    "@types/inquirer": "^9.0.3",
+    "@biomejs/biome": "^2.5.10",
     "@types/figlet": "^1.7.0",
-    "@types/gradient-string": "^1.1.6"
+    "@types/node": "^22.20.1",
+    "tsx": "^4.23.12",
+    "typescript": "^5.9.3"
   }
 }

package/readme.md

@@ -1,4 +1,9 @@
-# npx-brignano <a href="#"><img src="https://img.shields.io/badge/-npx%20brignano-white?style=flat-square&logo=npm&logoColor=grey" align="right" alt="npm Badge"></img></a>
+# npx-brignano
+
+[![npm version](https://img.shields.io/npm/v/brignano?style=flat-square&logo=npm&color=8b5cf6)](https://www.npmjs.com/package/brignano)
+[![npm downloads](https://img.shields.io/npm/dm/brignano?style=flat-square&color=8b5cf6)](https://www.npmjs.com/package/brignano)
+[![CI](https://img.shields.io/github/actions/workflow/status/brignano/npx-brignano/ci.yml?branch=main&style=flat-square&label=ci)](https://github.com/brignano/npx-brignano/actions/workflows/ci.yml)
+[![license](https://img.shields.io/npm/l/brignano?style=flat-square&color=8b5cf6)](LICENSE)
 
 An interactive terminal business card for Anthony Brignano. Run it with `npx` to get a gradient ASCII-art intro, a styled card with **live GitHub stats**, and quick actions — copy my email, open my socials, save my contact, or grab a scannable QR code.
 
@@ -33,7 +38,8 @@ Run `npx brignano --help` to see this list.
 | Flag | Description |
 |------|-------------|
 | `-h, --help` | Show help and exit. |
-| `-v, --view` | Open my resume in your default browser (`https://brignano.io/resume`). |
+| `-v, --version` | Print the installed version and exit. |
+| `-r, --view` / `--resume` | Open my resume in your default browser (`https://brignano.io/resume`). |
 | `-e, --email` | Open your mail client with a new message to `hi@brignano.io`. |
 | `--qr` | Print a scannable QR code to my website and exit. |
 | `--vcard` / `--save-contact` | Save my contact card (`.vcf`) and open it. |
@@ -41,11 +47,19 @@ Run `npx brignano --help` to see this list.
 | `--no-prompt` | Show the card only and exit (non-interactive). |
 | `-d, --download` | Deprecated alias for `--view`. |
 
+Unrecognized flags exit with a non-zero status instead of silently falling back
+to the default card.
+
+> **Note:** as of `2.0.0`, `-v` prints the version (the near-universal CLI
+> convention). The resume now lives at `-r`, and the long `--view` flag is
+> unchanged.
+
 ### Examples
 
 ```bash
 npx brignano              # full interactive experience
 npx brignano --view       # jump straight to my resume
+npx brignano --version    # print the version
 npx brignano --qr         # print a QR code to my site
 npx brignano --vcard      # save my contact card
 npx brignano --no-prompt  # card only (useful in CI/scripts)
@@ -61,7 +75,13 @@ npm run build
 node dist/card.js
 ```
 
-Source lives in `src/` (split into small modules — `card.ts` is the entry/`bin` target) and compiles to `dist/` via `tsc`.
+Source lives in `src/` (split into small modules — `card.ts` is the entry/`bin`
+target) and compiles to `dist/` via `tsc`. `npm run dev` runs the TypeScript
+directly through `tsx`; `npm run lint` and `npm run format` use
+[Biome](https://biomejs.dev).
+
+Only `dist/` is published — the tarball is ~8 kB, so `npx brignano` stays a fast
+cold start.
 
 ## Prerequisites
 
@@ -78,4 +98,4 @@ Inspired by [anmol098/npx_card](https://github.com/anmol098/npx_card).
 
 ## License
 
-See `package.json` for license information.
+[ISC](LICENSE) © Anthony Brignano

package/.github/workflows/ci.yml

@@ -1,29 +0,0 @@
-name: CI
-
-on:
-  pull_request:
-    paths:
-      - '**/*.ts'
-      - '*.json'
-      - '.github/workflows/ci.yml'
-
-jobs:
-  build:
-    runs-on: ubuntu-latest
-    strategy:
-      matrix:
-        node-version: [20.x, 22.x, 24.x]
-    steps:
-      - uses: actions/checkout@v6
-      - name: Use Node.js ${{ matrix.node-version }}
-        uses: actions/setup-node@v6
-        with:
-          node-version: ${{ matrix.node-version }}
-      - name: Install dependencies
-        run: npm ci
-      - name: Build
-        run: npm run build
-      - name: Test (non-interactive)
-        run: npm test
-        env:
-          CI: true

package/.github/workflows/publish.yml

@@ -1,32 +0,0 @@
-# This workflow will run tests using node and then publish a package to GitHub Packages when a release is created
-# For more information see: https://docs.github.com/en/actions/publishing-packages/publishing-nodejs-packages
-
-name: Publish Package
-
-on:
-  workflow_dispatch:
-  release:
-    types: [created]
-
-jobs:
-  publish:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v6
-      - name: Use Node.js
-        uses: actions/setup-node@v6
-        with:
-          node-version: '22.x'
-          registry-url: 'https://registry.npmjs.org'
-      - name: Install & Build
-        run: |
-          npm ci
-          npm run build
-      - name: Test (non-interactive)
-        run: npm test
-        env:
-          CI: true
-      - name: Publish to npm
-        env:
-          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
-        run: npm publish --access public

package/src/banner.ts

@@ -1,66 +0,0 @@
-import figlet from 'figlet';
-import gradient from 'gradient-string';
-import { sleep } from './reveal.js';
-
-// Brand palette — matches brignano.io's electric indigo/violet accent
-// (violet-700 → violet-500 → violet-400). Reads well on a dark terminal.
-const BRAND = ['#6d28d9', '#8b5cf6', '#a78bfa'];
-
-// A longer ramp with a bright crest (violet-300) used for the shimmer sweep.
-const SHIMMER = [
-  '#5b21b6',
-  '#6d28d9',
-  '#7c3aed',
-  '#8b5cf6',
-  '#a78bfa',
-  '#c4b5fd',
-  '#a78bfa',
-  '#8b5cf6',
-  '#7c3aed',
-  '#6d28d9',
-];
-
-function bannerArt(text: string): string {
-  try {
-    return figlet.textSync(text, { font: 'ANSI Shadow' });
-  } catch {
-    return text.toUpperCase();
-  }
-}
-
-function paint(colors: string[], art: string): string {
-  try {
-    return gradient(colors).multiline(art);
-  } catch {
-    return art;
-  }
-}
-
-// Static gradient banner (used for the non-animated path).
-export function renderBanner(text = 'brignano'): string {
-  return paint(BRAND, bannerArt(text));
-}
-
-// Animated splash: a violet highlight sweeps across the letters, then settles on
-// the static brand gradient. Redraws in place via ANSI cursor moves, so it must
-// only be called on a TTY (the caller gates this behind `shouldAnimate`).
-export async function animateBanner(
-  text = 'brignano',
-  frames = 14,
-  frameMs = 70,
-): Promise<void> {
-  const art = bannerArt(text);
-  const lineCount = art.split('\n').length;
-
-  for (let i = 0; i < frames; i++) {
-    const offset = i % SHIMMER.length;
-    const rotated = SHIMMER.slice(offset).concat(SHIMMER.slice(0, offset));
-    if (i > 0) process.stdout.write(`\u001b[${lineCount}A`);
-    process.stdout.write(`\r${paint(rotated, art)}\n`);
-    await sleep(frameMs);
-  }
-
-  // Settle on the canonical brand gradient.
-  process.stdout.write(`\u001b[${lineCount}A`);
-  process.stdout.write(`${renderBanner(text)}\n`);
-}

package/src/card.ts

@@ -1,98 +0,0 @@
-#!/usr/bin/env node
-
-import chalk from 'chalk';
-import inquirer from 'inquirer';
-import { animateBanner, renderBanner } from './banner.js';
-import { renderCard } from './cardBox.js';
-import { funFacts, pick, profile, taglines } from './data.js';
-import {
-  clearConsole,
-  isInteractive,
-  parseFlags,
-  shouldAnimate,
-  shouldFetchLive,
-} from './env.js';
-import { fetchLive } from './live.js';
-import { buildChoices, sendEmail, viewResume } from './menu.js';
-import { renderQr } from './qrcode.js';
-import { reveal, sleep } from './reveal.js';
-import { writeAndOpenVCard } from './vcard.js';
-
-function printHelp(): void {
-  console.log('\nUsage: npx brignano [options]\n');
-  console.log('Options:');
-  console.log('  -h, --help        Show this help');
-  console.log('  -v, --view        Open my resume in your browser');
-  console.log('  -e, --email       Open your mail client to email me');
-  console.log('      --qr          Print a scannable QR code to my website');
-  console.log('      --vcard       Save my contact card (.vcf) and open it');
-  console.log('      --no-animation  Render instantly, skip the reveal animation');
-  console.log('      --no-prompt   Show the card only (non-interactive)');
-  console.log('  -d, --download    Deprecated alias for --view\n');
-}
-
-async function main(): Promise<void> {
-  const argv = process.argv.slice(2);
-  const flags = parseFlags(argv);
-
-  // Direct-action flags short-circuit the full experience.
-  if (flags.help) return printHelp();
-  if (flags.view || flags.download) {
-    if (flags.download) {
-      console.warn('Note: --download is deprecated; opening the resume instead.');
-    }
-    return viewResume();
-  }
-  if (flags.email) return sendEmail();
-  if (flags.qr) {
-    console.log(await renderQr(profile.website));
-    console.log(chalk.gray(`  ${profile.website}\n`));
-    return;
-  }
-  if (flags.vcard) return writeAndOpenVCard();
-
-  const animate = shouldAnimate(flags);
-  const interactive = isInteractive(flags);
-
-  // Kick off the live fetch early (don't await yet) so its timeout budget
-  // overlaps the banner render. Skipped entirely when non-interactive/CI.
-  const livePromise = shouldFetchLive(flags) ? fetchLive() : Promise.resolve(null);
-
-  clearConsole();
-
-  // Banner first: an animated violet shimmer when we can animate, otherwise the
-  // static gradient.
-  if (animate) {
-    await animateBanner();
-    await sleep(120);
-  } else {
-    console.log(renderBanner());
-  }
-
-  // Card, enriched with whatever the (bounded) live fetch returned.
-  const live = await livePromise;
-  const tagline = pick(taglines);
-  await reveal(renderCard({ live, tagline }), 30, animate);
-
-  console.log(`Tip: ${chalk.cyanBright.bold('cmd/ctrl + click')} the links above.`);
-  console.log(chalk.gray(`     ${pick(funFacts)}\n`));
-
-  if (!interactive) return;
-
-  const prompt = inquirer.createPromptModule();
-  const { action } = await prompt([
-    {
-      type: 'list',
-      name: 'action',
-      message: 'What would you like to do?',
-      choices: buildChoices(),
-    },
-  ]);
-  await action();
-}
-
-main().catch((err: unknown) => {
-  const message = err instanceof Error ? err.message : String(err);
-  console.error(`Something went wrong: ${message}`);
-  process.exitCode = 1;
-});

package/src/cardBox.ts

@@ -1,64 +0,0 @@
-import boxen from 'boxen';
-import chalk from 'chalk';
-import { profile } from './data.js';
-import type { LiveData } from './live.js';
-
-// Right-aligns labels to a common width so the values line up cleanly.
-const LABEL_WIDTH = 10;
-function label(text: string): string {
-  return chalk.white.bold(text.padStart(LABEL_WIDTH) + ':');
-}
-
-interface CardOptions {
-  live?: LiveData | null;
-  tagline: string;
-}
-
-// Builds the boxen business card. `live` is optional — when absent the live
-// line is simply omitted, so the card looks intentional with or without network.
-export function renderCard({ live, tagline }: CardOptions): string {
-  // Violet accent matches brignano.io (violet-400 #a78bfa on dark).
-  const accent = chalk.hex('#a78bfa');
-  const lines = [
-    accent.bold(profile.fullName) + '  ' + chalk.gray(profile.handle),
-    '',
-    `${label('Work')}  ${profile.title} ${chalk.gray('at')} ${chalk
-      .hex('#3A5A78')
-      .bold(profile.org)}`,
-    '',
-    `${label('GitHub')}  ${chalk.gray('https://github.com/')}${chalk.green(
-      profile.username,
-    )}`,
-    `${label('LinkedIn')}  ${chalk.gray('https://linkedin.com/in/')}${chalk.blue(
-      profile.username,
-    )}`,
-    `${label('Website')}  ${chalk.cyan(profile.website)}`,
-  ];
-
-  if (live) {
-    lines.push('');
-    const parts = [
-      `${chalk.yellow('★')} ${chalk.bold(live.followers)} followers`,
-      `${chalk.bold(live.publicRepos)} repos`,
-    ];
-    if (live.latestRepo) {
-      parts.push(`latest: ${chalk.green(live.latestRepo.name)}`);
-    }
-    lines.push(`${label('Live')}  ${chalk.gray(parts.join(' · '))}`);
-  }
-
-  lines.push(
-    '',
-    `${label('Card')}  ${chalk.red('npx')} ${chalk.white('brignano')}`,
-    '',
-    chalk.italic(tagline),
-  );
-
-  return boxen(lines.join('\n'), {
-    margin: 1,
-    float: 'center',
-    padding: 1,
-    borderStyle: 'round',
-    borderColor: 'gray',
-  });
-}

package/src/data.ts

@@ -1,38 +0,0 @@
-// Single source of truth for everything the card, vCard, QR and live modules need.
-// Plain (uncolored) values live here; chalk styling is applied at render time.
-
-export const profile = {
-  firstName: 'Anthony',
-  lastName: 'Brignano',
-  fullName: 'Anthony Brignano',
-  handle: '@brignano',
-  username: 'brignano',
-  title: 'Senior Staff Software Engineer',
-  org: 'The Hartford',
-  email: 'hi@brignano.io',
-  website: 'https://brignano.io',
-  resume: 'https://brignano.io/resume',
-  github: 'https://github.com/brignano',
-  linkedin: 'https://linkedin.com/in/brignano',
-} as const;
-
-// Rotating taglines — one is picked per run so repeat visitors see variety.
-export const taglines: string[] = [
-  'My inbox is always open. Ask a question or just say hi — I read everything.',
-  'Building reliable systems, mentoring engineers, and shipping things that last.',
-  "If it's worth automating, it's worth a clean abstraction. Let's build.",
-  'Self-hoster, spec-driven, and unreasonably fond of a tidy terminal.',
-  'Good engineering is mostly good taste applied consistently. Say hello.',
-];
-
-// Small easter-egg facts, shown occasionally below the card.
-export const funFacts: string[] = [
-  'This card is open source — `npx brignano --help` shows every trick.',
-  'Tip: scan the QR with your phone to save my contact instantly.',
-  'The live stats above are pulled fresh from GitHub (with a strict timeout).',
-];
-
-// Deterministic-enough pick without Math.random (kept simple + dependency-free).
-export function pick<T>(items: readonly T[], seed = Date.now()): T {
-  return items[Math.floor(seed / 1000) % items.length];
-}

package/src/env.ts

@@ -1,69 +0,0 @@
-// Environment + capability detection. Keeps the render logic free of scattered
-// `process.stdout.isTTY` checks and guarantees CI / piped output never hangs.
-
-export interface Flags {
-  help: boolean;
-  view: boolean;
-  download: boolean;
-  email: boolean;
-  qr: boolean;
-  vcard: boolean;
-  noPrompt: boolean;
-  noAnimation: boolean;
-}
-
-export function hasFlag(argv: string[], names: string[]): boolean {
-  return names.some((n) => argv.includes(n));
-}
-
-export function parseFlags(argv: string[]): Flags {
-  return {
-    help: hasFlag(argv, ['--help', '-h']),
-    view: hasFlag(argv, ['--view', '-v']),
-    download: hasFlag(argv, ['--download', '-d']),
-    email: hasFlag(argv, ['--email', '-e']),
-    qr: hasFlag(argv, ['--qr']),
-    vcard: hasFlag(argv, ['--vcard', '--save-contact']),
-    noPrompt: hasFlag(argv, ['--no-prompt', '--quiet']),
-    noAnimation: hasFlag(argv, ['--no-animation']),
-  };
-}
-
-const isCI = (): boolean => Boolean(process.env.CI);
-
-// True only when we can safely show an interactive inquirer prompt.
-export function isInteractive(flags: Flags): boolean {
-  return Boolean(
-    process.stdout.isTTY && process.stdin.isTTY && !isCI() && !flags.noPrompt,
-  );
-}
-
-// True only when the reveal animation should play.
-export function shouldAnimate(flags: Flags): boolean {
-  return Boolean(
-    process.stdout.isTTY &&
-      !isCI() &&
-      !flags.noPrompt &&
-      !flags.noAnimation &&
-      !process.env.NO_COLOR,
-  );
-}
-
-// True only when we should spend time on a live network fetch.
-export function shouldFetchLive(flags: Flags): boolean {
-  return isInteractive(flags);
-}
-
-export function clearConsole(): void {
-  const out = process.stdout as NodeJS.WriteStream & { clear?: () => void };
-  if (typeof out.clear === 'function') {
-    try {
-      out.clear();
-    } catch {
-      /* ignore */
-    }
-  }
-  if (process.stdout.isTTY) {
-    process.stdout.write('\u001b[2J\u001b[0f');
-  }
-}

package/src/live.ts

@@ -1,58 +0,0 @@
-import { profile } from './data.js';
-
-export interface LiveData {
-  followers: number;
-  publicRepos: number;
-  latestRepo?: { name: string; url: string };
-}
-
-const API = 'https://api.github.com';
-const HEADERS = {
-  'User-Agent': 'npx-brignano',
-  Accept: 'application/vnd.github+json',
-};
-
-// Fetches live GitHub stats with a hard timeout. ANY failure (timeout, offline,
-// non-200, rate-limit, parse error) resolves to null — this never throws and
-// never blocks the card for longer than `timeoutMs`.
-export async function fetchLive(timeoutMs = 1500): Promise<LiveData | null> {
-  const controller = new AbortController();
-  const timer = setTimeout(() => controller.abort(), timeoutMs);
-  try {
-    const [userRes, reposRes] = await Promise.all([
-      fetch(`${API}/users/${profile.username}`, {
-        headers: HEADERS,
-        signal: controller.signal,
-      }),
-      fetch(
-        `${API}/users/${profile.username}/repos?sort=updated&per_page=1`,
-        { headers: HEADERS, signal: controller.signal },
-      ),
-    ]);
-
-    if (!userRes.ok || !reposRes.ok) return null;
-
-    const user = (await userRes.json()) as {
-      followers?: number;
-      public_repos?: number;
-    };
-    const repos = (await reposRes.json()) as Array<{
-      name?: string;
-      html_url?: string;
-    }>;
-
-    const latest = Array.isArray(repos) ? repos[0] : undefined;
-    return {
-      followers: user.followers ?? 0,
-      publicRepos: user.public_repos ?? 0,
-      latestRepo:
-        latest?.name && latest?.html_url
-          ? { name: latest.name, url: latest.html_url }
-          : undefined,
-    };
-  } catch {
-    return null;
-  } finally {
-    clearTimeout(timer);
-  }
-}

package/src/menu.ts

@@ -1,84 +0,0 @@
-import chalk from 'chalk';
-import clipboard from 'clipboardy';
-import open from 'open';
-import { profile } from './data.js';
-import { renderQr } from './qrcode.js';
-import { buildVCard, writeAndOpenVCard } from './vcard.js';
-
-// --- Action helpers (kept as named functions so flags and the menu share them) ---
-
-export async function copyEmail(): Promise<void> {
-  try {
-    await clipboard.write(profile.email);
-    console.log(`\n${chalk.green('Copied')} ${profile.email} to your clipboard.\n`);
-  } catch {
-    // Clipboard access fails in headless/SSH environments — degrade gracefully.
-    console.log(`\nMy email is ${chalk.green(profile.email)} — drop me a line!\n`);
-  }
-}
-
-export async function sendEmail(): Promise<void> {
-  try {
-    await open(`mailto:${profile.email}`);
-    console.log('\nOpened your mail client — see you in the inbox.\n');
-  } catch (err) {
-    const message = err instanceof Error ? err.message : String(err);
-    console.error(`Failed to open mail client: ${message}`);
-    console.error(`Reach me directly at ${profile.email}`);
-  }
-}
-
-export async function openUrl(url: string, label: string): Promise<void> {
-  try {
-    await open(url);
-    console.log(`\nOpened ${label}: ${url}\n`);
-  } catch (err) {
-    const message = err instanceof Error ? err.message : String(err);
-    console.error(`Failed to open ${label}: ${message}`);
-    console.error(`Here it is: ${url}`);
-  }
-}
-
-export async function viewResume(): Promise<void> {
-  await openUrl(profile.resume, 'resume');
-}
-
-export async function showContactQr(): Promise<void> {
-  const qr = await renderQr(buildVCard());
-  console.log('\nScan to save my contact:\n');
-  console.log(qr);
-}
-
-// --- Menu definition ---
-
-export interface MenuChoice {
-  name: string;
-  value: () => void | Promise<void>;
-}
-
-export function buildChoices(): MenuChoice[] {
-  return [
-    { name: `Copy my ${chalk.green.bold('email')} to clipboard`, value: copyEmail },
-    { name: `Send me an ${chalk.green.bold('email')}`, value: sendEmail },
-    {
-      name: `Open my ${chalk.green.bold('GitHub')}`,
-      value: () => openUrl(profile.github, 'GitHub'),
-    },
-    {
-      name: `Open my ${chalk.blue.bold('LinkedIn')}`,
-      value: () => openUrl(profile.linkedin, 'LinkedIn'),
-    },
-    { name: `View my ${chalk.magentaBright.bold('resume')}`, value: viewResume },
-    {
-      name: `Save my ${chalk.cyan.bold('contact')} (.vcf)`,
-      value: writeAndOpenVCard,
-    },
-    { name: `Show a ${chalk.yellow.bold('contact QR')} code`, value: showContactQr },
-    {
-      name: 'Just quit',
-      value: () => {
-        console.log('\nHave a great day!\n');
-      },
-    },
-  ];
-}

package/src/qrcode.ts

@@ -1,9 +0,0 @@
-import qrcode from 'qrcode-terminal';
-
-// Promisified wrapper around qrcode-terminal's callback API. `small: true` keeps
-// the code compact enough for most terminals.
-export function renderQr(text: string): Promise<string> {
-  return new Promise((resolve) => {
-    qrcode.generate(text, { small: true }, (output: string) => resolve(output));
-  });
-}

package/src/reveal.ts

@@ -1,25 +0,0 @@
-// Tiny animation helpers — no dependencies. Line-by-line reveal is immune to the
-// ANSI-escape-splitting problem a per-character typewriter would hit, and the
-// total budget stays well under a second.
-
-export function sleep(ms: number): Promise<void> {
-  return new Promise((resolve) => setTimeout(resolve, ms));
-}
-
-// Prints `text` one line at a time, pausing `perLineMs` between lines.
-// When `animate` is false, prints everything at once (CI / piped / --no-animation).
-export async function reveal(
-  text: string,
-  perLineMs = 35,
-  animate = true,
-): Promise<void> {
-  if (!animate) {
-    console.log(text);
-    return;
-  }
-  const lines = text.split('\n');
-  for (const line of lines) {
-    console.log(line);
-    await sleep(perLineMs);
-  }
-}

package/src/types/qrcode-terminal.d.ts

@@ -1,13 +0,0 @@
-// qrcode-terminal ships no official types and is CJS. Minimal ambient shim.
-declare module 'qrcode-terminal' {
-  interface GenerateOptions {
-    small?: boolean;
-  }
-  function generate(
-    input: string,
-    options?: GenerateOptions,
-    callback?: (output: string) => void,
-  ): void;
-  const qrcode: { generate: typeof generate };
-  export default qrcode;
-}

package/src/vcard.ts

@@ -1,41 +0,0 @@
-import { writeFileSync } from 'node:fs';
-import { tmpdir } from 'node:os';
-import { join } from 'node:path';
-import open from 'open';
-import { profile } from './data.js';
-
-// Builds a valid vCard 3.0 string (broadest contact-app compatibility) with the
-// spec-required CRLF line endings.
-export function buildVCard(): string {
-  const lines = [
-    'BEGIN:VCARD',
-    'VERSION:3.0',
-    `N:${profile.lastName};${profile.firstName};;;`,
-    `FN:${profile.fullName}`,
-    `ORG:${profile.org}`,
-    `TITLE:${profile.title}`,
-    `EMAIL;TYPE=INTERNET,PREF:${profile.email}`,
-    `URL:${profile.website}`,
-    `X-SOCIALPROFILE;TYPE=github:${profile.github}`,
-    `X-SOCIALPROFILE;TYPE=linkedin:${profile.linkedin}`,
-    'NOTE:npx brignano',
-    'END:VCARD',
-  ];
-  return lines.join('\r\n') + '\r\n';
-}
-
-// Writes the vCard to a temp file and asks the OS to open it (Contacts on
-// macOS/iOS, the default handler elsewhere). On failure, prints the path so the
-// user can open it manually — never throws.
-export async function writeAndOpenVCard(): Promise<void> {
-  const file = join(tmpdir(), 'anthony-brignano.vcf');
-  try {
-    writeFileSync(file, buildVCard(), 'utf8');
-    await open(file);
-    console.log(`\nSaved my contact card to: ${file}\n`);
-  } catch (err) {
-    const message = err instanceof Error ? err.message : String(err);
-    console.error(`\nCouldn't open the contact card automatically (${message}).`);
-    console.error(`It's saved here — open it manually: ${file}\n`);
-  }
-}

package/tsconfig.json

@@ -1,15 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "ES2020",
-    "module": "ES2020",
-    "declaration": false,
-    "outDir": "dist",
-    "rootDir": "src",
-    "strict": true,
-    "esModuleInterop": true,
-    "moduleResolution": "node",
-    "skipLibCheck": true,
-    "forceConsistentCasingInFileNames": true
-  },
-  "include": ["src/**/*"]
-}

package/vhs/demo.tape

@@ -1,40 +0,0 @@
-# Demo recording for `npx brignano`.
-# Regenerate with:  vhs vhs/demo.tape   (requires: brew install vhs)
-# Renders the gradient banner, the live card, menu navigation, and a contact QR.
-
-Output demo.gif
-Require node
-
-Set Shell "zsh"
-Set FontSize 14
-Set Width 1000
-Set Height 1000
-Set Padding 20
-Set Theme "GitHub Dark"
-Set TypingSpeed 55ms
-
-# Launch the local build so the demo reflects this branch (not the published npm version).
-Type "node dist/card.js"
-Sleep 400ms
-Enter
-
-# Banner animation + card reveal + live GitHub stats.
-Sleep 4s
-
-# Walk down the menu to showcase the actions.
-Down
-Sleep 600ms
-Down
-Sleep 600ms
-Down
-Sleep 600ms
-Down
-Sleep 600ms
-Down
-Sleep 600ms
-Down
-Sleep 800ms
-
-# Land on "Show a contact QR code" and select it.
-Enter
-Sleep 3s