laxy-verify 0.1.0

package/README.md

@@ -0,0 +1,163 @@
+# laxy-verify
+
+Frontend quality gate for any project. Checks your build and runs a Lighthouse audit — outputs a Silver/Bronze/Unverified grade.
+
+```bash
+npx laxy-verify .
+```
+
+```
+  Laxy Verify — ✅ Silver
+  ========================================
+
+  Build:          PASS (12.3s)
+
+  Lighthouse Scores:
+    Performance:     87  / 70  ✓
+    Accessibility:   92  / 85  ✓
+    SEO:             88  / 80  ✓
+    Best Practices:  90  / 80  ✓
+
+  Grade: Silver
+```
+
+> Want Gold? Gold requires E2E tests on top of build + Lighthouse. Run full verification at [laxy.dev](https://laxy.dev).
+
+---
+
+## Install
+
+```bash
+# Run once (no install needed)
+npx laxy-verify .
+
+# Or install globally
+npm install -g laxy-verify
+laxy-verify .
+```
+
+---
+
+## Usage
+
+```bash
+laxy-verify [dir] [options]
+
+Arguments:
+  dir                   Project directory (default: current directory)
+
+Options:
+  --format <type>       Output format: console, json, md (default: console)
+  --ci                  CI mode: relaxed thresholds, 3 Lighthouse runs
+  --skip-lighthouse     Build check only, skip Lighthouse
+  --runs <number>       Number of Lighthouse runs
+  --port <number>       Dev server port (default: 3000)
+```
+
+### Examples
+
+```bash
+# Check current directory
+npx laxy-verify .
+
+# Build check only (fast)
+npx laxy-verify . --skip-lighthouse
+
+# CI mode with JSON output
+npx laxy-verify . --ci --format json
+
+# Markdown output (for PR comments)
+npx laxy-verify . --format md
+```
+
+---
+
+## Exit Codes
+
+| Code | Meaning |
+|------|---------|
+| `0` | Silver or Gold — all checks passed |
+| `1` | Bronze — build passed, Lighthouse failed (soft fail) |
+| `2` | Unverified — build failed |
+| `3` | Config error — no package.json, no build script |
+
+---
+
+## Grades
+
+| Grade | Condition |
+|-------|-----------|
+| ✅ Silver | Build passed + all Lighthouse thresholds met |
+| 🔨 Bronze | Build passed, Lighthouse failed or skipped |
+| ⚠️ Unverified | Build failed |
+
+> 🏆 **Gold** requires E2E tests. Use [Laxy](https://laxy.dev) for full Gold verification.
+
+---
+
+## GitHub Action
+
+Add this to `.github/workflows/verify.yml`:
+
+```yaml
+name: Laxy Verify
+
+on:
+  pull_request:
+
+jobs:
+  verify:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: psungmin24/laxy-verify@v1
+        with:
+          format: md
+```
+
+On every PR, laxy-verify will:
+1. Run `npm run build`
+2. Start your dev server and run Lighthouse
+3. Post a comment with the grade and scores
+
+### Action Inputs
+
+| Input | Default | Description |
+|-------|---------|-------------|
+| `node-version` | `20` | Node.js version |
+| `skip-lighthouse` | `false` | Build check only |
+| `format` | `md` | Output format |
+
+---
+
+## Configuration
+
+Create `.laxy.yml` in your project root to customize thresholds:
+
+```yaml
+thresholds:
+  performance: 70
+  accessibility: 85
+  seo: 80
+  bestPractices: 80
+
+port: 3000
+runs: 1
+```
+
+---
+
+## Supported Frameworks
+
+Automatically detects and runs the right build command:
+
+- **Next.js** — `next build`
+- **Vite** — `vite build`
+- **Create React App** — `react-scripts build`
+- **Custom** — reads `scripts.build` from `package.json`
+
+---
+
+## License
+
+MIT

package/action.yml

@@ -0,0 +1,97 @@
+name: 'Laxy Verify'
+description: 'Frontend quality gate: build check + Lighthouse audit + verification grade'
+inputs:
+  threshold-config:
+    description: 'Path to .laxy.yml threshold config'
+    required: false
+    default: '.laxy.yml'
+  node-version:
+    description: 'Node.js version'
+    required: false
+    default: '20'
+  skip-lighthouse:
+    description: 'Skip Lighthouse, run build check only'
+    required: false
+    default: 'false'
+outputs:
+  grade:
+    description: 'Verification grade (Gold/Silver/Bronze/Unverified)'
+    value: ${{ steps.verify.outputs.grade }}
+  report:
+    description: 'JSON report string'
+    value: ${{ steps.verify.outputs.report }}
+runs:
+  using: 'composite'
+  steps:
+    - name: Setup Node.js
+      uses: actions/setup-node@v4
+      with:
+        node-version: ${{ inputs.node-version }}
+
+    - name: Install dependencies
+      shell: bash
+      run: npm ci
+
+    - name: Run Laxy Verify
+      id: verify
+      shell: bash
+      run: |
+        SKIP_FLAG=""
+        if [ "${{ inputs.skip-lighthouse }}" = "true" ]; then
+          SKIP_FLAG="--skip-lighthouse"
+        fi
+        npx laxy-verify . --format json --ci $SKIP_FLAG > laxy-report.json 2>&1 || true
+        GRADE=$(node -e "const r=JSON.parse(require('fs').readFileSync('laxy-report.json','utf8'));console.log(r.grade)")
+        echo "grade=$GRADE" >> $GITHUB_OUTPUT
+        echo "report=$(cat laxy-report.json)" >> $GITHUB_OUTPUT
+
+    - name: Post PR Comment
+      if: github.event_name == 'pull_request'
+      uses: actions/github-script@v7
+      with:
+        script: |
+          const fs = require('fs');
+          let report;
+          try {
+            report = JSON.parse(fs.readFileSync('laxy-report.json', 'utf8'));
+          } catch {
+            console.log('No report file found');
+            return;
+          }
+
+          // Generate markdown from report
+          const npx = process.platform === 'win32' ? 'npx.cmd' : 'npx';
+          const { execSync } = require('child_process');
+          let md;
+          try {
+            md = execSync(`${npx} laxy-verify . --format md --ci --skip-lighthouse 2>/dev/null || true`).toString();
+          } catch {
+            md = `## Laxy Verify — ${report.grade}\n\nSee JSON report for details.`;
+          }
+
+          // Find existing comment
+          const marker = '<!-- laxy-verify -->';
+          const { data: comments } = await github.rest.issues.listComments({
+            owner: context.repo.owner,
+            repo: context.repo.repo,
+            issue_number: context.issue.number,
+          });
+          const existing = comments.find(c => c.body?.includes(marker));
+
+          const body = md.includes(marker) ? md : `${marker}\n${md}`;
+
+          if (existing) {
+            await github.rest.issues.updateComment({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              comment_id: existing.id,
+              body,
+            });
+          } else {
+            await github.rest.issues.createComment({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              issue_number: context.issue.number,
+              body,
+            });
+          }

package/dist/build-runner.d.ts

@@ -0,0 +1,22 @@
+export interface BuildError {
+    file?: string;
+    line?: number;
+    col?: number;
+    code?: string;
+    message: string;
+    raw: string;
+}
+export interface BuildCheckResult {
+    success: boolean;
+    errors: string[];
+    structuredErrors: BuildError[];
+    warnings: string[];
+    duration: number;
+    output: string;
+}
+export declare function parseBuildOutput(output: string): {
+    errors: string[];
+    structuredErrors: BuildError[];
+    warnings: string[];
+};
+export declare function runBuild(projectPath: string): Promise<BuildCheckResult>;

package/dist/build-runner.js

@@ -0,0 +1,156 @@
+import { spawn } from "child_process";
+import { readFileSync, existsSync, readdirSync } from "fs";
+import { join } from "path";
+import { detectRuntimeFromFiles, getBuildCommandCandidates, parseProjectPackageJson, } from "./project-runtime.js";
+function parseErrorLine(raw) {
+    const clean = raw.trim();
+    if (!clean)
+        return null;
+    const tsMatch = clean.match(/^(.+?)\((\d+),(\d+)\):\s+error\s+(TS\d+):\s+(.+)$/);
+    if (tsMatch) {
+        return {
+            file: tsMatch[1].trim(),
+            line: parseInt(tsMatch[2], 10),
+            col: parseInt(tsMatch[3], 10),
+            code: tsMatch[4],
+            message: tsMatch[5].slice(0, 200),
+            raw: clean.slice(0, 250),
+        };
+    }
+    if (/error TS\d+:|Module not found|Cannot find module|Failed to resolve|SyntaxError:|Unexpected token|Build error occurred|Failed to compile/i.test(clean)) {
+        return { message: clean.slice(0, 200), raw: clean.slice(0, 250) };
+    }
+    return null;
+}
+export function parseBuildOutput(output) {
+    const errors = [];
+    const structuredErrors = [];
+    const warnings = [];
+    for (const line of output.split("\n")) {
+        const clean = line.trim();
+        if (!clean)
+            continue;
+        const structured = parseErrorLine(clean);
+        if (structured) {
+            errors.push(structured.raw);
+            structuredErrors.push(structured);
+        }
+        else if (/^warn|warning:/i.test(clean)) {
+            warnings.push(clean.slice(0, 150));
+        }
+    }
+    return {
+        errors: errors.slice(0, 20),
+        structuredErrors: structuredErrors.slice(0, 20),
+        warnings: warnings.slice(0, 10),
+    };
+}
+function extractFallbackBuildErrors(output, exitCode) {
+    const meaningfulLines = output
+        .split("\n")
+        .map((l) => l.trim())
+        .filter(Boolean)
+        .filter((l) => !/^warn|warning:|^> |^npm notice/i.test(l));
+    const likelyErrorLines = meaningfulLines.filter((l) => /error|failed|unable|cannot|missing|unexpected|resolve|exception|ELIFECYCLE|ERR!/i.test(l));
+    const selected = (likelyErrorLines.length > 0 ? likelyErrorLines : meaningfulLines)
+        .slice(-5)
+        .map((l) => l.slice(0, 200));
+    if (selected.length > 0)
+        return Array.from(new Set(selected));
+    return [`Build failed with exit code ${exitCode ?? "unknown"} but produced no parsed diagnostics.`];
+}
+function runBuildCommand(command, projectPath) {
+    const startTime = Date.now();
+    return new Promise((resolve) => {
+        const cmd = process.platform === "win32" ? `chcp 65001 > nul && ${command.cmd}` : command.cmd;
+        const child = spawn(cmd, command.args, {
+            cwd: projectPath,
+            shell: true,
+            env: { ...process.env, CI: "true", NODE_ENV: "production" },
+        });
+        let output = "";
+        child.stdout?.on("data", (d) => { output += d.toString(); });
+        child.stderr?.on("data", (d) => { output += d.toString(); });
+        const timeout = setTimeout(() => {
+            child.kill();
+            resolve({
+                success: false,
+                errors: ["Build timed out after 90s"],
+                structuredErrors: [{ message: "Build timed out after 90s", raw: "Build timed out after 90s" }],
+                warnings: [],
+                duration: 90000,
+                output: output.slice(-1000),
+            });
+        }, 90000);
+        child.on("close", (code) => {
+            clearTimeout(timeout);
+            const duration = Date.now() - startTime;
+            let { errors, structuredErrors, warnings } = parseBuildOutput(output);
+            if (code !== 0 && errors.length === 0) {
+                const fallback = extractFallbackBuildErrors(output, code);
+                errors = fallback;
+                structuredErrors = fallback.map((raw) => ({ message: raw.slice(0, 200), raw }));
+            }
+            resolve({ success: code === 0, errors, structuredErrors, warnings, duration, output: output.slice(-2000) });
+        });
+        child.on("error", (err) => {
+            clearTimeout(timeout);
+            resolve({
+                success: false,
+                errors: [`Build process error: ${err.message}`],
+                structuredErrors: [{ message: `Build process error: ${err.message}`, raw: err.message }],
+                warnings: [],
+                duration: Date.now() - startTime,
+                output: "",
+            });
+        });
+    });
+}
+export async function runBuild(projectPath) {
+    const packageJsonPath = join(projectPath, "package.json");
+    if (!existsSync(packageJsonPath)) {
+        return {
+            success: false,
+            errors: ["Not a Node.js project: package.json not found"],
+            structuredErrors: [{ message: "Not a Node.js project", raw: "package.json not found" }],
+            warnings: [],
+            duration: 0,
+            output: "",
+        };
+    }
+    const pkgContent = readFileSync(packageJsonPath, "utf-8");
+    const packageJson = parseProjectPackageJson(pkgContent);
+    const candidateFiles = readdirSync(projectPath).filter((f) => !f.startsWith("."));
+    const runtime = detectRuntimeFromFiles(candidateFiles, packageJson);
+    const npm = process.platform === "win32" ? "npm.cmd" : "npm";
+    const npx = process.platform === "win32" ? "npx.cmd" : "npx";
+    const buildCommands = getBuildCommandCandidates(runtime, { npmCommand: npm, npxCommand: npx });
+    if (buildCommands.length === 0) {
+        return {
+            success: false,
+            errors: ["No build command found in package.json"],
+            structuredErrors: [{ message: "No build command found", raw: "No build script in package.json" }],
+            warnings: [],
+            duration: 0,
+            output: "",
+        };
+    }
+    for (const command of buildCommands) {
+        const result = await runBuildCommand(command, projectPath);
+        if (result.success)
+            return result;
+        // If this wasn't a "command not found" error, stop trying
+        if (!/missing script|command not found|is not recognized/i.test(result.output)) {
+            return result;
+        }
+    }
+    return {
+        success: false,
+        errors: ["All build commands failed"],
+        structuredErrors: [{ message: "All build commands failed", raw: "No build command succeeded" }],
+        warnings: [],
+        duration: 0,
+        output: "",
+    };
+}
+//# sourceMappingURL=build-runner.js.map

package/dist/build-runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-runner.js","sourceRoot":"","sources":["../src/build-runner.ts"],"names":[],"mappings":"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"}

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli.js

@@ -0,0 +1,102 @@
+#!/usr/bin/env node
+import { Command } from "commander";
+import { resolve } from "path";
+import { existsSync } from "fs";
+import { loadConfig } from "./config.js";
+import { runBuild } from "./build-runner.js";
+import { runLighthouse } from "./lighthouse-runner.js";
+import { getVerificationGrade, getImprovementRecommendations } from "./verification.js";
+import { formatReport } from "./reporter.js";
+const EXIT_PASS = 0; // Silver or Gold
+const EXIT_SOFT_FAIL = 1; // Bronze (build OK, LH failed)
+const EXIT_FAIL = 2; // Unverified (build failed)
+const EXIT_CONFIG = 3; // Config error
+const program = new Command();
+program
+    .name("laxy-verify")
+    .description("Frontend quality gate: build check + Lighthouse audit + verification grade")
+    .version("0.1.0")
+    .argument("[dir]", "Project directory", ".")
+    .option("--format <type>", "Output format: console, json, md", "console")
+    .option("--ci", "CI mode: relaxed thresholds, 3 Lighthouse runs")
+    .option("--skip-lighthouse", "Skip Lighthouse, build-only verification")
+    .option("--runs <number>", "Number of Lighthouse runs", parseInt)
+    .option("--port <number>", "Dev server port", parseInt)
+    .action(async (dir, opts) => {
+    const projectPath = resolve(dir);
+    if (!existsSync(projectPath)) {
+        console.error(`Directory not found: ${projectPath}`);
+        process.exit(EXIT_CONFIG);
+    }
+    if (!existsSync(resolve(projectPath, "package.json"))) {
+        console.error("Not a Node.js project: package.json not found");
+        process.exit(EXIT_CONFIG);
+    }
+    // Load config
+    const { config, warnings } = loadConfig(projectPath, opts.ci);
+    for (const w of warnings)
+        console.warn(`[warn] ${w}`);
+    // Override config with CLI flags
+    if (opts.runs)
+        config.runs = opts.runs;
+    if (opts.port)
+        config.port = opts.port;
+    // Step 1: Build check
+    const buildResult = await runBuild(projectPath);
+    if (!buildResult.success) {
+        const report = {
+            grade: "unverified",
+            build: { success: false, errors: buildResult.errors, duration: buildResult.duration },
+            lighthouse: { scores: null },
+            thresholds: config.thresholds,
+            recommendations: getImprovementRecommendations({
+                buildSuccess: false,
+                buildErrors: buildResult.errors,
+            }),
+        };
+        console.log(formatReport(report, opts.format));
+        process.exit(EXIT_FAIL);
+    }
+    // Step 2: Lighthouse (optional)
+    let lighthouseScores = null;
+    let lighthouseError;
+    if (!opts.skipLighthouse) {
+        const lhResult = await runLighthouse(projectPath, {
+            port: config.port,
+            runs: config.runs,
+            ciMode: opts.ci,
+        });
+        lighthouseScores = lhResult.scores;
+        lighthouseError = lhResult.error;
+    }
+    // Step 3: Grade
+    const grade = getVerificationGrade({
+        buildSuccess: true,
+        lighthouseScores: lighthouseScores ?? undefined,
+    });
+    const report = {
+        grade,
+        build: { success: true, errors: [], duration: buildResult.duration },
+        lighthouse: { scores: lighthouseScores, error: lighthouseError },
+        thresholds: config.thresholds,
+        recommendations: getImprovementRecommendations({
+            buildSuccess: true,
+            lighthouseScores: lighthouseScores ?? undefined,
+        }),
+    };
+    console.log(formatReport(report, opts.format));
+    // Exit codes
+    switch (grade) {
+        case "gold":
+        case "silver":
+            process.exit(EXIT_PASS);
+            break;
+        case "bronze":
+            process.exit(EXIT_SOFT_FAIL);
+            break;
+        default:
+            process.exit(EXIT_FAIL);
+    }
+});
+program.parse();
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/config.d.ts

@@ -0,0 +1,16 @@
+export interface LaxyConfig {
+    thresholds: {
+        performance: number;
+        accessibility: number;
+        seo: number;
+        bestPractices: number;
+    };
+    buildCommand?: string;
+    devCommand?: string;
+    port: number;
+    runs: number;
+}
+export declare function loadConfig(projectPath: string, ciMode?: boolean): {
+    config: LaxyConfig;
+    warnings: string[];
+};

package/dist/config.js

@@ -0,0 +1,55 @@
+import { readFileSync, existsSync } from "fs";
+import { join } from "path";
+import { parse as parseYaml } from "yaml";
+import { LH_THRESHOLDS, LH_CI_THRESHOLDS } from "./verification.js";
+const DEFAULT_CONFIG = {
+    thresholds: { ...LH_THRESHOLDS },
+    port: 3000,
+    runs: 1,
+};
+export function loadConfig(projectPath, ciMode = false) {
+    const warnings = [];
+    const configPath = join(projectPath, ".laxy.yml");
+    const defaults = {
+        thresholds: ciMode ? { ...LH_CI_THRESHOLDS } : { ...LH_THRESHOLDS },
+        port: DEFAULT_CONFIG.port,
+        runs: ciMode ? 3 : 1,
+    };
+    if (!existsSync(configPath)) {
+        return { config: defaults, warnings };
+    }
+    try {
+        const raw = readFileSync(configPath, "utf-8");
+        const parsed = parseYaml(raw);
+        if (!parsed || typeof parsed !== "object") {
+            warnings.push("Invalid .laxy.yml: not an object. Using defaults.");
+            return { config: defaults, warnings };
+        }
+        const config = { ...defaults };
+        if (parsed.thresholds && typeof parsed.thresholds === "object") {
+            const t = parsed.thresholds;
+            if (typeof t.performance === "number")
+                config.thresholds.performance = t.performance;
+            if (typeof t.accessibility === "number")
+                config.thresholds.accessibility = t.accessibility;
+            if (typeof t.seo === "number")
+                config.thresholds.seo = t.seo;
+            if (typeof t.bestPractices === "number")
+                config.thresholds.bestPractices = t.bestPractices;
+        }
+        if (typeof parsed.buildCommand === "string")
+            config.buildCommand = parsed.buildCommand;
+        if (typeof parsed.devCommand === "string")
+            config.devCommand = parsed.devCommand;
+        if (typeof parsed.port === "number")
+            config.port = parsed.port;
+        if (typeof parsed.runs === "number")
+            config.runs = Math.max(1, Math.min(parsed.runs, 5));
+        return { config, warnings };
+    }
+    catch {
+        warnings.push("Failed to parse .laxy.yml. Using defaults.");
+        return { config: defaults, warnings };
+    }
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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"}

package/dist/dev-server.d.ts

@@ -0,0 +1,8 @@
+import { type ChildProcess } from "child_process";
+export interface DevServerHandle {
+    process: ChildProcess;
+    port: number;
+    url: string;
+}
+export declare function startDevServer(projectPath: string, port: number): Promise<DevServerHandle>;
+export declare function stopDevServer(handle: DevServerHandle): void;