frontend-guardian 0.1.15 → 0.1.17

package/README.md

@@ -9,6 +9,7 @@ npx frontend-guardian .                    # scan current dir
 npx frontend-guardian ./src                # scan ./src
 npx frontend-guardian . --fail-on-score 70 # exit 1 if score < 70 (for CI)
 npx frontend-guardian . --json             # output JSON
+npx frontend-guardian . --suggest          # AI fix suggestions (hosted API or GEMINI_API_KEY)
 npx frontend-guardian init                 # add .github/workflows/frontend-guardian.yml to repo
 ```
 
@@ -23,10 +24,12 @@ node packages/cli/dist/cli.js .
 
 ## Publish to npm
 
+From repo root:
+
 ```bash
 pnpm run build:packages
 cd packages/core && npm publish --access public
-cd ../cli && npm publish --access public
+cd packages/cli && npm publish --access public
 ```
 
 ## Output

package/dist/cli.js

@@ -4,6 +4,7 @@ import * as path from "path";
 import { fileURLToPath } from "url";
 import chalk from "chalk";
 import ora from "ora";
+import { GoogleGenAI } from "@google/genai";
 import { scanFiles, scanZip } from "@justinmoto/frontend-guardian-core";
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 const EXT = [".js", ".jsx", ".ts", ".tsx", ".css"];
@@ -321,14 +322,17 @@ function parseArgs() {
     const argv = process.argv.slice(2);
     const pathArg = argv[0];
     if (!pathArg || pathArg.startsWith("-")) {
-        return { path: "", json: false, failOnScore: null };
+        return { path: "", json: false, failOnScore: null, suggest: false };
     }
     let json = false;
     let failOnScore = null;
+    let suggest = false;
     for (let i = 1; i < argv.length; i++) {
         const a = argv[i];
         if (a === "--json")
             json = true;
+        else if (a === "--suggest")
+            suggest = true;
         else if (a === "--fail-on-score" && argv[i + 1] != null) {
             const n = parseInt(argv[i + 1], 10);
             if (!Number.isNaN(n) && n >= 0 && n <= 100)
@@ -341,7 +345,29 @@ function parseArgs() {
                 failOnScore = n;
         }
     }
-    return { path: pathArg, json, failOnScore };
+    return { path: pathArg, json, failOnScore, suggest };
+}
+const DEFAULT_SUGGEST_API = "https://frontend-guardian.vercel.app/api/suggest";
+async function getGeminiSuggestion(apiKey, issueTitle, detected) {
+    const ai = new GoogleGenAI({ apiKey });
+    const prompt = `Frontend Guardian found this issue: "${issueTitle}". Detected: ${detected.slice(0, 500)}. Give a brief concrete fix suggestion in 1-2 sentences. No preamble.`;
+    const res = await ai.models.generateContent({ model: "gemini-1.5-flash", contents: prompt });
+    const text = res.text;
+    return (text ?? "").trim();
+}
+async function getSuggestFromBackend(issueTitle, detected) {
+    const url = process.env.FRONTEND_GUARDIAN_SUGGEST_URL || DEFAULT_SUGGEST_API;
+    const res = await fetch(url, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({ issueTitle, detected: detected.slice(0, 500) }),
+    });
+    if (!res.ok) {
+        const err = await res.json().catch(() => ({}));
+        throw new Error(err?.error || `API ${res.status}`);
+    }
+    const data = (await res.json());
+    return (data.suggestion ?? "").trim();
 }
 async function main() {
     const argv = process.argv.slice(2);
@@ -349,14 +375,15 @@ async function main() {
         initWorkflow(process.cwd());
         return;
     }
-    const { path: pathArg, json: outputJson, failOnScore } = parseArgs();
+    const { path: pathArg, json: outputJson, failOnScore, suggest: wantSuggest } = parseArgs();
     if (!pathArg) {
         console.error("Usage: frontend-guardian <path> [options]");
         console.error("       frontend-guardian init   # add GitHub Actions workflow");
         console.error("       npx frontend-guardian .");
         console.error("       npx frontend-guardian . --fail-on-score 70");
         console.error("       npx frontend-guardian . --json");
-        console.error("Options: --json  Output result as JSON. --fail-on-score <0-100>  Exit 1 if score below threshold.");
+        console.error("       npx frontend-guardian . --suggest   # AI fix suggestions (uses hosted API or your GEMINI_API_KEY)");
+        console.error("Options: --json  Output as JSON. --fail-on-score <0-100>  Exit 1 if below. --suggest  Gemini AI suggestions.");
         process.exit(1);
     }
     const resolved = path.resolve(process.cwd(), pathArg);
@@ -414,6 +441,42 @@ async function main() {
     else {
         printResult(projectName, result);
     }
+    if (wantSuggest && result.warnings.length + result.duplicates.length > 0) {
+        const apiKey = process.env.GEMINI_API_KEY;
+        const byTitle = new Map();
+        for (const w of result.warnings) {
+            const { title, detected } = issueType(w);
+            const key = title;
+            if (!byTitle.has(key))
+                byTitle.set(key, detected);
+            else
+                byTitle.set(key, byTitle.get(key) + "; " + detected);
+        }
+        for (const d of result.duplicates) {
+            const key = "Duplicate Components";
+            const detected = d.files.join(", ");
+            if (!byTitle.has(key))
+                byTitle.set(key, detected);
+            else
+                byTitle.set(key, byTitle.get(key) + "; " + detected);
+        }
+        console.log(chalk.cyan("\n  🤖 AI suggestions\n"));
+        const spinner = ora("Getting suggestions...").start();
+        try {
+            for (const [title, detected] of byTitle.entries()) {
+                const suggestion = apiKey
+                    ? await getGeminiSuggestion(apiKey, title, detected)
+                    : await getSuggestFromBackend(title, detected);
+                spinner.stop();
+                console.log("  " + chalk.bold(title) + "\n  " + chalk.gray(suggestion) + "\n");
+                spinner.start("Getting suggestions...");
+            }
+            spinner.succeed("Done.");
+        }
+        catch {
+            spinner.fail("AI suggestions not available at the moment.");
+        }
+    }
     if (failOnScore != null && result.score < failOnScore) {
         const msg = `Score ${result.score} is below required ${failOnScore}. Failing.`;
         if (outputJson)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "frontend-guardian",
-  "version": "0.1.15",
+  "version": "0.1.17",
   "description": "Scan frontend projects for Tailwind & component consistency (Phase 1 CLI)",
   "type": "module",
   "bin": {
@@ -11,6 +11,7 @@
     "build": "tsc"
   },
   "dependencies": {
+    "@google/genai": "^1.0.0",
     "@justinmoto/frontend-guardian-core": "^0.1.15",
     "chalk": "^5.3.0",
     "ora": "^8.0.1"