@xyleapp/cli 0.6.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.5.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.6.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

@@ -4,6 +4,9 @@
  */
 
 import { createRequire } from "node:module";
+import { existsSync } from "node:fs";
+import { resolve } from "node:path";
+import { execSync } from "node:child_process";
 import { printJson, printTable } from "./formatting.mjs";
 import {
   checkHealth,
@@ -133,14 +136,63 @@ 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}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
+          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`);
+          }
+
+          // 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}`);
+              }
+            }
+          }
         }
       } catch (e) {
         handleError(e);
@@ -184,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}`);
@@ -194,6 +256,102 @@ 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(`\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`
+            );
+            console.log(
+              `  ${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_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(
@@ -435,4 +593,38 @@ export function registerCommands(program) {
         );
       }
     });
+
+  // --- deploy ---
+  program
+    .command("deploy")
+    .description("Deploy Xyle services (API, frontend, trigger.dev)")
+    .option("--api", "Deploy API to Cloud Run")
+    .option("--frontend", "Deploy frontend to Vercel")
+    .option("--trigger", "Deploy Trigger.dev tasks")
+    .option("--dir <path>", "Project root directory", process.cwd())
+    .action(async (opts) => {
+      const scriptPath = resolve(opts.dir, "scripts", "deploy.sh");
+      if (!existsSync(scriptPath)) {
+        process.stderr.write(
+          `\x1b[31mDeploy script not found: ${scriptPath}\x1b[0m\n` +
+            `\x1b[2mRun this command from the project root or use --dir <path>\x1b[0m\n`
+        );
+        process.exit(1);
+      }
+
+      const flags = [];
+      if (opts.api) flags.push("--api");
+      if (opts.frontend) flags.push("--frontend");
+      if (opts.trigger) flags.push("--trigger");
+      // No flags = deploy all (script's default behavior)
+
+      const cmd = `bash "${scriptPath}" ${flags.join(" ")}`;
+      console.log(`\x1b[36mRunning:\x1b[0m ${cmd}\n`);
+      try {
+        execSync(cmd, { stdio: "inherit", cwd: opts.dir });
+      } catch (e) {
+        process.stderr.write(`\x1b[31mDeploy failed.\x1b[0m\n`);
+        process.exit(e.status || 1);
+      }
+    });
 }