chaffjs 0.20.0 → 0.21.0

package/dist/structure/cross-definitions.d.ts

@@ -0,0 +1,23 @@
+import { type Vote } from "../cross-votes.ts";
+/** A definition as a file writes it: the term, what follows it up to the end of the sentence, and where it is. */
+export type WrittenDefinition = {
+    readonly term: string;
+    readonly body: string;
+    readonly offset: number;
+};
+export type FileDefinitions = {
+    readonly path: string;
+    readonly definitions: readonly WrittenDefinition[];
+};
+/** A file that defines a term unlike most files that define it, and one file of the usual wording. */
+export type DefinitionOutOfStep = {
+    readonly path: string;
+    readonly definition: WrittenDefinition;
+    readonly usual: Vote<WrittenDefinition>;
+    readonly files: number;
+};
+/** The wording compared: width, spaces and the punctuation at the ends evened out. */
+export declare const definitionKey: (body: string) => string;
+/** The files that define a term in other words than most files of the run that define it. */
+export declare const definitionsOutOfStep: (files: readonly FileDefinitions[]) => DefinitionOutOfStep[];
+//# sourceMappingURL=cross-definitions.d.ts.map

package/dist/structure/cross-definitions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cross-definitions.d.ts","sourceRoot":"","sources":["../../src/structure/cross-definitions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,KAAK,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAI1D,kHAAkH;AAClH,MAAM,MAAM,iBAAiB,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAE1G,MAAM,MAAM,eAAe,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,WAAW,EAAE,SAAS,iBAAiB,EAAE,CAAA;CAAE,CAAC;AAE5G,sGAAsG;AACtG,MAAM,MAAM,mBAAmB,GAAG;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,iBAAiB,CAAC;IACvC,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC,iBAAiB,CAAC,CAAC;IACxC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB,CAAC;AAkBF,sFAAsF;AACtF,eAAO,MAAM,aAAa,GAAI,MAAM,MAAM,KAAG,MAGlC,CAAC;AAUZ,6FAA6F;AAC7F,eAAO,MAAM,oBAAoB,GAAI,OAAO,SAAS,eAAe,EAAE,KAAG,mBAAmB,EAW3F,CAAC"}

package/dist/structure/cross-definitions.js

@@ -0,0 +1,34 @@
+import { tallyVotes } from "../cross-votes.js";
+/** Marks that do not change what a definition says: the punctuation at its two ends. Spaces are evened out apart. */
+const LEADING = new Set(["、", "，", ",", ":", "："]);
+const TRAILING = new Set(["。", "．", "."]);
+const SPACE = /\s+/gu;
+const SPACE_CHAR = /\s/u;
+/** The text without spaces and the marks of a set at its start, or at its end. */
+const trimStartOf = (text, marks) => {
+    const first = text.split("").findIndex((char) => !marks.has(char) && !SPACE_CHAR.test(char));
+    return first === -1 ? "" : text.slice(first);
+};
+const trimEndOf = (text, marks) => text.slice(0, text.split("").findLastIndex((char) => !marks.has(char) && !SPACE_CHAR.test(char)) + 1);
+/** The wording compared: width, spaces and the punctuation at the ends evened out. */
+export const definitionKey = (body) => trimEndOf(trimStartOf(body.normalize("NFKC"), LEADING), TRAILING)
+    .replace(SPACE, " ")
+    .trim();
+/** A file's vote for a term: its first definition of it (a second one in the same file is duplicate-definition's). */
+const voteOf = (file, term) => {
+    const first = file.definitions.find((definition) => definition.term === term && definitionKey(definition.body) !== "");
+    return first === undefined ? [] : [{ path: file.path, value: first }];
+};
+const sameWording = (left, right) => definitionKey(left.body) === definitionKey(right.body);
+/** The files that define a term in other words than most files of the run that define it. */
+export const definitionsOutOfStep = (files) => {
+    const terms = [...new Set(files.flatMap((file) => file.definitions.map((definition) => definition.term)))];
+    return terms.flatMap((term) => {
+        const tally = tallyVotes(files.flatMap((file) => voteOf(file, term)), sameWording);
+        const [usual] = tally?.usual ?? [];
+        if (tally === undefined || usual === undefined)
+            return [];
+        return tally.odd.map((vote) => ({ path: vote.path, definition: vote.value, usual, files: tally.usual.length }));
+    });
+};
+//# sourceMappingURL=cross-definitions.js.map

package/dist/structure/cross-definitions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cross-definitions.js","sourceRoot":"","sources":["../../src/structure/cross-definitions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAa,MAAM,mBAAmB,CAAC;AAiB1D,qHAAqH;AACrH,MAAM,OAAO,GAAwB,IAAI,GAAG,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;AACxE,MAAM,QAAQ,GAAwB,IAAI,GAAG,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;AAC/D,MAAM,KAAK,GAAG,OAAO,CAAC;AAEtB,MAAM,UAAU,GAAG,KAAK,CAAC;AAEzB,kFAAkF;AAClF,MAAM,WAAW,GAAG,CAAC,IAAY,EAAE,KAA0B,EAAU,EAAE;IACvE,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAC7F,OAAO,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;AAC/C,CAAC,CAAC;AAEF,MAAM,SAAS,GAAG,CAAC,IAAY,EAAE,KAA0B,EAAU,EAAE,CACrE,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,aAAa,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;AAExG,sFAAsF;AACtF,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,IAAY,EAAU,EAAE,CACpD,SAAS,CAAC,WAAW,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,EAAE,QAAQ,CAAC;KAC9D,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC;KACnB,IAAI,EAAE,CAAC;AAEZ,sHAAsH;AACtH,MAAM,MAAM,GAAG,CAAC,IAAqB,EAAE,IAAY,EAA6B,EAAE;IAChF,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,KAAK,IAAI,IAAI,aAAa,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;IACvH,OAAO,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;AACxE,CAAC,CAAC;AAEF,MAAM,WAAW,GAAG,CAAC,IAAuB,EAAE,KAAwB,EAAW,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AAE3I,6FAA6F;AAC7F,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,KAAiC,EAAyB,EAAE;IAC/F,MAAM,KAAK,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3G,OAAO,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;QAC5B,MAAM,KAAK,GAAG,UAAU,CACtB,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,EAC3C,WAAW,CACZ,CAAC;QACF,MAAM,CAAC,KAAK,CAAC,GAAG,KAAK,EAAE,KAAK,IAAI,EAAE,CAAC;QACnC,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,SAAS;YAAE,OAAO,EAAE,CAAC;QAC1D,OAAO,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IAClH,CAAC,CAAC,CAAC;AACL,CAAC,CAAC"}

package/genres.yaml

@@ -1,9 +1,12 @@
 # The genres chaff knows, in the order `chaff genres` lists them.
 #
 # A genre is a preset: pick the kind of document and chaff checks it the way that kind is written.
-#   rules:   the level a rule runs at for this genre (strict / normal / relaxed / off), under chaff.yaml's rules.
+#   rules:   the level a rule runs at for this genre (strict / normal / relaxed), under chaff.yaml's rules.
 #            A group's rules apply to every genre in it; a genre's own rules win over its group's.
-#            A rule turned off here is listed under "did not run" with the genre as the reason.
+#            A rule a group or genre turns off says so in its own file (off_for, with why), not here; chaff reads it
+#            as an off in that group's or genre's rules. It is listed under "did not run" with the genre as the reason.
+#            An off_for entry "<group>: measured by yarn rules:measure" is written by `yarn rules:measure --apply`: the
+#            rule reports on most human documents of the group (chaff-spec.md §21.1). Edit the measurement, not these.
 #   profile: the document profile (profiles/*.yaml) this genre reads with, when chaff.yaml names none.
 #   suggest: when no genre is set, what makes a file look like this genre, strongest first:
 #            paths (the file's path), then per language an opening (the body's first line, past front matter and
@@ -23,266 +26,19 @@ groups:
   # (shall be deemed), and joins long noun compounds (個人情報取扱事業者). Those rules would only flag the form.
   - id: legal
     name: { ja: 法務, en: Legal }
-    rules:
-      agentless-passive: off
-      max-kanji-continuous: off
-      no-doubled-joshi: off
-      ngram-repetition: off
-      repeated-sentence-head: off
-      heading-echo: off
-      taigen-dome-in-prose: off
-      unqualified-superlative: off
-      excessive-hedging: off
-      proper-noun-density: off
-      expletive-construction: off
-      adverb-overuse: off
-      concrete-evidence-density: off
-      closing-cliche: off
-      padded-intro: off
-      preamble-length: off
-      cushion-phrase-density: off
-      sasete-itadaku: off
-      sentence-rhythm: off
-      rule-of-three: off
-      section-length-uniformity: off
-      paragraph-length-variance: off
-      ai-tell: off
-      ai-generated-composite: off
-      contrast-framing: off
-      stock-transition: off
-      announcing-opener: off
-      colon-lead-in: off
-      emoji-heading: off
-      bold-label-list: off
-      # A clause, a definition or a claim is a paragraph of one sentence by form.
-      one-sentence-paragraph-run: off
-      ai-structure: off
-      # Statutes and opinions write "not inconsistent with" on purpose.
-      double-negative: off
-      # Drafting writes "in the event that" and "for the purpose of" on purpose.
-      wordy-phrase: off
-      weasel-word: off
-      sentence-initial-so: off
-      # Legal drafting writes 「…を行う」 and "make a payment" as its register; the corpus statutes are full of them.
-      nominalization: off
-      # すなわち and that is, open a definition that restates on purpose.
-      paragraph-restatement: off
-      # A statute or contract opens with its first article, and its titles are formal names.
-      no-lead: off
-      title-length: off
-      # Drafting writes a number twice on purpose: thirty (30) days.
-      number-style-consistency: off
-      # An enumeration of conditions mixes 〜こと and 〜とき by what each condition is.
-      list-item-form-mix: off
-      # A paper's citations, figures and abstract: only the academic paper genre turns these on.
-      citation-style-mix: off
-      citation-reference-mismatch: off
-      figure-reference-order: off
-      abstract-length: off
   # A help page repeats its heading in its first line (To upload a file, ...) and states no claims to back up.
   - id: docs
     name: { ja: 説明書, en: Documentation }
-    rules:
-      heading-echo: off
-      agentless-passive: off
-      concrete-evidence-density: off
-      preamble-length: off
-      proper-noun-density: off
-      unqualified-superlative: off
-      expletive-construction: off
-      adverb-overuse: off
-      cushion-phrase-density: off
-      double-keigo: off
-      sasete-itadaku: off
-      sentence-initial-conjunction-run: off
-      closing-cliche: off
-      padded-intro: off
-      sentence-rhythm: off
-      rule-of-three: off
-      section-length-uniformity: off
-      paragraph-length-variance: off
-      ai-tell: off
-      ai-generated-composite: off
-      contrast-framing: off
-      stock-transition: off
-      announcing-opener: off
-      colon-lead-in: off
-      emoji-heading: off
-      bold-label-list: off
-      ai-structure: off
-      # A paper's citations, figures and abstract: only the academic paper genre turns these on.
-      citation-style-mix: off
-      citation-reference-mismatch: off
-      figure-reference-order: off
-      abstract-length: off
   # Science writes in the passive, hedges its claims on purpose (may, suggest) and cites numbers as its evidence.
   - id: academic
     name: { ja: 学術, en: Academic }
-    rules:
-      agentless-passive: off
-      excessive-hedging: off
-      expletive-construction: off
-      concrete-evidence-density: off
-      proper-noun-density: off
-      adverb-overuse: off
-      closing-cliche: off
-      padded-intro: off
-      preamble-length: off
-      cushion-phrase-density: off
-      sasete-itadaku: off
-      double-keigo: off
-      sentence-rhythm: off
-      rule-of-three: off
-      section-length-uniformity: off
-      paragraph-length-variance: off
-      stock-transition: off
-      emoji-heading: off
-      bold-label-list: off
-      ai-structure: off
-      requirement-smell: off
   # Length, rhythm, repetition and register are the author's choices in literature, and dialogue mixes styles.
   # Only what one work can hold itself to runs: consistent spacing and commas, and numbering without gaps.
   - id: literature
     name: { ja: 文学, en: Literature }
-    rules:
-      # A character who says "never" and later makes an exception is the story, not a drafting slip.
-      absolute-exception: off
-      # A story's narrator and its characters each say 私 or 僕 in their own voice.
-      person-consistency: off
-      max-sentence-length: off
-      max-paragraph-length: off
-      ngram-repetition: off
-      repeated-sentence-head: off
-      heading-echo: off
-      empty-intensifier: off
-      no-doubled-joshi: off
-      no-nakaguro-parallel: off
-      taigen-dome-in-prose: off
-      max-kanji-continuous: off
-      hiragana-fukushi: off
-      no-mixed-desumasu: off
-      contraction-consistency: off
-      doubled-word: off
-      agreement-slip: off
-      agentless-passive: off
-      expletive-construction: off
-      excessive-hedging: off
-      unqualified-superlative: off
-      adverb-overuse: off
-      sentence-initial-conjunction-run: off
-      repeated-conjunction: off
-      undefined-acronym: off
-      proper-noun-density: off
-      concrete-evidence-density: off
-      closing-cliche: off
-      padded-intro: off
-      preamble-length: off
-      cushion-phrase-density: off
-      sasete-itadaku: off
-      double-keigo: off
-      no-em-dash: off
-      emoji-density: off
-      elapsed-years-mismatch: off
-      fact-conflict: off
-      summary-fact-mismatch: off
-      sentence-rhythm: off
-      rule-of-three: off
-      section-length-uniformity: off
-      paragraph-length-variance: off
-      ai-tell: off
-      ai-generated-composite: off
-      contrast-framing: off
-      stock-transition: off
-      announcing-opener: off
-      colon-lead-in: off
-      emoji-heading: off
-      bold-label-list: off
-      nominalization: off
-      dangling-reference: off
-      duplicate-definition: off
-      date-order: off
-      date-weekday-mismatch: off
-      total-mismatch: off
-      announced-count-mismatch: off
-      dangling-figure-reference: off
-      date-range-reversed: off
-      percent-sum-mismatch: off
-      vague-figure-reference: off
-      # A narrator may hedge, speak with ら dropped, and spell as the work's time and place did.
-      double-negative: off
-      ra-nuki: off
-      spelling-consistency: off
-      orthographic-variant: off
-      translationese-density: off
-      unknown-word: off
-      redundant-expression: off
-      requirement-smell: off
-      # Dialogue may misuse an idiom on purpose, to draw the speaker.
-      idiom-misuse: off
-      paragraph-restatement: off
-      # A story or poem chooses its own opening and its own title.
-      no-lead: off
-      title-length: off
-      # A narrator spells out numbers in dialogue and writes figures in a date.
-      number-style-consistency: off
-      list-item-form-mix: off
-      # Dialogue and verse set each line apart.
-      one-sentence-paragraph-run: off
-      # Dialect and old usage ("an hospital") are the work's voice, and dialogue leans on "very".
-      article-sound: off
-      very-adjective: off
-      # A paper's citations, figures and abstract: only the academic paper genre turns these on.
-      citation-style-mix: off
-      citation-reference-mismatch: off
-      figure-reference-order: off
-      abstract-length: off
-      # A narrator and a character speak as they speak: dialect ("would of"), "So," and hearsay are the voice.
-      homophone-slip: off
-      wordy-phrase: off
-      weasel-word: off
-      sentence-initial-so: off
   # A speech opens with greetings and closes with thanks: that is its form, not padding.
   - id: speech
     name: { ja: 話し言葉, en: Speech }
-    rules:
-      agentless-passive: off
-      preamble-length: off
-      padded-intro: off
-      closing-cliche: off
-      concrete-evidence-density: off
-      proper-noun-density: off
-      sentence-rhythm: off
-      rule-of-three: off
-      section-length-uniformity: off
-      paragraph-length-variance: off
-      contrast-framing: off
-      stock-transition: off
-      announcing-opener: off
-      colon-lead-in: off
-      ai-structure: off
-      # A transcript keeps the speaker's words: hedges and ら dropped as spoken.
-      double-negative: off
-      ra-nuki: off
-      requirement-smell: off
-      article-sound: off
-      very-adjective: off
-      homophone-slip: off
-      wordy-phrase: off
-      weasel-word: off
-      sentence-initial-so: off
-      # A speaker says it again so the room hears it: 要するに, in other words.
-      paragraph-restatement: off
-      # An address or a transcript is titled by occasion (第221回国会における…演説) and opens as spoken.
-      no-lead: off
-      title-length: off
-      # Spoken numbers are transcribed as heard.
-      number-style-consistency: off
-      list-item-form-mix: off
-      # A paper's citations, figures and abstract: only the academic paper genre turns these on.
-      citation-style-mix: off
-      citation-reference-mismatch: off
-      figure-reference-order: off
-      abstract-length: off
 
 genres:
   - id: technical/spec
@@ -335,23 +91,11 @@ genres:
     summary:
       ja: プレスリリースと、お知らせ
       en: Press releases and public notices
-    # A release names the agency, the people quoted, the mission and the place: that is its news, not a crowd of
-    # names to thin out. Every English release in the corpus (GSA, NASA, NOAA) is over the limit.
-    rules:
-      proper-noun-density: off
   - id: business/meeting-notes
     name: { ja: 議事録, en: Meeting notes }
     summary:
       ja: 議事録・議事要旨
       en: Minutes and meeting notes
-    # Minutes record what the meeting did (the meeting was held, 了承された): the actor is the meeting, by the form.
-    # In the corpus the rule fires on nearly every set of minutes, English and Japanese.
-    # A header block of labelled fields (- **日時**：…, - **出席者**：…) is the form of minutes, not a list of captions.
-    rules:
-      # Minutes jot points down as they come: a noun, a remark, a decision, side by side.
-      list-item-form-mix: off
-      agentless-passive: off
-      bold-label-list: off
   - id: legal/contract
     name: { ja: 契約書・規約, en: Contract and terms }
     summary:
@@ -374,6 +118,9 @@ genres:
       total-mismatch: normal
       dangling-figure-reference: normal
       date-range-reversed: normal
+      # A contract names each party and term once and uses that name: a term quoted again or a party written out in full is a slip.
+      defined-term-form: normal
+      defined-name-repeated: normal
   - id: legal/statute
     name: { ja: 法令・規程, en: Statute and regulation }
     summary:
@@ -395,8 +142,6 @@ genres:
       total-mismatch: normal
       dangling-figure-reference: normal
       date-range-reversed: normal
-      # A statute defines its 等 terms (以下「個人情報等」という) and uses them in its obligations.
-      requirement-smell: off
   - id: legal/judgment
     name: { ja: 判決, en: Court decision }
     summary:
@@ -405,9 +150,6 @@ genres:
     suggest:
       ja: { line: "^(?:#{1,6}\\s*)?(?:主\\s*文|理\\s*由|判\\s*決)\\s*$", min_lines: 2 }
       en: { line: "delivered the opinion of the Court|^(?:Reversed|Affirmed)\\.?$", min_lines: 1 }
-    # requirement-smell is for the documents that state requirements: specifications, contracts and documentation.
-    rules:
-      requirement-smell: off
   - id: legal/patent
     name: { ja: 特許明細書, en: Patent }
     summary:
@@ -416,9 +158,6 @@ genres:
     suggest:
       ja: { line: "【(?:課題|解決手段|請求項[0-9０-９]+|選択図|技術分野|背景技術|発明の詳細な説明|特許請求の範囲)】", min_lines: 2 }
       en: { line: "^#{1,6}\\s*(?:BACKGROUND OF THE INVENTION|SUMMARY OF THE INVENTION|Claims\\b)|\\bof claim \\d+", min_lines: 3 }
-    # requirement-smell is for the documents that state requirements: specifications, contracts and documentation.
-    rules:
-      requirement-smell: off
   - id: docs/manual
     name: { ja: マニュアル・手順書, en: Manual and how-to }
     summary:
@@ -427,6 +166,12 @@ genres:
     # Path only: step and procedure headings are as common in tech blogs and specifications as in manuals.
     suggest:
       paths: ["(^|/)(manuals?|guides?|how-?tos?|help|tutorials?|user-?guides?)(/|[-_.])"]
+    # A manual is followed command by command: its code blocks, prompts, command headings and steps are what the reader acts on.
+    rules:
+      code-fence-language-mix: normal
+      shell-prompt-mix: normal
+      heading-command-missing: normal
+      step-statement-mix: normal
   - id: docs/faq
     name: { ja: よくある質問, en: FAQ }
     summary:
@@ -436,9 +181,6 @@ genres:
       paths: ["(^|[/_-])(faqs?|q-?and-?a)([/_.-]|$)"]
       ja: { line: "^(?:#{1,6}\\s*)?(?:[QＱ][0-9０-９]*[.．:：、\\s　]|問[0-9０-９]+[.．:：\\s　])|^#{1,6}\\s*(?:よくある(?:ご)?質問|Ｑ＆Ａ|Q&A)", min_lines: 2 }
       en: { line: "^(?:#{1,6}\\s*)?Q[0-9]*[.:)]\\s|^#{1,6}\\s*(?:FAQs?|Frequently asked questions)\\b", min_lines: 2 }
-    # A question is the heading: its length is the reader's question, not a name to shorten.
-    rules:
-      title-length: off
   - id: docs/glossary
     name: { ja: 用語集, en: Glossary }
     summary:
@@ -448,13 +190,6 @@ genres:
       paths: ["(^|/)(glossary|glossaries|yogo|用語集)(/|[-_.])"]
       ja: { line: "^#{1,6}\\s*用語集", min_lines: 1 }
       en: { line: "^#{1,6}\\s*Glossary\\b", min_lines: 1 }
-    # A reader looks up one entry and reads only that. A definition is a noun phrase (風の吹いてくる方向。), and sibling
-    # entries share one wording on purpose (Portion of labor productivity change attributed to …), which no reader sees twice.
-    rules:
-      taigen-dome-in-prose: off
-      ngram-repetition: off
-      # An entry that ends 〜すること or 〜のこと defines a word; it is no requirement.
-      requirement-smell: off
   - id: academic/paper
     name: { ja: 論文, en: Academic paper }
     summary:
@@ -529,37 +264,3 @@ genres:
       paths: ["(^|/)(transcripts?|kaigiroku)(/|[-_.])"]
       ja: { line: "^○[^　\\s]{1,30}　|^（(?:問|答)）|^【(?:記者|大臣|質問|回答)】", min_lines: 3 }
       en: { line: "^(?:Mr|Ms|Mrs|Dr)\\. [A-Z][A-Z-]{2,}(?: of [A-Z][a-z]+)?\\. ", min_lines: 3 }
-    # A transcript records what was said: its sentences, repeats and register are the speaker's, not the writer's to fix.
-    rules:
-      # Several people speak, each naming themselves their own way.
-      person-consistency: off
-      max-sentence-length: off
-      max-paragraph-length: off
-      ngram-repetition: off
-      repeated-sentence-head: off
-      heading-echo: off
-      empty-intensifier: off
-      no-doubled-joshi: off
-      no-nakaguro-parallel: off
-      taigen-dome-in-prose: off
-      max-kanji-continuous: off
-      hiragana-fukushi: off
-      no-mixed-desumasu: off
-      contraction-consistency: off
-      doubled-word: off
-      agreement-slip: off
-      sasete-itadaku: off
-      double-keigo: off
-      # Labelled speaker turns (- **記者**：…) are how a transcript is laid out.
-      bold-label-list: off
-      cushion-phrase-density: off
-      excessive-hedging: off
-      unqualified-superlative: off
-      expletive-construction: off
-      adverb-overuse: off
-      sentence-initial-conjunction-run: off
-      repeated-conjunction: off
-      undefined-acronym: off
-      ai-tell: off
-      ai-generated-composite: off
-      assistant-residue: off

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "chaffjs",
-  "version": "0.20.0",
+  "version": "0.21.0",
   "description": "Prose validation harness. Finds what is hard to read, and never rewrites it for you.",
   "keywords": [
     "chaff",
@@ -66,8 +66,8 @@
   },
   "dependencies": {
     "@anthropic-ai/sdk": "^0.125.0",
-    "@chaffjs/lang-en": "0.18.0",
-    "@chaffjs/lang-ja": "0.19.0",
+    "@chaffjs/lang-en": "0.19.0",
+    "@chaffjs/lang-ja": "0.20.0",
     "mdast-util-from-markdown": "^2.0.3",
     "mdast-util-frontmatter": "^2.0.1",
     "mdast-util-gfm-table": "^2.0.0",

package/rules/absolute-exception.yaml

@@ -1,6 +1,6 @@
 id: absolute-exception
 layer: L3
-status: experimental
+status: stable
 how_to_find: absolute-exception
 word_list: absolute-word
 extra_word_lists: [exception-marker, light-verb]
@@ -37,6 +37,8 @@ placeholders:
 levels: { strict: error, normal: warning, relaxed: info }
 
 use_for: [business, technical, blog, legal, docs, academic, literature, speech]
+off_for:
+  literature: 'A character who says "never" and later makes an exception is the story, not a drafting slip.'
 
 group: structure
 summary:

package/rules/abstract-length.yaml

@@ -1,6 +1,6 @@
 id: abstract-length
 layer: L3
-status: experimental
+status: stable
 how_to_find: abstract-length
 severity: info
 
@@ -36,6 +36,11 @@ levels:
   en: { strict: 250, normal: 400, relaxed: 500 }
 
 use_for: [academic, legal, docs, literature, speech]
+off_for:
+  legal: "A paper's citations, figures and abstract: only the academic paper genre turns these on."
+  docs: "A paper's citations, figures and abstract: only the academic paper genre turns these on."
+  literature: "A paper's citations, figures and abstract: only the academic paper genre turns these on."
+  speech: "A paper's citations, figures and abstract: only the academic paper genre turns these on."
 
 group: structure
 summary:
@@ -102,6 +107,7 @@ level_meaning:
   ja: 要旨 {limit} 字まで
   en: up to {limit} words in the abstract
 rewrite:
+  depth: structure
   ja:
     direction: 要旨を、目的・方法・結果・結論をそれぞれ一、二文で言う形に縮めてください。背景の説明や先行研究の紹介は本文に移します。数字は、結論を支える一つか二つだけを残します。要旨が無ければ、本文から目的・方法・結果・結論を抜き出して要旨を書きます。
     pairs:

package/rules/acronym-expansion-conflict.yaml

@@ -1,6 +1,6 @@
 id: acronym-expansion-conflict
 layer: L3
-status: experimental
+status: stable
 how_to_find: acronym-expansion-conflict
 severity: warning
 
@@ -58,6 +58,7 @@ not_flagged:
   ja: 名前の大文字小文字、ハイフン、終わりの複数の s の違いは同じ名前と見ます。英語の名前は、頭文字が略語と揃うときだけ展開と読みます。
   en: Differences of case, hyphens and a final plural s are not counted. An English name counts as an expansion only when its initials spell the abbreviation.
 rewrite:
+  depth: light
   ja:
     direction: 二つの展開のうち正しいほうを書き手に確かめ、もう一方を消すか正しい名前に替えてください。二度目以降は略語だけで書けます。
     pairs:

package/rules/adverb-overuse.yaml

@@ -1,6 +1,6 @@
 id: adverb-overuse
 layer: L3
-status: experimental
+status: stable
 how_to_find: adverb-density
 requires: [pos]
 languages: [en]
@@ -26,6 +26,12 @@ how_to_fix:
 levels: { strict: 10, normal: 15, relaxed: 25 }
 
 use_for: [blog, business, legal, docs, academic, literature, speech]
+off_for:
+  legal: "Legal drafting repeats its terms and its sentence heads on purpose, puts the actor in the passive (shall be deemed), and joins long noun compounds (個人情報取扱事業者). This rule would only flag the form."
+  docs: "A help page repeats its heading in its first line (To upload a file, ...) and states no claims to back up."
+  academic: "Science writes in the passive, hedges its claims on purpose (may, suggest) and cites numbers as its evidence."
+  literature: "Length, rhythm, repetition and register are the author's choices in literature, and dialogue mixes styles. Only what one work can hold itself to runs: consistent spacing and commas, and numbering without gaps."
+  speech/transcript: "A transcript records what was said: its sentences, repeats and register are the speaker's, not the writer's to fix."
 
 group: readability
 summary:

package/rules/adverb-without-negation.yaml

@@ -0,0 +1,60 @@
+id: adverb-without-negation
+layer: L3
+status: stable
+how_to_find: adverb-polarity
+word_list: negative-polarity-adverb
+extra_word_lists: [negation-word]
+requires: [pos]
+languages: [ja]
+severity: info
+
+name:
+  ja: 打ち消しを伴わない「全然」「決して」
+  en: 全然 or 決して with no negation
+
+why:
+  ja: 「全然」「決して」「到底」は、書き言葉では「全然足りない」「決して許されない」のように打ち消しと組む副詞です。「全然大丈夫です」のように打ち消し無しで使うのは話し言葉で、報告書や案内では砕けて読まれます。文の後ろに打ち消しの語（ない、ません、ず、違う、不〜、無〜）が一つも無いときだけ指します。
+  en: In written Japanese, adverbs such as 全然 and 決して pair with a negation (全然足りない, "not at all enough"). Without one (全然大丈夫です, "totally fine") they are spoken usage and read as casual in a report or a notice. chaff reports one only when no negating word (ない, ません, ず, 違う, a 不 or 無 prefix) follows it in the sentence.
+
+message:
+  ja: 「{word}」の後に打ち消しがありません
+  en: '"{word}" has no negation after it'
+
+how_to_fix:
+  ja: 打ち消しを伴わないなら、別の副詞に替えてください（全然大丈夫です → まったく問題ありません、十分に間に合います）。
+  en: Without a negation, use another adverb (全然大丈夫です → まったく問題ありません).
+
+levels: { strict: warning, normal: info, relaxed: info }
+
+use_for: [business, technical, legal, docs, academic, literature, speech]
+off_for:
+  literature: "Spoken 全然大丈夫, なので and より in a character's voice; classical verse has a たり that does not list."
+  speech: "Spoken Japanese says 全然大丈夫, opens with なので and greets with より参りました."
+
+group: wording
+summary:
+  ja: 「全然大丈夫です」のように、打ち消しと組む副詞を打ち消し無しで使った所
+  en: A Japanese adverb that pairs with a negation (全然, 決して) used without one
+example:
+  ja:
+    before: |
+      納期は全然大丈夫です。
+    after: |
+      納期には十分に間に合います。
+
+not_flagged:
+  ja: 後ろに打ち消しの語（ない、ません、ず、まい、違う、異なる、駄目）か、不・未・無・非で始まる語（不十分、無理）があれば指しません。「まったく」は「まったく同じ」が正しいので見ません。ブログ、文芸、話し言葉のジャンルでは動きません。
+  en: Not reported when a negating word (ない, ません, ず, 違う, 駄目) or a word opening with 不, 未, 無 or 非 follows. まったく is not checked, since まったく同じ is correct. Off for blogs, literature and speech.
+rewrite:
+  depth: light
+  ja:
+    direction: 打ち消しの無い「全然」「決して」を、肯定と組む言い方に替えてください。打ち消しを言いたかったのなら、打ち消しの形にします。
+    pairs:
+      - before: 納期は全然大丈夫です。
+        after: 納期には十分に間に合います。
+      - before: 新しい手順は全然簡単です。
+        after: 新しい手順はとても簡単です。
+    keep:
+      - 文が言っている判断の向き（問題が無い、簡単だ）
+    avoid:
+      - 打ち消しを足して文の意味を逆にする

package/rules/adversative-ga-repeat.yaml

@@ -1,6 +1,6 @@
 id: adversative-ga-repeat
 layer: L3
-status: experimental
+status: stable
 how_to_find: sentence-conjunctive-count
 word_list: adversative-particle
 requires: [pos]
@@ -45,6 +45,7 @@ level_meaning:
   ja: 一文の逆接の「が」{limit} 個まで
   en: up to {limit} contrastive が in a sentence
 rewrite:
+  depth: light
   ja:
     direction: 一つ目の逆接の「が」の所で文を切ってください。次の文の頭に、前との関係を言う語（しかし、ただし）を置けます。
     pairs: