buvard 0.0.0-stage → 0.1.0

package/lib/catalog.mjs

@@ -0,0 +1,72 @@
+/**
+ * buvard catalog v2 — the slop patterns, as data.
+ *
+ * Every entry: [id, weight, sources, languages, regex]. Weights follow the
+ * barème ratified in docs/research.md (lexique 5, structure 8, servile 10);
+ * punctuation budgets live in the CLI, not here (they are per-document
+ * arithmetic, not patterns).
+ *
+ * Sources: fr1 = JulienSnsnCode/anti-slop-fr, fr2 = captain-marketing/
+ * anti-slop-fr, étape = letape-dapres.fr writing-unslop, no-slop = the
+ * creatoreconomy 20-pattern skill, ui-sk = ui-skills.com anti-ai-slop-writing.
+ * See docs/research.md for the clustering and the vote table.
+ *
+ * High-precision by design: every hit is a review candidate, not a verdict.
+ * The author's voice always wins — the sources agree on this unanimously.
+ */
+
+export const CATALOG_VERSION = 2;
+
+export const CATALOG = [
+  // --- ouvertures à vide (fr1 §1, étape FR)
+  ['ouverture-vide', 5, 'fr1 fr2 étape', 'fr',
+    /\b(soyons honn[êe]tes|soyons clairs|on ne va pas se mentir|la v[ée]rit[ée],? c'est que|parlons peu,? parlons bien|il faut le dire|spoiler\s*:|petit rappel\s*:|petite pr[ée]cision\s*:|autant vous le dire tout de suite)\b/gi],
+  // --- décors grandioses (fr1 §2, étape FR)
+  ['décor grandiose', 5, 'fr1 étape', 'fr',
+    /\b(dans un monde (trépidant|en constante évolution|[a-zéèà-ÿ]+)|[àa] l'[èe]re de|[àa] l'heure [oùo]|dans le paysage (du|de la|des)|au c[œo]ur de|au coeur de|aujourd'hui plus que jamais|face aux défis de|dans un contexte o[ùu]|dans un monde o[ùu])\b/gi],
+  // --- impératifs impersonnels (fr1 §5, étape FR)
+  ['impératif impersonnel', 5, 'fr1 fr2 étape', 'fr',
+    /\bil est (essentiel|important|crucial|imp[ée]ratif|int[ée]ressant) de\b|\bil convient de (noter|souligner|rappeler|pr[ée]ciser)\b|\bforce est de constater\b|\bil va sans dire\b|\bil appert que\b/gi],
+  // --- anti-copule (fr1 §6, étape EN "copula avoidance", flaviocopes)
+  ['anti-copule', 5, 'fr1 étape flaviocopes', 'fr',
+    /\b(constitue|repr[ée]sente|s'impose comme|se positionne comme|incarne|se r[ée]v[èe]le [êe]tre|t[ée]moigne de|s'inscrit dans|se veut [a-zéèà-ÿ]+|se traduit par)\b/gi],
+  // --- connecteurs en chaîne (fr1 §7, étape FR)
+  ['connecteur en début', 5, 'fr1 étape', 'fr',
+    /^(de plus|en outre|par ailleurs|en effet|ainsi|de ce fait|dès lors|néanmoins|cependant|toutefois|qui plus est|de surcroît|dans cette optique|à cet égard)\b *[,:]?/gim],
+  // --- conclusions-bilans (fr1 §8, étape, no-slop)
+  ['conclusion-bilan', 5, 'fr1 étape no-slop', 'fr',
+    /\b(en conclusion|en résumé|en somme|en définitive|au final|pour conclure|en bref|vous l'aurez compris|voilà pour (cet|cette)|l'avenir nous le dira|seul le temps nous dira|the future isn'?t coming)\b/gi],
+  // --- attribution vague (fr1 §10, étape, no-slop)
+  ['attribution vague', 8, 'fr1 étape no-slop', 'fr en',
+    /\b(les experts s'accordent|de nombreuses études montrent|on observe que|on constate que|il est reconnu que|il est admis que|d'aucuns|selon certains|experts (agree|argue|say)|studies show)\b/gi],
+  // --- faux poids (fr1 §11, étape "significance inflation")
+  ['faux poids', 8, 'fr1 étape no-slop', 'fr en',
+    /\b(marque un tournant|moment charnière|change la donne|game-?chang(er|ing)|le potentiel est immense|les enjeux (sont )?(considérables|énormes)|un tournant décisif|plus que jamais|stands as|is a testament to|marks a pivotal|pivotal moment)\b/gi],
+  // --- servilité et méta-commentaire (fr1 §12, étape "sycophancy")
+  ['servilité/méta', 10, 'fr1 fr2 étape no-slop', 'fr en',
+    /\b(excellente question|n'hésitez pas [àa]|n'hésitez plus|plot twist|cerise sur le gâteau|dans cet article,? nous (allons|allions)|au programme\s*:|installez-?vous confortablement|c'est parti !|que vous soyez (débutant|[a-zéèà-ÿ]+) ou|i hope this (helps|this helps)|as an? (ai|assistant|language model)\b)/gi],
+  // --- adjectifs gonflés (fr1 §4, fr2 hyperboles, étape EN, flaviocopes)
+  ['adjectif gonflé', 5, 'fr1 fr2 étape flaviocopes', 'fr en',
+    /\b(incontournable|r[ée]volutionnaire|disruptif|innovant|captivant|fascinant|redoutable|holistique|granulaire|sublimer|débloquer le potentiel|cutting-edge|groundbreaking|revolutioniz\w+|seamless\w*|robuste|robust)\b/gi],
+  // --- adverbes de remplissage (fr1 §9, fr2) — à relire, FP possibles
+  ['adverbe remplissage', 3, 'fr1 fr2', 'fr',
+    /\b(vraiment|littéralement|fondamentalement|intrinsèquement|résolument|crucialement|absolument|incroyablement|extrêmement|parfaitement|totalement|véritablement)\b/gi],
+  // --- contraste binaire (fr1 st§1, fr2 règle 2, étape, no-slop, flaviocopes)
+  ['contraste binaire', 8, 'fr1 fr2 étape no-slop flaviocopes', 'fr en',
+    /\bce n'est pas\b[^.!?]{1,90}?\b(c'est|mais)\b|[Cc]e n'est pas [^.!?]{1,60}[.!?]\s*[^\n]{0,20}\bc'est\b|not (just|merely|only)? ?[^.!?]{1,60}\bbut\b/gi],
+  // --- question-réponse artificielle (fr1 st§2, étape EN rhetorical openers)
+  ['question-réponse', 8, 'fr1 étape no-slop', 'fr en',
+    /\b(le problème\s*\?|la bonne nouvelle\s*\?|le résultat\s*:|résultat\s*\?|mon conseil\s*\?|la réponse\s*:)\b/gi],
+  // --- fragments dramatiques (fr1 st§3, no-slop)
+  ['fragment dramatique', 8, 'fr1 no-slop', 'fr en',
+    /\b(un mot\.|simple\. efficace\.|c'est tout\.|that'?s it\. that'?s)\b/gi],
+  // --- EN lexical slop (étape EN, flaviocopes, no-slop)
+  ['EN slop lexique', 5, 'étape flaviocopes no-slop', 'en',
+    /\b(delve into|unpack\w*|navigate the complexit\w+|ever-changing landscape|the landscape of|synerg\w+|leverage\w*|holistic approach|it'?s worth noting|lean into|foster a culture|at the end of the day|moving forward|in today'?s world|unlock the potential|harness the power|deep dive|key takeaways|north star|double down on|at scale|boasts a|vibrant|profound)\b/gi],
+];
+
+/** Punctuation budgets (ui-sk): 1 tiret cadratin / 500 words, 1 ! / 1000. */
+export const BUDGETS = [
+  { re: /—/g, perWords: 500, floor: 1, id: 'tiret cadratin', weight: 5 },
+  { re: /!/g, perWords: 1000, floor: 1, id: 'exclamation', weight: 5 },
+];

package/lib/index.mjs

@@ -0,0 +1,4 @@
+/** buvard package entry — the catalog, the budgets, and the lint core. */
+
+export { CATALOG, CATALOG_VERSION, BUDGETS } from './catalog.mjs';
+export { lint, bodyOf } from './lint.mjs';

package/lib/lint.mjs

@@ -0,0 +1,86 @@
+/**
+ * buvard lint core — score a text against the catalog.
+ *
+ * Scoring starts at 100; each hit costs its weight (lexique 5, structure 8,
+ * servile 10); punctuation charges per occurrence past the budget: one tiret
+ * cadratin per 500 words, one exclamation per 1000. Every hit is a review
+ * candidate, not a verdict — the author's voice always wins.
+ */
+
+import { CATALOG, BUDGETS } from './catalog.mjs';
+
+/**
+ * Quoted spans are exempt: quoted speech, documentation quoting slop on
+ * purpose, code. A match counts only if it starts outside every span.
+ * Spans are bounded so an unpaired opener cannot swallow the document.
+ */
+const QUOTED_SPANS = [
+  /```[\s\S]*?(?:```|$)/g,   // fenced code blocks
+  /`[^`\n]+`/g,              // inline code
+  /«[^»]{0,400}»/g,          // guillemets
+  /“[^”\n]{0,400}?”/g,       // typographic double quotes
+  /"[^"\n]*"/g,              // straight double quotes, same line only
+];
+
+function quotedRanges(text) {
+  const ranges = [];
+  for (const re of QUOTED_SPANS) {
+    re.lastIndex = 0;
+    for (const m of text.matchAll(re)) ranges.push([m.index, m.index + m[0].length]);
+  }
+  return ranges.sort((a, b) => a[0] - b[0]);
+}
+
+/** Membership test by binary search over the sorted spans. */
+function outsideTest(ranges) {
+  return (index) => {
+    let lo = 0;
+    let hi = ranges.length - 1;
+    while (lo <= hi) {
+      const mid = (lo + hi) >> 1;
+      const [s, e] = ranges[mid];
+      if (index < s) hi = mid - 1;
+      else if (index >= e) lo = mid + 1;
+      else return false; // inside a quoted span
+    }
+    return true;
+  };
+}
+
+/** Body = everything after the frontmatter fence (frontmatter is data, not prose). */
+export function bodyOf(text) {
+  const parts = text.split('---');
+  return parts.length >= 3 && text.startsWith('---') ? parts.slice(2).join('---').trim() : text.trim();
+}
+
+function excerpt(text, index) {
+  return '…' + text.slice(Math.max(0, index - 38), index + 52).replace(/\s+/g, ' ') + '…';
+}
+
+export function lint(text) {
+  const words = text.split(/\s+/).filter(Boolean).length;
+  const outside = outsideTest(quotedRanges(text));
+  const hits = [];
+  let score = 100;
+  let masked = 0;
+  for (const [id, w, , , re] of CATALOG) {
+    for (const m of text.matchAll(re)) {
+      if (!outside(m.index)) { masked++; continue; }
+      hits.push({ id, w, at: excerpt(text, m.index) });
+      score -= w;
+    }
+  }
+  for (const { re, perWords, floor, id, weight } of BUDGETS) {
+    const budget = Math.max(floor, Math.floor(words / perWords));
+    let excess = 0;
+    for (const m of text.matchAll(re)) {
+      if (!outside(m.index)) { masked++; continue; }
+      if (excess >= budget) {
+        hits.push({ id: `budget ${id} (>${budget}/${words} mots)`, w: weight, at: `occurrence ${excess + 1}` });
+        score -= weight;
+      }
+      excess++;
+    }
+  }
+  return { words, hits, masked, score: Math.max(0, score) };
+}

package/package.json

@@ -1,6 +1,14 @@
 {
   "name": "buvard",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "buvard — l'anti-slop qui tache. Blotting paper for AI-flavored prose: a weighted multi-score linter for French and English slop patterns.",
+  "type": "module",
+  "bin": { "buvard": "bin/buvard.js" },
+  "main": "lib/index.mjs",
+  "files": ["bin", "lib", "docs", "AGENTS.md", "SKILL.md", "README.md", "LICENSE"],
+  "scripts": { "test": "node --test test/" },
+  "keywords": ["slop", "linter", "prose", "french", "writing", "ai-writing", "style"],
+  "license": "GPL-3.0-only",
+  "repository": { "type": "git", "url": "https://git.nech.pl/pln/buvard.git" },
+  "engines": { "node": ">=18" }
+}