@heyramzi/lint 2.0.0 → 2.1.0

package/bin/heyramzi-comment-length.js

@@ -101,15 +101,16 @@ function gate(files) {
     return;
   }
 
+  // A long comment is a warning: one word over the cap never broke anything. A hack marker fails.
   for (const { file, words } of failures) {
-    console.error(`${file}: longest comment ${words} words (over ${max})`);
+    console.warn(`warning ${file}: longest comment ${words} words (over ${max})`);
   }
-  if (failures.length > 0) console.error("\nCompress the comment to the point it makes.");
+  if (failures.length > 0) console.warn("Compress the comment to the point it makes.\n");
   for (const { file, line, label } of markers) {
     console.error(`${file}:${line}: ${label}`);
   }
   if (markers.length > 0) {
     console.error("\nFix what the comment names, or delete it. No old name survives a refactor.");
+    exit(1);
   }
-  exit(1);
 }

package/bin/heyramzi-file-tokens.js

@@ -28,8 +28,8 @@ const real = failures.filter(({ file }) => !generated(file));
 if (real.length === 0) {
   console.log(`file-tokens: every ${fileMode ? "" : "staged "}file is under its cap`);
 } else {
-  console.error(report(real));
-  exit(1);
+  // A warning: splits made only to clear a few tokens were churn. Split by job when you're in the file.
+  console.warn(`warning ${report(real)}`);
 }
 
 function gitRoot(cwd) {

package/bin/heyramzi-slop.js

@@ -53,7 +53,9 @@
 
 import { readdirSync, readFileSync, statSync, writeFileSync } from "node:fs";
 import { join } from "node:path";
-import { patterns, shapes, titleTells } from "#lint/data/slop-words.js";
+import { shapes } from "#lint/data/slop-words.js";
+import { patterns } from "#lint/data/slop/patterns.js";
+import { titleTells } from "#lint/data/slop/title-tells.js";
 import { REVIEW, auditShapes, isUnavailable, kiloKey, proseOf } from "#lint/jev.js";
 import { slopGate } from "#lint/slop.js";
 

package/config/oxlintrc.json

@@ -57,7 +57,7 @@
     "@heyramzi/lint/svelte-section-order": "warn",
     "@heyramzi/lint/no-inline-svg": "error",
     "@heyramzi/lint/no-inline-path": "error",
-    "@heyramzi/lint/no-relative-imports": "error",
+    "@heyramzi/lint/no-relative-imports": "warn",
     "@heyramzi/lint/no-underscore-reexport": "error",
     "@heyramzi/lint/convex-react-client-module-scope": "error",
     "@heyramzi/lint/no-chained-type-assertions": "warn",

package/data/slop/artifacts.js

@@ -0,0 +1,87 @@
+/**
+ * Machine residue. The citation and formatting markup a chatbot leaks into its own output, one entry per tool that leaks it.
+ */
+
+/*
+ * WHY this is separate from `patterns`: a pattern is a judgement about a sentence and a person can disagree with it. These are certainties.
+ */
+
+/*
+ * No writer types `:contentReference[oaicite:0]`, `【85†L261-269】` or `utm_source=chatgpt.com` into finished copy, so a hit is not a style opinion, it is the receipt.
+ */
+
+/*
+ * Wikipedia:Signs of AI writing calls it "an unambiguous indicator that the text originated with AI" (WP:OAICITE, WP:STARTSPAN, WP:GROKCARD), and it is the only half of that page that needs no
+ */
+
+/*
+ * corpus check before shipping.
+ */
+
+/*
+ * Language neutral by construction: the residue is the same in every language, which is why the French page lists `:contentReference[oaicite:2]{index=2}` under "Sources rédigées avec une syntaxe inconnue".
+ */
+export const artifacts = [
+  {
+    id: "openai-citation",
+    name: "ChatGPT citation residue",
+    test: /:contentReference\[oaicite:\d+\]|\boai_citation\b|\bcontentReference\b|\bcite\u{E200}?turn\d+|\bturn\d+(?:search|image|news|file|view|forecast)\d+|\{"attribution":\s*\{"attributableIndex"/u,
+    rule: "ChatGPT's internal reference markup, pasted through. Delete it and write the citation, or delete the sentence that needed one.",
+    example: '":contentReference[oaicite:0]{index=0}" / "citeturn0search3"',
+  },
+  {
+    id: "gemini-citation",
+    name: "Gemini citation residue",
+    test: /\[cite:\s*[\d,\s]+\]|\[span_\d+\]\((?:start|end)_span\)|\((?:start|end)_span\)/,
+    rule: "Gemini's citation and span markup, pasted through. Delete it.",
+    example: '"[cite: 3, 12, 13]" / "[span_1](start_span)"',
+  },
+  {
+    id: "grok-citation",
+    name: "Grok citation residue",
+    test: /grok_render_citation_card_json|<\/?grok-card\b|\bgrok_card\b|[?&]referrer=grok\.com\b/i,
+    rule: "Grok's citation card markup, pasted through. Delete it.",
+    example: '"<grok-card data-id=...>" / "grok_render_citation_card_json"',
+  },
+  {
+    id: "deepseek-citation",
+    name: "DeepSeek citation residue",
+    test: /【\d+†[^】]*】/,
+    rule: "DeepSeek's lenticular-bracket footnote markup, pasted through. Delete it.",
+    example: '"【85†L261-269】"',
+  },
+  {
+    id: "perplexity-citation",
+    name: "Perplexity citation residue",
+    test: /\[(?:attached_file|web):\d+\]|ppl-ai-file-upload/i,
+    rule: "Perplexity's file and web reference markup, pasted through. Delete it.",
+    example: '"[attached_file:1]" / "[web:1]"',
+  },
+  {
+    id: "assistant-utm",
+    name: "Assistant UTM tag",
+    // The link the model handed back, with its own referral tag still on it. It
+    // proves the URL came from a chatbot even when a human wrote the sentence.
+    test: /[?&](?:utm_source=(?:chatgpt\.com|openai|copilot\.com|perplexity\.ai)|referrer=grok\.com)\b/i,
+    rule: "A URL still carrying the chatbot's referral parameter. Strip the query string back to the link the reader needs.",
+    example: '"https://example.com/article?utm_source=chatgpt.com"',
+  },
+  {
+    id: "document-block-markup",
+    name: "Document block markup",
+    // The `:::writing{variant="document" id=...}` wrapper, and the fenced
+    // wikitext block a chatbot emits when asked for markup it does not speak.
+    test: /:::\s*writing\{|```\s*wikitext\b|↩️?/,
+    rule: "A document wrapper or a footnote return arrow the chat interface added around the answer. Delete the wrapper and keep the text.",
+    example: ':::writing{variant="document" id="12345"} / "```wikitext"',
+  },
+  {
+    id: "assistant-turn-markup",
+    name: "Assistant turn markup",
+    // A model's own control tags. `function_calls` and `thinking` reach copy
+    // when a transcript is pasted rather than the answer.
+    test: /<\/?(?:thinking|antml:[a-z_]+|function_calls|invoke name=)\b/i,
+    rule: "A control tag from the model's own turn, pasted with the answer. Delete it, and check what else came with it.",
+    example: '"<thinking>" / "<function_calls>"',
+  },
+];

package/data/slop/pattern-parts.js

@@ -0,0 +1,56 @@
+// Grammar parts shared by `elided-passive` and `parallel-clauses`, kept as
+// strings so each regex reads as the sentence shape it names.
+export const SUBJECT_STOP =
+  "(?!(?:I|We|You|They|He|She|It|This|That|These|Those|There|Here|Who|What|Whatever|Which|When|Where|Why|How|If|Once|Then|And|But|So|Or|Every|Each|Anything|Everything|Something|Nothing|Everyone|Anyone|Someone|Nobody|No|Not|Please)\\b)";
+export const PARTICIPLE =
+  "(?:[a-z]{3,}ed|(?:re|un|pre|over)?(?:built|made|kept|done|written|shown|sent|held|drawn|given|taken|chosen|driven|known|sold|told|paid|found|brought|bought|taught|grown|seen|spent|laid|hidden|tied))";
+// Words that end a noun phrase: a determiner means verb plus object, an auxiliary means the verb is there.
+export const NOUN_PHRASE_STOP =
+  "(?!(?:the|a|an|your|our|their|its|my|his|her|this|that|it|them|me|us|you|anything|everything|something|nothing|is|are|was|were|be|been|being|has|have|had|can|will|would|should|may|might|must|do|does|did|get|gets|got|not|never|to)\\b)";
+// Past tenses that take a preposition without being passive: "the team worked on".
+export const INTRANSITIVE_PAST =
+  "(?!(?:started|worked|moved|happened|stayed|waited|lived|failed|talked|looked|ended|lasted|belonged|listened|responded|reacted|agreed|arrived|returned|walked|travelled|traveled|asked|applied|voted|replied|opted|relied|depended|focused|pointed|referred)\\b)";
+export const PREPOSITION =
+  "(?:around|for|by|with|into|from|in|on|to|at|over|under|through|across|inside|onto|per|behind|beside|without|before|after|until|as)";
+export const FINITE_AUXILIARY =
+  "(?:is|are|was|were|has|have|had|can|will|would|should|must|may|might|does|do|did|gets|get)";
+export const CLAUSE_SUBJECT = `(?:(?:[Tt]he|[Yy]our|[Oo]ur|[Tt]heir|[Ee]ach|[Ee]very)[ \\t]+[a-z][\\w'’-]*|${SUBJECT_STOP}[A-Z][\\w&'’-]*)`;
+export const PRESENT_VERB =
+  "(?!(?:is|was|has|does|this|its|his|us|yes|plus|less|thus|across|always|perhaps|as|towards)\\b)[a-z]{2,}s";
+export const OBJECT_DETERMINER = "(?:the|a|an|your|its|their|our|his|her|every|each|all|it|them)";
+
+export const PARTICIPLE_LIST =
+  "(?:[a-z]{3,}ed|built|made|kept|done|written|shown|sent|held|drawn|given|taken|chosen|driven|known|sold|told|paid|found|brought|bought|taught|grown|seen|spent|laid|hidden)";
+
+// A quantity, written either way. Thousands take a comma, because "3,556 videos"
+// is how the measured claims in the video skills are written.
+export const COUNT =
+  "(?:\\d{1,3}(?:,\\d{3})+|\\d+|one|two|three|four|five|six|seven|eight|nine|ten|eleven|twelve)";
+// Time units, for `bare-duration-clause`. Closed on purpose: every one of these
+// is a noun in every reading, which is what makes a missing verb decidable.
+export const DURATION =
+  "(?:sec|secs|second|seconds|min|mins|minute|minutes|hour|hours|day|days|week|weeks|month|months|year|years)";
+// A word that cannot carry a real second clause: no auxiliary, and no pronoun
+// that would supply the subject ("15 minutes, it takes time" is a sentence).
+export const TAIL_WORD =
+  "(?!(?:is|are|was|were|be|been|being|has|have|had|can|will|would|should|may|might|must|does|do|did|gets|get|i|it|we|you|they|he|she|there|this|that)(?![\\w'’-]))[a-zà-ÿ][\\w'’-]*";
+/**
+ * Where a sentence starts, for the patterns that judge a whole clause.
+ */
+
+/*
+ * A bare `\n` is deliberately not in it.
+ */
+
+/*
+ * Markdown prose here is hard-wrapped, so every line start looks sentence-initial and a clause anchored on `\n` reads the middle of a paragraph as its beginning:
+ */
+
+/*
+ * it put 4 false hits on shipped skills before the paragraph anchor replaced it, all of them mid-sentence ("the next video without the algorithm's help").
+ */
+
+/*
+ * A blank line is a real paragraph start, and `.!?:;` plus a space is a real sentence start.
+ */
+export const SENTENCE_OPEN = "(?:^|(?<=[.!?:;][\"'’”)\\]]?\\**[ \\t])|(?<=\\n\\n)|(?<=\\n\\n[ \\t]))";

package/data/slop/patterns/appositives-and-sayings.js

@@ -0,0 +1,81 @@
+/** Patterns for appositive headings and clauses, sayings that sound deep and narration about a previous version. */
+export const patternsAppositivesAndSayings = [
+  {
+    id: "appositive-heading",
+    name: "The X, participled",
+    // Anti-voice 13, the half that is decidable.
+
+    // The shape is a determiner-led noun phrase, a comma, and a participle or a relative pronoun, with the whole thing being a heading: no main verb ever arrives.
+
+    // The determiner is the entire tell, and it is what a first attempt on 6 Sep 2026 missed: bare `<noun phrase>, <participle>` matched 25 lines across the UpSys corpus and
+
+    // almost all were legitimate feature labels ("Your tools, connected", "Automations, switched on", "Price per user, per month, billed yearly").
+
+    // A label drops the article; a comment on a thing already named keeps it.
+
+    // Re-measured with the article required: 6 of 6 known instances of the shape, 0 false hits on 24,366 copy units.
+
+    // Noun phrase widened to 8 words, 8 Sep 2026: at 4 it missed the shipped slide "The same 5 containers for every client, nested 3 deep".
+
+    // Anchored to a quote, a backtick or a markdown heading on the left and to a quote or a line end on the right,
+
+    // so it only fires on a whole string.
+
+    // That is what keeps an ordinary mid-sentence appositive out ("The report, published in 2024, showed a 40% gap"): the sentence runs on past a full stop the character class refuses.
+
+    // The line end refuses a lowercase continuation, added 6 Sep 2026 after a hard-wrapped source string ("...that doc moves run\n\t\t\t\ton.") read as a heading.
+
+    // A wrapped sentence resumes in lowercase; a heading's body does not. English only.
+
+    // French uses the definite article for a generic plural, so "Les automatisations, activées" is the legitimate label "Automations, switched on" and the tell does not survive translation.
+    test: /(?:^|["'`]|#{1,6}[ \t])[ \t]*(?:the|a|an)\s+(?:[\w-]+\s+){0,7}[\w-]+,\s+(?:[a-z]+(?:ed|ing)|(?:re|un|over|pre)?(?:built|run|made|done|kept|held|sold|told|given|taken|written|drawn|shown|set|put|sent|spent|left|lost|found|chosen|driven|known|paid|read|met|won|cut|bought|brought|caught|taught|thought)|which|who|that|where|when)\b[^.!?\n"'`<>]{0,70}(?=[ \t]*(?:["'`]|$(?![\r\n][ \t]*[a-z])))/im,
+    rule: "A heading built as a thing, a comma and a comment on that thing, with no verb anywhere. It reads as a caption rather than as a claim, and the half after the comma grades the half before it instead of saying what happens. Write the sentence: name the subject and give it a verb.",
+    example:
+      '"The architecture, decided before it is built" / "The build, run against your real delivery" / "The adoption, which is the part that fails"',
+  },
+
+  {
+    id: "appositive-as-clause",
+    name: "The X, as we found it",
+    // `appositive-fragment`'s `as` half: noun phrase, comma, `as`, pronoun, verb, no main verb
+    // ("The cut, as it stands"). 17 Sep 2026: 11 hits in 30,898 files, 0 false.
+    test: /(?:^|["'`]|#{1,6}[ \t])[ \t]*(?:the|a|an|your|our|their|his|her|its|my)\s+(?:[\w-]+\s+){0,7}[\w-]+,\s+as\s+(?:we|you|they|it|i|he|she)\s+[\w-]+[^.!?\n"'`<>]{0,70}(?=[ \t]*(?:["'`]|$(?![\r\n][ \t]*[a-z])))/im,
+    rule: "A thing, a comma, and an `as` clause that only says when it was seen. No main verb arrives, so it reads as a museum caption rather than a claim, and on a page written to somebody it also drops them into the third person. Write the sentence: say who did what.",
+    example:
+      '"Your website, as we found it" / "The cut, as it stands" / "The entitlement, as it now stands"',
+  },
+
+  // --- blader/humanizer 3.0.0 catch-up, 21 Sep 2026. Four shapes its rebuilt
+  // list names that no phrase can hold. ---
+  {
+    id: "deep-saying",
+    test: /\b(?:is|are)\s+the\s+(?:language|currency|architecture|grammar|oxygen)\s+of\b|\bbecomes\s+a\s+trap\b/i,
+    name: "Saying that sounds deep",
+    rule: "An ordinary point dressed as a hidden truth. Replace the aphorism with the specific claim it stands in for.",
+    example:
+      '"Symmetry is the language of trust." / "Efficiency becomes a trap when teams forget the human layer."',
+  },
+  {
+    id: "clipped-negative-tail",
+    test: /,\s+no\s+(?:guessing|guesswork|fluff|fuss|surprises|hassle|jargon|ceremony|bloat|nonsense|hype|gimmicks)\b/i,
+    name: "Clipped negative tail",
+    rule: "A comma and a `no X` that denies something nobody claimed, so the sentence sounds larger. State what the thing does.",
+    example:
+      '"The options come from the selected item, no guessing." / "Setup takes ten minutes, no fluff."',
+  },
+  {
+    id: "dotted-emphasis",
+    test: /\b(?:every|each)\.\s+(?:single|one)\b/i,
+    name: "Periods between the words",
+    rule: "Emphasis by full stop after every word. Write the sentence and let the fact carry the weight.",
+    example: '"Every. single. day." / "Each. one. matters."',
+  },
+  {
+    id: "previous-version-narration",
+    test: /\b(?:was|were)\s+(?:added|introduced|created)\s+to\s+replace\b|\breplaces?\s+the\s+(?:previous|old|former|earlier|original)\s+(?:approach|version|implementation|behaviou?r|way)\b/i,
+    name: "Writing about the previous version",
+    rule: "Docs and comments describe what the text replaced instead of the current behavior. Say what it does now; the history lives in the changelog and git.",
+    example:
+      '"This function was added to replace the previous approach of iterating all items." / "It replaces the old implementation."',
+  },
+];

package/data/slop/patterns/comma-clauses.js

@@ -0,0 +1,106 @@
+/** Patterns where a comma hangs a clause, participle or aside on the sentence. */
+export const patternsCommaClauses = [
+  {
+    id: "comma-and-opener",
+    // Anchored to the start of the text, a sentence or a paragraph, and limited to ONE word before the comma, so a mid-sentence clause ("he said yes,
+
+    // and then left") and a real adverbial pair ("On Monday, and only then, we ship") cannot reach it.
+
+    // The word is letters only, so a date or a number opener does not match.
+
+    // Not per line: a hard-wrapped Oxford list breaks before "integrators, and autonomous agents" and failed the CBAM about page, 15 Sep 2026.
+    test: /(?:^|(?<=[.!?]\s)|(?<=\n\n)|(?<=\n\n[ \t]))[ \t]*[A-Za-z]{2,12},\s+(?:and|but)\b/,
+    name: "Comma-and opener",
+    rule: "A sentence that spends its first word on a verdict, then hinges on a comma plus and or but before it says anything. The opener carries nothing the next clause does not, and the hinge is where a model hedges before answering. Ramzi, 14 Sep 2026, on a shipped Reddit comment. Delete the opener and start on the answer.",
+    example:
+      '"Yes, and the honest answer is that a full reconcile is not available." / "No, but the reason matters more than the number." / "Honestly, and this is the part nobody says, it never worked."',
+  },
+  {
+    id: "comma-and-title",
+    name: "The rest of the site, and what each part is for",
+    // A LINE with no sentence punctuation in it, hinged on a comma plus `and` and a wh-word.
+
+    // The line shape is what makes it decidable: a heading, a card label or a copy-module value, never a comma mid-sentence in prose,
+
+    // which ends on a stop and cannot reach the line anchor. The trailing `["'`]?[,;]?` is the source view, where a value ends on `",`.
+
+    // The wh-word takes a space and a clause after it, so an Oxford list of bare wh-words ("What you do, where, and when") is a list and stays one.
+    test: /^[ \t]*(?:#{1,6}[ \t]+|[-*+][ \t]+|\*\*)?[A-Z][^.!?\n]{2,70},[ \t]+(?:and|or)[ \t]+(?:what|where|why|how|who|when|which|whether)[ \t][^.!?\n]{2,70}?["'`]?[,;]?[ \t]*$/m,
+    rule: 'A title that names a thing, then bolts a wh-clause on with a comma and `and`. The second half promises an explanation the page was going to give anyway, and the shape says the writer could not choose which half was the subject. Ramzi, 17 Sep 2026, on "The rest of the site, and what each part is for": the sloper should have caught it. Cut to the half that carries the page: "The rest of the site".',
+    example:
+      '"The rest of the site, and what each part is for" / "## Mail, and where every secret lives" / "The queue, and how a job gets claimed"',
+  },
+  {
+    id: "comma-hung-participle",
+    // The decidable half of `comma-hung-fragment`: a LINE that ends on a comma plus one participle.
+
+    // Any `-ed` word, not a closed list: the list missed "resolved" and shipped it to the CBAM footer, 15 Sep 2026.
+
+    // Per line, and the whole line is the fragment, so the shape is a headline, a card label or a slide band and never a comma mid-sentence in prose.
+
+    // `[ \t]` and not `\s`, so a hard-wrapped paragraph cannot hand the anchor the next line.
+    test: /^[ \t]*(?:#{1,6}[ \t]+)?[A-Z0-9][^.!?\n]{2,60},[ \t]*(?:[a-zà-ÿ]{3,}ed|back|done|gone|built)[ \t]*[.!?]?[ \t]*$/m,
+    name: "Comma-hung participle",
+    rule: "A noun, a comma, and a past participle standing in for a sentence. Write the sentence: say who does it and what happens.",
+    example:
+      '"Sales tax report, filed" / "The week, planned" / "4 to 5 hours a week, back" / "EU carbon border data, resolved."',
+  },
+  {
+    id: "comma-hung-phrase",
+    // Per LINE, like `comma-hung-participle`: a label or headline whose second
+    // half is a stock verbless tail, or a mirrored "one X, one Y".
+    test: /^[ \t]*(?:#{1,6}[ \t]+|[-*+][ \t]+|[\w$]+:[ \t]*["'`])?(?:[A-Za-z][^.!?\n,]{1,50},[ \t]+(?:end to end|start to finish|top to bottom|front to back|beginning to end|step by step|in one place|at a glance|all in one)|(?:[Oo]ne|[Nn]o|[Ee]very|[Ee]ach)[ \t]+[\w'’-]+,[ \t]+(?:one|no|every|each)[ \t]+[\w'’-]+)[ \t]*[.!]?["'`]?[,;]?[ \t]*$/m,
+    name: "Comma-hung phrase",
+    rule: 'A name, a comma, then a stock tail with no verb ("end to end", "in one place"), or a mirrored "one X, one Y". It reads as a slogan and says nothing a sentence would not. Ramzi, 28 Sep 2026, on "Editor OS, end to end". Write the sentence, or cut to the name.',
+    example: '"Editor OS, end to end" / "one camera, one go" / "No setup, no code"',
+  },
+  {
+    id: "guided-tour-promise",
+    // A relative clause restating a thing's obvious job as hand-holding.
+
+    // The verb set is closed and always takes "you" plus a direction word, so ordinary English does not reach it: "it takes you 3 minutes" has no direction word,
+
+    // and "the wiki that covers one page per space" has no second person.
+    test: /\b(?:that|which)\s+(?:walks?|takes?|guides?|shows?)\s+you\s+(?:through|step by step|exactly)\b/i,
+    name: "Guided-tour promise",
+    rule: "A thing named, then a relative clause that restates its obvious job as hand-holding, usually with a totality claim bolted on. Say what the thing covers and let the reader work out that reading it helps.",
+    example:
+      '"A wiki that walks you through every piece." / "A guide that takes you step by step through everything you need." / "A dashboard that shows you exactly where you stand."',
+  },
+  {
+    id: "vague-attribution",
+    // An unnamed authority as the subject of a reporting verb.
+
+    // A named source does not match, because the subject has to be the bare category word: "The Gartner report says 40%" and "Researchers and conservationists study the river" both read
+
+    // clean.
+    test: /\b(?:experts?|observers?|analysts?|critics?|researchers?|industry reports?|studies|sources)\s+(?:say|says|argue|argues|believe|believes|note|notes|suggest|suggests|have cited|show|shows)\b/i,
+    name: "Vague attribution",
+    rule: "An unnamed authority standing in for evidence. Name the source or drop the claim.",
+    example:
+      '"Experts believe it plays a crucial role." / "Industry reports say the market doubled."',
+  },
+  {
+    id: "wasted-time-confession",
+    // Simple past plus a duration. The present perfect that the rule explicitly
+    // allows, "I have spent 10 years inside project tools", cannot match,
+    // because `spent` there is preceded by `have`.
+    test: /\bi\s+(?:spent|wasted|burned|lost)\s+(?:a|an|\d+|one|two|three|six)\s+(?:year|years|month|months|week|weeks|day|days)\b/i,
+    name: "Wasted-time confession",
+    rule: 'Simple past plus a duration plus the writer\'s own past foolishness, used as a credential or a closer: "I spent a year ...". The reader is asked to trade attention for a stranger\'s regret. Time served that built competence is a different sentence and is fine ("I have spent 10 years inside project tools"): present perfect, and the years bought something.',
+    example: '"I spent a year following up on people who were still inside their terms."',
+  },
+  {
+    id: "advisory-aside",
+    // The announcement, not the advice. Closed set of openers, each one a fixed phrase nobody writes by accident.
+
+    // "one thing I'd/I'll/I would" added 14 Sep 2026, Ramzi: "this sentence is pure AI slop 'One thing I'd revisit'" — the same self-assigned-critique announcement as "one thing worth",
+
+    // one pronoun over.
+    test: /\b(?:one thing worth|a quick note before|worth flagging|one last thing that|a small tip before|one thing (?:i'd|i'll|i would|i will))\b/i,
+    name: "Advisory aside",
+    rule: "The writer awarding themselves a bonus tip and announcing it before giving it. The announcement is pure throat-clearing and it grades the advice on the reader's behalf. State the thing.",
+    example:
+      '"One thing worth checking once: your own payment terms." / "Worth flagging: the Edge key expires."',
+  },
+];

package/data/slop/patterns/diagram-and-script-tells.js

@@ -0,0 +1,71 @@
+/** Patterns read off a diagram caption and a script about spotting slop. */
+export const patternsDiagramAndScriptTells = [
+  // --- Next 4: Ramzi, 28 Sep 2026, on the "Editor OS" diagram: "This is AI slop." Every line he
+  // pointed at passed this gate with no hit. ---
+  {
+    id: "not-because-pivot",
+    name: "Not because X. Because Y.",
+    // `negation-pivot` with the reason swapped in for the thing, but decidable: a sentence opening
+    // on "Not because" never opens anything else. The comma form is the same swap.
+    test: /(?:^|[.!?]["'’”)\]]?\s+|\n)(?:#{1,6}[ \t]+)?(?:(?:it|that)(?:'s|’s|\s+is|\s+was)\s+)?not\s+because\b[^.!?\n]{2,120}(?:[.!?]\s+|,\s+|\n)(?:(?:it|that)(?:'s|’s|\s+is|\s+was)\s+)?because\b/i,
+    rule: "A wrong reason set up so the right one can knock it down. The reader never held the wrong reason, so the first sentence is there for the drama. Give the real reason as a plain sentence.",
+    example:
+      '"Not because the editing got faster. Because the editing stopped being a decision." / "It\'s not because the tool is slow, it\'s because nobody owns it."',
+  },
+  {
+    id: "comma-then-slogan",
+    name: "Do X, then Y",
+    // 2 bare verb phrases hung on ", then", no subject, alone on a line, 7 words max: on the UpSys
+    // corpus, 28 Sep 2026, every longer hit was UI copy.
+    view: "prose",
+    test: /^[ \t]*(?=(?:[^\s\n]+[ \t]+){1,6}[^\s\n]+[ \t]*$)[\p{L}][^.!?\n,]{0,40},\s+then\s+[^.!?\n,]{2,40}[.!]?[ \t]*$/imu,
+    rule: 'Two orders on one line with a comma and a `then` between them. It reads like a product promise on a box and says nothing about what happens. Say who does what: "You install the layouts once. Every video after that starts at the record button."',
+    example:
+      '"Set up once, then press record" / "Record, then hand it over" / "Brief it once, then walk away."',
+  },
+  {
+    id: "in-out-pair",
+    name: "X goes in. Y comes out.",
+    test: /\b(?:goes|go|went|comes|come|came)\s+in\b[^.!?\n]{0,20}[.!?]\s+[^.!?\n]{2,60}\b(?:comes|come|came|goes|go|went)\s+out\b/i,
+    rule: "A machine drawn as a pipe with two ends. It skips everything the reader wanted to know, which is what happens in the middle. Name the steps, or the one step that matters.",
+    example:
+      '"A raw take goes in. A cut, dressed video comes out." / "Your notes go in. A finished deck comes out."',
+  },
+  {
+    id: "zero-tail",
+    name: "X, zero Y",
+    // Verbless: noun phrase, comma, `zero` and a noun phrase, or "No X, no Y". A bare `, no` tail
+    // only hit status labels ("Parked, no slot yet"), 28 Sep.
+    view: "prose",
+    test: /^[ \t]*(?:[^.!?\n,]{3,40},\s+zero|no\s+[^.!?\n,]{2,40},\s+no)\s+[\p{L}][^.!?\n,]{1,30}[.!]?[ \t]*$/imu,
+    rule: "A thing and a missing thing, joined by a comma, with no verb. It's a tagline, and the tag is always a cost the reader never mentioned. Write the sentence: \"The edit took under an hour and I didn't choose a single layout.\"",
+    example:
+      '"An hour of editing, zero decisions" / "No brand, no named pieces" / "Two clicks, zero setup"',
+  },
+  // The next 3 are Ramzi's, 2 Oct 2026, on a CutKit script about spotting AI slop that scored 94 and passed this gate with zero findings.
+  {
+    id: "once-twice-law",
+    name: "Once is craft. Twice is a tell.",
+    test: /\b(?:once|one\s+time|a\s+single\s+time)\s+(?:is|=)\s+(?:an?\s+)?[\w-]+(?:\s+[\w-]+)?[.,;]\s*(?:twice|two\s+times|again)\s+(?:is|=)\s+(?:an?\s+)?[\w-]+|\b(?:appears?|happens?|shows?\s+up)\s+once\s+(?:is|are)\s+[^.!?]{2,25},?\s+(?:while|but|and)\s+[^.!?]{2,40}\b(?:repeats?|twice|again)\b[^.!?]{0,20}\b(?:is|are)\b/i,
+    rule: 'A two-beat law: "once is X, twice is Y". It sounds like a rule and is a slogan, because the reader can\'t check it and it stands in for the sentence that would say what to look for. Say the thing: what repeats, how often, and what you do about it.',
+    example:
+      '"Once is craft. Twice is a tell." / "A shape that appears once is craft, while a shape that repeats is a tell"',
+  },
+  {
+    id: "while-antithesis",
+    name: "Real writing jumps, while raw AI stays flat",
+    view: "prose",
+    test: /[^.!?\n]{8,80},\s+while\s+(?:a|an|the|raw|real|good|bad|plain|your)\s+[^.!?\n,]{2,60}\s+(?:is|are|stays?|runs?|ships?|sits?|reads?|hides?|repeats?)\b/i,
+    rule: 'A comma, "while", and the mirror clause. The sentence exists to set two things side by side, and the contrast does the work a fact should. One per script is a style. Several is the shape of a model. Split it into two sentences and give each its own evidence, or drop the half that only mirrors the other.',
+    example:
+      '"Real writing jumps from 3 words to 40, while raw AI stays flat." / "Accuse a good writer and you lose them, while the real slop ships."',
+  },
+  {
+    id: "youd-think-setup",
+    name: "You'd think finding one word is proof",
+    test: /\byou(?:'|’)?d\s+(?:think|assume|expect)\b|\byou\s+(?:might|may|would)\s+(?:think|assume|expect)\b/i,
+    rule: 'A strawman handed to the reader so the next clause can correct it: "you\'d think X, but Y". It sets a belief up only to knock it over and attributes it to the viewer. State what is true, then the evidence. When a real belief needs breaking, name who holds it ("most agencies check for...").',
+    example:
+      '"You\'d think finding one word is proof, but a shape that appears once is craft." / "You might think it needs a rewrite"',
+  },
+];

package/data/slop/patterns/dropped-elements.js

@@ -0,0 +1,149 @@
+import { FINITE_AUXILIARY, COUNT, SENTENCE_OPEN } from "#lint/data/slop/pattern-parts.js";
+
+/** Patterns where the sentence drops the element a reader would check. */
+export const patternsDroppedElements = [
+  {
+    id: "interrogative-heading",
+    name: "What the answer is built on",
+    // A whole line opening on an interrogative and ending on a verb, with no question mark: the heading asks the section's own question instead of naming what is in it.
+
+    // Distinct from `question-heading`, which needs the `?`.
+
+    // The trailing lookahead drops a hard-wrapped paragraph whose next line continues in lower case, and a line that ends in `.` is a sentence,
+
+    // not a heading, so it never reaches the anchor.
+    test: /^[ \t]*(?:#{1,6}[ \t]+)?(?:\d+ • )?(?:What|How|Where|Which|Why|When|Who)[ \t]+(?:[A-Za-zà-ÿ0-9][\w'’-]*[ \t]+){1,9}[a-zà-ÿ0-9][\w'’-]*[ \t]*$(?!\n[ \t]*[a-zà-ÿ])/m,
+    rule: 'A heading that restates the section as a question the reader did not ask, then leaves the answer to the body. Ramzi, 15 Sep 2026, on the CBAM calculator page, and 23 Sep 2026 on a Skool lesson card titled "What you take away from lesson 4". Name what the section holds.',
+    example: '"What the answer is built on" / "What Annex I covers" / "How the dataset is built"',
+  },
+  {
+    id: "positioned-noun-heading",
+    name: "The X beside the Y",
+    // A whole line made of two noun phrases and a position word, with no verb.
+
+    // Per line and anchored both ends, like `the-x-that-y-headline`, so the same words inside a sentence ("the rule beside the field is cited") are untouched.
+    test: /^[ \t]*(?:#{1,6}[ \t]+)?The[ \t]+[a-zà-ÿ-]+[ \t]+(?:beside|behind|beneath|below|above|under|over|inside|within|alongside|around|between|next[ \t]+to|across[ \t]+from|in[ \t]+front[ \t]+of|on[ \t]+top[ \t]+of)[ \t]+(?:the|its|your|each)[ \t]+[a-zà-ÿ-]+[ \t]*[.!?]?[ \t]*$/m,
+    rule: "A card title that places one noun next to another and stops, with no verb and nothing asserted. Ramzi, 15 Sep 2026, on the CBAM home cards. Say what the thing does where it sits.",
+    example: '"The rule beside the field" / "The source behind each number"',
+  },
+  {
+    id: "the-x-follows",
+    name: "When X changes, the Y follows",
+    // A "when" clause, a comma, then the product as the subject of a bare reaction verb that ends the sentence.
+
+    // The verb must close the sentence, so "the API follows the weekly price" or "and the API follows it" passes.
+    test: /\bwhen[ \t]+[^,.!?\n]{2,50},[ \t]*(?:the|our|your)[ \t]+[\w'’-]+[ \t]+(?:follows|adapts|keeps[ \t]+up|keeps[ \t]+pace|responds|moves[ \t]+with[ \t]+it)[ \t]*[.!]/i,
+    rule: 'A headline that casts a regulator as an actor and the product as its shadow, which reads as a slogan and never says what the product is. Ramzi, 16 Sep 2026, on the CBAM home headline: "too pompous". Name the category: what it is and what it is for.',
+    example:
+      '"When Brussels changes CBAM, the API follows." / "When the market moves, our data keeps up."',
+  },
+  // --- 17 Sep 2026. Three shapes named off one cold sales email, which opened "42 skills across seven folders" about a repo holding 26.
+
+  // One fault under all three: the sentence drops the element that would let a reader check it.
+
+  // The count has no verb, so nobody counted; the promise names the drawback and not the mechanism; the benefit names the reader's absence and not the work.
+
+  // Ramzi the same day, setting how they had to be written: "think about the heuristic of the grammar so that the rule is strong enough",
+
+  // "understand the first principles of the grammatical choice to fix the root cause".
+  {
+    id: "bare-count-clause",
+    name: "N things across M things",
+    /**
+     * Two counts, a distributive preposition, and no verb: a measurement parked where the predicate belongs.
+     */
+
+    /*
+     * The preposition set is closed to the three that can ONLY distribute.
+     */
+
+    /*
+     * `over` and `in` were measured and dropped: "159 comments and over 7,000 likes" and "28 emails over 10 days" are a comparative and a duration, and neither is this shape.
+     */
+
+    /*
+     * The clause has to CLOSE on a comma, a stop or "and", which is what leaves a verb out: "627 transcripts across 13 channels put the winner ahead" has a
+     */
+
+    /*
+     * predicate and passes.
+     */
+
+    /*
+     * 7 hits across 190 posts and 1,458 files, every one of them the shape.
+     */
+    test: new RegExp(
+      `(?:^|[.!?:;]["'’”)\\]]?\\**[ \\t]+|\\n)[ \\t]*\\**${COUNT}[ \\t]+(?:[a-zà-ÿ-]+[ \\t]+){0,2}[a-zà-ÿ]{3,}[ \\t]+(?:across|spanning|throughout)[ \\t]+${COUNT}[ \\t]+(?:[a-zà-ÿ-]+[ \\t]+){0,2}[a-zà-ÿ]{3,}\\**(?=[,.;!?]|[ \\t]+and[ \\t]|[ \\t]*\\n|[ \\t]*$)`,
+    ),
+    rule: 'A count, a second count, and no verb between them. Breadth stands in for the claim, and because nobody is said to have counted anything the number is never checked: the email that named this wrote "42 skills across seven folders" about a repo that shipped 26 in 6. Give the count a doer and a verb, and the reader can test it: "I counted 270 frames on ten channels", "the pack holds 86 face plates in 26 expressions".',
+    example:
+      '"42 skills across seven folders." / "30 agents across nine business areas." / "270 frames across ten channels, each split into two bands."',
+  },
+  {
+    id: "promise-minus-drawback",
+    name: "X without the Y",
+    /**
+     * A noun phrase, a privative `without`, and still no verb. The hair-dye frame: "colour without the ammonia".
+     */
+
+    /*
+     * Three things keep it off ordinary English, and each was measured.
+     */
+
+    /*
+     * The head noun cannot end in `s`, `d` or `ing`, so a finite verb in that slot fails ("The build runs without the dev server").
+     */
+
+    /*
+     * No auxiliary may sit in the filler, so a copula fails ("The output is right without the correction").
+     */
+
+    /*
+     * And the `without` phrase has to end the clause, so a predicate after it fails ("A feature tour without the claim line is a screen recording").
+     */
+
+    /*
+     * 0 hits across 190 posts and 1,458 files.
+     */
+    test: new RegExp(
+      `${SENTENCE_OPEN}\\**(?:[Aa]ll[ \\t]+the|[Tt]he|[Aa]|[Aa]n|[Yy]our|[Oo]ur|[Ee]very)[ \\t]+(?:(?!without[ \\t])(?!${FINITE_AUXILIARY}[ \\t])[a-zà-ÿ-]+[ \\t]+){0,3}[a-zà-ÿ]{2,}(?<![sd])(?<!ing)[ \\t]+without[ \\t]+(?:the|a|an|any)[ \\t]+(?:[a-zà-ÿ-]+[ \\t]+){0,2}[a-zà-ÿ-]{3,}\\**[ \\t]*(?=[,.;!?]|[ \\t]*\\n|$)`,
+    ),
+    rule: "A thing offered, then the drawback it does not have, and nothing about how. It is the negation pivot sold as a benefit: the reader learns what is absent, never what is present, and a competitor's weakness carries the sentence instead of the product. Say what it does. If the missing drawback is the point, name the mechanism that removes it.",
+    example:
+      '"A hair colour change without the ammonia." / "All the power without the complexity." / "The reach of an agency without the retainer."',
+  },
+  {
+    id: "absentee-benefit",
+    name: "While you sleep",
+    /**
+     * The work described as happening in the reader's absence, which is the value the sentence offers instead of a mechanism.
+     */
+
+    /*
+     * Second person is required throughout, because the state words are ordinary on their own: Ramzi's own 2023 post, "90% is on autopilot until I start the client project",
+     */
+
+    /*
+     * is a bounded fact about a system and is spared.
+     */
+
+    /*
+     * "so you do not have to" needs the clause to END there, for the same reason: the ellipsis IS the fault, and naming the work makes the sentence informative ("so
+     */
+
+    /*
+     * you do not have to open it").
+     */
+    test: new RegExp(
+      `\\bwhile[ \\t]+you(?:[ \\t]+(?:are|'re|’re))?[ \\t]+(?:sleep\\w*|asleep|rest\\w*|relax\\w*|away|off|out|do[ \\t]+nothing|focus[ \\t]+on|get[ \\t]+on[ \\t]+with)\\b` +
+        `|\\bin[ \\t]+your[ \\t]+sleep\\b` +
+        `|\\b(?:you|your)\\b[^.!?\\n]{0,60}\\bon[ \\t]+autopilot\\b|\\bon[ \\t]+autopilot\\b[^.!?\\n]{0,60}\\b(?:you|your)\\b` +
+        `|\\bset[ \\t]+it[ \\t]+and[ \\t]+forget[ \\t]+it\\b` +
+        `|\\bso[ \\t]+you[ \\t]+(?:do[ \\t]*not|don'?t|never|no[ \\t]+longer)[ \\t]+have[ \\t]+to[ \\t]*(?=[.!?,;]|[ \\t]*$)`,
+      "i",
+    ),
+    rule: 'The benefit stated as the reader\'s absence. It says when the work happens and never what does it, so the sentence cannot be wrong and cannot be checked, and it carries the passive-income register every ad in the category uses. Ramzi, 17 Sep 2026, on "A calendar takes them while you sleep": the subject is an abstraction and "while you" is slop. Name what runs and what it does: "the booking page writes the event to your calendar".',
+    example:
+      '"A calendar takes them while you sleep." / "It books the call while you focus on the work." / "Your pipeline runs on autopilot." / "The agent files them so you do not have to."',
+  },
+];