laxy-verify 1.1.7 → 1.1.8

package/README.md

@@ -3,10 +3,12 @@
 Frontend quality gate for AI-generated code. Build + Lighthouse verification with grade output (Gold/Silver/Bronze/Unverified).
 
 ```bash
-npx laxy-verify --init    # Auto-detect framework, generate config
-npx laxy-verify .         # Run verification
-npx laxy-verify login     # Log in for Pro/Pro+ features
-npx laxy-verify --badge   # Show shields.io badge
+npx laxy-verify --init --run  # 설정 생성 + 즉시 검증 (원커맨드)
+npx laxy-verify --init        # Auto-detect framework, generate config
+npx laxy-verify .             # Run verification
+npx laxy-verify login         # Log in for Pro/Pro+ features
+npx laxy-verify --badge       # Show shields.io badge
+npx laxy-verify --help        # 도움말 보기
 ```
 
 ## Quick Start
@@ -82,6 +84,14 @@ env:
   LAXY_TOKEN: ${{ secrets.LAXY_TOKEN }}
 ```
 
+**LAXY_TOKEN을 GitHub Secrets에 등록하는 방법:**
+
+1. 로컬에서 로그인: `npx laxy-verify login`
+2. 토큰 복사: `cat ~/.laxy/credentials.json` → `"token"` 값을 복사
+3. GitHub 리포 → Settings → Secrets and variables → Actions → **New repository secret**
+4. Name: `LAXY_TOKEN`, Value: 복사한 토큰 붙여넣기
+5. `--init` 으로 생성된 workflow 파일은 이미 `LAXY_TOKEN`을 포함합니다
+
 ### Multi-viewport (Pro+)
 
 ```bash

package/dist/build.d.ts

@@ -8,4 +8,4 @@ export declare class BuildError extends Error {
     timedOut: boolean;
     constructor(message: string, errors: string[], timedOut?: boolean);
 }
-export declare function runBuild(command: string, timeoutSec: number): Promise<BuildResult>;
+export declare function runBuild(command: string, timeoutSec: number, cwd?: string): Promise<BuildResult>;

package/dist/build.js

@@ -18,13 +18,17 @@ class BuildError extends Error {
     }
 }
 exports.BuildError = BuildError;
-function runBuild(command, timeoutSec) {
+function runBuild(command, timeoutSec, cwd) {
     return new Promise((resolve, reject) => {
         const startTime = Date.now();
         const stderrLines = [];
         const errorLines = [];
-        console.log(`\n Building: ${command}`);
-        const proc = (0, node_child_process_1.spawn)(command, { shell: true, stdio: ["ignore", "pipe", "pipe"] });
+        console.log(`\n Building: ${command}${cwd ? ` (cwd: ${cwd})` : ""}`);
+        const proc = (0, node_child_process_1.spawn)(command, {
+            shell: true,
+            stdio: ["ignore", "pipe", "pipe"],
+            cwd,
+        });
         let timedOut = false;
         const timer = setTimeout(() => {
             timedOut = true;

package/dist/cli.js

@@ -33,6 +33,9 @@ var __importStar = (this && this.__importStar) || (function () {
         return result;
     };
 })();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 const fs = __importStar(require("node:fs"));
 const path = __importStar(require("node:path"));
@@ -49,6 +52,21 @@ const status_js_1 = require("./status.js");
 const auth_js_1 = require("./auth.js");
 const entitlement_js_1 = require("./entitlement.js");
 const multi_viewport_js_1 = require("./multi-viewport.js");
+const index_js_1 = require("./verification-core/index.js");
+const package_json_1 = __importDefault(require("../package.json"));
+function exitGracefully(code) {
+    if (process.platform === "win32") {
+        setTimeout(() => process.exit(code), 100);
+        return;
+    }
+    process.exit(code);
+}
+async function ensurePortAvailableForVerification(port) {
+    const status = await (0, serve_js_1.probeServerStatus)(port);
+    if (status === null)
+        return;
+    throw new Error(`An existing local server is already responding on port ${port} (HTTP ${status}). Stop the running app before using laxy-verify, because the verification build can invalidate an active dev session.`);
+}
 function parseArgs() {
     const raw = process.argv.slice(2);
     // Single-pass: collect flags and first positional
@@ -80,20 +98,20 @@ function parseArgs() {
             }
         }
     }
-    // 서브커맨드 처리: login [email], logout, whoami
+    // ?쒕툕而ㅻ㎤??泥섎━: login [email], logout, whoami
     let subcommand;
     let subcommandArg;
     if (projectDir === "login" || projectDir === "logout" || projectDir === "whoami") {
         subcommand = projectDir;
         projectDir = ".";
-        // login 뒤에 이메일이 올 수 있음
+        // login ?ㅼ뿉 ?대찓?쇱씠 ?????덉쓬
         if (subcommand === "login" && raw.length > 0 && !raw[0].startsWith("-")) {
             // already consumed via loop above if it was first; re-check flags
         }
-        // 첫 번째 non-flag를 이메일로 취급
+        // 泥?踰덉㎏ non-flag瑜??대찓?쇰줈 痍④툒
         subcommandArg = flags["email"];
         if (!subcommandArg) {
-            // login PSM@example.com 형태 — positional already captured in projectDir before reset
+            // login PSM@example.com ?뺥깭 ??positional already captured in projectDir before reset
         }
     }
     return {
@@ -107,29 +125,59 @@ function parseArgs() {
         skipLighthouse: flags["skip-lighthouse"] !== undefined,
         badge: flags["badge"] !== undefined,
         init: flags["init"] !== undefined,
+        initRun: flags["init"] !== undefined && flags["run"] !== undefined,
         multiViewport: flags["multi-viewport"] !== undefined,
         failureAnalysis: flags["failure-analysis"] !== undefined,
+        help: flags["help"] !== undefined || flags["h"] !== undefined,
     };
 }
 function writeResultFile(projectDir, result) {
     const filePath = path.join(projectDir, ".laxy-result.json");
     fs.writeFileSync(filePath, JSON.stringify(result, null, 2) + "\n", "utf-8");
 }
+function summarizeViewportIssues(scores, thresholds) {
+    if (!scores)
+        return { count: 0 };
+    const failed = [];
+    for (const [label, viewportScores] of Object.entries(scores)) {
+        if (!viewportScores) {
+            failed.push(`${label}: missing`);
+            continue;
+        }
+        const passes = viewportScores.performance >= thresholds.performance &&
+            viewportScores.accessibility >= thresholds.accessibility &&
+            viewportScores.seo >= thresholds.seo &&
+            viewportScores.bestPractices >= thresholds.bestPractices;
+        if (!passes) {
+            failed.push(`${label}: P${viewportScores.performance} A${viewportScores.accessibility} SEO${viewportScores.seo} BP${viewportScores.bestPractices}`);
+        }
+    }
+    return {
+        count: failed.length,
+        summary: failed.length > 0 ? failed.join(" | ") : "All checked viewports passed.",
+    };
+}
 function consoleOutput(result) {
     const gradeLabel = result.grade;
-    const checkEmoji = result.grade !== "Unverified" ? " ✅" : "";
-    console.log(`\n  Laxy Verify — ${gradeLabel}${checkEmoji}`);
+    const checkEmoji = result.grade !== "Unverified" ? " OK" : "";
+    console.log(`\n  Laxy Verify ${gradeLabel}${checkEmoji}`);
     console.log(`  Build: ${result.build.success ? `OK (${result.build.durationMs}ms)` : "FAILED"}`);
     if (result.build.errors.length > 0) {
-        const last5 = result.build.errors.slice(-5);
         console.log(`  Errors:`);
-        for (const e of last5)
+        // 泥?踰덉㎏ 'error' ?ㅼ썙?쒓? ?ы븿??以?(?먯씤 ?뚯븙??
+        const firstError = result.build.errors.find(e => /error/i.test(e));
+        // 留덉?留?5以?(鍮뚮뱶 醫낅즺 而⑦뀓?ㅽ듃)
+        const last5 = result.build.errors.slice(-5);
+        const toShow = firstError && !last5.includes(firstError)
+            ? [firstError, "  ...", ...last5]
+            : last5;
+        for (const e of toShow)
             console.error(`    ${e}`);
     }
     if (result.lighthouse !== null) {
         const lh = result.lighthouse;
         const t = result.thresholds;
-        const check = (passed) => passed ? " ✅" : " ❌";
+        const check = (passed) => (passed ? " OK" : " FAIL");
         console.log(`  Lighthouse:`);
         console.log(`    Performance:     ${lh.performance} / ${t.performance}${check(lh.performance >= t.performance)}`);
         console.log(`    Accessibility:   ${lh.accessibility} / ${t.accessibility}${check(lh.accessibility >= t.accessibility)}`);
@@ -140,6 +188,28 @@ function consoleOutput(result) {
     else {
         console.log(`  Lighthouse: skipped`);
     }
+    if (result.verification) {
+        const view = result.verification.view;
+        console.log(`  Verification tier: ${view.tier}`);
+        console.log(`  Question: ${view.question}`);
+        console.log(`  Verdict: ${view.verdict} (${view.confidence})`);
+        console.log(`  Summary: ${view.summary}`);
+        if (view.blockers.length > 0) {
+            console.log(`  Blockers:`);
+            for (const blocker of view.blockers)
+                console.log(`    - ${blocker.title}`);
+        }
+        if (view.nextActions.length > 0) {
+            console.log(`  Next actions:`);
+            for (const action of view.nextActions)
+                console.log(`    - ${action}`);
+        }
+        if (view.failureEvidence.length > 0) {
+            console.log(`  Evidence:`);
+            for (const item of view.failureEvidence)
+                console.log(`    - ${item}`);
+        }
+    }
     if (result.github) {
         if (result.github.status === "comment_posted")
             console.log(`  PR comment: posted`);
@@ -148,45 +218,100 @@ function consoleOutput(result) {
     }
     console.log(`  Result: .laxy-result.json`);
     console.log(`  Exit code: ${result.exitCode}`);
+    // Upsell CTA: Gold ?ъ꽦?????먭퀬 Free ?뚮옖????
+    if (result.grade === "silver" || result.grade === "bronze") {
+        if (!result._plan || result._plan === "free") {
+            console.log(`\n  Gold ?깃툒???먰븯?좊떎硫?Pro/Pro+濡??낃렇?덉씠?쒗븯?몄슂:`);
+            console.log(`  ??https://laxy-blue.vercel.app/pricing`);
+        }
+    }
 }
 async function run() {
     const args = parseArgs();
-    // ── 서브커맨드 처리 ──────────────────────────────────────────────────────
+    // ?€?€ --help ?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€
+    if (args.help) {
+        console.log(`
+  laxy-verify v${package_json_1.default.version}
+  Frontend quality gate: build + Lighthouse verification
+
+  Usage:
+    npx laxy-verify [project-dir] [options]
+    npx laxy-verify <subcommand>
+
+  Subcommands:
+    login [email]     Log in to unlock Pro/Pro+ features
+    logout            Remove saved credentials
+    whoami            Show current login status
+
+  Options:
+    --init            Generate .laxy.yml + GitHub workflow file
+    --init --run      Generate config and immediately run verification
+    --format          console | json  (default: console)
+    --ci              CI mode: -10 Performance threshold, runs=3
+    --config <path>   Path to .laxy.yml
+    --fail-on         unverified | bronze | silver | gold
+    --skip-lighthouse Build-only (max Bronze grade)
+    --multi-viewport  Pro+: Lighthouse on desktop/tablet/mobile
+    --badge           Print shields.io badge markdown
+    --help            Show this help
+
+  Exit codes:
+    0   Grade meets or exceeds fail_on threshold
+    1   Grade worse than fail_on, or build failed
+    2   Configuration error
+
+  Examples:
+    npx laxy-verify --init --run        # Setup + first verification
+    npx laxy-verify .                   # Run in current directory
+    npx laxy-verify . --ci              # CI mode
+    npx laxy-verify . --fail-on silver  # Require Silver or better
+
+  Docs: https://github.com/psungmin24/laxy-verify
+`);
+        exitGracefully(0);
+        return;
+    }
+    // ?€?€ ?쒕툕而ㅻ㎤??泥섎━ ?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€
     if (args.subcommand === "login") {
         await (0, auth_js_1.login)(args.subcommandArg);
-        // Windows: fetch()의 TCP 소켓이 closing 중에 process.exit()을 즉시 호출하면
-        // UV_HANDLE_CLOSING Assertion 발생. setTimeout으로 UV 루프에 정리 시간을 준다.
-        setTimeout(() => process.exit(0), 100);
+        // Windows: fetch()??TCP ?뚯폆??closing 以묒뿉 process.exit()??利됱떆 ?몄텧?섎㈃
+        // UV_HANDLE_CLOSING Assertion 諛쒖깮. setTimeout?쇰줈 UV 猷⑦봽???뺣━ ?쒓컙??以€??
+        exitGracefully(0);
         return;
     }
     if (args.subcommand === "logout") {
         (0, auth_js_1.clearToken)();
-        process.exit(0);
+        exitGracefully(0);
         return;
     }
     if (args.subcommand === "whoami") {
         (0, auth_js_1.whoami)();
-        process.exit(0);
+        exitGracefully(0);
         return;
     }
     // --init
     if (args.init) {
         (0, init_js_1.runInit)(args.projectDir);
-        process.exit(0);
-        return;
+        if (!args.initRun) {
+            console.log(`\n  ?ㅼ쓬 ?④퀎: npx laxy-verify .  (?먮뒗 --init --run ?쇰줈 諛붾줈 ?ㅽ뻾)`);
+            exitGracefully(0);
+            return;
+        }
+        console.log("\n  泥?踰덉㎏ 寃€利앹쓣 ?쒖옉?⑸땲??..\n");
+        // initRun: fall through to run verification below
     }
     // --badge
     if (args.badge) {
         const resultPath = path.join(args.projectDir, ".laxy-result.json");
         if (!fs.existsSync(resultPath)) {
             console.error("Error: .laxy-result.json not found. Run `npx laxy-verify .` first to generate it.");
-            process.exit(2);
+            exitGracefully(2);
             return;
         }
         const content = JSON.parse(fs.readFileSync(resultPath, "utf-8"));
         const badge = (0, badge_js_1.generateBadge)(content.grade);
         console.log(badge);
-        process.exit(0);
+        exitGracefully(0);
         return;
     }
     // Load config
@@ -204,7 +329,7 @@ async function run() {
     }
     catch (err) {
         console.error(`Config error: ${err instanceof Error ? err.message : String(err)}`);
-        process.exit(2);
+        exitGracefully(2);
         return;
     }
     // Auto-detect framework + package manager
@@ -214,17 +339,25 @@ async function run() {
     }
     catch (err) {
         console.error(`Detection error: ${err instanceof Error ? err.message : String(err)}`);
-        process.exit(2);
+        exitGracefully(2);
         return;
     }
     // Merge config overrides
     const buildCmd = config.build_command || detected.buildCmd;
     const devCmd = config.dev_command || detected.devCmd;
     const port = config.port;
+    try {
+        await ensurePortAvailableForVerification(port);
+    }
+    catch (err) {
+        console.error(`Preflight error: ${err instanceof Error ? err.message : String(err)}`);
+        exitGracefully(2);
+        return;
+    }
     // Phase 1: Build
     let buildResult;
     try {
-        buildResult = await (0, build_js_1.runBuild)(buildCmd, config.build_timeout);
+        buildResult = await (0, build_js_1.runBuild)(buildCmd, config.build_timeout, args.projectDir);
     }
     catch (err) {
         buildResult = {
@@ -243,14 +376,14 @@ async function run() {
         seo: config.thresholds.seo,
         bestPractices: config.thresholds.bestPractices,
     };
-    // ── 플랜 기능 조회 (토큰 없으면 Free 폴백) ──────────────────────────────
+    // ?€?€ ?뚮옖 湲곕뒫 議고쉶 (?좏겙 ?놁쑝硫?Free ?대갚) ?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€
     let entitlements = null;
     try {
         entitlements = await (0, entitlement_js_1.getEntitlements)();
         (0, entitlement_js_1.printPlanBanner)(entitlements);
     }
     catch {
-        // 네트워크 오류 시 Free로 진행
+        // ?ㅽ듃?뚰겕 ?ㅻ쪟 ??Free濡?吏꾪뻾
     }
     const features = entitlements ?? {
         plan: "free",
@@ -261,7 +394,7 @@ async function run() {
         failure_analysis: false,
         fast_lane: false,
     };
-    // Pro 이상이면 Lighthouse 3회 실행 (더 정밀)
+    // Pro ?댁긽?대㈃ Lighthouse 3???ㅽ뻾 (???뺣?)
     if (features.lighthouse_runs_3 && config.lighthouse_runs < 3) {
         config = { ...config, lighthouse_runs: 3 };
     }
@@ -271,7 +404,7 @@ async function run() {
     if (buildResult.success && !args.skipLighthouse) {
         let servePid;
         try {
-            const serve = await (0, serve_js_1.startDevServer)(devCmd, port, config.dev_timeout);
+            const serve = await (0, serve_js_1.startDevServer)(devCmd, port, config.dev_timeout, args.projectDir);
             servePid = serve.pid;
             try {
                 const lhResult = await (0, lighthouse_js_1.runLighthouse)(port, config.lighthouse_runs);
@@ -289,9 +422,9 @@ async function run() {
             catch (lhErr) {
                 console.error(`Lighthouse error: ${lhErr instanceof Error ? lhErr.message : String(lhErr)}`);
             }
-            // ── Pro+: 멀티 뷰포트 (dev server가 돌리는 중) ─────────────────────
+            // ?€?€ Pro+: 硫€??酉고룷??(dev server媛€ ?뚮━??以? ?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€?€
             if (args.multiViewport && !features.multi_viewport) {
-                console.log("\n  ⚠️  --multi-viewport는 Pro+ 플랜 전용입니다. laxy-verify login 으로 로그인하세요.");
+                console.log("\n  ?좑툘  --multi-viewport??Pro+ ?뚮옖 ?꾩슜?낅땲?? laxy-verify login ?쇰줈 濡쒓렇?명븯?몄슂.");
             }
             else if (features.multi_viewport) {
                 try {
@@ -321,6 +454,27 @@ async function run() {
         failOn: config.fail_on,
         goldEligible: features.gold_grade && allViewportsOk,
     });
+    const verificationTier = (0, index_js_1.planToVerificationTier)(features.plan);
+    const viewportSummary = summarizeViewportIssues(multiViewportScores, adjustedThresholds);
+    const failureEvidence = [
+        ...buildResult.errors.slice(0, 3).map((error) => `Build: ${error}`),
+        ...(viewportSummary.count > 0 && viewportSummary.summary
+            ? [`Viewport: ${viewportSummary.summary}`]
+            : []),
+    ];
+    const verificationReport = (0, index_js_1.buildVerificationReport)({
+        buildSuccess: buildResult.success,
+        buildErrors: buildResult.errors,
+        viewportIssues: multiViewportScores ? viewportSummary.count : undefined,
+        multiViewportPassed: multiViewportScores ? allViewportsOk : undefined,
+        multiViewportSummary: multiViewportScores ? viewportSummary.summary : undefined,
+        lighthouseScores: scores,
+        failureEvidence,
+    }, {
+        tier: verificationTier,
+        thresholds: adjustedThresholds,
+    });
+    const verificationView = (0, index_js_1.getTierVerificationView)(verificationReport);
     // Build result object
     const resultObj = {
         grade: gradeResult.grade.charAt(0).toUpperCase() + gradeResult.grade.slice(1), // Capitalize
@@ -336,6 +490,12 @@ async function run() {
         framework: detected.framework,
         exitCode: gradeResult.exitCode,
         config_fail_on: config.fail_on,
+        _plan: features.plan,
+        verification: {
+            tier: verificationTier,
+            report: verificationReport,
+            view: verificationView,
+        },
     };
     // GitHub integration (only in Actions)
     const inGitHubActions = !!process.env.GITHUB_ACTIONS;
@@ -364,9 +524,9 @@ async function run() {
     if (inGitHubActions && process.env.GITHUB_OUTPUT) {
         fs.appendFileSync(process.env.GITHUB_OUTPUT, `grade=${resultObj.grade}\n`);
     }
-    process.exit(gradeResult.exitCode);
+    exitGracefully(gradeResult.exitCode);
 }
 run().catch((err) => {
     console.error(`Fatal error: ${err instanceof Error ? err.message : String(err)}`);
-    process.exit(1);
+    exitGracefully(1);
 });

package/dist/serve.d.ts

@@ -8,5 +8,6 @@ export interface ServeResult {
     pid: number;
     port: number;
 }
-export declare function startDevServer(command: string, port: number, timeoutSec: number): Promise<ServeResult>;
+export declare function probeServerStatus(port: number): Promise<number | null>;
+export declare function startDevServer(command: string, port: number, timeoutSec: number, cwd?: string): Promise<ServeResult>;
 export declare function stopDevServer(pid: number): void;

package/dist/serve.js

@@ -37,6 +37,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DevServerTimeoutError = exports.PortConflictError = void 0;
+exports.probeServerStatus = probeServerStatus;
 exports.startDevServer = startDevServer;
 exports.stopDevServer = stopDevServer;
 const node_child_process_1 = require("node:child_process");
@@ -67,13 +68,17 @@ function httpGet(url) {
         });
     });
 }
-async function startDevServer(command, port, timeoutSec) {
+function probeServerStatus(port) {
+    return httpGet(`http://localhost:${port}/`);
+}
+async function startDevServer(command, port, timeoutSec, cwd) {
     return new Promise((resolve, reject) => {
-        console.log(`Starting dev server: ${command}`);
+        console.log(`Starting dev server: ${command}${cwd ? ` (cwd: ${cwd})` : ""}`);
         const proc = (0, node_child_process_1.spawn)(command, {
             shell: true,
             stdio: ["ignore", "pipe", "pipe"],
             env: { ...process.env, PORT: String(port) },
+            cwd,
         });
         // Pipe output to console
         proc.stdout?.on("data", (chunk) => {
@@ -103,7 +108,7 @@ async function startDevServer(command, port, timeoutSec) {
                 reject(new DevServerTimeoutError(port, timeoutSec));
                 return;
             }
-            const status = await httpGet(`http://localhost:${port}/`);
+            const status = await probeServerStatus(port);
             if (status !== null) {
                 if (status === 200) {
                     console.log(`Dev server ready on port ${port} (HTTP ${status})`);

package/dist/verification-core/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./types.js";
+export * from "./tier-policy.js";
+export * from "./report.js";

package/dist/verification-core/index.js

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./types.js"), exports);
+__exportStar(require("./tier-policy.js"), exports);
+__exportStar(require("./report.js"), exports);

package/dist/verification-core/report.d.ts

@@ -0,0 +1,14 @@
+import type { LighthouseThresholds, TierVerificationView, VerificationEvidence, VerificationFinding, VerificationGrade, VerificationInput, VerificationReport, VerificationTier } from "./types.js";
+export declare const DEFAULT_LH_THRESHOLDS: LighthouseThresholds;
+export declare function getLighthousePass(lighthouseScores?: VerificationInput["lighthouseScores"], thresholds?: LighthouseThresholds): boolean;
+export declare function getVerificationGrade(input: VerificationInput, thresholds?: LighthouseThresholds): VerificationGrade;
+export declare function buildVerificationEvidence(input: VerificationInput, thresholds?: LighthouseThresholds): VerificationEvidence;
+export declare function getImprovementRecommendations(input: VerificationInput, thresholds?: LighthouseThresholds): VerificationFinding[];
+export declare function buildVerificationReport(input: VerificationInput, options?: {
+    tier?: VerificationTier;
+    thresholds?: LighthouseThresholds;
+}): VerificationReport;
+export declare function buildTierVerificationView(input: VerificationInput, options?: {
+    tier?: VerificationTier;
+    thresholds?: LighthouseThresholds;
+}): TierVerificationView;

package/dist/verification-core/report.js

@@ -0,0 +1,273 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_LH_THRESHOLDS = void 0;
+exports.getLighthousePass = getLighthousePass;
+exports.getVerificationGrade = getVerificationGrade;
+exports.buildVerificationEvidence = buildVerificationEvidence;
+exports.getImprovementRecommendations = getImprovementRecommendations;
+exports.buildVerificationReport = buildVerificationReport;
+exports.buildTierVerificationView = buildTierVerificationView;
+const tier_policy_js_1 = require("./tier-policy.js");
+exports.DEFAULT_LH_THRESHOLDS = {
+    performance: 70,
+    accessibility: 85,
+    seo: 80,
+    bestPractices: 80,
+};
+function getLighthousePass(lighthouseScores, thresholds = exports.DEFAULT_LH_THRESHOLDS) {
+    if (!lighthouseScores)
+        return false;
+    return (lighthouseScores.performance >= thresholds.performance &&
+        lighthouseScores.accessibility >= thresholds.accessibility &&
+        lighthouseScores.seo >= thresholds.seo &&
+        lighthouseScores.bestPractices >= thresholds.bestPractices);
+}
+function getVerificationGrade(input, thresholds = exports.DEFAULT_LH_THRESHOLDS) {
+    const buildPassed = input.buildSuccess === true;
+    const e2ePassedAll = typeof input.e2ePassed === "number" &&
+        typeof input.e2eTotal === "number" &&
+        input.e2eTotal > 0 &&
+        input.e2ePassed === input.e2eTotal;
+    const lighthousePassed = getLighthousePass(input.lighthouseScores, thresholds);
+    if (buildPassed && e2ePassedAll && lighthousePassed)
+        return "gold";
+    if (buildPassed && e2ePassedAll)
+        return "silver";
+    if (buildPassed)
+        return "bronze";
+    return "unverified";
+}
+function buildVerificationEvidence(input, thresholds = exports.DEFAULT_LH_THRESHOLDS) {
+    const buildPassed = input.buildSuccess === true;
+    const hasE2EData = typeof input.e2eTotal === "number" && input.e2eTotal > 0;
+    const e2ePassedAll = hasE2EData &&
+        typeof input.e2ePassed === "number" &&
+        typeof input.e2eTotal === "number" &&
+        input.e2ePassed === input.e2eTotal;
+    const hasMultiViewportData = typeof input.viewportIssues === "number" || typeof input.multiViewportPassed === "boolean";
+    const multiViewportPassed = hasMultiViewportData
+        ? input.multiViewportPassed === true ||
+            (input.multiViewportPassed !== false && (input.viewportIssues ?? 0) <= 0)
+        : false;
+    const hasVisualDiffData = typeof input.visualDiffVerdict === "string";
+    const visualDiffPassed = hasVisualDiffData &&
+        input.visualDiffVerdict !== "warn" &&
+        input.visualDiffVerdict !== "rollback";
+    const lighthousePassed = getLighthousePass(input.lighthouseScores, thresholds);
+    return {
+        input,
+        thresholds,
+        buildPassed,
+        hasE2EData,
+        e2ePassedAll,
+        hasMultiViewportData,
+        multiViewportPassed,
+        hasVisualDiffData,
+        visualDiffPassed,
+        lighthousePassed,
+    };
+}
+function getImprovementRecommendations(input, thresholds = exports.DEFAULT_LH_THRESHOLDS) {
+    const findings = [];
+    const errors = input.buildErrors ?? [];
+    if (input.buildSuccess === false) {
+        if (errors.some((error) => /TS\d+|type/i.test(error))) {
+            findings.push({
+                category: "build",
+                severity: "critical",
+                title: "TypeScript build errors",
+                description: "Type errors are blocking a clean production build.",
+                action: "Fix the TypeScript errors first, then rerun verification.",
+            });
+        }
+        if (errors.some((error) => /Module not found|Cannot find module|Failed to resolve/i.test(error))) {
+            findings.push({
+                category: "build",
+                severity: "critical",
+                title: "Missing or unresolved modules",
+                description: "The build cannot resolve one or more imports or packages.",
+                action: "Check import paths, package installation, and package.json consistency.",
+            });
+        }
+        if (errors.some((error) => /SyntaxError|Unexpected token/i.test(error))) {
+            findings.push({
+                category: "build",
+                severity: "critical",
+                title: "Syntax errors in source code",
+                description: "The code contains syntax issues that stop the build from completing.",
+                action: "Fix the syntax errors, then rerun the build verification.",
+            });
+        }
+        if (findings.every((finding) => finding.category !== "build")) {
+            findings.push({
+                category: "build",
+                severity: "critical",
+                title: "Build failed",
+                description: "Production build verification did not pass.",
+                action: "Inspect the build logs and resolve the blocking errors before release.",
+            });
+        }
+    }
+    if (typeof input.e2ePassed === "number" &&
+        typeof input.e2eTotal === "number" &&
+        input.e2eTotal > 0 &&
+        input.e2ePassed < input.e2eTotal) {
+        findings.push({
+            category: "e2e",
+            severity: "high",
+            title: `E2E failures (${input.e2ePassed}/${input.e2eTotal})`,
+            description: "One or more verification scenarios failed.",
+            action: "Fix the broken user flow and rerun the verification scenarios.",
+        });
+    }
+    const hasMultiViewportData = typeof input.viewportIssues === "number" || typeof input.multiViewportPassed === "boolean";
+    const multiViewportPassed = input.multiViewportPassed === true ||
+        (input.multiViewportPassed !== false && (input.viewportIssues ?? 0) <= 0);
+    if (hasMultiViewportData && !multiViewportPassed) {
+        findings.push({
+            category: "viewport",
+            severity: "high",
+            title: `Multi-viewport issues detected (${input.viewportIssues ?? 0})`,
+            description: input.multiViewportSummary ||
+                "One or more responsive layout or viewport-specific verification issues were found.",
+            action: "Fix the responsive layout issues and rerun the multi-viewport verification pass.",
+        });
+    }
+    if (input.visualDiffVerdict === "rollback") {
+        findings.push({
+            category: "visual",
+            severity: "high",
+            title: `Visual regression detected (${input.visualDiffPercentage ?? 0}%)`,
+            description: "The visual diff is large enough to recommend a rollback or release hold.",
+            action: "Review the visual diff artifacts and fix the unintended UI regression before release.",
+        });
+    }
+    else if (input.visualDiffVerdict === "warn") {
+        findings.push({
+            category: "visual",
+            severity: "medium",
+            title: `Visual change needs review (${input.visualDiffPercentage ?? 0}%)`,
+            description: "The visual diff changed enough to require a manual review before release.",
+            action: "Check the visual diff and confirm the UI change is intentional.",
+        });
+    }
+    const lighthouseScores = input.lighthouseScores;
+    if (!lighthouseScores) {
+        return findings;
+    }
+    const lighthouseFinding = (category, actual, required, title, description, action) => ({
+        category,
+        severity: required - actual >= 20 ? "high" : "medium",
+        title: `${title} (${actual} / ${required})`,
+        description,
+        action,
+    });
+    if (lighthouseScores.performance < thresholds.performance) {
+        findings.push(lighthouseFinding("performance", lighthouseScores.performance, thresholds.performance, "Performance below threshold", "Runtime performance is below the minimum verification threshold.", "Reduce heavy assets, expensive scripts, and blocking work on initial load."));
+    }
+    if (lighthouseScores.accessibility < thresholds.accessibility) {
+        findings.push(lighthouseFinding("accessibility", lighthouseScores.accessibility, thresholds.accessibility, "Accessibility below threshold", "Accessibility checks are below the minimum verification threshold.", "Fix labels, semantics, contrast, and keyboard accessibility issues."));
+    }
+    if (lighthouseScores.seo < thresholds.seo) {
+        findings.push(lighthouseFinding("seo", lighthouseScores.seo, thresholds.seo, "SEO below threshold", "SEO checks are below the minimum verification threshold.", "Fix title, description, crawl settings, and indexable metadata."));
+    }
+    if (lighthouseScores.bestPractices < thresholds.bestPractices) {
+        findings.push(lighthouseFinding("bestPractices", lighthouseScores.bestPractices, thresholds.bestPractices, "Best practices below threshold", "Best practices checks are below the minimum verification threshold.", "Fix browser warnings, unsafe patterns, and platform-level issues."));
+    }
+    return findings.sort((a, b) => {
+        const priority = { critical: 0, high: 1, medium: 2 };
+        return priority[a.severity] - priority[b.severity];
+    });
+}
+function buildVerificationReport(input, options) {
+    const thresholds = options?.thresholds ?? exports.DEFAULT_LH_THRESHOLDS;
+    const tier = options?.tier ?? "free";
+    const evidence = buildVerificationEvidence(input, thresholds);
+    const findings = getImprovementRecommendations(input, thresholds);
+    const blockers = findings.filter((finding) => finding.severity === "critical" || finding.severity === "high");
+    const warnings = findings.filter((finding) => finding.severity === "medium");
+    const grade = getVerificationGrade(input, thresholds);
+    const failureEvidence = (input.failureEvidence ?? []).filter(Boolean).slice(0, 5);
+    let verdict;
+    let confidence;
+    let summary;
+    if (!evidence.buildPassed) {
+        verdict = "build-failed";
+        confidence = "low";
+        summary = "Build failed. Fix the blocking build errors before relying on this verification result.";
+    }
+    else if (blockers.length > 0) {
+        verdict = "hold";
+        confidence = tier === "free" ? "low" : "medium";
+        summary = "Blocking verification issues were found. Hold release until the blockers are fixed.";
+    }
+    else if (tier === "pro_plus" &&
+        evidence.buildPassed &&
+        evidence.e2ePassedAll &&
+        evidence.lighthousePassed &&
+        evidence.hasMultiViewportData &&
+        evidence.multiViewportPassed) {
+        verdict = "release-ready";
+        confidence = "high";
+        summary = "Core verification checks passed. This run supports a release-ready call.";
+    }
+    else if (tier === "pro_plus" &&
+        evidence.buildPassed &&
+        evidence.e2ePassedAll &&
+        evidence.lighthousePassed &&
+        !evidence.hasMultiViewportData) {
+        verdict = "investigate";
+        confidence = "medium";
+        summary = "Core checks passed, but release-ready confidence still needs multi-viewport verification evidence.";
+    }
+    else if (tier === "free") {
+        verdict = "quick-pass";
+        confidence = evidence.lighthousePassed ? "medium" : "low";
+        summary = "No immediate hard blockers were found in the quick verification pass.";
+    }
+    else {
+        verdict = "investigate";
+        confidence = "medium";
+        summary = "The build is standing, but deeper verification evidence should be reviewed before release.";
+    }
+    const passes = [
+        { key: "build", label: "Production build", passed: evidence.buildPassed },
+        ...(evidence.hasE2EData
+            ? [{ key: "e2e", label: `E2E ${input.e2ePassed ?? 0}/${input.e2eTotal ?? 0}`, passed: evidence.e2ePassedAll }]
+            : []),
+        ...(evidence.hasMultiViewportData
+            ? [{
+                    key: "viewport",
+                    label: `Viewport ${input.viewportIssues ?? 0} issues`,
+                    passed: evidence.multiViewportPassed,
+                }]
+            : []),
+        ...(evidence.hasVisualDiffData
+            ? [{
+                    key: "visual",
+                    label: input.hasVisualBaseline
+                        ? `Visual diff ${input.visualDiffPercentage ?? 0}%`
+                        : "Visual baseline seeded",
+                    passed: input.visualDiffVerdict !== "rollback",
+                }]
+            : []),
+        { key: "lighthouse", label: "Lighthouse thresholds", passed: evidence.lighthousePassed },
+    ];
+    const nextActions = [...blockers, ...warnings].slice(0, 4).map((finding) => finding.action);
+    return {
+        tier,
+        verdict,
+        confidence,
+        summary,
+        grade,
+        blockers,
+        warnings,
+        passes,
+        nextActions,
+        failureEvidence,
+        evidence,
+    };
+}
+function buildTierVerificationView(input, options) {
+    return (0, tier_policy_js_1.getTierVerificationView)(buildVerificationReport(input, options));
+}

package/dist/verification-core/tier-policy.d.ts

@@ -0,0 +1,13 @@
+import type { TierVerificationView, VerificationReport, VerificationTier } from "./types.js";
+export interface TierPolicy {
+    tier: VerificationTier;
+    showDetailedLighthouse: boolean;
+    showDetailedE2E: boolean;
+    showReportExport: boolean;
+    maxBlockers: number;
+    maxWarnings: number;
+}
+export declare function getTierPolicy(tier?: VerificationTier): TierPolicy;
+export declare function planToVerificationTier(plan?: string | null): VerificationTier;
+export declare function getVerificationTierQuestion(tier: VerificationTier): string;
+export declare function getTierVerificationView(report: VerificationReport): TierVerificationView;

package/dist/verification-core/tier-policy.js

@@ -0,0 +1,71 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getTierPolicy = getTierPolicy;
+exports.planToVerificationTier = planToVerificationTier;
+exports.getVerificationTierQuestion = getVerificationTierQuestion;
+exports.getTierVerificationView = getTierVerificationView;
+const TIER_POLICIES = {
+    free: {
+        tier: "free",
+        showDetailedLighthouse: false,
+        showDetailedE2E: false,
+        showReportExport: false,
+        maxBlockers: 1,
+        maxWarnings: 2,
+    },
+    pro: {
+        tier: "pro",
+        showDetailedLighthouse: true,
+        showDetailedE2E: true,
+        showReportExport: true,
+        maxBlockers: 5,
+        maxWarnings: 5,
+    },
+    pro_plus: {
+        tier: "pro_plus",
+        showDetailedLighthouse: true,
+        showDetailedE2E: true,
+        showReportExport: true,
+        maxBlockers: 8,
+        maxWarnings: 8,
+    },
+};
+function getTierPolicy(tier = "free") {
+    return TIER_POLICIES[tier];
+}
+function planToVerificationTier(plan) {
+    if (plan === "pro")
+        return "pro";
+    if (plan === "pro_plus" || plan === "team" || plan === "enterprise")
+        return "pro_plus";
+    return "free";
+}
+function getVerificationTierQuestion(tier) {
+    switch (tier) {
+        case "pro":
+            return "Is this strong enough to send to a client?";
+        case "pro_plus":
+            return "Can I call this release-ready with confidence?";
+        default:
+            return "Is this likely to break right now?";
+    }
+}
+function getTierVerificationView(report) {
+    const policy = getTierPolicy(report.tier);
+    return {
+        tier: report.tier,
+        question: getVerificationTierQuestion(report.tier),
+        verdict: report.verdict,
+        confidence: report.confidence,
+        summary: report.summary,
+        grade: report.grade,
+        blockers: report.blockers.slice(0, policy.maxBlockers),
+        warnings: report.warnings.slice(0, policy.maxWarnings),
+        passes: report.passes,
+        nextActions: report.nextActions.slice(0, Math.max(2, policy.maxWarnings)),
+        failureEvidence: report.failureEvidence.slice(0, Math.max(2, policy.maxWarnings)),
+        showDetailedLighthouse: policy.showDetailedLighthouse,
+        showDetailedE2E: policy.showDetailedE2E,
+        showReportExport: policy.showReportExport,
+    };
+}

package/dist/verification-core/types.d.ts

@@ -0,0 +1,82 @@
+export type VerificationGrade = "gold" | "silver" | "bronze" | "unverified";
+export type VerificationTier = "free" | "pro" | "pro_plus";
+export type ReleaseVerdict = "quick-pass" | "investigate" | "hold" | "release-ready" | "build-failed";
+export interface LighthouseThresholds {
+    performance: number;
+    accessibility: number;
+    seo: number;
+    bestPractices: number;
+}
+export interface LighthouseScores {
+    performance: number;
+    accessibility: number;
+    bestPractices: number;
+    seo: number;
+}
+export interface VerificationInput {
+    buildSuccess?: boolean;
+    buildErrors?: string[];
+    e2ePassed?: number;
+    e2eTotal?: number;
+    viewportIssues?: number;
+    multiViewportPassed?: boolean;
+    multiViewportSummary?: string;
+    visualDiffVerdict?: "pass" | "warn" | "rollback";
+    visualDiffPercentage?: number;
+    hasVisualBaseline?: boolean;
+    failureEvidence?: string[];
+    lighthouseScores?: LighthouseScores;
+}
+export interface VerificationCheck {
+    key: "build" | "e2e" | "lighthouse" | "viewport" | "visual";
+    label: string;
+    passed: boolean;
+}
+export interface VerificationFinding {
+    category: "build" | "performance" | "accessibility" | "seo" | "bestPractices" | "e2e" | "viewport" | "visual";
+    severity: "critical" | "high" | "medium";
+    title: string;
+    description: string;
+    action: string;
+}
+export interface VerificationEvidence {
+    input: VerificationInput;
+    thresholds: LighthouseThresholds;
+    buildPassed: boolean;
+    e2ePassedAll: boolean;
+    hasE2EData: boolean;
+    hasMultiViewportData: boolean;
+    multiViewportPassed: boolean;
+    hasVisualDiffData: boolean;
+    visualDiffPassed: boolean;
+    lighthousePassed: boolean;
+}
+export interface VerificationReport {
+    tier: VerificationTier;
+    verdict: ReleaseVerdict;
+    confidence: "low" | "medium" | "high";
+    summary: string;
+    grade: VerificationGrade;
+    blockers: VerificationFinding[];
+    warnings: VerificationFinding[];
+    passes: VerificationCheck[];
+    nextActions: string[];
+    failureEvidence: string[];
+    evidence: VerificationEvidence;
+}
+export interface TierVerificationView {
+    tier: VerificationTier;
+    question: string;
+    verdict: ReleaseVerdict;
+    confidence: "low" | "medium" | "high";
+    summary: string;
+    grade: VerificationGrade;
+    blockers: VerificationFinding[];
+    warnings: VerificationFinding[];
+    passes: VerificationCheck[];
+    nextActions: string[];
+    failureEvidence: string[];
+    showDetailedLighthouse: boolean;
+    showDetailedE2E: boolean;
+    showReportExport: boolean;
+}

package/dist/verification-core/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "laxy-verify",
-  "version": "1.1.7",
+  "version": "1.1.8",
   "description": "Frontend quality gate: build + Lighthouse verification",
   "type": "commonjs",
   "bin": {