@qaguardian/playwright-score 0.1.0 → 0.1.2

package/README.md

@@ -18,15 +18,18 @@ See [METHODOLOGY.md](./METHODOLOGY.md) for the frozen formula, or the full produ
 
 ```bash
 npm install -D @qaguardian/playwright-score
-# or run from this package
-npm install && npm run build
 ```
 
+Package: [@qaguardian/playwright-score](https://www.npmjs.com/package/@qaguardian/playwright-score) on npm.
+
 ## CLI
 
 ```bash
-npx @qaguardian/playwright-score ./tests --profile standard --threshold 80
-npx @qaguardian/playwright-score ./flow.spec.ts --profile guardian --format json --out report.json
+# One-shot (scoped package — use -p so the playwright-score binary is resolved)
+npx -p @qaguardian/playwright-score playwright-score ./tests --profile standard --threshold 80
+
+# After local install
+npx playwright-score ./flow.spec.ts --profile guardian --format json --out report.json
 ```
 
 | Flag | Description |
@@ -35,8 +38,9 @@ npx @qaguardian/playwright-score ./flow.spec.ts --profile guardian --format json
 | `--threshold <n>` | Pass bar 0–100 |
 | `--format text\|json\|markdown\|sarif` | Output format |
 | `--out <file>` | Write report to file |
+| `--version` | Print version |
 
-**Exit codes:** `0` pass · `1` below threshold · `2` tool error  
+**Exit codes:** `0` pass · `1` below threshold **or no files matched** · `2` tool error  
 
 ## Library
 
@@ -56,7 +60,7 @@ console.log(result.score, result.grade, result.pass, result.findings);
 
 ```yaml
 - name: Playwright Spec Score
-  run: npx playwright-score ./tests --profile standard --threshold 80 --format text
+  run: npx -p @qaguardian/playwright-score playwright-score ./tests --profile standard --threshold 80 --format text
 ```
 
 ## QA Guardian integration

package/dist/cli.js

@@ -10,28 +10,44 @@ import { formatText } from './formatters/text.js';
 import { formatMarkdown } from './formatters/markdown.js';
 import { formatSarif } from './formatters/sarif.js';
 function printHelp() {
-    console.log(`playwright-score — deterministic Playwright spec quality score (sqs-v1)
+    console.log(`@qaguardian/playwright-score — deterministic Playwright spec quality score (sqs-v1)
 
 Usage:
-  playwright-score <paths...> [options]
+  npx -p @qaguardian/playwright-score playwright-score <paths...> [options]
+  # after npm install -D @qaguardian/playwright-score:
+  npx playwright-score <paths...> [options]
 
 Options:
   --profile <standard|guardian>   Scoring profile (default: standard)
   --threshold <n>                 Pass threshold 0-100 (default: 80 standard / 75 guardian)
   --format <text|json|markdown|sarif>  Output format (default: text)
   --out <file>                    Write report to file
+  --version                       Print version
   --help                          Show help
 
 Exit codes:
   0  score >= threshold
-  1  score < threshold
+  1  score < threshold (or no files matched)
   2  tool error
 
-See METHODOLOGY.md for sqs-v1 formula.
+Website: https://qaguardian.com/open-source/playwright-score
+Methodology: METHODOLOGY.md (sqs-v1)
 `);
 }
 async function main() {
     const args = process.argv.slice(2);
+    if (args.includes('--version') || args.includes('-v')) {
+        try {
+            const { createRequire } = await import('node:module');
+            const require = createRequire(import.meta.url);
+            const pkg = require('../package.json');
+            console.log(pkg.version ?? '0.0.0');
+        }
+        catch {
+            console.log('0.1.1');
+        }
+        process.exit(0);
+    }
     if (args.length === 0 || args.includes('--help') || args.includes('-h')) {
         printHelp();
         process.exit(args.length === 0 ? 2 : 0);
@@ -68,6 +84,9 @@ async function main() {
         else if (a === '--out') {
             out = args[++i];
         }
+        else if (a === '--version' || a === '-v') {
+            continue;
+        }
         else if (a.startsWith('-')) {
             console.error(`Unknown option: ${a}`);
             process.exit(2);

package/dist/eslint-runner.js

@@ -1,5 +1,6 @@
 import path from 'node:path';
 import { ESLint } from 'eslint';
+import { commonAncestorDir } from './fs-util.js';
 import playwright from 'eslint-plugin-playwright';
 import { guardianPlugin, guardianRuleConfigs, } from './rules/guardian-plugin.js';
 import { mapRule } from './profiles.js';
@@ -67,7 +68,17 @@ function toSeverity(eslintSeverity, override) {
  * Does not load host-repo eslint.config.js.
  */
 export async function runEslint(options) {
-    const cwd = options.cwd ?? process.cwd();
+    // ESLint 9 flat config resolves a `basePath` from `cwd` and silently
+    // drops (as an untracked, ruleId-less message) any file that isn't
+    // underneath it — no error, no findings, just a quietly clean score.
+    // The caller's cwd (e.g. a runner process's install dir) has no reason
+    // to contain the spec files being scored, so it can never be trusted
+    // as the ESLint basePath. Derive a basePath that is guaranteed to
+    // contain every file instead; fall back to the caller's cwd only when
+    // there are no files (nothing to lint anyway).
+    const cwd = options.files.length > 0
+        ? commonAncestorDir(options.files)
+        : (options.cwd ?? process.cwd());
     const overrideConfig = buildConfig(options.profile);
     // Try to attach typescript-eslint parser for .ts files
     try {

package/dist/fs-util.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Deepest directory that contains every given absolute file path.
+ * Used as the ESLint flat-config basePath so linting never silently
+ * excludes files that fall outside an unrelated caller cwd.
+ */
+export declare function commonAncestorDir(absoluteFiles: string[]): string;

package/dist/fs-util.js

@@ -0,0 +1,22 @@
+import path from 'node:path';
+/**
+ * Deepest directory that contains every given absolute file path.
+ * Used as the ESLint flat-config basePath so linting never silently
+ * excludes files that fall outside an unrelated caller cwd.
+ */
+export function commonAncestorDir(absoluteFiles) {
+    const dirs = absoluteFiles.map((f) => path.dirname(path.resolve(f)));
+    if (dirs.length === 0)
+        return process.cwd();
+    let common = dirs[0].split(path.sep);
+    for (const dir of dirs.slice(1)) {
+        const parts = dir.split(path.sep);
+        let i = 0;
+        while (i < common.length && i < parts.length && common[i] === parts[i]) {
+            i++;
+        }
+        common = common.slice(0, i);
+    }
+    const joined = common.join(path.sep);
+    return joined || path.sep;
+}

package/dist/index.js

@@ -45,24 +45,42 @@ export async function scorePaths(options) {
     const threshold = options.threshold ?? DEFAULT_THRESHOLDS[profile] ?? 80;
     const files = expandPaths(options.paths, cwd);
     if (files.length === 0) {
-        return computeScore({
+        // Hard-fail: empty match must never look like a healthy suite (was ~99 PASS).
+        const findings = [
+            {
+                rule: 'playwright-score/no-files',
+                severity: 'error',
+                message: `No Playwright spec files matched: ${options.paths.join(', ') || '(no paths)'}`,
+                file: cwd,
+                dimension: 'structure',
+            },
+        ];
+        return {
+            scoreVersion: 'sqs-v1',
             profile,
+            score: 0,
+            grade: 'F',
+            pass: false,
             threshold,
-            findings: [
-                {
-                    rule: 'playwright-score/no-files',
-                    severity: 'error',
-                    message: 'No Playwright spec files matched the given paths',
-                    file: cwd,
-                    dimension: 'structure',
-                },
-            ],
-            sloc: 1,
-            files: 0,
-            tests: 0,
-            nativeLocators: 0,
-            rawLocators: 0,
-        });
+            summary: {
+                files: 0,
+                tests: 0,
+                sloc: 0,
+                findings: 1,
+                errors: 1,
+                warnings: 0,
+                nativeLocators: 0,
+                rawLocators: 0,
+            },
+            dimensions: {
+                playwrightHygiene: 0,
+                assertions: 0,
+                locators: 0,
+                structure: 0,
+                ...(profile === 'guardian' ? { guardianConventions: 0 } : {}),
+            },
+            findings,
+        };
     }
     const eslintFindings = await runEslint({ files, profile, cwd });
     let totalSloc = 0;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qaguardian/playwright-score",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Deterministic, AI-free Playwright spec quality score (sqs-v1). Lint + score with standard and guardian profiles.",
   "type": "module",
   "main": "./dist/index.js",