@ai-lighthouse/cli 1.0.1 → 1.0.3

package/.ai-lighthouse/crawl_github.com_2025-12-15T12-03-33.json

@@ -1,28 +0,0 @@
-{
-  "crawl_id": "crawl_1765800213564_8yer1z9g6",
-  "crawled_at": "2025-12-15T12:03:33.564Z",
-  "base_url": "https://github.com",
-  "start_url": "https://github.com",
-  "total_pages": 5,
-  "crawl_depth": 2,
-  "pages": [
-    "{\n  \"version\": \"1.0.0\",\n  \"audit_id\": \"ed541752-b5ba-49bf-9d2a-9154dffd4cee\",\n  \"scanned_at\": \"2025-12-15T12:03:33.090Z\",\n  \"input\": {\n    \"requested_url\": \"https://github.com\",\n    \"final_url\": \"https://github.com\",\n    \"status_code\": 200,\n    \"redirect_chain\": []\n  },\n  \"scores\": {\n    \"crawlability\": 76,\n    \"structure\": 50,\n    \"schema_coverage\": 50,\n    \"content_clarity\": 5,\n    \"ai_readiness\": 51,\n    \"overall\": 50.8\n  },\n  \"entities\": [],\n  \"issues\": [\n    {\n      \"id\": \"CHUNK-001\",\n      \"severity\": \"critical\",\n      \"message\": \"Chunk exceeds recommended token/window size\",\n      \"evidence\": \"tokens:2045\",\n      \"suggested_fix\": \"Break content into smaller semantic sections using headings or create separate pages for distinct topics.\",\n      \"impact\": \"critical\",\n      \"category\": \"content\"\n    },\n    {\n      \"id\": \"KG-001\",\n      \"severity\": \"high\",\n      \"message\": \"No Schema.org structured data\",\n      \"evidence\": \"No JSON-LD structured data found\",\n      \"suggested_fix\": \"Add Schema.org structured data using JSON-LD. Consider Organization, Person, Article, Product, or other relevant schemas.\",\n      \"impact\": \"high\",\n      \"category\": \"schema\"\n    },\n    {\n      \"id\": \"AIREAD-002\",\n      \"severity\": \"high\",\n      \"message\": \"Multiple H1 Headings\",\n      \"evidence\": \"count: 4\",\n      \"suggested_fix\": \"Consider using a single H1 heading for better SEO practices.\",\n      \"impact\": \"high\",\n      \"category\": \"structure\"\n    },\n    {\n      \"id\": \"AIREAD-066\",\n      \"severity\": \"medium\",\n      \"message\": \"Videos without captions\",\n      \"evidence\": \"Videos without captions: 2\",\n      \"suggested_fix\": \"Add <track kind=\\\"captions\\\"> elements to video tags with WebVTT caption files.\",\n      \"impact\": \"medium\",\n      \"category\": \"structure\"\n    },\n    {\n      \"id\": \"CHUNK-002\",\n      \"severity\": \"medium\",\n      \"message\": \"Repetitive text content\",\n      \"evidence\": \"Repetitive patterns: 24, Wasted tokens: ~1650, Example: \\\"Search\\n      \\n      \\n          \\n            \\n    \\n\\n          \\n        \\n          \\n          \\n       ...\\\"\",\n      \"suggested_fix\": \"Consolidate repetitive text into a single location. Use references or footnotes instead of repeating the same text multiple times.\",\n      \"impact\": \"medium\",\n      \"category\": \"content\"\n    },\n    {\n      \"id\": \"A11Y-002\",\n      \"severity\": \"medium\",\n      \"message\": \"Form inputs without labels\",\n      \"evidence\": \"Unlabeled inputs: 1\",\n      \"suggested_fix\": \"Add <label> elements associated with inputs via for/id attributes, or use aria-label/aria-labelledby attributes.\",\n      \"impact\": \"medium\",\n      \"category\": \"accessibility\"\n    },\n    {\n      \"id\": \"CHUNK-005\",\n      \"severity\": \"medium\",\n      \"message\": \"Duplicate navigation elements\",\n      \"evidence\": \"Navigation count: 7, Estimated wasted tokens: ~220\",\n      \"suggested_fix\": \"Consolidate navigation into a single element. If multiple navs are needed, ensure they serve distinct purposes and contain unique content.\",\n      \"impact\": \"medium\",\n      \"category\": \"content\"\n    },\n    {\n      \"id\": \"AIREAD-068\",\n      \"severity\": \"low\",\n      \"message\": \"No video transcripts available\",\n      \"evidence\": \"Videos: 2, No transcript links\",\n      \"suggested_fix\": \"Provide full text transcripts for videos. Link to them near the video or include them on the page.\",\n      \"impact\": \"low\",\n      \"category\": \"structure\"\n    },\n    {\n      \"id\": \"CRAWL-014\",\n      \"severity\": \"low\",\n      \"message\": \"Excessive external resources\",\n      \"evidence\": \"Total external resources: 123\",\n      \"suggested_fix\": \"Consolidate resources, use sprite sheets, inline critical assets, and defer non-critical loads.\",\n      \"impact\": \"low\",\n      \"category\": \"crawl\"\n    }\n  ],\n  \"recommendations\": [\n    {\n      \"issue_id\": \"CHUNK-001\",\n      \"fix\": \"Break content into smaller semantic sections using headings or create separate pages for distinct topics.\",\n      \"impact\": \"critical\"\n    },\n    {\n      \"issue_id\": \"KG-001\",\n      \"fix\": \"Add Schema.org structured data using JSON-LD. Consider Organization, Person, Article, Product, or other relevant schemas.\",\n      \"impact\": \"high\"\n    },\n    {\n      \"issue_id\": \"AIREAD-002\",\n      \"fix\": \"Consider using a single H1 heading for better SEO practices.\",\n      \"impact\": \"high\"\n    }\n  ],\n  \"detailed_scoring\": {\n    \"overall_score\": 50.8,\n    \"grade\": \"D\",\n    \"category_scores\": [\n      {\n        \"category\": \"AIREAD\",\n        \"score\": 0,\n        \"grade\": \"F\",\n        \"issues\": 3,\n        \"weight\": 1.5\n      },\n      {\n        \"category\": \"CHUNK\",\n        \"score\": 0,\n        \"grade\": \"F\",\n        \"issues\": 3,\n        \"weight\": 1.3\n      },\n      {\n        \"category\": \"KG\",\n        \"score\": 0,\n        \"grade\": \"F\",\n        \"issues\": 1,\n        \"weight\": 1.1\n      },\n      {\n        \"category\": \"A11Y\",\n        \"score\": 10,\n        \"grade\": \"F\",\n        \"issues\": 1,\n        \"weight\": 1.2\n      },\n      {\n        \"category\": \"CRAWL\",\n        \"score\": 76,\n        \"grade\": \"B\",\n        \"issues\": 1,\n        \"weight\": 1.2\n      }\n    ],\n    \"severity_breakdown\": {\n      \"info\": 0,\n      \"low\": 2,\n      \"medium\": 4,\n      \"high\": 2,\n      \"critical\": 1\n    }\n  }\n}",
-    "{\n  \"version\": \"1.0.0\",\n  \"audit_id\": \"fba437b4-97ad-4154-9f7d-4bb25e21ddd8\",\n  \"scanned_at\": \"2025-12-15T12:03:33.119Z\",\n  \"input\": {\n    \"requested_url\": \"https://github.com/fluidicon.png\",\n    \"final_url\": \"https://github.com/fluidicon.png\",\n    \"status_code\": 200,\n    \"redirect_chain\": []\n  },\n  \"scores\": {\n    \"crawlability\": 0,\n    \"structure\": 50,\n    \"schema_coverage\": 50,\n    \"content_clarity\": 50,\n    \"ai_readiness\": 53,\n    \"overall\": 53.3\n  },\n  \"entities\": [],\n  \"issues\": [\n    {\n      \"id\": \"AIREAD-001\",\n      \"severity\": \"critical\",\n      \"message\": \"Missing H1\",\n      \"evidence\": \"No <h1> tags found in the document.\",\n      \"suggested_fix\": \"Add at least one H1 heading to the HTML document to improve accessibility and SEO.\",\n      \"impact\": \"critical\",\n      \"category\": \"structure\"\n    },\n    {\n      \"id\": \"KG-001\",\n      \"severity\": \"high\",\n      \"message\": \"No Schema.org structured data\",\n      \"evidence\": \"No JSON-LD structured data found\",\n      \"suggested_fix\": \"Add Schema.org structured data using JSON-LD. Consider Organization, Person, Article, Product, or other relevant schemas.\",\n      \"impact\": \"high\",\n      \"category\": \"schema\"\n    },\n    {\n      \"id\": \"AIREAD-041\",\n      \"severity\": \"high\",\n      \"message\": \"No links found\",\n      \"evidence\": \"No <a href> elements found\",\n      \"suggested_fix\": \"Add relevant internal and external links to improve navigation and content relationships.\",\n      \"impact\": \"high\",\n      \"category\": \"structure\"\n    },\n    {\n      \"id\": \"AIREAD-028\",\n      \"severity\": \"high\",\n      \"message\": \"Missing or inadequate page title\",\n      \"evidence\": \"Title: \\\"none\\\"\",\n      \"suggested_fix\": \"Add a descriptive <title> element that clearly describes the page content. Aim for 50-60 characters.\",\n      \"impact\": \"high\",\n      \"category\": \"structure\"\n    },\n    {\n      \"id\": \"AIREAD-014\",\n      \"severity\": \"high\",\n      \"message\": \"Missing main semantic container\",\n      \"evidence\": \"No <main> or <article> element found\",\n      \"suggested_fix\": \"Wrap your main content in a <main> element, or use <article> for article-type content. This helps AI understand what content is most important.\",\n      \"impact\": \"high\",\n      \"category\": \"structure\"\n    },\n    {\n      \"id\": \"A11Y-001\",\n      \"severity\": \"high\",\n      \"message\": \"No ARIA landmarks or semantic elements\",\n      \"evidence\": \"No landmarks found\",\n      \"suggested_fix\": \"Add ARIA landmark roles (role=\\\"main\\\", role=\\\"navigation\\\", etc.) or use semantic HTML5 elements (<main>, <nav>, <header>, <footer>).\",\n      \"impact\": \"high\",\n      \"category\": \"accessibility\"\n    },\n    {\n      \"id\": \"CRAWL-003\",\n      \"severity\": \"high\",\n      \"message\": \"Missing canonical tag\",\n      \"evidence\": \"No canonical tag found\",\n      \"suggested_fix\": \"Add <link rel=\\\"canonical\\\" href=\\\"...\\\"> to specify the preferred URL version.\",\n      \"impact\": \"high\",\n      \"category\": \"crawl\"\n    },\n    {\n      \"id\": \"AIREAD-010\",\n      \"severity\": \"medium\",\n      \"message\": \"Missing or short meta description\",\n      \"evidence\": \"Description length: 0 chars\",\n      \"suggested_fix\": \"Add a meta description tag with 150-160 characters that summarizes the page content.\",\n      \"impact\": \"medium\",\n      \"category\": \"structure\"\n    },\n    {\n      \"id\": \"AIREAD-013\",\n      \"severity\": \"medium\",\n      \"message\": \"Missing OpenGraph meta tags\",\n      \"evidence\": \"Missing tags: og:title, og:description, og:image\",\n      \"suggested_fix\": \"Add missing OpenGraph meta tags (og:title, og:description, og:image) to improve how AI agents and social platforms understand your content.\",\n      \"impact\": \"medium\",\n      \"category\": \"structure\"\n    },\n    {\n      \"id\": \"AIREAD-080\",\n      \"severity\": \"medium\",\n      \"message\": \"Missing summary or intro section\",\n      \"evidence\": \"No summary section detected, First paragraph length: 0\",\n      \"suggested_fix\": \"Add a clear introduction or summary section at the start of your content.\",\n      \"impact\": \"medium\",\n      \"category\": \"structure\"\n    },\n    {\n      \"id\": \"AIREAD-098\",\n      \"severity\": \"low\",\n      \"message\": \"No contact information\",\n      \"evidence\": \"No email, phone, or contact links found\",\n      \"suggested_fix\": \"Add contact information to improve trust and AI understanding of your organization.\",\n      \"impact\": \"low\",\n      \"category\": \"structure\"\n    }\n  ],\n  \"recommendations\": [\n    {\n      \"issue_id\": \"AIREAD-001\",\n      \"fix\": \"Add at least one H1 heading to the HTML document to improve accessibility and SEO.\",\n      \"impact\": \"critical\"\n    },\n    {\n      \"issue_id\": \"KG-001\",\n      \"fix\": \"Add Schema.org structured data using JSON-LD. Consider Organization, Person, Article, Product, or other relevant schemas.\",\n      \"impact\": \"high\"\n    },\n    {\n      \"issue_id\": \"AIREAD-041\",\n      \"fix\": \"Add relevant internal and external links to improve navigation and content relationships.\",\n      \"impact\": \"high\"\n    },\n    {\n      \"issue_id\": \"AIREAD-028\",\n      \"fix\": \"Add a descriptive <title> element that clearly describes the page content. Aim for 50-60 characters.\",\n      \"impact\": \"high\"\n    },\n    {\n      \"issue_id\": \"AIREAD-014\",\n      \"fix\": \"Wrap your main content in a <main> element, or use <article> for article-type content. This helps AI understand what content is most important.\",\n      \"impact\": \"high\"\n    },\n    {\n      \"issue_id\": \"A11Y-001\",\n      \"fix\": \"Add ARIA landmark roles (role=\\\"main\\\", role=\\\"navigation\\\", etc.) or use semantic HTML5 elements (<main>, <nav>, <header>, <footer>).\",\n      \"impact\": \"high\"\n    },\n    {\n      \"issue_id\": \"CRAWL-003\",\n      \"fix\": \"Add <link rel=\\\"canonical\\\" href=\\\"...\\\"> to specify the preferred URL version.\",\n      \"impact\": \"high\"\n    }\n  ],\n  \"detailed_scoring\": {\n    \"overall_score\": 53.3,\n    \"grade\": \"D\",\n    \"category_scores\": [\n      {\n        \"category\": \"AIREAD\",\n        \"score\": 0,\n        \"grade\": \"F\",\n        \"issues\": 8,\n        \"weight\": 1.5\n      },\n      {\n        \"category\": \"CRAWL\",\n        \"score\": 0,\n        \"grade\": \"F\",\n        \"issues\": 1,\n        \"weight\": 1.2\n      },\n      {\n        \"category\": \"A11Y\",\n        \"score\": 0,\n        \"grade\": \"F\",\n        \"issues\": 1,\n        \"weight\": 1.2\n      },\n      {\n        \"category\": \"KG\",\n        \"score\": 0,\n        \"grade\": \"F\",\n        \"issues\": 1,\n        \"weight\": 1.1\n      }\n    ],\n    \"severity_breakdown\": {\n      \"info\": 0,\n      \"low\": 1,\n      \"medium\": 3,\n      \"high\": 6,\n      \"critical\": 1\n    }\n  }\n}",
-    "{\n  \"version\": \"1.0.0\",\n  \"audit_id\": \"0df2d7d8-26e6-4da7-92d0-5b7a9b9d32c9\",\n  \"scanned_at\": \"2025-12-15T12:03:33.268Z\",\n  \"input\": {\n    \"requested_url\": \"https://github.com?locale=ja\",\n    \"final_url\": \"https://github.com?locale=ja\",\n    \"status_code\": 200,\n    \"redirect_chain\": []\n  },\n  \"scores\": {\n    \"crawlability\": 76,\n    \"structure\": 50,\n    \"schema_coverage\": 50,\n    \"content_clarity\": 5,\n    \"ai_readiness\": 51,\n    \"overall\": 50.8\n  },\n  \"entities\": [],\n  \"issues\": [\n    {\n      \"id\": \"KG-001\",\n      \"severity\": \"high\",\n      \"message\": \"No Schema.org structured data\",\n      \"evidence\": \"No JSON-LD structured data found\",\n      \"suggested_fix\": \"Add Schema.org structured data using JSON-LD. Consider Organization, Person, Article, Product, or other relevant schemas.\",\n      \"impact\": \"high\",\n      \"category\": \"schema\"\n    },\n    {\n      \"id\": \"AIREAD-002\",\n      \"severity\": \"high\",\n      \"message\": \"Multiple H1 Headings\",\n      \"evidence\": \"count: 4\",\n      \"suggested_fix\": \"Consider using a single H1 heading for better SEO practices.\",\n      \"impact\": \"high\",\n      \"category\": \"structure\"\n    },\n    {\n      \"id\": \"AIREAD-066\",\n      \"severity\": \"medium\",\n      \"message\": \"Videos without captions\",\n      \"evidence\": \"Videos without captions: 2\",\n      \"suggested_fix\": \"Add <track kind=\\\"captions\\\"> elements to video tags with WebVTT caption files.\",\n      \"impact\": \"medium\",\n      \"category\": \"structure\"\n    },\n    {\n      \"id\": \"CHUNK-002\",\n      \"severity\": \"medium\",\n      \"message\": \"Repetitive text content\",\n      \"evidence\": \"Repetitive patterns: 23, Wasted tokens: ~480, Example: \\\"Search\\n      \\n      \\n          \\n            \\n    \\n\\n          \\n        \\n          \\n          \\n       ...\\\"\",\n      \"suggested_fix\": \"Consolidate repetitive text into a single location. Use references or footnotes instead of repeating the same text multiple times.\",\n      \"impact\": \"medium\",\n      \"category\": \"content\"\n    },\n    {\n      \"id\": \"A11Y-002\",\n      \"severity\": \"medium\",\n      \"message\": \"Form inputs without labels\",\n      \"evidence\": \"Unlabeled inputs: 1\",\n      \"suggested_fix\": \"Add <label> elements associated with inputs via for/id attributes, or use aria-label/aria-labelledby attributes.\",\n      \"impact\": \"medium\",\n      \"category\": \"accessibility\"\n    },\n    {\n      \"id\": \"CHUNK-005\",\n      \"severity\": \"medium\",\n      \"message\": \"Duplicate navigation elements\",\n      \"evidence\": \"Navigation count: 7, Estimated wasted tokens: ~210\",\n      \"suggested_fix\": \"Consolidate navigation into a single element. If multiple navs are needed, ensure they serve distinct purposes and contain unique content.\",\n      \"impact\": \"medium\",\n      \"category\": \"content\"\n    },\n    {\n      \"id\": \"AIREAD-068\",\n      \"severity\": \"low\",\n      \"message\": \"No video transcripts available\",\n      \"evidence\": \"Videos: 2, No transcript links\",\n      \"suggested_fix\": \"Provide full text transcripts for videos. Link to them near the video or include them on the page.\",\n      \"impact\": \"low\",\n      \"category\": \"structure\"\n    },\n    {\n      \"id\": \"CRAWL-014\",\n      \"severity\": \"low\",\n      \"message\": \"Excessive external resources\",\n      \"evidence\": \"Total external resources: 123\",\n      \"suggested_fix\": \"Consolidate resources, use sprite sheets, inline critical assets, and defer non-critical loads.\",\n      \"impact\": \"low\",\n      \"category\": \"crawl\"\n    }\n  ],\n  \"recommendations\": [\n    {\n      \"issue_id\": \"KG-001\",\n      \"fix\": \"Add Schema.org structured data using JSON-LD. Consider Organization, Person, Article, Product, or other relevant schemas.\",\n      \"impact\": \"high\"\n    },\n    {\n      \"issue_id\": \"AIREAD-002\",\n      \"fix\": \"Consider using a single H1 heading for better SEO practices.\",\n      \"impact\": \"high\"\n    }\n  ],\n  \"detailed_scoring\": {\n    \"overall_score\": 50.8,\n    \"grade\": \"D\",\n    \"category_scores\": [\n      {\n        \"category\": \"AIREAD\",\n        \"score\": 0,\n        \"grade\": \"F\",\n        \"issues\": 3,\n        \"weight\": 1.5\n      },\n      {\n        \"category\": \"CHUNK\",\n        \"score\": 0,\n        \"grade\": \"F\",\n        \"issues\": 2,\n        \"weight\": 1.3\n      },\n      {\n        \"category\": \"KG\",\n        \"score\": 0,\n        \"grade\": \"F\",\n        \"issues\": 1,\n        \"weight\": 1.1\n      },\n      {\n        \"category\": \"A11Y\",\n        \"score\": 10,\n        \"grade\": \"F\",\n        \"issues\": 1,\n        \"weight\": 1.2\n      },\n      {\n        \"category\": \"CRAWL\",\n        \"score\": 76,\n        \"grade\": \"B\",\n        \"issues\": 1,\n        \"weight\": 1.2\n      }\n    ],\n    \"severity_breakdown\": {\n      \"info\": 0,\n      \"low\": 2,\n      \"medium\": 4,\n      \"high\": 2,\n      \"critical\": 0\n    }\n  }\n}",
-    "{\n  \"version\": \"1.0.0\",\n  \"audit_id\": \"23dc8a46-ff6c-413b-bd93-5f071689f675\",\n  \"scanned_at\": \"2025-12-15T12:03:33.414Z\",\n  \"input\": {\n    \"requested_url\": \"https://github.com?locale=ko\",\n    \"final_url\": \"https://github.com?locale=ko\",\n    \"status_code\": 200,\n    \"redirect_chain\": []\n  },\n  \"scores\": {\n    \"crawlability\": 0,\n    \"structure\": 50,\n    \"schema_coverage\": 50,\n    \"content_clarity\": 5,\n    \"ai_readiness\": 42,\n    \"overall\": 42.2\n  },\n  \"entities\": [],\n  \"issues\": [\n    {\n      \"id\": \"CHUNK-001\",\n      \"severity\": \"critical\",\n      \"message\": \"Chunk exceeds recommended token/window size\",\n      \"evidence\": \"tokens:2045\",\n      \"suggested_fix\": \"Break content into smaller semantic sections using headings or create separate pages for distinct topics.\",\n      \"impact\": \"critical\",\n      \"category\": \"content\"\n    },\n    {\n      \"id\": \"KG-001\",\n      \"severity\": \"high\",\n      \"message\": \"No Schema.org structured data\",\n      \"evidence\": \"No JSON-LD structured data found\",\n      \"suggested_fix\": \"Add Schema.org structured data using JSON-LD. Consider Organization, Person, Article, Product, or other relevant schemas.\",\n      \"impact\": \"high\",\n      \"category\": \"schema\"\n    },\n    {\n      \"id\": \"AIREAD-002\",\n      \"severity\": \"high\",\n      \"message\": \"Multiple H1 Headings\",\n      \"evidence\": \"count: 4\",\n      \"suggested_fix\": \"Consider using a single H1 heading for better SEO practices.\",\n      \"impact\": \"high\",\n      \"category\": \"structure\"\n    },\n    {\n      \"id\": \"AIREAD-066\",\n      \"severity\": \"medium\",\n      \"message\": \"Videos without captions\",\n      \"evidence\": \"Videos without captions: 2\",\n      \"suggested_fix\": \"Add <track kind=\\\"captions\\\"> elements to video tags with WebVTT caption files.\",\n      \"impact\": \"medium\",\n      \"category\": \"structure\"\n    },\n    {\n      \"id\": \"CHUNK-002\",\n      \"severity\": \"medium\",\n      \"message\": \"Repetitive text content\",\n      \"evidence\": \"Repetitive patterns: 24, Wasted tokens: ~1650, Example: \\\"Search\\n      \\n      \\n          \\n            \\n    \\n\\n          \\n        \\n          \\n          \\n       ...\\\"\",\n      \"suggested_fix\": \"Consolidate repetitive text into a single location. Use references or footnotes instead of repeating the same text multiple times.\",\n      \"impact\": \"medium\",\n      \"category\": \"content\"\n    },\n    {\n      \"id\": \"CRAWL-004\",\n      \"severity\": \"medium\",\n      \"message\": \"Canonical points to different URL\",\n      \"evidence\": \"Current: https://github.com/?locale=ko, Canonical: https://github.com/\",\n      \"suggested_fix\": \"Ensure canonical URL matches the current page URL unless intentionally consolidating duplicate content.\",\n      \"impact\": \"medium\",\n      \"category\": \"crawl\"\n    },\n    {\n      \"id\": \"A11Y-002\",\n      \"severity\": \"medium\",\n      \"message\": \"Form inputs without labels\",\n      \"evidence\": \"Unlabeled inputs: 1\",\n      \"suggested_fix\": \"Add <label> elements associated with inputs via for/id attributes, or use aria-label/aria-labelledby attributes.\",\n      \"impact\": \"medium\",\n      \"category\": \"accessibility\"\n    },\n    {\n      \"id\": \"CHUNK-005\",\n      \"severity\": \"medium\",\n      \"message\": \"Duplicate navigation elements\",\n      \"evidence\": \"Navigation count: 7, Estimated wasted tokens: ~220\",\n      \"suggested_fix\": \"Consolidate navigation into a single element. If multiple navs are needed, ensure they serve distinct purposes and contain unique content.\",\n      \"impact\": \"medium\",\n      \"category\": \"content\"\n    },\n    {\n      \"id\": \"AIREAD-068\",\n      \"severity\": \"low\",\n      \"message\": \"No video transcripts available\",\n      \"evidence\": \"Videos: 2, No transcript links\",\n      \"suggested_fix\": \"Provide full text transcripts for videos. Link to them near the video or include them on the page.\",\n      \"impact\": \"low\",\n      \"category\": \"structure\"\n    },\n    {\n      \"id\": \"CRAWL-014\",\n      \"severity\": \"low\",\n      \"message\": \"Excessive external resources\",\n      \"evidence\": \"Total external resources: 123\",\n      \"suggested_fix\": \"Consolidate resources, use sprite sheets, inline critical assets, and defer non-critical loads.\",\n      \"impact\": \"low\",\n      \"category\": \"crawl\"\n    }\n  ],\n  \"recommendations\": [\n    {\n      \"issue_id\": \"CHUNK-001\",\n      \"fix\": \"Break content into smaller semantic sections using headings or create separate pages for distinct topics.\",\n      \"impact\": \"critical\"\n    },\n    {\n      \"issue_id\": \"KG-001\",\n      \"fix\": \"Add Schema.org structured data using JSON-LD. Consider Organization, Person, Article, Product, or other relevant schemas.\",\n      \"impact\": \"high\"\n    },\n    {\n      \"issue_id\": \"AIREAD-002\",\n      \"fix\": \"Consider using a single H1 heading for better SEO practices.\",\n      \"impact\": \"high\"\n    }\n  ],\n  \"detailed_scoring\": {\n    \"overall_score\": 42.2,\n    \"grade\": \"F\",\n    \"category_scores\": [\n      {\n        \"category\": \"AIREAD\",\n        \"score\": 0,\n        \"grade\": \"F\",\n        \"issues\": 3,\n        \"weight\": 1.5\n      },\n      {\n        \"category\": \"CHUNK\",\n        \"score\": 0,\n        \"grade\": \"F\",\n        \"issues\": 3,\n        \"weight\": 1.3\n      },\n      {\n        \"category\": \"CRAWL\",\n        \"score\": 0,\n        \"grade\": \"F\",\n        \"issues\": 2,\n        \"weight\": 1.2\n      },\n      {\n        \"category\": \"KG\",\n        \"score\": 0,\n        \"grade\": \"F\",\n        \"issues\": 1,\n        \"weight\": 1.1\n      },\n      {\n        \"category\": \"A11Y\",\n        \"score\": 10,\n        \"grade\": \"F\",\n        \"issues\": 1,\n        \"weight\": 1.2\n      }\n    ],\n    \"severity_breakdown\": {\n      \"info\": 0,\n      \"low\": 2,\n      \"medium\": 5,\n      \"high\": 2,\n      \"critical\": 1\n    }\n  }\n}",
-    "{\n  \"version\": \"1.0.0\",\n  \"audit_id\": \"ecff4294-466b-453d-9241-6712aa03f497\",\n  \"scanned_at\": \"2025-12-15T12:03:33.564Z\",\n  \"input\": {\n    \"requested_url\": \"https://github.com?locale=pt\",\n    \"final_url\": \"https://github.com?locale=pt\",\n    \"status_code\": 200,\n    \"redirect_chain\": []\n  },\n  \"scores\": {\n    \"crawlability\": 0,\n    \"structure\": 50,\n    \"schema_coverage\": 50,\n    \"content_clarity\": 5,\n    \"ai_readiness\": 42,\n    \"overall\": 42.2\n  },\n  \"entities\": [],\n  \"issues\": [\n    {\n      \"id\": \"CHUNK-001\",\n      \"severity\": \"critical\",\n      \"message\": \"Chunk exceeds recommended token/window size\",\n      \"evidence\": \"tokens:2045\",\n      \"suggested_fix\": \"Break content into smaller semantic sections using headings or create separate pages for distinct topics.\",\n      \"impact\": \"critical\",\n      \"category\": \"content\"\n    },\n    {\n      \"id\": \"KG-001\",\n      \"severity\": \"high\",\n      \"message\": \"No Schema.org structured data\",\n      \"evidence\": \"No JSON-LD structured data found\",\n      \"suggested_fix\": \"Add Schema.org structured data using JSON-LD. Consider Organization, Person, Article, Product, or other relevant schemas.\",\n      \"impact\": \"high\",\n      \"category\": \"schema\"\n    },\n    {\n      \"id\": \"AIREAD-002\",\n      \"severity\": \"high\",\n      \"message\": \"Multiple H1 Headings\",\n      \"evidence\": \"count: 4\",\n      \"suggested_fix\": \"Consider using a single H1 heading for better SEO practices.\",\n      \"impact\": \"high\",\n      \"category\": \"structure\"\n    },\n    {\n      \"id\": \"AIREAD-066\",\n      \"severity\": \"medium\",\n      \"message\": \"Videos without captions\",\n      \"evidence\": \"Videos without captions: 2\",\n      \"suggested_fix\": \"Add <track kind=\\\"captions\\\"> elements to video tags with WebVTT caption files.\",\n      \"impact\": \"medium\",\n      \"category\": \"structure\"\n    },\n    {\n      \"id\": \"CHUNK-002\",\n      \"severity\": \"medium\",\n      \"message\": \"Repetitive text content\",\n      \"evidence\": \"Repetitive patterns: 24, Wasted tokens: ~1650, Example: \\\"Search\\n      \\n      \\n          \\n            \\n    \\n\\n          \\n        \\n          \\n          \\n       ...\\\"\",\n      \"suggested_fix\": \"Consolidate repetitive text into a single location. Use references or footnotes instead of repeating the same text multiple times.\",\n      \"impact\": \"medium\",\n      \"category\": \"content\"\n    },\n    {\n      \"id\": \"CRAWL-004\",\n      \"severity\": \"medium\",\n      \"message\": \"Canonical points to different URL\",\n      \"evidence\": \"Current: https://github.com/?locale=pt, Canonical: https://github.com/\",\n      \"suggested_fix\": \"Ensure canonical URL matches the current page URL unless intentionally consolidating duplicate content.\",\n      \"impact\": \"medium\",\n      \"category\": \"crawl\"\n    },\n    {\n      \"id\": \"A11Y-002\",\n      \"severity\": \"medium\",\n      \"message\": \"Form inputs without labels\",\n      \"evidence\": \"Unlabeled inputs: 1\",\n      \"suggested_fix\": \"Add <label> elements associated with inputs via for/id attributes, or use aria-label/aria-labelledby attributes.\",\n      \"impact\": \"medium\",\n      \"category\": \"accessibility\"\n    },\n    {\n      \"id\": \"CHUNK-005\",\n      \"severity\": \"medium\",\n      \"message\": \"Duplicate navigation elements\",\n      \"evidence\": \"Navigation count: 7, Estimated wasted tokens: ~220\",\n      \"suggested_fix\": \"Consolidate navigation into a single element. If multiple navs are needed, ensure they serve distinct purposes and contain unique content.\",\n      \"impact\": \"medium\",\n      \"category\": \"content\"\n    },\n    {\n      \"id\": \"AIREAD-068\",\n      \"severity\": \"low\",\n      \"message\": \"No video transcripts available\",\n      \"evidence\": \"Videos: 2, No transcript links\",\n      \"suggested_fix\": \"Provide full text transcripts for videos. Link to them near the video or include them on the page.\",\n      \"impact\": \"low\",\n      \"category\": \"structure\"\n    },\n    {\n      \"id\": \"CRAWL-014\",\n      \"severity\": \"low\",\n      \"message\": \"Excessive external resources\",\n      \"evidence\": \"Total external resources: 123\",\n      \"suggested_fix\": \"Consolidate resources, use sprite sheets, inline critical assets, and defer non-critical loads.\",\n      \"impact\": \"low\",\n      \"category\": \"crawl\"\n    }\n  ],\n  \"recommendations\": [\n    {\n      \"issue_id\": \"CHUNK-001\",\n      \"fix\": \"Break content into smaller semantic sections using headings or create separate pages for distinct topics.\",\n      \"impact\": \"critical\"\n    },\n    {\n      \"issue_id\": \"KG-001\",\n      \"fix\": \"Add Schema.org structured data using JSON-LD. Consider Organization, Person, Article, Product, or other relevant schemas.\",\n      \"impact\": \"high\"\n    },\n    {\n      \"issue_id\": \"AIREAD-002\",\n      \"fix\": \"Consider using a single H1 heading for better SEO practices.\",\n      \"impact\": \"high\"\n    }\n  ],\n  \"detailed_scoring\": {\n    \"overall_score\": 42.2,\n    \"grade\": \"F\",\n    \"category_scores\": [\n      {\n        \"category\": \"AIREAD\",\n        \"score\": 0,\n        \"grade\": \"F\",\n        \"issues\": 3,\n        \"weight\": 1.5\n      },\n      {\n        \"category\": \"CHUNK\",\n        \"score\": 0,\n        \"grade\": \"F\",\n        \"issues\": 3,\n        \"weight\": 1.3\n      },\n      {\n        \"category\": \"CRAWL\",\n        \"score\": 0,\n        \"grade\": \"F\",\n        \"issues\": 2,\n        \"weight\": 1.2\n      },\n      {\n        \"category\": \"KG\",\n        \"score\": 0,\n        \"grade\": \"F\",\n        \"issues\": 1,\n        \"weight\": 1.1\n      },\n      {\n        \"category\": \"A11Y\",\n        \"score\": 10,\n        \"grade\": \"F\",\n        \"issues\": 1,\n        \"weight\": 1.2\n      }\n    ],\n    \"severity_breakdown\": {\n      \"info\": 0,\n      \"low\": 2,\n      \"medium\": 5,\n      \"high\": 2,\n      \"critical\": 1\n    }\n  }\n}"
-  ],
-  "summary": {
-    "avgOverallScore": 47.85999999999999,
-    "avgAIReadinessScore": 0,
-    "totalIssues": 48,
-    "issuesBySeverity": {
-      "critical": 4,
-      "high": 14,
-      "medium": 21,
-      "low": 9,
-      "info": 0
-    },
-    "pagesWithCriticalIssues": 4
-  }
-}

package/CLI_UI_README.md

@@ -1,211 +0,0 @@
-# AI Lighthouse Beautiful CLI
-
-The AI Lighthouse CLI now features:
-- 🧙‍♂️ **Interactive Setup Wizard** - No complex flags needed!
-- 🎨 **Beautiful Terminal UI** - Built with React (using Ink)
-- 📊 **Full Feature Parity** - Matches the web version's functionality
-
-## Features
-
-### Interactive UI Components
-
-- **Beautiful Score Display** - Animated score with gradient text and grade badges
-- **Tab Navigation** - Navigate through 6 different analysis sections using arrow keys or number keys
-- **Real-time Loading States** - Beautiful loading spinners with progress indicators
-- **Color-coded Data** - All severity levels, scores, and statuses are color-coded for easy scanning
-- **Progress Bars** - Visual progress bars for all dimension scores
-- **Expandable Sections** - Organized data in bordered, color-coded sections
-
-### Analysis Sections
-
-1. **Overview Tab** - AI readiness summary with:
-   - AI Agent Perspective (Can Understand, Extract, Index, Answer)
-   - Dimension scores with progress bars
-   - Quick Wins section
-
-2. **Issues Tab** - Comprehensive issue reporting with:
-   - Issue summary by severity
-   - Color-coded issue cards
-   - Detailed fix recommendations
-   - Category and impact information
-
-3. **AI Understanding Tab** - LLM analysis including:
-   - Inferred page type
-   - AI-generated insights
-   - Key topics and entities
-   - Questions AI can answer
-   - Suggested FAQs
-
-4. **Hallucination Risk Tab** - Risk assessment with:
-   - Overall risk score
-   - Fact check summary
-   - High-risk triggers
-   - Verification recommendations
-
-5. **Message Alignment Tab** - AI understanding check showing:
-   - Alignment and clarity scores
-   - What AI actually understood about your site
-   - Priority mismatches
-   - Recommendations
-
-6. **Technical Tab** - Technical analysis including:
-   - Category scores (Crawlability, Structure, Schema Coverage, Content Clarity)
-   - Chunking analysis
-   - Extractability metrics
-
-## Usage
-
-### Interactive Mode (Default)
-
-```bash
-ai-lighthouse audit https://example.com
-```
-
-This will launch the interactive UI with tab navigation. Use:
-- **← →** arrow keys to navigate between tabs
-- **1-6** number keys to jump to specific tabs
-- **Ctrl+C** to exit
-
-### Interactive Mode with LLM Analysis
-
-```bash
-ai-lighthouse audit https://example.com --enable-llm --llm-provider openai --llm-api-key YOUR_KEY
-```
-
-### Interactive Mode with All Features
-
-```bash
-ai-lighthouse audit https://example.com \
-  --enable-llm \
-  --enable-chunking \
-  --enable-extractability \
-  --enable-hallucination \
-  --llm-provider openai \
-  --llm-api-key YOUR_KEY
-```
-
-### Export Modes (Non-interactive)
-
-For automated workflows, you can export to various formats:
-
-```bash
-# JSON export (for CI/CD)
-ai-lighthouse audit https://example.com --output json
-
-# HTML report
-ai-lighthouse audit https://example.com --output html
-
-# PDF report
-ai-lighthouse audit https://example.com --output pdf
-
-# Lighthouse format
-ai-lighthouse audit https://example.com --output lhr
-
-# CSV export
-ai-lighthouse audit https://example.com --output csv
-```
-
-## UI Components
-
-All UI components are built with React and Ink, located in `src/ui/`:
-
-- `AuditReportUI.tsx` - Main container with tab navigation
-- `components/ScoreDisplay.tsx` - Animated score display with gradient
-- `components/OverviewSection.tsx` - Overview tab with dimensions
-- `components/IssuesSection.tsx` - Issues list with filtering
-- `components/AIUnderstandingSection.tsx` - LLM analysis display
-- `components/HallucinationSection.tsx` - Hallucination risk display
-- `components/MessageAlignmentSection.tsx` - Message alignment display
-- `components/TechnicalSection.tsx` - Technical metrics display
-
-## Design System
-
-### Colors
-
-- **Critical**: Red
-- **High**: Magenta/Orange
-- **Medium**: Yellow
-- **Low**: Blue
-- **Success**: Green
-- **Info**: Cyan
-
-### Icons
-
-- 📊 Overview
-- ⚠️ Issues
-- 🧠 AI Understanding
-- ⚠️ Hallucination Risk
-- 🔍 Message Alignment
-- ⚙️ Technical
-
-### Borders
-
-- Rounded borders for primary sections
-- Single borders for nested content
-- Color-coded borders matching severity/status
-
-## Development
-
-### Running in Development
-
-```bash
-pnpm dev audit https://example.com
-```
-
-### Type Checking
-
-```bash
-pnpm check-types
-```
-
-### Building
-
-The CLI uses `tsx` runtime, so no build step is required. For distribution:
-
-```bash
-pnpm build
-```
-
-## Architecture
-
-The CLI now supports two modes:
-
-1. **Interactive Mode** - Uses Ink to render React components in the terminal
-2. **Export Mode** - Traditional CLI output with spinners and formatted text
-
-The mode is automatically selected based on the `--output` flag:
-- `--output interactive` (default) - Interactive UI
-- `--output json|html|pdf|lhr|csv` - Export modes
-
-## Comparison with Web Version
-
-The CLI UI now matches the web version's functionality:
-
-| Feature | Web | CLI |
-|---------|-----|-----|
-| Score Display | ✅ | ✅ |
-| Tab Navigation | ✅ | ✅ |
-| AI Understanding | ✅ | ✅ |
-| Hallucination Risk | ✅ | ✅ |
-| Message Alignment | ✅ | ✅ |
-| Technical Metrics | ✅ | ✅ |
-| Issues List | ✅ | ✅ |
-| Quick Wins | ✅ | ✅ |
-| Dimension Scores | ✅ | ✅ |
-| Progress Bars | ✅ | ✅ |
-| Color Coding | ✅ | ✅ |
-| Interactive Navigation | ✅ | ✅ |
-| Animations | ✅ | ✅ (Spinners) |
-
-## Future Enhancements
-
-Potential improvements for the CLI UI:
-
-- [ ] Fuzzy search/filter in issues tab
-- [ ] Export current view to file
-- [ ] Side-by-side comparison mode
-- [ ] Chart visualizations (using ASCII art)
-- [ ] Custom color themes
-- [ ] Keyboard shortcuts help overlay
-- [ ] Persistent session state
-- [ ] History/comparison with previous audits

package/EXAMPLES.md

@@ -1,87 +0,0 @@
-# Example Usage
-
-## Basic Audit
-
-```bash
-cd apps/cli
-pnpm dev audit https://example.com
-```
-
-## Audit with HTML Output
-
-```bash
-pnpm dev audit https://github.com --output html
-```
-
-## Audit with All Features Enabled
-
-```bash
-pnpm dev audit https://example.com \
-  --output html \
-  --enable-chunking \
-  --enable-extractability \
-  --enable-hallucination \
-  --enable-llm \
-  --llm-provider ollama \
-  --llm-model qwen2.5:0.5b \
-  --llm-base-url http://localhost:11434
-```
-
-## Crawl Multiple Pages
-
-```bash
-pnpm dev crawl https://example.com --depth 2 --max-pages 10 --output html
-```
-
-## Crawl Using Sitemap
-
-```bash
-pnpm dev crawl https://example.com --sitemap --max-pages 50 --output json
-```
-
-## Generate Report from Previous Run
-
-```bash
-pnpm dev report ./.ai-lighthouse/audit_example_com_2024-12-05T10-30-00.json --open
-```
-
-## CI/CD Integration
-
-```bash
-# Fail build if score is below 80
-pnpm dev audit https://example.com --threshold 80 --output json
-```
-
-## Export to Different Formats
-
-```bash
-# JSON (default)
-pnpm dev audit https://example.com --output json
-
-# HTML (beautiful report)
-pnpm dev audit https://example.com --output html
-
-# Lighthouse-compatible format
-pnpm dev audit https://example.com --output lhr
-
-# CSV for spreadsheets
-pnpm dev audit https://example.com --output csv
-```
-
-## Advanced Options
-
-```bash
-# Fine-tune issue detection
-pnpm dev audit https://example.com \
-  --min-impact 9 \
-  --min-confidence 0.8 \
-  --max-issues 10
-
-# Enable all analysis features
-pnpm dev audit https://example.com \
-  --enable-chunking \
-  --enable-extractability \
-  --enable-hallucination \
-  --enable-llm \
-  --max-chunk-tokens 1500
-```

package/IMPLEMENTATION.md

@@ -1,215 +0,0 @@
-# AI Lighthouse CLI - Implementation Complete
-
-## ✅ What Was Built
-
-A comprehensive command-line interface for the AI Lighthouse scanner with three main commands:
-
-### 1. **audit** - Single Page Auditing
-Audits a single webpage for AI readiness, SEO, and content quality.
-
-**Features:**
-- Multiple output formats (JSON, HTML, LHR, CSV)
-- Configurable rule presets
-- LLM integration support (OpenAI, Anthropic, Ollama, local)
-- Advanced filtering (min impact, confidence thresholds)
-- CI/CD integration with score thresholds
-- Beautiful HTML reports with visualizations
-
-**Example:**
-```bash
-pnpm dev audit https://example.com --output html --enable-llm
-```
-
-### 2. **crawl** - Multi-Page Auditing
-Crawls and audits multiple pages from a website.
-
-**Features:**
-- Configurable crawl depth
-- Sitemap.xml parsing
-- Max pages limit
-- Aggregate scoring across pages
-- Respects robots.txt
-- HTML and JSON reports
-
-**Example:**
-```bash
-pnpm dev crawl https://example.com --depth 2 --sitemap --max-pages 50
-```
-
-### 3. **report** - Report Generation & Viewing
-Generates and views reports from saved audit results.
-
-**Features:**
-- Converts JSON to HTML
-- Opens reports in browser
-- CSV export for analysis
-- Works with both single audits and crawls
-
-**Example:**
-```bash
-pnpm dev report ./.ai-lighthouse/last_run.json --open
-```
-
-## 📦 Project Structure
-
-```
-apps/cli/
-├── src/
-│   ├── index.ts              # Main entry point
-│   └── commands/
-│       ├── audit.ts          # Audit command implementation
-│       ├── crawl.ts          # Crawl command implementation
-│       └── report.ts         # Report command implementation
-├── bin/
-│   └── cli.js                # Executable entry point
-├── package.json
-├── tsconfig.json
-├── README.md                 # Full documentation
-├── EXAMPLES.md               # Usage examples
-└── test.sh                   # Test script
-```
-
-## 🚀 Usage
-
-### Development
-```bash
-cd apps/cli
-pnpm install
-pnpm dev audit https://example.com
-```
-
-### All Commands
-
-```bash
-# Basic audit
-pnpm dev audit https://example.com
-
-# Audit with HTML output
-pnpm dev audit https://example.com --output html
-
-# Enable all features with LLM
-pnpm dev audit https://example.com \
-  --enable-chunking \
-  --enable-extractability \
-  --enable-hallucination \
-  --enable-llm \
-  --llm-provider ollama \
-  --llm-model qwen2.5:0.5b
-
-# Crawl multiple pages
-pnpm dev crawl https://example.com --depth 2 --sitemap
-
-# Generate report from saved results
-pnpm dev report ./.ai-lighthouse/audit_*.json --open
-
-# CI/CD with threshold
-pnpm dev audit https://example.com --threshold 80
-```
-
-## 🎨 Output Formats
-
-### 1. **JSON** (Default)
-Standard JSON format with all audit data. Perfect for CI/CD pipelines and programmatic access.
-
-### 2. **HTML**
-Beautiful, interactive HTML reports with:
-- Score cards with gradients
-- Issue categorization by severity
-- Expandable details
-- Entity detection display
-- Color-coded severity levels
-
-### 3. **LHR** (Lighthouse Report)
-Lighthouse-compatible JSON format for integration with existing Lighthouse tooling and dashboards.
-
-### 4. **CSV**
-Comma-separated values for easy import into spreadsheets and analysis tools.
-
-## 📊 Key Features
-
-### Advanced Filtering
-- `--min-impact`: Only show high-impact issues
-- `--min-confidence`: Filter by confidence score
-- `--max-issues`: Limit number of issues returned
-
-### LLM Integration
-- Multiple providers: OpenAI, Anthropic, Ollama, local models
-- Configurable models and endpoints
-- Optional hallucination detection
-- Content comprehension analysis
-
-### CI/CD Integration
-- `--threshold`: Set minimum score requirement
-- Exit code 1 if below threshold
-- Perfect for automated testing pipelines
-
-### Report Storage
-All results automatically saved to `.ai-lighthouse/` directory with timestamps.
-
-## 🔧 Configuration Options
-
-### Audit Options
-- `-o, --output <format>` - Output format (json, html, lhr, csv)
-- `-r, --rules <preset>` - Rule preset (default, strict, minimal)
-- `--threshold <score>` - Minimum score for CI/CD
-- `--enable-chunking` - Content chunking analysis
-- `--enable-extractability` - Extractability mapping
-- `--enable-hallucination` - Hallucination detection
-- `--enable-llm` - LLM comprehension analysis
-
-### Crawl Options
-- `-d, --depth <number>` - Maximum crawl depth
-- `--sitemap` - Parse sitemap.xml
-- `--max-pages <number>` - Maximum pages to crawl
-- `--follow-external` - Follow external links
-- `--respect-robots` - Respect robots.txt
-
-### Report Options
-- `--open` - Open report in browser
-- `-f, --format <format>` - Output format
-
-## 🎯 Implementation Highlights
-
-1. **Commander.js** for CLI framework
-2. **Chalk** for colored output
-3. **Ora** for elegant spinners
-4. **Open** for browser integration
-5. **Type-safe** integration with scanner package
-6. **Error handling** with helpful messages
-7. **Progress indicators** for long-running tasks
-8. **Flexible output** formats for different use cases
-
-## 📝 Next Steps
-
-To use the CLI:
-
-1. **Development mode:**
-   ```bash
-   cd apps/cli
-   pnpm dev audit https://example.com
-   ```
-
-2. **Install globally (future):**
-   ```bash
-   pnpm install -g @ai-lighthouse/cli
-   ai-lighthouse audit https://example.com
-   ```
-
-3. **CI/CD Integration:**
-   ```yaml
-   - name: Audit Website
-     run: pnpm --filter @ai-lighthouse/cli dev audit ${{ env.URL }} --threshold 80
-   ```
-
-## 🎉 Summary
-
-The AI Lighthouse CLI is now fully functional with:
-- ✅ Three main commands (audit, crawl, report)
-- ✅ Multiple output formats
-- ✅ LLM integration support
-- ✅ CI/CD ready with thresholds
-- ✅ Beautiful HTML reports
-- ✅ Comprehensive documentation
-- ✅ Example scripts and usage guides
-
-The CLI provides a professional, user-friendly interface to the powerful AI Lighthouse scanner engine!