botvisibility 1.0.0 → 1.2.1

package/README.md

@@ -0,0 +1,166 @@
+# BotVisibility CLI
+
+Scan any URL to check how visible and usable it is to AI agents. Like Lighthouse for AI agent readiness.
+
+```bash
+npx botvisibility stripe.com
+```
+
+## What it does
+
+BotVisibility runs 28+ automated checks across 4 levels to measure how well your site works with AI agents like Claude, GPT, Copilot, and autonomous agent frameworks.
+
+Without agent-ready metadata and APIs, agents burn 5-100x more tokens through HTML scraping, trial-and-error discovery, and retry loops. A fully unoptimized site can cost agents **120,000-500,000+ excess tokens per session**.
+
+The CLI tells you exactly what's missing and how to fix it.
+
+## Install & run
+
+No install needed. Just run:
+
+```bash
+npx botvisibility <url>
+```
+
+Or install globally:
+
+```bash
+npm install -g botvisibility
+botvisibility stripe.com
+```
+
+## Usage
+
+```bash
+# Basic URL scan
+npx botvisibility https://example.com
+
+# JSON output for CI/CD
+npx botvisibility stripe.com --json
+
+# Full scan with local repo analysis (unlocks Level 3 code checks + Level 4)
+npx botvisibility https://myapp.com --repo ./
+
+# Combined scan with JSON output
+npx botvisibility mysite.com --repo ../my-backend --json
+```
+
+## What it checks
+
+### Level 1: Discoverable (12 checks)
+
+Bots can find you. These checks verify that AI agents can discover your site's capabilities without scraping HTML.
+
+| Check | What it looks for |
+|-------|-------------------|
+| llms.txt | Machine-readable site description at /llms.txt |
+| Agent Card | Capability declaration at /.well-known/agent-card.json |
+| OpenAPI Spec | Published API specification |
+| robots.txt AI Policy | AI crawler directives in robots.txt |
+| Documentation Accessibility | Public dev docs without auth walls |
+| CORS Headers | Cross-origin access for browser-based agents |
+| AI Meta Tags | llms:description, llms:url, llms:instructions meta tags |
+| Skill File | Structured agent instructions at /skill.md |
+| AI Site Profile | Site manifest at /.well-known/ai.json |
+| Skills Index | Skills catalog at /.well-known/skills/index.json |
+| Link Headers | HTML link elements pointing to AI discovery files |
+| MCP Server | Model Context Protocol endpoint discovery |
+
+### Level 2: Usable (9 checks)
+
+Your API works for agents. Authentication, error handling, and core operations are agent-compatible.
+
+| Check | What it looks for |
+|-------|-------------------|
+| API Read Operations | GET/list/search endpoints in API spec |
+| API Write Operations | POST/PUT/PATCH/DELETE endpoints |
+| API Primary Action | Core value action available via API |
+| API Key Authentication | Simple API key auth (not just OAuth) |
+| Scoped API Keys | Permission-scoped API keys |
+| OpenID Configuration | OIDC discovery document |
+| Structured Error Responses | JSON errors with codes, not HTML error pages |
+| Async Operations | Job ID + polling for long-running operations |
+| Idempotency Support | Idempotency key support on write endpoints |
+
+### Level 3: Optimized (7 checks)
+
+Agents work efficiently. Pagination, filtering, caching, and MCP tools reduce token waste.
+
+| Check | What it looks for |
+|-------|-------------------|
+| Sparse Fields | fields/select parameter to request only needed data |
+| Cursor Pagination | Cursor-based pagination on list endpoints |
+| Search & Filtering | Server-side filter and search parameters |
+| Bulk Operations | Batch create/update/delete endpoints |
+| Rate Limit Headers | X-RateLimit-* headers on API responses |
+| Caching Headers | ETag, Cache-Control, Last-Modified headers |
+| MCP Tool Quality | Well-described MCP tools with input schemas |
+
+With `--repo`, Level 3 checks also scan your codebase for these patterns in code, catching implementations that the web scanner can't detect from HTTP responses alone.
+
+### Level 4: Agent-Native (7 checks, --repo required)
+
+First-class agent support. These checks require local code access.
+
+| Check | What it looks for |
+|-------|-------------------|
+| Intent-Based Endpoints | High-level action endpoints (e.g., /send-invoice) |
+| Agent Sessions | Persistent session management for multi-step interactions |
+| Scoped Agent Tokens | Agent-specific tokens with capability limits |
+| Agent Audit Logs | API actions logged with agent identifiers |
+| Sandbox Environment | Test environment for safe agent experimentation |
+| Consequence Labels | Annotations marking irreversible/destructive actions |
+| Native Tool Schemas | Ready-to-use tool definitions for agent frameworks |
+
+## Scoring
+
+BotVisibility uses a weighted cross-level algorithm:
+
+- **L1 Discoverable**: Pass 50%+ of L1 checks
+- **L2 Usable**: Pass 50%+ of L1 AND 50%+ of L2 (or 35%+ L1 with 75%+ L2)
+- **L3 Optimized**: Achieve L2 AND pass 50%+ of L3 (or 35%+ L2 with 75%+ L3)
+- **L4 Agent-Native**: Requires `--repo` flag for code-level analysis
+
+This rewards sites that invest in higher-level capabilities even if some lower-level items are still missing.
+
+## CI/CD integration
+
+Add to your CI pipeline to catch agent-readiness regressions:
+
+```yaml
+# GitHub Actions
+- name: Check BotVisibility
+  run: |
+    SCORE=$(npx botvisibility mysite.com --json | jq '.currentLevel')
+    if [ "$SCORE" -lt 1 ]; then
+      echo "BotVisibility score below Level 1"
+      exit 1
+    fi
+```
+
+## The agent tax
+
+Every unoptimized interaction costs AI agents extra tokens:
+
+| Without | With | Savings |
+|---------|------|---------|
+| Scrape HTML (30,000 tokens) | Read llms.txt (500 tokens) | 98% |
+| Guess API endpoints (100,000 tokens) | Read OpenAPI spec (15,000 tokens) | 85% |
+| Parse HTML errors (10,000 tokens) | Read JSON error (50 tokens) | 99% |
+| Fetch all fields (2,000 tokens) | Sparse fields (200 tokens) | 90% |
+
+At Claude Sonnet 4.6 rates, a single unoptimized session costs $0.83 vs $0.07 optimized. At 1,000 agent visits/day, that's **$22,800/month** in wasted tokens.
+
+Read the full analysis: [The Agent Tax](https://botvisibility.com/agent-tax)
+
+## Links
+
+- **Scanner**: [botvisibility.com](https://botvisibility.com)
+- **Checklist**: [botvisibility.com/checklist](https://botvisibility.com/checklist)
+- **Badge**: [botvisibility.com/badge](https://botvisibility.com/badge)
+- **Agent Tax Whitepaper**: [botvisibility.com/agent-tax](https://botvisibility.com/agent-tax)
+- **GitHub**: [github.com/jjanisheck/botvisibility](https://github.com/jjanisheck/botvisibility)
+
+## License
+
+MIT

package/package.json

@@ -1,11 +1,15 @@
 {
   "name": "botvisibility",
-  "version": "1.0.0",
+  "version": "1.2.1",
   "description": "Scan any URL to check if it's ready for AI agents",
   "main": "dist/index.js",
   "bin": {
     "botvisibility": "./dist/index.js"
   },
+  "files": [
+    "dist",
+    "README.md"
+  ],
   "scripts": {
     "build": "tsc",
     "dev": "tsc -w",
@@ -24,6 +28,7 @@
   ],
   "author": "Joey Janisheck",
   "license": "MIT",
+  "homepage": "https://botvisibility.com",
   "repository": {
     "type": "git",
     "url": "https://github.com/jjanisheck/botvisibility"

package/.claude-flow/data/pending-insights.jsonl

@@ -1,2 +0,0 @@
-{"type":"edit","file":"unknown","timestamp":1773448122142,"sessionId":null}
-{"type":"edit","file":"unknown","timestamp":1773448124561,"sessionId":null}

package/.next/trace

@@ -1 +0,0 @@
-[{"name":"generate-buildid","duration":71,"timestamp":199541658392,"id":4,"parentId":1,"tags":{},"startTime":1773816019614,"traceId":"260b839151d64215"},{"name":"load-custom-routes","duration":107,"timestamp":199541658494,"id":5,"parentId":1,"tags":{},"startTime":1773816019614,"traceId":"260b839151d64215"},{"name":"create-dist-dir","duration":132,"timestamp":199541658609,"id":6,"parentId":1,"tags":{},"startTime":1773816019614,"traceId":"260b839151d64215"},{"name":"clean","duration":82,"timestamp":199541658966,"id":7,"parentId":1,"tags":{},"startTime":1773816019614,"traceId":"260b839151d64215"},{"name":"next-build","duration":314254,"timestamp":199541346562,"id":1,"tags":{"buildMode":"default","version":"16.1.6","bundler":"turbopack"},"startTime":1773816019302,"traceId":"260b839151d64215"}]

package/.next/trace-build

@@ -1 +0,0 @@
-[{"name":"next-build","duration":314254,"timestamp":199541346562,"id":1,"tags":{"buildMode":"default","version":"16.1.6","bundler":"turbopack"},"startTime":1773816019302,"traceId":"260b839151d64215"}]

package/src/index.ts

@@ -1,402 +0,0 @@
-#!/usr/bin/env node
-
-import { normalizeUrl, runAllChecks } from './scanner.js';
-import { runRepoChecks } from './repo-scanner.js';
-import { calculateLevelProgress, getCurrentLevel, LEVELS, CLI_CHECKS } from './scoring.js';
-import { CheckResult, ScanResult, RepoCheckResult, LevelProgress } from './types.js';
-import * as path from 'path';
-import * as readline from 'readline';
-
-// ANSI colors
-const colors = {
-  reset: '\x1b[0m',
-  bold: '\x1b[1m',
-  dim: '\x1b[2m',
-  red: '\x1b[31m',
-  green: '\x1b[32m',
-  yellow: '\x1b[33m',
-  blue: '\x1b[34m',
-  magenta: '\x1b[35m',
-  cyan: '\x1b[36m',
-  white: '\x1b[37m',
-};
-
-function getLevelColor(levelNumber: number): string {
-  switch (levelNumber) {
-    case 1: return colors.red;
-    case 2: return colors.yellow;
-    case 3: return colors.green;
-    case 4: return colors.blue;
-    default: return colors.white;
-  }
-}
-
-function printHelp() {
-  console.log(`
-${colors.bold}BotVisibility CLI${colors.reset}
-The Speedtest.net for AI agents. Scan any URL to check bot visibility.
-
-${colors.bold}USAGE${colors.reset}
-  npx botvisibility <url> [options]
-
-${colors.bold}OPTIONS${colors.reset}
-  --json        Output results as JSON (for CI/CD integration)
-  --repo <path> Include local repo analysis for deeper checks (unlocks Level 4)
-  --help, -h    Show this help message
-
-${colors.bold}EXAMPLES${colors.reset}
-  ${colors.dim}# Basic URL scan${colors.reset}
-  npx botvisibility https://example.com
-
-  ${colors.dim}# JSON output for CI/CD${colors.reset}
-  npx botvisibility stripe.com --json
-
-  ${colors.dim}# Full scan with repo analysis (unlocks Level 4)${colors.reset}
-  npx botvisibility https://myapp.com --repo ./
-
-  ${colors.dim}# Combined scan with JSON output${colors.reset}
-  npx botvisibility clone.fyi --repo ../my-backend --json
-
-${colors.bold}LEVELS${colors.reset}
-  ${colors.red}Level 1: Discoverable${colors.reset}   Bots can find you via machine-readable metadata (6 checks)
-  ${colors.yellow}Level 2: Usable${colors.reset}        Your API works for agents (9 checks, most require OpenAPI)
-  ${colors.green}Level 3: Optimized${colors.reset}     Your API minimizes token cost and handles scale (6 checks)
-  ${colors.blue}Level 4: Agent-Native${colors.reset}  Your platform treats AI agents as first-class users (7 checks, --repo required)
-
-${colors.bold}LEARN MORE${colors.reset}
-  https://botvisibility.com
-  https://github.com/jjanisheck/botvisibility
-`);
-}
-
-function statusIcon(status: CheckResult['status']): string {
-  switch (status) {
-    case 'pass': return `${colors.green}+${colors.reset}`;
-    case 'fail': return `${colors.red}x${colors.reset}`;
-    case 'partial': return `${colors.yellow}~${colors.reset}`;
-    case 'na': return `${colors.dim}-${colors.reset}`;
-  }
-}
-
-function printLevelSection(
-  levelNumber: number,
-  levelName: string,
-  checks: (CheckResult | RepoCheckResult)[],
-  hasRepo: boolean,
-) {
-  const levelColor = getLevelColor(levelNumber);
-  const applicable = checks.filter(c => c.status !== 'na');
-  const passed = checks.filter(c => c.status === 'pass').length;
-  const naCount = checks.filter(c => c.status === 'na').length;
-
-  // Level 4 header when no --repo
-  if (levelNumber === 4 && !hasRepo) {
-    console.log('');
-    console.log(`${levelColor}${colors.bold}LEVEL ${levelNumber}: ${levelName.toUpperCase()}${colors.reset} ${colors.dim}(--repo required)${colors.reset}`);
-    console.log(`${colors.dim}${'─'.repeat(55)}${colors.reset}`);
-    console.log(`  ${colors.dim}Run with --repo <path> to unlock Level 4 checks${colors.reset}`);
-    return;
-  }
-
-  console.log('');
-  console.log(`${levelColor}${colors.bold}LEVEL ${levelNumber}: ${levelName.toUpperCase()}${colors.reset}${' '.repeat(Math.max(0, 40 - levelName.length - 10))}${colors.bold}${passed}/${applicable.length}${colors.reset}`);
-  console.log(`${colors.dim}${'─'.repeat(55)}${colors.reset}`);
-
-  // Print non-NA checks
-  for (const check of checks) {
-    if (check.status === 'na') continue;
-    const icon = statusIcon(check.status);
-    console.log(`  ${icon} ${colors.bold}${check.name}${colors.reset}`);
-    console.log(`    ${colors.dim}${check.message}${colors.reset}`);
-
-    if (check.details) {
-      console.log(`    ${colors.dim}${check.details}${colors.reset}`);
-    }
-
-    if (check.recommendation && check.status !== 'pass') {
-      console.log(`    ${colors.yellow}-> ${check.recommendation}${colors.reset}`);
-    }
-
-    if ('filePath' in check && check.filePath) {
-      console.log(`    ${colors.dim}File: ${check.filePath}${colors.reset}`);
-    }
-  }
-
-  // Collapsed NA count
-  if (naCount > 0) {
-    console.log(`  ${colors.dim}- ${naCount} check${naCount === 1 ? '' : 's'} require${naCount === 1 ? 's' : ''} an OpenAPI spec to evaluate${colors.reset}`);
-  }
-}
-
-function printResults(result: ScanResult, repoChecks?: RepoCheckResult[]) {
-  const allChecks: CheckResult[] = [...result.checks, ...(repoChecks || [])];
-  const levelProgress = calculateLevelProgress(allChecks);
-  const currentLevel = getCurrentLevel(levelProgress);
-
-  const totalPassed = allChecks.filter(c => c.status === 'pass').length;
-  const totalApplicable = allChecks.filter(c => c.status !== 'na').length;
-
-  // Find the "current working level" — first incomplete
-  const workingLevel = levelProgress.find(lp => !lp.complete) || levelProgress[levelProgress.length - 1];
-  const workingLevelColor = getLevelColor(workingLevel.level.number);
-
-  console.log('');
-  console.log(`${colors.bold}+-------------------------------------------------------+${colors.reset}`);
-  console.log(`${colors.bold}|            BOTVISIBILITY SCAN RESULTS                 |${colors.reset}`);
-  console.log(`${colors.bold}+-------------------------------------------------------+${colors.reset}`);
-  console.log('');
-  console.log(`  ${colors.dim}URL:${colors.reset}     ${result.url}`);
-  console.log(`  ${colors.dim}Scanned:${colors.reset} ${new Date(result.timestamp).toLocaleString()}`);
-  console.log('');
-
-  // Score box
-  console.log(`  ${colors.bold}+-------------------------------------+${colors.reset}`);
-  console.log(`  ${colors.bold}|${colors.reset}  ${workingLevelColor}${colors.bold}Level ${workingLevel.level.number}: ${workingLevel.level.name}${colors.reset}${' '.repeat(Math.max(0, 24 - workingLevel.level.name.length))}${colors.bold}|${colors.reset}`);
-  console.log(`  ${colors.bold}|${colors.reset}     ${colors.bold}${totalPassed}${colors.reset}${colors.dim}/${totalApplicable}${colors.reset} checks passed${' '.repeat(14)}${colors.bold}|${colors.reset}`);
-  console.log(`  ${colors.bold}+-------------------------------------+${colors.reset}`);
-  console.log('');
-
-  if (currentLevel === 0) {
-    console.log(`  ${colors.dim}Start by making your site discoverable to AI agents.${colors.reset}`);
-  } else if (currentLevel < 4) {
-    const nextLevel = LEVELS[currentLevel]; // 0-indexed: currentLevel is the next one
-    console.log(`  ${colors.dim}Level ${currentLevel} complete! Work on Level ${nextLevel.number}: ${nextLevel.name}.${colors.reset}`);
-  } else {
-    console.log(`  ${colors.green}All levels complete! Maximum agent visibility achieved.${colors.reset}`);
-  }
-
-  // Group checks by level
-  const hasRepo = !!repoChecks && repoChecks.length > 0;
-
-  for (const level of LEVELS) {
-    const levelChecks = allChecks.filter(c => c.level === level.number);
-
-    if (level.number === 4 && !hasRepo) {
-      printLevelSection(level.number, level.name, [], false);
-    } else if (levelChecks.length > 0) {
-      printLevelSection(level.number, level.name, levelChecks, hasRepo);
-    }
-  }
-
-  // Summary
-  console.log('');
-  console.log(`${colors.bold}${'='.repeat(55)}${colors.reset}`);
-  const totalPartial = allChecks.filter(c => c.status === 'partial').length;
-  const totalFailed = allChecks.filter(c => c.status === 'fail').length;
-  const totalNa = allChecks.filter(c => c.status === 'na').length;
-
-  console.log(`  ${colors.green}+ ${totalPassed} passed${colors.reset}  ${colors.yellow}~ ${totalPartial} partial${colors.reset}  ${colors.red}x ${totalFailed} failed${colors.reset}  ${colors.dim}- ${totalNa} n/a${colors.reset}`);
-  console.log('');
-  console.log(`  ${colors.dim}Full checklist: https://botvisibility.com${colors.reset}`);
-  console.log('');
-}
-
-// Ask user a yes/no question
-function askQuestion(question: string): Promise<boolean> {
-  return new Promise((resolve) => {
-    const rl = readline.createInterface({
-      input: process.stdin,
-      output: process.stdout
-    });
-
-    rl.question(question, (answer) => {
-      rl.close();
-      const normalized = answer.toLowerCase().trim();
-      resolve(normalized === 'y' || normalized === 'yes');
-    });
-  });
-}
-
-// Generate the publish payload
-interface PublishPayload {
-  domain: string;
-  scannedAt: string;
-  currentLevel: number;
-  checks: Array<{
-    id: string;
-    name: string;
-    passed: boolean;
-    status: string;
-    level: number;
-  }>;
-  repoChecks?: Array<{
-    id: string;
-    name: string;
-    passed: boolean;
-    status: string;
-    level: number;
-  }>;
-}
-
-function generatePublishPayload(
-  result: ScanResult,
-  repoChecks?: RepoCheckResult[]
-): PublishPayload {
-  const url = new URL(result.url);
-  const domain = url.hostname.replace(/^www\./, '');
-
-  return {
-    domain,
-    scannedAt: result.timestamp,
-    currentLevel: result.currentLevel,
-    checks: result.checks.map(c => ({
-      id: c.id,
-      name: c.name,
-      passed: c.passed,
-      status: c.status,
-      level: c.level
-    })),
-    repoChecks: repoChecks?.map(c => ({
-      id: c.id,
-      name: c.name,
-      passed: c.passed,
-      status: c.status,
-      level: c.level
-    }))
-  };
-}
-
-async function promptPublish(result: ScanResult, repoChecks?: RepoCheckResult[]) {
-  console.log('');
-  console.log(`${colors.bold}Share Your Score${colors.reset}`);
-  console.log(`${colors.dim}${'─'.repeat(55)}${colors.reset}`);
-  console.log('');
-
-  const shouldPublish = await askQuestion(
-    `  Would you like to publish this score to ${colors.cyan}botvisibility.com${colors.reset}? (y/n) `
-  );
-
-  if (shouldPublish) {
-    const payload = generatePublishPayload(result, repoChecks);
-    const domain = payload.domain;
-    const profileUrl = `https://botvisibility.com/site/${domain}`;
-
-    console.log('');
-    console.log(`  ${colors.green}+${colors.reset} Score ready to publish!`);
-    console.log('');
-    console.log(`  ${colors.bold}Your public profile will be available at:${colors.reset}`);
-    console.log(`  ${colors.cyan}${profileUrl}${colors.reset}`);
-    console.log('');
-    console.log(`  ${colors.dim}This page will show:${colors.reset}`);
-    console.log(`    - Level ${payload.currentLevel} badge`);
-    console.log(`    - Check results and recommendations`);
-    console.log(`    - Score history over time`);
-    console.log('');
-
-    console.log(`  ${colors.dim}Payload preview:${colors.reset}`);
-    console.log(`  ${colors.dim}${JSON.stringify({
-      domain: payload.domain,
-      currentLevel: payload.currentLevel,
-      checks: `${payload.checks.length} URL checks` + (payload.repoChecks ? ` + ${payload.repoChecks.length} repo checks` : '')
-    })}${colors.reset}`);
-    console.log('');
-
-    // TODO: When API is ready, uncomment this:
-    // try {
-    //   const response = await fetch('https://botvisibility.com/api/publish', {
-    //     method: 'POST',
-    //     headers: { 'Content-Type': 'application/json' },
-    //     body: JSON.stringify(payload)
-    //   });
-    //   if (response.ok) {
-    //     const data = await response.json();
-    //     console.log(`  ${colors.green}+${colors.reset} Published! View at: ${data.profileUrl}`);
-    //   }
-    // } catch (e) {
-    //   console.log(`  ${colors.yellow}!${colors.reset} Could not publish. Try again later.`);
-    // }
-
-    console.log(`  ${colors.yellow}!${colors.reset} Publishing API coming soon! For now, share your results manually.`);
-    console.log('');
-  } else {
-    console.log('');
-    console.log(`  ${colors.dim}No problem! Run with --json to export results.${colors.reset}`);
-    console.log('');
-  }
-}
-
-async function main() {
-  const args = process.argv.slice(2);
-
-  // Parse flags
-  const jsonOutput = args.includes('--json');
-  const helpFlag = args.includes('--help') || args.includes('-h');
-  const repoIndex = args.indexOf('--repo');
-  const repoPath = repoIndex !== -1 ? args[repoIndex + 1] : null;
-
-  // Filter out flags to get URL
-  const urlArgs = args.filter((arg, i) =>
-    !arg.startsWith('--') &&
-    !arg.startsWith('-') &&
-    (repoIndex === -1 || i !== repoIndex + 1)
-  );
-
-  if (helpFlag || urlArgs.length === 0) {
-    printHelp();
-    process.exit(0);
-  }
-
-  const urlInput = urlArgs[0];
-
-  // Normalize URL
-  let baseUrl: string;
-  try {
-    baseUrl = normalizeUrl(urlInput);
-  } catch (e) {
-    console.error(`${colors.red}Error: Invalid URL "${urlInput}"${colors.reset}`);
-    process.exit(1);
-  }
-
-  if (!jsonOutput) {
-    console.log('');
-    console.log(`${colors.cyan}Scanning ${baseUrl}...${colors.reset}`);
-  }
-
-  // Run URL checks
-  const checks = await runAllChecks(baseUrl);
-
-  // Run repo checks if specified
-  let repoChecks: RepoCheckResult[] | undefined;
-  if (repoPath) {
-    const absolutePath = path.resolve(repoPath);
-    if (!jsonOutput) {
-      console.log(`${colors.cyan}Scanning repo at ${absolutePath}...${colors.reset}`);
-    }
-    repoChecks = runRepoChecks(absolutePath);
-  }
-
-  // Calculate level progress
-  const allChecks = [...checks, ...(repoChecks || [])];
-  const levelProgress = calculateLevelProgress(allChecks);
-  const currentLevel = getCurrentLevel(levelProgress);
-
-  const result: ScanResult = {
-    url: baseUrl,
-    timestamp: new Date().toISOString(),
-    currentLevel,
-    levels: levelProgress,
-    checks,
-    cliChecks: CLI_CHECKS,
-  };
-
-  // Output
-  if (jsonOutput) {
-    const output = {
-      ...result,
-      repoChecks: repoChecks || []
-    };
-    console.log(JSON.stringify(output, null, 2));
-  } else {
-    printResults(result, repoChecks);
-
-    // Prompt to publish (only in interactive mode)
-    if (process.stdin.isTTY) {
-      await promptPublish(result, repoChecks);
-    }
-  }
-}
-
-main().catch(err => {
-  console.error(`${colors.red}Error: ${err.message}${colors.reset}`);
-  process.exit(1);
-});