install-glo 2.0.0 → 2.0.2

package/lib/display.mjs

@@ -0,0 +1,103 @@
+import chalk from "chalk";
+import { VITALS } from "./vitals.mjs";
+
+export function formatVital(key, value) {
+  const info = VITALS[key];
+  if (!info || value === undefined || value === null) return null;
+  const passed = value <= info.good;
+  const formatted =
+    info.unit === "ms" ? `${Math.round(value)}ms` : value.toFixed(3);
+  const icon = passed ? chalk.green("✓") : chalk.red("✗");
+  const color = passed ? chalk.green : chalk.red;
+  return (
+    `    ${chalk.white(key.padEnd(6))}` +
+    `${color(formatted.padStart(9))}` +
+    `  ${chalk.dim(`(good: <${info.good}${info.unit})`)} ${icon}`
+  );
+}
+
+export function printBanner() {
+  const lines = [
+    "",
+    chalk.hex("#FF8C00").bold(
+      "  ┌─────────────────────────────────────────────────────┐"
+    ),
+    chalk.hex("#FF8C00").bold("  │") +
+      chalk.hex("#FF8C00").bold(
+        "             T H E   G L O   L O O P                "
+      ) +
+      chalk.hex("#FF8C00").bold("│"),
+    chalk.hex("#FF8C00").bold("  │") +
+      chalk.dim(
+        "   Web Vitals Optimization Engine                    "
+      ) +
+      chalk.hex("#FF8C00").bold("│"),
+    chalk.hex("#FF8C00").bold("  │") +
+      chalk.dim(
+        "                                                     "
+      ) +
+      chalk.hex("#FF8C00").bold("│"),
+    chalk.hex("#FF8C00").bold("  │") +
+      chalk.hex("#4AF626")("    G") +
+      chalk.white("ather    → ") +
+      chalk.dim("run Lighthouse, extract metrics    ") +
+      chalk.hex("#FF8C00").bold("│"),
+    chalk.hex("#FF8C00").bold("  │") +
+      chalk.hex("#4AF626")("    L") +
+      chalk.white("everage  → ") +
+      chalk.dim("AI analyzes code + diagnostics    ") +
+      chalk.hex("#FF8C00").bold("│"),
+    chalk.hex("#FF8C00").bold("  │") +
+      chalk.hex("#4AF626")("    O") +
+      chalk.white("perate   → ") +
+      chalk.dim("apply fix, re-measure, repeat     ") +
+      chalk.hex("#FF8C00").bold("│"),
+    chalk.hex("#FF8C00").bold("  │") +
+      chalk.dim(
+        "                                                     "
+      ) +
+      chalk.hex("#FF8C00").bold("│"),
+    chalk.hex("#FF8C00").bold("  │") +
+      chalk.dim("    ↻ repeat until target met") +
+      chalk.dim(
+        "                         "
+      ) +
+      chalk.hex("#FF8C00").bold("│"),
+    chalk.hex("#FF8C00").bold(
+      "  └─────────────────────────────────────────────────────┘"
+    ),
+    "",
+  ];
+  console.log(lines.join("\n"));
+}
+
+export function printScore(score) {
+  const colored =
+    score >= 90
+      ? chalk.green(`${score}/100`)
+      : score >= 50
+        ? chalk.yellow(`${score}/100`)
+        : chalk.red(`${score}/100`);
+  console.log(chalk.white(`    Score   `) + chalk.bold(colored));
+}
+
+export function printSuggestion(suggestion) {
+  for (const line of suggestion.split("\n")) {
+    if (
+      line.startsWith("DIAGNOSIS:") ||
+      line.startsWith("FILE:") ||
+      line.startsWith("LINE:") ||
+      line.startsWith("WHY:")
+    ) {
+      const [label, ...rest] = line.split(":");
+      console.log(
+        chalk.hex("#FF8C00")(`    ${label}:`) +
+          chalk.white(rest.join(":"))
+      );
+    } else if (line.startsWith("BEFORE:") || line.startsWith("AFTER:")) {
+      console.log(chalk.hex("#FF8C00")(`    ${line}`));
+    } else {
+      console.log(chalk.hex("#89b4fa")(`    ${line}`));
+    }
+  }
+}

package/lib/lighthouse.mjs

@@ -0,0 +1,86 @@
+import { execSync as defaultExecSync } from "node:child_process";
+import { VITALS } from "./vitals.mjs";
+
+export function checkLighthouse({ execSync = defaultExecSync } = {}) {
+  try {
+    execSync("npx -y lighthouse --version", { stdio: "pipe" });
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+export function runLighthouse(url, { execSync = defaultExecSync } = {}) {
+  const cmd = [
+    "npx -y lighthouse",
+    `"${url}"`,
+    "--output=json",
+    '--chrome-flags="--headless --no-sandbox"',
+    "--only-categories=performance",
+    "--quiet",
+  ].join(" ");
+
+  const result = execSync(cmd, {
+    maxBuffer: 100 * 1024 * 1024,
+    stdio: ["pipe", "pipe", "pipe"],
+  });
+  return JSON.parse(result.toString());
+}
+
+export function extractMetrics(report) {
+  const metrics = {};
+  for (const [key, info] of Object.entries(VITALS)) {
+    const audit = report.audits?.[info.audit];
+    if (audit) {
+      metrics[key] = {
+        value: audit.numericValue,
+        display: audit.displayValue,
+        score: audit.score,
+      };
+    }
+  }
+  metrics.performanceScore = Math.round(
+    (report.categories?.performance?.score || 0) * 100
+  );
+  return metrics;
+}
+
+export function extractDiagnostics(report) {
+  const relevant = [
+    "render-blocking-resources",
+    "unused-css-rules",
+    "unused-javascript",
+    "modern-image-formats",
+    "uses-optimized-images",
+    "uses-responsive-images",
+    "offscreen-images",
+    "unminified-css",
+    "unminified-javascript",
+    "dom-size",
+    "critical-request-chains",
+    "largest-contentful-paint-element",
+    "layout-shift-elements",
+    "long-tasks",
+    "mainthread-work-breakdown",
+    "bootup-time",
+    "font-display",
+    "uses-text-compression",
+    "duplicated-javascript",
+    "legacy-javascript",
+    "total-byte-weight",
+  ];
+
+  const issues = [];
+  for (const id of relevant) {
+    const audit = report.audits?.[id];
+    if (audit && audit.score !== null && audit.score < 1) {
+      issues.push({
+        id,
+        title: audit.title,
+        displayValue: audit.displayValue || "",
+        score: audit.score,
+      });
+    }
+  }
+  return issues.sort((a, b) => a.score - b.score);
+}

package/lib/model.mjs

@@ -0,0 +1,21 @@
+import { createAnthropic as defaultCreateAnthropic } from "@ai-sdk/anthropic";
+import { createOpenAI as defaultCreateOpenAI } from "@ai-sdk/openai";
+
+export function getModel({
+  env = process.env,
+  createAnthropic = defaultCreateAnthropic,
+  createOpenAI = defaultCreateOpenAI,
+} = {}) {
+  if (env.ANTHROPIC_API_KEY) {
+    const anthropic = createAnthropic();
+    return {
+      model: anthropic("claude-sonnet-4-20250514"),
+      label: "Claude (Anthropic)",
+    };
+  }
+  if (env.OPENAI_API_KEY) {
+    const openai = createOpenAI();
+    return { model: openai("gpt-4o-mini"), label: "GPT-4o-mini (OpenAI)" };
+  }
+  return null;
+}

package/lib/source-discovery.mjs

@@ -0,0 +1,111 @@
+import {
+  readFileSync as defaultReadFileSync,
+  existsSync as defaultExistsSync,
+} from "node:fs";
+import { join, relative } from "node:path";
+
+const MAX_FILE_SIZE = 15_000;
+const MAX_IMPORT_SIZE = 8_000;
+
+function pageCandidates(routePath) {
+  return [
+    // Next.js App Router
+    join("app", routePath, "page.tsx"),
+    join("app", routePath, "page.jsx"),
+    join("app", routePath, "page.js"),
+    join("app", routePath, "layout.tsx"),
+    join("app", routePath, "layout.jsx"),
+    join("app", "layout.tsx"),
+    join("app", "layout.jsx"),
+    // src/app
+    join("src", "app", routePath, "page.tsx"),
+    join("src", "app", routePath, "layout.tsx"),
+    join("src", "app", "layout.tsx"),
+    // Next.js Pages Router
+    join("pages", routePath + ".tsx"),
+    join("pages", routePath + ".jsx"),
+    join("pages", routePath, "index.tsx"),
+    join("pages", routePath, "index.jsx"),
+    // Config files relevant to performance
+    "next.config.ts",
+    "next.config.js",
+    "next.config.mjs",
+    "vite.config.ts",
+    "vite.config.js",
+  ];
+}
+
+function truncate(content, limit) {
+  return content.length > limit
+    ? content.slice(0, limit) + "\n// ... truncated"
+    : content;
+}
+
+function safeRead(fullPath, limit, { readFileSync, existsSync }) {
+  if (!existsSync(fullPath)) return null;
+  try {
+    const content = readFileSync(fullPath, "utf8");
+    return truncate(content, limit);
+  } catch {
+    return null;
+  }
+}
+
+function resolveImports(pageFile, projectRoot, files, { readFileSync, existsSync }) {
+  const importRegex = /from\s+["']([./][^"']+)["']/g;
+  let match;
+  while ((match = importRegex.exec(pageFile.content)) !== null) {
+    const importPath = match[1];
+    const possiblePaths = [
+      importPath + ".tsx",
+      importPath + ".jsx",
+      importPath + ".ts",
+      importPath + ".js",
+      join(importPath, "index.tsx"),
+    ];
+    for (const p of possiblePaths) {
+      const resolved = join(
+        projectRoot,
+        pageFile.path.replace(/[^/]+$/, ""),
+        p
+      );
+      if (existsSync(resolved)) {
+        const content = safeRead(resolved, MAX_IMPORT_SIZE, { readFileSync, existsSync });
+        if (content !== null) {
+          const relPath = relative(projectRoot, resolved);
+          if (!files.find((f) => f.path === relPath)) {
+            files.push({ path: relPath, content });
+          }
+        }
+        break;
+      }
+    }
+  }
+}
+
+export function discoverPageFiles(
+  projectRoot,
+  route,
+  { readFileSync = defaultReadFileSync, existsSync = defaultExistsSync } = {}
+) {
+  const routePath = route === "/" ? "" : route.replace(/^\//, "");
+  const files = [];
+  const deps = { readFileSync, existsSync };
+
+  const seen = new Set();
+  for (const rel of pageCandidates(routePath)) {
+    if (seen.has(rel)) continue;
+    seen.add(rel);
+    const full = join(projectRoot, rel);
+    const content = safeRead(full, MAX_FILE_SIZE, deps);
+    if (content !== null) {
+      files.push({ path: rel, content });
+    }
+  }
+
+  if (files.length > 0) {
+    resolveImports(files[0], projectRoot, files, deps);
+  }
+
+  return files;
+}

package/lib/vitals.mjs

@@ -0,0 +1,40 @@
+// Web Vitals constants and thresholds
+
+export const VITALS = {
+  LCP: {
+    good: 2500,
+    unit: "ms",
+    name: "Largest Contentful Paint",
+    audit: "largest-contentful-paint",
+  },
+  FCP: {
+    good: 1800,
+    unit: "ms",
+    name: "First Contentful Paint",
+    audit: "first-contentful-paint",
+  },
+  CLS: {
+    good: 0.1,
+    unit: "",
+    name: "Cumulative Layout Shift",
+    audit: "cumulative-layout-shift",
+  },
+  TBT: {
+    good: 200,
+    unit: "ms",
+    name: "Total Blocking Time",
+    audit: "total-blocking-time",
+  },
+  SI: {
+    good: 3400,
+    unit: "ms",
+    name: "Speed Index",
+    audit: "speed-index",
+  },
+  TTFB: {
+    good: 800,
+    unit: "ms",
+    name: "Time to First Byte",
+    audit: "server-response-time",
+  },
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "install-glo",
-  "version": "2.0.0",
+  "version": "2.0.2",
   "description": "GLO Loop — AI-powered web vitals optimization engine built with Vercel AI SDK",
   "main": "index.mjs",
   "bin": {
@@ -10,7 +10,8 @@
     "about-glo-loop": "about.mjs"
   },
   "scripts": {
-    "postinstall": "node postinstall.mjs"
+    "postinstall": "node postinstall.mjs",
+    "test": "node --test __tests__/*.test.mjs"
   },
   "type": "module",
   "keywords": [
@@ -35,6 +36,7 @@
     "@ai-sdk/openai": "^3.0.47",
     "ai": "^6.0.134",
     "boxen": "^8.0.1",
-    "chalk": "^5.4.1"
+    "chalk": "^5.4.1",
+    "zod": "^3.24.0"
   }
 }