@xyleapp/cli 0.7.0 → 0.8.0

package/bin/xyle.mjs

@@ -7,8 +7,8 @@ const program = new Command();
 
 program
   .name("xyle")
-  .description("SEO Intelligence Engine CLI")
-  .version("0.7.0");
+  .description("SEO & AEO Intelligence Engine CLI")
+  .version("0.8.0");
 
 registerCommands(program);
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@xyleapp/cli",
-  "version": "0.7.0",
-  "description": "CLI for the Xyle SEO Intelligence Engine",
+  "version": "0.8.0",
+  "description": "CLI for the Xyle SEO & AEO Intelligence Engine",
   "type": "module",
   "bin": {
     "xyle": "bin/xyle.mjs"

package/src/commands.mjs

@@ -136,24 +136,61 @@ export function registerCommands(program) {
         if (opts.json) {
           console.log(printJson(data));
         } else {
-          const score = data.score || 0;
-          const color = score >= 0.7 ? "\x1b[32m" : "\x1b[33m";
-          console.log(`${color}SEO Score: ${Math.round(score * 100)}%\x1b[0m`);
-          console.log(`Summary: ${data.summary || ""}`);
+          const scoreBar = (label, score) => {
+            const pct = Math.round((score || 0) * 100);
+            const filled = Math.round(pct / 5);
+            const bar = "\u2588".repeat(filled) + "\u2591".repeat(20 - filled);
+            const color = pct >= 70 ? "\x1b[32m" : pct >= 40 ? "\x1b[33m" : "\x1b[31m";
+            return `  ${label.padEnd(22)} ${color}${bar} ${pct}%\x1b[0m`;
+          };
+
+          // SEO Score Breakdown
+          const bd = data.seo_breakdown;
+          if (bd) {
+            console.log(`\n\x1b[1mSEO Score Breakdown\x1b[0m`);
+            console.log(scoreBar("Overall", bd.overall));
+            console.log(scoreBar("Technical (25%)", bd.technical));
+            console.log(scoreBar("On-Page (30%)", bd.on_page));
+            console.log(scoreBar("Content (25%)", bd.content));
+            console.log(scoreBar("Links (20%)", bd.links));
+          } else {
+            const score = data.score || 0;
+            const color = score >= 0.7 ? "\x1b[32m" : "\x1b[33m";
+            console.log(`${color}SEO Score: ${Math.round(score * 100)}%\x1b[0m`);
+          }
+
+          console.log(`\nSummary: ${data.summary || ""}`);
           const missing = data.missing_topics || [];
           if (missing.length) {
             console.log(`Missing topics: ${missing.join(", ")}`);
           }
-          // AEO Score + Recommendations
+
+          // AEO Score
           if (data.aeo_score != null) {
             const aeoColor = data.aeo_score >= 0.7 ? "\x1b[32m" : "\x1b[33m";
             console.log(`${aeoColor}AEO Score: ${Math.round(data.aeo_score * 100)}%\x1b[0m`);
           }
-          const recs = data.aeo_recommendations || [];
-          if (recs.length) {
-            console.log("AEO Recommendations:");
-            for (const rec of recs) {
-              console.log(`  \x1b[36m\u2192\x1b[0m ${rec}`);
+
+          // Structured Recommendations
+          const structured = data.recommendations || [];
+          if (structured.length) {
+            console.log(`\n\x1b[1mRecommendations\x1b[0m`);
+            const priorityColors = { critical: "\x1b[31m", important: "\x1b[33m", nice_to_have: "\x1b[2m" };
+            const priorityLabels = { critical: "CRITICAL", important: "IMPORTANT", nice_to_have: "NICE" };
+            for (const rec of structured) {
+              const pc = priorityColors[rec.priority] || "\x1b[0m";
+              const pl = priorityLabels[rec.priority] || rec.priority;
+              console.log(`  ${pc}[${pl}]\x1b[0m \x1b[36m${rec.category}\x1b[0m ${rec.title}`);
+              console.log(`         \x1b[2m${rec.description}\x1b[0m`);
+            }
+          } else {
+            // Fallback to old AEO recommendations
+            const recs = data.aeo_recommendations || [];
+            if (recs.length) {
+              console.log("\nAEO Recommendations:");
+              for (const rec of recs) {
+                console.log(`  \x1b[36m\u2192\x1b[0m ${rec}`);
+              }
             }
           }
         }
@@ -199,6 +236,16 @@ export function registerCommands(program) {
         if (opts.json) {
           console.log(printJson(data));
         } else {
+          const check = (v) => (v ? "\x1b[32m\u2713\x1b[0m" : "\x1b[31m\u2717\x1b[0m");
+          const scoreBar = (label, score) => {
+            const pct = Math.round((score || 0) * 100);
+            const filled = Math.round(pct / 5);
+            const bar = "\u2588".repeat(filled) + "\u2591".repeat(20 - filled);
+            const color = pct >= 70 ? "\x1b[32m" : pct >= 40 ? "\x1b[33m" : "\x1b[31m";
+            return `  ${label.padEnd(22)} ${color}${bar} ${pct}%\x1b[0m`;
+          };
+
+          console.log(`\n\x1b[1mCrawl Results\x1b[0m`);
           console.log(`Title:      ${data.title || "-"}`);
           console.log(`Meta desc:  ${data.meta_desc || "-"}`);
           console.log(`Word count: ${data.word_count || 0}`);
@@ -209,11 +256,79 @@ export function registerCommands(program) {
               console.log(`  ${h}`);
             }
           }
+
+          // Technical SEO
+          const tech = data.technical_seo;
+          if (tech) {
+            console.log(`\n\x1b[1mTechnical SEO\x1b[0m`);
+            console.log(
+              `  ${check(tech.is_https)} HTTPS              ${check(tech.has_canonical)} Canonical          ${check(tech.has_viewport)} Viewport`
+            );
+            console.log(
+              `  ${check(tech.has_charset)} Charset            ${check(tech.has_lang)} Lang (${tech.lang_value || "-"})       ${check(tech.has_favicon)} Favicon`
+            );
+            console.log(
+              `  ${check(tech.has_og_title)} OG Title           ${check(tech.has_og_desc)} OG Description     ${check(tech.has_og_image)} OG Image`
+            );
+            console.log(
+              `  ${check(tech.has_twitter_card)} Twitter Card       ${check(tech.has_robots_meta)} Robots Meta        ${check(tech.h1_count === 1)} H1 Count: ${tech.h1_count}`
+            );
+            console.log(`  Title: ${tech.title_length} chars   Meta desc: ${tech.meta_desc_length} chars   Images without alt: ${tech.images_without_alt}/${tech.image_count}`);
+          }
+
+          // Rendering
+          const rendering = data.rendering;
+          if (rendering) {
+            console.log(`\n\x1b[1mRendering\x1b[0m`);
+            const fwLabel = rendering.detected_framework ? `\x1b[35m${rendering.detected_framework}\x1b[0m` : "none";
+            const rtColor = rendering.seo_impact === "good" ? "\x1b[32m" : rendering.seo_impact === "poor" ? "\x1b[31m" : "\x1b[33m";
+            console.log(`  Framework: ${fwLabel}   Type: ${rtColor}${rendering.rendering_type.toUpperCase()}\x1b[0m   SEO Impact: ${rtColor}${rendering.seo_impact}\x1b[0m`);
+            console.log(`  JS Bundles: ${rendering.js_bundle_count}   DOM Content: ${rendering.initial_dom_has_content ? "rich" : "thin"}   Client Router: ${rendering.uses_client_router ? "yes" : "no"}`);
+            if (rendering.rendering_notes) {
+              console.log(`  \x1b[2m${rendering.rendering_notes}\x1b[0m`);
+            }
+          }
+
+          // Content Quality
+          const cq = data.content_quality;
+          if (cq) {
+            console.log(`\n\x1b[1mContent Quality\x1b[0m`);
+            console.log(`  Words: ${cq.word_count}   Sentences: ${cq.sentence_count}   Paragraphs: ${cq.paragraph_count}   Reading time: ${cq.reading_time_minutes} min`);
+            console.log(`  Flesch Reading Ease: ${cq.flesch_reading_ease}   Grade Level: ${cq.flesch_kincaid_grade}   Vocabulary: ${Math.round(cq.vocabulary_richness * 100)}%`);
+            console.log(scoreBar("Humanness Score", cq.humanness_score));
+            console.log(scoreBar("Content Depth", cq.content_depth_score));
+            console.log(scoreBar("E-E-A-T Score", cq.eeat_score));
+            console.log(`  ${check(cq.has_author)} Author    ${check(cq.has_publish_date)} Publish Date    ${check(cq.has_updated_date)} Updated Date    ${check(cq.has_sources_section)} Sources`);
+          }
+
+          // Link Analysis
+          const links = data.link_analysis;
+          if (links) {
+            console.log(`\n\x1b[1mLink Analysis\x1b[0m`);
+            console.log(`  Internal: ${links.internal_link_count}   External: ${links.external_link_count}   Nofollow: ${links.nofollow_link_count}   In content: ${links.links_in_content}`);
+            const aqColor = links.anchor_quality === "good" ? "\x1b[32m" : links.anchor_quality === "poor" ? "\x1b[31m" : "\x1b[33m";
+            console.log(`  Anchor quality: ${aqColor}${links.anchor_quality}\x1b[0m   Generic anchors: ${links.generic_anchor_count}   External ratio: ${Math.round(links.external_link_ratio * 100)}%`);
+            if (links.broken_link_sample && links.broken_link_sample.length) {
+              console.log(`  \x1b[31mBroken links:\x1b[0m`);
+              for (const bl of links.broken_link_sample) {
+                console.log(`    \x1b[31m\u2717\x1b[0m ${bl}`);
+              }
+            }
+          }
+
+          // Blog Signals
+          const blog = data.blog_signals;
+          if (blog && blog.is_blog_post) {
+            console.log(`\n\x1b[1mBlog Signals\x1b[0m`);
+            const freshColor = blog.content_freshness === "fresh" ? "\x1b[32m" : blog.content_freshness === "stale" ? "\x1b[31m" : "\x1b[33m";
+            console.log(`  Author: ${blog.has_author_name || "-"}   Published: ${blog.has_publish_date || "-"}   Freshness: ${freshColor}${blog.content_freshness}\x1b[0m   Reading time: ${blog.estimated_reading_time} min`);
+            console.log(`  ${check(blog.has_social_sharing)} Social sharing`);
+          }
+
           // AEO Signals
           const aeo = data.aeo_signals;
           if (aeo) {
-            console.log("AEO Signals:");
-            const check = (v) => (v ? "\x1b[32m\u2713\x1b[0m" : "\x1b[31m\u2717\x1b[0m");
+            console.log(`\n\x1b[1mAEO Signals\x1b[0m`);
             console.log(
               `  ${check(aeo.has_article_schema)} Article Schema    ${check(aeo.has_faq_schema)} FAQPage Schema    ${check(aeo.has_howto_schema)} HowTo Schema`
             );
@@ -221,15 +336,22 @@ export function registerCommands(program) {
               `  ${check(aeo.heading_hierarchy_valid)} Heading Hierarchy ${check(aeo.has_faq_content)} FAQ Content        ${check(aeo.has_date_modified)} Date Modified`
             );
             console.log(
-              `  ${check(aeo.has_speakable_schema)} Speakable Schema`
+              `  ${check(aeo.has_speakable_schema)} Speakable Schema  ${check(aeo.has_breadcrumb_schema)} Breadcrumb Schema  ${check(aeo.has_org_schema)} Org Schema`
+            );
+            console.log(
+              `  ${check(aeo.has_video_schema)} Video Schema`
             );
             console.log(
               `  Lists: ${aeo.list_count}  Tables: ${aeo.table_count}  Concise answers: ${aeo.concise_answer_count}  Definitions: ${aeo.definition_count}  Citations: ${aeo.citation_count}`
             );
+            console.log(
+              `  Questions: ${aeo.question_count}  Direct answer ratio: ${(aeo.direct_answer_ratio * 100).toFixed(0)}%`
+            );
             if (aeo.avg_sentence_length > 0) {
               console.log(`  Avg sentence length: ${aeo.avg_sentence_length} words`);
             }
           }
+
           const wc = data.word_count || 0;
           if (wc > 0 && wc < 50) {
             console.log(