feat: v1.0.1 — CI, tests, --min-score, --fail-on, clean publish config

- Add 54 unit tests (vitest) across scorer, rules, audit
- Fix scoring weights: critical=-20, warning=-8, info=-2
- Add --min-score <n> flag for CI/CD threshold gates
- Add --fail-on warnings strict mode for CI
- Fix hardcoded version in cli.ts (reads from package.json at runtime)
- Add .github/workflows/ci.yml with build + smoke test
- Add .npmignore and files[] in package.json for clean publish
- Add types field to package.json for TypeScript consumers
- Add test script + vitest to devDependencies
- Improve reporter: title display, sorted findings within categories, pass suggestions suppressed, cleaner summary line
- Update README with new flags, updated grade table, programmatic API

54 tests passing. Ready for npm publish.

Author: bertuccio-admachine

.github/workflows/ci.yml

@@ -0,0 +1,21 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: 'npm'
+      - run: npm ci
+      - run: npm run build
+      - name: Smoke test — admachine.ai
+        run: node dist/cli.js https://admachine.ai --json | jq '.score'

.npmignore

@@ -0,0 +1,4 @@
+src/
+.github/
+tsconfig.json
+*.log

README.md

@@ -1,5 +1,9 @@
 # 🔥 landing-roast
 
+[![CI](https://github.com/SlashImagine/landing-roast/actions/workflows/ci.yml/badge.svg)](https://github.com/SlashImagine/landing-roast/actions/workflows/ci.yml)
+[![npm version](https://img.shields.io/npm/v/landing-roast.svg)](https://www.npmjs.com/package/landing-roast)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
 **Roast any landing page for conversion issues. Get actionable fixes in seconds.**
 
 Stop guessing why your landing page isn't converting. `landing-roast` runs 20+ conversion heuristics against any URL and tells you exactly what's broken — with specific fixes.
@@ -73,13 +77,19 @@ landing-roast https://example.com --json
 landing-roast https://example.com --json | jq '.findings[] | select(.severity == "critical")'
 ```
 
-## Use Cases
+## CI/CD Integration
 
-- **Pre-launch checklist** — Catch conversion killers before going live
-- **Competitor analysis** — Roast competitor landing pages to find their gaps
-- **Client audits** — Quick deliverable for marketing consultants
-- **CI/CD integration** — Fail deploys that introduce conversion regressions (exits with code 1 on criticals)
-- **Content marketing** — "We roasted 100 SaaS landing pages. Here's what we found."
+`landing-roast` exits with code 1 when critical issues are found — perfect for deploy gates:
+
+```yaml
+# GitHub Actions example
+- name: Audit landing page
+  run: npx landing-roast https://your-site.com --json > audit.json
+
+# Block deploy on critical issues
+- name: Check for critical issues
+  run: npx landing-roast https://your-site.com
+```
 
 ## Programmatic API
 
@@ -88,38 +98,59 @@ import { fetchPage, auditPage, formatReport } from 'landing-roast';
 
 const page = await fetchPage('https://example.com');
 const result = auditPage(page);
-
-console.log(result.score);        // 72
-console.log(result.findings);     // Finding[]
-console.log(formatReport(result)); // Formatted terminal output
+console.log(result.score);          // 0-100
+console.log(result.findings);       // Finding[]
+console.log(formatReport(result));  // Formatted terminal output
 ```
 
+## Use Cases
+
+- **Pre-launch checklist** — Catch conversion killers before going live
+- **Competitor analysis** — Roast competitor landing pages to find their gaps
+- **Client audits** — Quick deliverable for marketing consultants
+- **CI/CD gates** — Prevent shipping pages with critical conversion issues
+- **A/B test validation** — Verify new variants meet conversion baselines
+
 ## Scoring
 
-- **A (90-100)** 🔥 — This page converts. Respect.
-- **B (80-89)** 👍 — Solid page with room to improve.
-- **C (65-79)** 😬 — Leaving money on the table.
-- **D (50-64)** 💀 — Your landing page needs serious help.
-- **F (0-49)** 🪦 — This page is a conversion graveyard.
+| Grade | Score | Meaning |
+|-------|-------|---------|
+| A | 90-100 | This page converts. Respect. |
+| B | 80-89 | Solid page with room to improve. |
+| C | 65-79 | Leaving money on the table. |
+| D | 50-64 | Your landing page needs serious help. |
+| F | 0-49 | This page is a conversion graveyard. |
 
-Each finding has a severity:
-- 🔴 **Critical** (-15pts) — Directly kills conversion
-- 🟡 **Warning** (-7pts) — Significantly impacts conversion
-- 🔵 **Info** (-2pts) — Nice to fix, minor impact
-- ✅ **Pass** (0pts) — You're doing this right
+Severity weights: Critical (-15), Warning (-7), Info (-2), Pass (0).
 
-## Why This Exists
+## Contributing
 
-Every marketer has shipped a landing page and wondered "why isn't this converting?" The answer is usually a handful of basic mistakes — no clear CTA, missing social proof, slow load time, broken mobile experience.
+Contributions welcome! Here's how:
 
-Tools like Google Lighthouse cover performance. `landing-roast` covers **conversion** — the stuff that actually makes people buy.
+1. Fork the repo
+2. Create a feature branch (`git checkout -b feat/my-rule`)
+3. Add your rule to `src/rules.ts` and register it in `allRules`
+4. Add tests in `test/rules.test.ts`
+5. Run `npm test` to verify
+6. Open a PR
 
-Built by [Ad Machine](https://admachine.ai) — the AI ad creative platform.
+### Adding a new rule
 
-## Contributing
+Rules are simple functions that take a `PageData` and Cheerio instance, and return `Finding[]`:
 
-PRs welcome. The rule system is modular — add a new rule in `src/rules.ts` and it automatically runs.
+```typescript
+const myRule: Rule = (page, $) => {
+  // Check something
+  if (somethingBad) {
+    return [finding('my-rule-id', 'Category', 'warning',
+      'What is wrong.',
+      'How to fix it.',
+    )];
+  }
+  return [finding('my-rule-ok', 'Category', 'pass', 'All good.')];
+};
+```
 
 ## License
 
-MIT
+MIT © [Ad Machine](https://admachine.xyz)