chaffjs 0.19.0 → 0.21.0

package/rules/colloquial-opener.yaml

@@ -0,0 +1,62 @@
+id: colloquial-opener
+layer: L2
+status: stable
+how_to_find: opener-pile
+word_list: colloquial-opener
+requires: [pos]
+languages: [ja]
+severity: info
+
+name:
+  ja: 文頭の話し言葉の接続詞
+  en: A spoken conjunction opening a sentence
+
+why:
+  ja: 文の頭の「なので」「でも」「だけど」は話し言葉の接続詞です。報告書や案内の中にあると、そこだけ口調が砕けて聞こえます。書き言葉には同じ働きの語（そのため、したがって、しかし）があります。文の途中の「〜なので」は普通の書き方なので見ません。
+  en: In Japanese, なので, でも and だけど at the head of a sentence are spoken conjunctions. In a report or a notice they make that sentence sound casual. Written Japanese has words that do the same job (そのため, しかし). なので inside a sentence is ordinary and not checked.
+
+message:
+  ja: 「{matched}」で始まる文が {count} 個あります（{limit} 個から）
+  en: '{count} {count|sentence opens|sentences open} with "{matched}" ({limit} needed)'
+
+how_to_fix:
+  ja: 書き言葉の接続詞に替えてください（なので → そのため、でも → しかし）。
+  en: Use the written conjunction (なので → そのため, でも → しかし).
+
+levels: { strict: 1, normal: 1, relaxed: 2 }
+
+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 sentence opening with a spoken conjunction (なので, でも)
+example:
+  ja:
+    before: |
+      在庫が足りません。なので、出荷は来週になります。
+    after: |
+      在庫が足りません。そのため、出荷は来週になります。
+
+not_flagged:
+  ja: 文の途中の「〜なので」「〜でも」と、書き言葉の接続詞（そのため、しかし、したがって）は指しません。ブログ、文芸、話し言葉のジャンルでは動きません。
+  en: なので and でも inside a sentence, and written conjunctions (そのため, しかし), are not reported. Off for blogs, literature and speech.
+level_meaning:
+  ja: 話し言葉の接続詞で始まる文が {limit} 個あれば指摘
+  en: reported from {limit} sentences opening with a spoken conjunction
+rewrite:
+  depth: light
+  ja:
+    direction: 文頭の話し言葉の接続詞を、同じ働きの書き言葉に替えてください（なので → そのため、でも → しかし、だけど → しかし）。
+    pairs:
+      - before: 在庫が足りません。なので、出荷は来週になります。
+        after: 在庫が足りません。そのため、出荷は来週になります。
+      - before: 費用は増えます。でも、作業は半分になります。
+        after: 費用は増えます。しかし、作業は半分になります。
+    keep:
+      - 前の文とのつながりの向き（理由、逆接）
+    avoid:
+      - 接続詞を消して、つながりの向きを読み手に推させる

package/rules/colon-lead-in.yaml

@@ -1,6 +1,6 @@
 id: colon-lead-in
 layer: L1
-status: experimental
+status: stable
 how_to_find: colon-lead-in
 # English human writing hands off to a list after a colon as a matter of course: two in a short self-written English
 # document already passed any limit that the generated-style samples reached. Japanese only until a limit separates them.
@@ -26,7 +26,12 @@ how_to_fix:
 # 1000 字あたりの数。2 つより少なければ言わない（ai-phrasing.ts の PILE）。
 levels: { strict: 1, normal: 2, relaxed: 4 }
 
-use_for: [blog, business, legal, docs, academic, literature, speech]
+use_for: [technical/readme, 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."
+  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: "A speech opens with greetings and closes with thanks: that is its form, not padding."
 
 group: ai-tells
 summary:
@@ -52,12 +57,13 @@ example:
       - 地図
 
 not_flagged:
-  ja: 1 つだけのコロンの前置きと、コロンで終わらない前置き（「次のとおりとする。」）は数えません。説明書・法務・技術文書のジャンルでは見ません。短い文書は測りません。英語の文書は、人もよくこの形で書くので見ません。日本語の文書の中の英文（Examples include:）も数えません。
-  en: A single colon lead-in, and a lead-in that does not end in a colon, are not counted. Documentation, legal and technical genres do not run this rule. Short documents are not measured. Japanese documents only, and in them only Japanese sentences; an English sentence inside (Examples include:) is not counted.
+  ja: 1 つだけのコロンの前置きと、コロンで終わらない前置き（「次のとおりとする。」）は数えません。説明書・法務・仕様書（technical/spec）のジャンルでは見ません。短い文書は測りません。英語の文書は、人もよくこの形で書くので見ません。日本語の文書の中の英文（Examples include:）も数えません。
+  en: A single colon lead-in, and a lead-in that does not end in a colon, are not counted. Documentation, legal and specification (technical/spec) genres do not run this rule. Short documents are not measured. Japanese documents only, and in them only Japanese sentences; an English sentence inside (Examples include:) is not counted.
 level_meaning:
   ja: コロンで箇条書きへ渡す文が 1000 字あたり {limit} 個まで
   en: "colon lead-ins to lists: up to {limit} per 1000 characters"
 rewrite:
+  depth: structure
   ja:
     direction: コロンで箇条書きへ渡す所のうち、項目が二つか三つで互いに繋がっているものを文に戻してください。手順や部品の一覧は箇条書きのままにします。
     pairs:

package/rules/concrete-evidence-density.yaml

@@ -25,6 +25,12 @@ how_to_fix:
 levels: { strict: 1, normal: 3, relaxed: 6 }
 
 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: "A speech opens with greetings and closes with thanks: that is its form, not padding."
 
 group: structure
 summary:

package/rules/contraction-consistency.yaml

@@ -1,6 +1,6 @@
 id: contraction-consistency
 layer: L2
-status: experimental
+status: stable
 how_to_find: contraction-mix
 word_list: contraction
 languages: [en]
@@ -26,6 +26,9 @@ how_to_fix:
 levels: { strict: 4, normal: 2, relaxed: 1 }
 
 use_for: [blog, business, technical, legal, docs, academic, literature, speech]
+off_for:
+  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: consistency
 summary:

package/rules/contrast-framing.yaml

@@ -1,6 +1,6 @@
 id: contrast-framing
 layer: L2
-status: experimental
+status: stable
 how_to_find: contrast-framing
 word_list: contrast-frame
 # 打ち消し（it's not）と、それを返す語（it's、but）。後ろに返しが来たときだけ対比の枠になる。
@@ -29,7 +29,12 @@ levels:
   ja: { strict: 1, normal: 1.5, relaxed: 3 }
   en: { strict: 2, normal: 3, relaxed: 6 }
 
-use_for: [blog, business, legal, docs, academic, literature, speech]
+use_for: [technical/readme, 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."
+  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: "A speech opens with greetings and closes with thanks: that is its form, not padding."
 
 group: ai-tells
 summary:
@@ -56,6 +61,7 @@ level_meaning:
   ja: 1000 字あたり対比の枠 {limit} 個まで
   en: up to {limit} contrast frames per 1000 words
 rewrite:
+  depth: light
   ja:
     direction: 打ち消している側（X）を消し、言いたい側（Y）を普通の文で書いてください。X が誰かの実際の誤解なら、その誤解を書いたうえで一度だけ打ち消してください。
     pairs:

package/rules/cross-doc-broken-link.yaml

@@ -0,0 +1,83 @@
+id: cross-doc-broken-link
+layer: L1
+status: experimental
+how_to_find: cross-doc-broken-link
+# documents: compares the files of one run, so it runs only when chaff is given two or more files, or a folder.
+requires: [markdown, documents]
+severity: warning
+
+name:
+  ja: ほかのファイルへの行き先の無いリンク
+  en: Link to another file that goes nowhere
+
+why:
+  ja: 説明書や文書の束では、ページどうしを相対パスのリンクでつなぎます（[料金](./pricing.md#月額料金)）。ファイルの名前を変えたり見出しを書き換えたりすると、ほかのページからのリンクが行き先を失います。一つのファイルだけを見ても、行き先のファイルや見出しがあるかは分かりません。一度に渡したファイルどうしを突き合わせ、行き先のファイルが無いリンクと、行き先のファイルに無い見出しを指すリンクを指します。見出しの名前は字と数字だけで比べます。
+  en: 'A manual or a bundle of documents links its pages to each other with relative paths ("[Fees](./pricing.md#monthly-fee)"). Renaming a file or rewording a heading leaves the links from other pages with nowhere to go, and no single file shows it. The files given together are checked against each other: a link whose file is not there, and a link to a heading that file does not have, are pointed out. Heading anchors are compared on letters and digits only.'
+
+message:
+  ja: リンク「{link}」の行き先がありません
+  en: 'The link "{link}" goes nowhere'
+
+messages:
+  file:
+    ja: リンク「{link}」が指すファイル「{target}」が、一緒に見たファイルの中にありません
+    en: 'The link "{link}" points to "{target}", which is not among the files checked'
+  anchor:
+    ja: リンク「{link}」が指す「{target}」の見出しが、そのファイルにありません
+    en: 'The link "{link}" points to "{target}", but that file has no such heading'
+
+how_to_fix:
+  ja: 行き先のファイルの今の名前と、今の見出しの言葉に合わせてください。ファイルや見出しを消したなら、リンクも消すか、代わりのページを指してください。
+  en: Match the file's current name and the heading as it is now written. If the file or the heading is gone, remove the link or point it at the page that replaced it.
+
+placeholders:
+  link:
+    ja: 〇〇
+    en: the link
+  target:
+    ja: 行き先
+    en: the target
+
+levels: { strict: error, normal: warning, relaxed: info }
+
+use_for: [business, technical, blog, legal, docs, academic, literature, speech]
+
+group: structure
+summary:
+  ja: 一緒に見たほかのファイルへのリンクで、行き先のファイルか見出しが無いもの
+  en: A link to another of the files checked together whose file or heading is not there
+example:
+  ja:
+    other: |
+      # 手順
+
+      ## 準備
+
+      道具をそろえます。
+    before: |
+      # 案内
+
+      始める前に[準備](./a.md#用意)を読んでください。
+    after: |
+      # 案内
+
+      始める前に[準備](./a.md#準備)を読んでください。
+  en:
+    other: |
+      # Steps
+
+      ## Setup
+
+      Gather the tools.
+    before: |
+      # Guide
+
+      Before you start, read [Setup](./a.md#preparation).
+    after: |
+      # Guide
+
+      Before you start, read [Setup](./a.md#setup).
+
+not_flagged:
+  ja: URL、サイトの根からのパス（/guide/）、同じページの中へのリンク（broken-link が見ます）、Markdown でないファイル（画像やスクリプト）へのリンクは見ません。行き先のファイルが無くても、一緒に見たファイルのどれも置かれていないフォルダのものと、フォルダを指すリンク（./guide/）は、確かめようがないので指しません。拡張子を書かないリンク（./reference）は、.md などを補って探します。
+  en: URLs, paths from the site's root ("/guide/"), links within the same page (broken-link checks those) and links to files that are not Markdown (images, scripts) are not checked. A missing file in a folder that none of the files checked are in, and a link to a folder ("./guide/"), cannot be confirmed and are not reported. A link without an extension ("./reference") is looked up as .md and the like.

package/rules/cross-doc-duplicate-definition.yaml

@@ -0,0 +1,70 @@
+id: cross-doc-duplicate-definition
+layer: L3
+status: experimental
+how_to_find: cross-doc-duplicate-definition
+# documents: compares the files of one run, so it runs only when chaff is given two or more files, or a folder.
+requires: [structure, documents]
+# The words that make a sentence a definition (をいう, means), per language.
+extra_word_lists: [definition-statement]
+severity: warning
+
+name:
+  ja: ファイルによって違う定義
+  en: One term defined differently in different files
+
+why:
+  ja: 契約書の束や説明書では、同じ語をいくつものファイルで定義することがあります（本契約と別紙、用語集と各ページ）。後から一方だけを直すと、ファイルによって定義が食い違い、どちらの意味で読めばよいか分からなくなります。一度に渡したファイルどうしで、同じ語の定義（「『X』とは、…をいう」"X" means …）の、語の後ろの言葉を比べ、多くのファイルと違う言葉で定義したファイルを指します。全角半角、空白、両端の句読点の違いは問いません。言葉が違っても意味が同じかは機械では決まらないので、確かめる場所を示すだけです。
+  en: 'A bundle of contracts or a manual often defines the same term in several files (the agreement and its schedule, the glossary and the pages). When one is changed later and the other is not, the files disagree on what the term means. Across the files given together, the words after the term in each definition ("X" means …, 「X」とは、…をいう) are compared, and a file that defines the term in other words than most files do is pointed out. Width, spaces and the punctuation at either end do not count. Whether two wordings mean the same is not something a machine can decide, so chaff only shows where to look.'
+
+message:
+  ja: 「{term}」を、一緒に見たほかの {count} ファイルと違う言葉で定義しています（例：{example}）
+  en: '"{term}" is defined in other words than in {count} other {count|file|files} checked with it (as in {example})'
+
+how_to_fix:
+  ja: 定義を一か所（用語集や本契約）にまとめ、ほかのファイルからはそこを参照してください。意味を変えているなら、別の語にします。
+  en: Keep the definition in one place (the glossary, the main agreement) and refer to it from the other files. If the meaning is meant to differ, use a different term.
+
+placeholders:
+  term:
+    ja: 〇〇
+    en: the term
+
+levels: { strict: error, normal: warning, relaxed: info }
+
+use_for: [business, technical, blog, legal, docs, academic, literature, speech]
+
+group: structure
+summary:
+  ja: 同じ語を、ファイルによって違う言葉で定義している所
+  en: The same term defined in other words in different files
+example:
+  ja:
+    other: |
+      # 用語集
+
+      「メンバー」とは、ワークスペースに招かれた人のことです。
+    before: |
+      # はじめに
+
+      「メンバー」とは、料金を払った人のことです。
+    after: |
+      # はじめに
+
+      「メンバー」とは、ワークスペースに招かれた人のことです。
+  en:
+    other: |
+      # Glossary
+
+      "Member" means a person invited to a workspace.
+    before: |
+      # Getting started
+
+      "Member" means a person who pays the fee.
+    after: |
+      # Getting started
+
+      "Member" means a person invited to a workspace.
+
+not_flagged:
+  ja: 範囲を限った定義（「この条において『X』とは」）と、語の後ろに意味を書かない定義（「以下『X』という。」）は比べません。一つのファイルの中で二度定義した語は、最初の定義で比べます（二度目は duplicate-definition が見ます）。全角半角、空白、両端の句読点だけが違う定義は同じとみなします。
+  en: Definitions limited to a part ("In this section, X means") and those that give the meaning before the term ('(the "Vendor")') are not compared. A file that defines a term twice is compared by its first definition (duplicate-definition reports the second). Definitions that differ only in width, spaces or the punctuation at either end are taken as the same.

package/rules/cross-doc-fact-conflict.yaml

@@ -0,0 +1,64 @@
+id: cross-doc-fact-conflict
+layer: L3
+status: experimental
+how_to_find: cross-doc-fact-conflict
+# documents: compares the files of one run, so it runs only when chaff is given two or more files, or a folder.
+requires: [quantities, documents]
+uses: [pos]
+severity: warning
+
+name:
+  ja: ファイルによって違う値が書いてある項目
+  en: One item given different values in different files
+
+why:
+  ja: 説明書や文書の束では、料金・版・締切・問い合わせ先のような同じ項目を、いくつものページに書きます。値を直したときに一つのページだけ直し忘れると、ページによって値が食い違い、読み手はどれを信じればよいか分かりません。一度に渡したファイルどうしで、「項目：値」「項目は値です」と書いた所と表の升を読み、同じ項目名（全角半角、大文字小文字は揃えて比べます）に、同じ単位で違う値を書いたファイルを指します。メールアドレスと、三つ以上に区切った版（2.4.1、v3）も値として読みます。どちらが正しいかは決めず、その値を書いたファイルの少ないほうを指します。
+  en: 'A manual or a bundle of documents repeats the same items, such as a fee, a version, a deadline or a contact address, on page after page. When a value changes and one page is missed, the pages disagree and the reader cannot tell which to trust. Across the files given together, values written as "Item: value" or "The item is value", and table cells, are read; a file that gives the same item name (case and width aside) a different value in the same unit is pointed out. Email addresses and versions of three parts or more (2.4.1, v3) are read as values too. chaff does not decide which is right; it points at the value fewer files give.'
+
+message:
+  ja: 「{label}」が {value} と書かれていますが、一緒に見たほかの {count} ファイルでは {other} です（例：{example}）
+  en: '"{label}" is {value} here, but {other} in {count} other {count|file|files} checked with it (as in {example})'
+
+how_to_fix:
+  ja: どちらの値が正しいかを確かめて、違うほうを直してください。別のもの（別のプラン、別の版）の値なら、項目名にそれを書き分けてください（「プロプランの月額料金」）。
+  en: Check which value is right and correct the other. If they are values of different things (another plan, another release), say so in the item name ("Pro plan monthly fee").
+
+levels: { normal: warning, relaxed: info }
+
+use_for: [business, technical, blog, legal, docs, academic, literature, speech]
+
+group: facts
+summary:
+  ja: 同じ項目（料金、版、締切、問い合わせ先）に、ファイルによって違う値を書いた所
+  en: The same item (a fee, a version, a deadline, a contact address) given different values in different files
+example:
+  ja:
+    other: |
+      # 料金
+
+      月額料金：1,200円
+    before: |
+      # よくある質問
+
+      月額料金：1,500円
+    after: |
+      # よくある質問
+
+      月額料金：1,200円
+  en:
+    other: |
+      # Pricing
+
+      Monthly fee: $12
+    before: |
+      # Questions
+
+      Monthly fee: $15
+    after: |
+      # Questions
+
+      Monthly fee: $12
+
+not_flagged:
+  ja: 一つのファイルの中で同じ項目に二つ以上の値を書いたファイルは数えません（プランごとの料金のような一覧か、ファイルの中の食い違いで、そちらは fact-conflict が見ます）。ファイルどうしで値が三通り以上に分かれる項目も、一覧と読んで何も言いません。単位の違う値、記録の欄（同じ名前が行の頭に何度も出る欄）、値の後ろに条件が続くもの（「1,200円から」）も比べません。
+  en: A file that gives an item two or more values is not counted (it is a list, such as a fee per plan, or a conflict within the file, which fact-conflict reports). An item whose values split three or more ways across the files is read as a list and left alone. Values in different units, record fields (the same name at the start of many lines), and values followed by a condition ("$12 per seat") are not compared.

package/rules/cross-doc-term-variant.yaml

@@ -0,0 +1,73 @@
+id: cross-doc-term-variant
+layer: L3
+status: experimental
+how_to_find: cross-doc-term-variant
+# documents: compares the files of one run, so it runs only when chaff is given two or more files, or a folder.
+requires: [documents]
+# The katakana words come from the language package's split. Without parts of speech only the Latin and listed words are read.
+uses: [pos]
+severity: warning
+
+name:
+  ja: ファイルによって書き方が違う語
+  en: A word spelled differently in different files
+
+why:
+  ja: 説明書や文書の束では、一つのファイルの中ではそろっていても、ファイルどうしで書き方が分かれることがあります（あるページは「サーバ」、ほかのページは「サーバー」）。書いた人や書いた時期が違うと起きます。読み手は別のものかと迷い、サイトの検索でも片方を取りこぼします。一度に渡したファイルどうしを比べ、同じ語をファイルによって違う書き方で書いている所を指します。見る書き方は三つです。カタカナ語の語末の「ー」（サーバ／サーバー）、イギリスとアメリカの綴り（colour／color）、英字の語のハイフンの有無（e-mail／email）。どちらが正しいかは決めず、使うファイルの少ないほうを指します。
+  en: 'In a manual or a bundle of documents, each file can be consistent on its own while the files disagree with each other: one page writes "e-mail", the others "email". It happens when different people write at different times. A reader wonders whether they are different things, and a site search misses one. The files given together are compared, and a word written one way in some files and another way in the rest is pointed out. Three kinds of spelling are compared: the final ー of a katakana word (サーバ / サーバー), British and American spellings (colour / color), and a Latin word with and without a hyphen (e-mail / email). chaff does not pick a side; it points at the way fewer files use.'
+
+message:
+  ja: 「{matched}」と書いていますが、一緒に見たほかの {count} ファイルでは「{preferred}」です（例：{other}）
+  en: '"{matched}" here, but "{preferred}" in {count} other {count|file|files} checked with it (as in {other})'
+
+how_to_fix:
+  ja: 「{preferred}」に直してください。どちらに寄せるかをチームで決めているなら、chaff.yaml の prefer に書いておくと、どのファイルでも決めた書き方で見ます。
+  en: Change it to "{preferred}". If the team has decided which way, list the pair under prefer in chaff.yaml, and every file is checked against it.
+
+placeholders:
+  matched:
+    ja: 見つけた語
+    en: the word found
+  preferred:
+    ja: ほかのファイルの書き方
+    en: the other files' spelling
+
+levels: { strict: error, normal: warning, relaxed: info }
+
+use_for: [business, technical, blog, legal, docs, academic, literature, speech]
+
+group: consistency
+summary:
+  ja: 同じ語を、ファイルによって違う書き方で書いている所（サーバ／サーバー、e-mail／email）
+  en: The same word spelled one way in some files and another way in the rest (サーバ / サーバー, e-mail / email)
+example:
+  ja:
+    other: |
+      # 手順
+
+      サーバーを起動します。
+    before: |
+      # 案内
+
+      サーバに接続します。
+    after: |
+      # 案内
+
+      サーバーに接続します。
+  en:
+    other: |
+      # Steps
+
+      Send an email to the team.
+    before: |
+      # Guide
+
+      Reply to the e-mail by Friday.
+    after: |
+      # Guide
+
+      Reply to the email by Friday.
+
+not_flagged:
+  ja: 一つのファイルの中で両方の書き方を使っている語は、そのファイルを数えません（ファイルの中の揺れは katakana-long-vowel などが見ます）。違う語どうし（サーバーとブラウザ）は比べません。語末の「ー」の前が 1 音の語（カー）、辞書が固有名詞と知っている語、chaff.yaml の names に並べた名前、引用符の中の英語の綴り、文の途中で大文字で始まる英語の名前も見ません。ハイフンは、一緒に見たファイルのどれかがハイフンで書いた語だけを比べます。
+  en: A file that writes a word both ways is not counted for that word (the per-file rules, such as katakana-long-vowel, point at that). Different words are not compared (サーバー and ブラウザ). Katakana words of one mora before the final ー (カー), words the dictionary knows as proper nouns, the names under names in chaff.yaml, spellings inside quotation marks, and capitalized names in mid-sentence are left alone. For hyphens, only words that one of the files writes with a hyphen are compared.

package/rules/cushion-phrase-density.yaml

@@ -1,6 +1,6 @@
 id: cushion-phrase-density
 layer: L2
-status: experimental
+status: stable
 how_to_find: cushion-density
 word_list: cushion-phrase
 uses: [pos]
@@ -25,6 +25,12 @@ how_to_fix:
 levels: { strict: 2, normal: 5, relaxed: 10 }
 
 use_for: [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: wording
 summary:
@@ -51,6 +57,7 @@ level_meaning:
   ja: 1000 字あたりクッション言葉 {limit} 個まで
   en: up to {limit} softeners per 1000 words
 rewrite:
+  depth: light
   ja:
     direction: クッション言葉は最初の一つだけ残し、あとは用件（何を、いつまでに）から書いてください。敬語の丁寧さは変えません。
     pairs:

package/rules/dangling-figure-reference.yaml

@@ -1,6 +1,6 @@
 id: dangling-figure-reference
 layer: L3
-status: experimental
+status: stable
 how_to_find: dangling-figure
 severity: warning
 
@@ -23,6 +23,8 @@ how_to_fix:
 levels: { strict: error, normal: warning, relaxed: info }
 
 use_for: [business, technical, blog, legal, docs, academic, literature, speech]
+off_for:
+  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."
 
 group: facts
 summary:

package/rules/dangling-reference.yaml

@@ -1,6 +1,6 @@
 id: dangling-reference
 layer: L3
-status: experimental
+status: stable
 how_to_find: dangling-reference
 requires: [structure]
 severity: error
@@ -25,6 +25,8 @@ how_to_fix:
 levels: { normal: error, relaxed: warning }
 
 use_for: [business, technical, blog, legal, docs, academic, literature, speech]
+off_for:
+  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."
 sources: [jis-z8301-2019, femmer-2017]
 
 group: structure

package/rules/date-format-consistency.yaml

@@ -0,0 +1,86 @@
+id: date-format-consistency
+layer: L1
+status: stable
+how_to_find: date-format
+severity: info
+
+name:
+  ja: 日付の書き方が揃っていない
+  en: Dates written two ways
+
+why:
+  ja: 一つの文書で「2026-10-02」と「2026年10月2日」、「Oct 2, 2026」と「10/2/2026」のように日付を二通りに書くと、読み手は同じ種類の日付なのかを確かめ、10/2 が十月二日なのか二月十日なのかも迷います。書き写した所や、あとから足した所に多い揺れです。どちらの書き方が正しいかは決めず、文書の中で少ないほうを指します。年・月・日のそろった日付だけを比べます。月の名前と元号は言語ごとの語彙表にあります。
+  en: One document writing "2026-10-02" in one place and "October 2, 2026" or "10/2/2026" in another makes the reader check whether the dates are the same kind, and 10/2 may be read as October 2 or 10 February. The mix usually comes from a pasted or later-added passage. chaff does not pick a style; it points at the minority. Only dates with a year, a month and a day are compared. Month names and eras are in each language's lexicon.
+
+message:
+  ja: 日付「{written}」の書き方が、この文書のほかの日付（「{example}」など {count} 箇所）と違います
+  en: 'The date "{written}" is written differently from {count} other dates in the document (such as "{example}")'
+
+how_to_fix:
+  ja: 文書の中の日付を一つの書き方に揃えてください。
+  en: Write every date in the document the same way.
+
+placeholders:
+  written:
+    ja: 日付
+    en: the date
+  example:
+    ja: ほかの日付
+    en: another date
+  count:
+    ja: 〇
+    en: N
+
+# 少ないほうの日付が全体のこの割合（パーセント）以下なら指す。それより多ければ、二つの書き方を使い分けている文書と読む。
+levels: { strict: 49, normal: 34, relaxed: 20 }
+
+use_for: [business, technical, blog, legal, docs, academic, literature, speech]
+
+group: consistency
+summary:
+  ja: 「2026-10-02」と「2026年10月2日」のように、一つの文書で日付を二通りに書いている所
+  en: Dates written two ways in one document, such as "2026-10-02" and "October 2, 2026"
+example:
+  ja:
+    before: |
+      申込は2026年10月2日に始まり、2026年10月9日に締め切ります。結果は2026/10/16に通知します。
+    after: |
+      申込は2026年10月2日に始まり、2026年10月9日に締め切ります。結果は2026年10月16日に通知します。
+  en:
+    before: |
+      Registration opens on October 2, 2026 and closes on October 9, 2026. Results are sent on 10/16/2026.
+    after: |
+      Registration opens on October 2, 2026 and closes on October 9, 2026. Results are sent on October 16, 2026.
+
+not_flagged:
+  ja: 年だけ、月日だけの日付、URL や版の中の数（/2026/10/02/、1.2026.10）、コードの中の日付は比べません。少ないほうが全体の三分の一を超える文書は、二つの書き方を使い分けている（表は 2026-10-02、本文は 2026年10月2日）と読んで指しません。いちばん多い書き方が同じ数で並ぶときも指しません。
+  en: Year-only and month-day dates, numbers inside URLs and versions (/2026/10/02/, 1.2026.10), and dates in code are not compared. When the minority is more than a third of the dates, the document is taken to use two styles on purpose (ISO in tables, long dates in prose) and nothing is reported, nor when the two commonest styles are tied.
+level_meaning:
+  ja: 少ないほうの書き方の日付が全体の {limit}% 以下なら指摘
+  en: reported while the minority style is {limit}% of the dates or less
+rewrite:
+  depth: light
+  ja:
+    direction: 指された日付を、文書の多いほうの書き方（指摘が例に引く日付の書き方）に書き直してください。日付そのもの（年・月・日）は変えません。
+    pairs:
+      - before: 結果は2026/10/16に通知します。（ほかは「2026年10月2日」）
+        after: 結果は2026年10月16日に通知します。
+      - before: 締切は2026-10-09です。（ほかは「2026年10月2日」）
+        after: 締切は2026年10月9日です。
+    keep:
+      - 年・月・日と曜日
+      - 文の言い回し
+    avoid:
+      - 月と日の順の分からない日付（10/2/2026）を、確かめずに書き換える
+  en:
+    direction: Rewrite the flagged date in the style most of the document uses (the one the finding quotes). Keep the date itself.
+    pairs:
+      - before: Results are sent on 10/16/2026. (other dates read "October 2, 2026")
+        after: Results are sent on October 16, 2026.
+      - before: The deadline is 2026-10-09. (other dates read "October 2, 2026")
+        after: The deadline is October 9, 2026.
+    keep:
+      - the year, month, day and weekday
+      - the wording around the date
+    avoid:
+      - rewriting an ambiguous date (10/2/2026) without checking which order was meant

package/rules/date-order.yaml

@@ -1,6 +1,6 @@
 id: date-order
 layer: L3
-status: experimental
+status: stable
 how_to_find: date-order
 requires: [dates]
 severity: warning
@@ -24,6 +24,8 @@ how_to_fix:
 levels: { strict: error, normal: warning, relaxed: info }
 
 use_for: [business, technical, blog, legal, docs, academic, literature, speech]
+off_for:
+  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."
 sources: [de-marneffe-2008]
 
 group: facts

package/rules/date-range-reversed.yaml

@@ -1,6 +1,6 @@
 id: date-range-reversed
 layer: L3
-status: experimental
+status: stable
 how_to_find: date-range-reversed
 requires: [dates]
 severity: warning
@@ -24,6 +24,8 @@ how_to_fix:
 levels: { strict: error, normal: warning, relaxed: info }
 
 use_for: [business, technical, blog, legal, docs, academic, literature, speech]
+off_for:
+  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."
 
 group: facts
 summary: