npm install @glincker/geo-audit

import { audit } from '@glincker/geo-audit';

const result = await audit('https://example.com');

console.log(`Score: ${result.score}/100 (${result.grade})`);
console.log(`Categories:`, result.categories);

interface AuditResult {
  url: string;
  score: number;           // 0-100
  grade: 'A' | 'B' | 'C' | 'D' | 'F';
  categories: Category[];
  rules: RuleResult[];
  recommendations: Recommendation[];
  timestamp: string;
  duration: number;        // milliseconds
  version: string;
}

interface Category {
  name: string;
  slug: string;
  maxPoints: number;
  score: number;
  rules: RuleResult[];
}

interface RuleResult {
  id: string;
  name: string;
  description: string;
  category: string;
  status: 'pass' | 'warn' | 'fail' | 'skip';
  score: number;
  maxScore: number;
  message: string;
  recommendation?: string;
  details?: Record<string, unknown>;
}

interface Recommendation {
  rule: string;
  message: string;
  impact: number;
  fix?: string;
}

const result = await audit('https://example.com');

if (result.score < 80) {
  console.error('❌ AI-readiness score too low');
  process.exit(1);
}

const result = await audit('https://example.com');

console.log(`## AI-Readiness Report for ${result.url}`);
console.log(`Score: ${result.score}/100 (${result.grade})`);
console.log(`\n### Categories:`);

result.categories.forEach(cat => {
  console.log(`- ${cat.name}: ${cat.score}/${cat.maxPoints}`);
});

const result = await audit('https://example.com');

const failedRules = result.rules.filter(r => r.status === 'fail');

if (failedRules.length > 0) {
  console.log('Failed Rules:');
  failedRules.forEach(rule => {
    console.log(`- ${rule.name}: ${rule.message}`);
    if (rule.recommendation) {
      console.log(`  Fix: ${rule.recommendation}`);
    }
  });
}