conformly 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Conformly
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,68 @@
+# conformly
+
+[![npm version](https://img.shields.io/npm/v/conformly.svg)](https://www.npmjs.com/package/conformly)
+[![license](https://img.shields.io/npm/l/conformly.svg)](./LICENSE)
+[![node](https://img.shields.io/node/v/conformly.svg)](https://nodejs.org)
+
+Free **RGAA / WCAG** web accessibility scanner for your **CLI & CI** — check any URL in one
+command, no account required. Powered by the public [Conformly](https://conformly.online)
+free-scan API (real-browser render, so React/Vue/Angular apps are analysed properly).
+
+> Scanner d'accessibilité **RGAA / WCAG** en ligne de commande & CI, sans compte.
+
+## Usage
+
+```bash
+npx conformly scan https://your-site.com
+# → Score RGAA : 96 %  ·  1 anomalie(s)
+```
+
+```bash
+# Fail the build (exit 1) below a score threshold
+npx conformly scan https://your-site.com --threshold 90
+
+# Raw JSON output
+npx conformly scan https://your-site.com --json
+```
+
+### In CI (GitHub Actions)
+
+```yaml
+- name: Accessibility check
+  run: npx conformly scan https://your-site.com --threshold 90
+```
+
+Exit code `1` when the score is below the threshold → your pipeline fails, just like a
+broken test. Works the same in GitLab CI, CircleCI, etc.
+
+## Options
+
+| Option | Effet |
+|---|---|
+| `--threshold N` | Sort en erreur (exit 1) si le score est sous `N` (0–100). |
+| `--json` | Sortie JSON brute (`{ url, score, anomalies, threshold }`). |
+
+## Configuration
+
+| Variable | Défaut | Rôle |
+|---|---|---|
+| `CONFORMLY_URL` | `https://conformly.online` | Base de l'API. |
+
+## What it checks — and what it doesn't
+
+The scan combines **axe-core** with **expert tests** (page language, title, skip link,
+visible focus, 200% zoom…) and maps findings to RGAA criteria.
+
+**Honest scope:** automated testing only covers **part** of WCAG/RGAA. A full accessibility
+declaration still requires human review of the non-automatable criteria. Treat the score as
+a fast, reliable signal and a between-audits safety net — **not** a certification.
+
+## Continuous monitoring
+
+A CI check is a floor. For drift over time — regression alerts on every deploy, per-page
+history, timestamped evidence, per-framework fix guides — create a free account at
+**[conformly.online](https://conformly.online)**.
+
+## License
+
+[MIT](./LICENSE) — © Conformly · [conformly.online](https://conformly.online)

package/bin/conformly.mjs

@@ -0,0 +1,119 @@
+#!/usr/bin/env node
+// Epic 15.4 — CLI de scan d'accessibilité RGAA. Utilise l'API publique du scan gratuit
+// de Conformly (aucun token requis). Idéal en CI : `--threshold` fait échouer le build
+// sous le score visé.
+//
+// Usage :
+//   npx conformly scan <url> [--threshold <0-100>] [--json]
+//
+// Variables : CONFORMLY_URL (défaut https://conformly.online).
+
+const API = (process.env.CONFORMLY_URL || "https://conformly.online").replace(/\/$/, "");
+const POLL_MS = 2500;
+const MAX_POLLS = 60;
+
+const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
+
+function usage(code) {
+  console.error(
+    [
+      "conformly — scan d'accessibilité RGAA",
+      "",
+      "Usage :",
+      "  conformly scan <url> [--threshold <0-100>] [--json]",
+      "",
+      "Options :",
+      "  --threshold N  Échoue (exit 1) si le score est sous N.",
+      "  --json         Sortie JSON brute.",
+    ].join("\n"),
+  );
+  process.exit(code);
+}
+
+function parseArgs(argv) {
+  if (argv[0] !== "scan" || !argv[1] || argv[1].startsWith("-")) usage(2);
+  const url = argv[1];
+  let threshold = null;
+  let json = false;
+  for (let i = 2; i < argv.length; i++) {
+    if (argv[i] === "--threshold") threshold = Number(argv[++i]);
+    else if (argv[i] === "--json") json = true;
+    else usage(2);
+  }
+  if (threshold !== null && (Number.isNaN(threshold) || threshold < 0 || threshold > 100)) usage(2);
+  return { url, threshold, json };
+}
+
+function anomalyCount(violations) {
+  if (!Array.isArray(violations)) return 0;
+  let n = 0;
+  for (const v of violations) {
+    if (!v || typeof v.ruleId !== "string") continue;
+    n += Array.isArray(v.nodes) ? v.nodes.length : 1;
+  }
+  return n;
+}
+
+async function main() {
+  const { url, threshold, json } = parseArgs(process.argv.slice(2));
+
+  let started;
+  try {
+    const res = await fetch(`${API}/api/free-scan`, {
+      method: "POST",
+      headers: { "content-type": "application/json" },
+      body: JSON.stringify({ url }),
+    });
+    started = await res.json();
+    if (!res.ok || !started.id) {
+      console.error(`Erreur : ${started.error || res.status}`);
+      process.exit(1);
+    }
+  } catch (err) {
+    console.error(`Erreur réseau : ${err.message}`);
+    process.exit(1);
+  }
+
+  if (!json) process.stderr.write(`Scan de ${url} en cours…\n`);
+
+  let result = null;
+  for (let i = 0; i < MAX_POLLS; i++) {
+    await sleep(POLL_MS);
+    try {
+      const r = await fetch(`${API}/api/free-scan/${started.id}`);
+      const data = await r.json();
+      if (data.status === "done" || data.status === "error") {
+        result = data;
+        break;
+      }
+    } catch {
+      /* on retente */
+    }
+  }
+
+  if (!result) {
+    console.error("Délai dépassé.");
+    process.exit(1);
+  }
+  if (result.status === "error") {
+    console.error(`Analyse impossible : ${result.errorReason || "erreur inconnue"}`);
+    process.exit(1);
+  }
+
+  const score = result.score != null ? Math.round(result.score) : null;
+  const anomalies = anomalyCount(result.violations);
+
+  if (json) {
+    console.log(JSON.stringify({ url, score, anomalies, threshold }, null, 2));
+  } else {
+    console.log(`Score RGAA : ${score != null ? score + " %" : "—"}  ·  ${anomalies} anomalie(s)`);
+  }
+
+  if (threshold !== null && score != null && score < threshold) {
+    console.error(`Score ${score}% sous le seuil ${threshold}%.`);
+    process.exit(1);
+  }
+  process.exit(0);
+}
+
+main();

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "conformly",
+  "version": "0.1.0",
+  "description": "CLI de scan d'accessibilité RGAA/WCAG — vérifiez une URL en ligne de commande, idéal en CI. Sans compte.",
+  "type": "module",
+  "bin": {
+    "conformly": "bin/conformly.mjs"
+  },
+  "files": [
+    "bin",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "accessibility",
+    "accessibilité",
+    "rgaa",
+    "wcag",
+    "a11y",
+    "audit",
+    "ci",
+    "cli",
+    "conformly"
+  ],
+  "homepage": "https://conformly.online",
+  "bugs": {
+    "url": "https://conformly.online"
+  },
+  "author": "Conformly (https://conformly.online)",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/SeifBouarada/conformly-cli.git"
+  }
+}