chaffjs 0.14.0 → 0.16.0

package/rules/duplicate-definition.yaml

@@ -23,4 +23,4 @@ how_to_fix:
 
 levels: { strict: 1, normal: 1, relaxed: 1 }
 
-use_for: [business, technical, blog]
+use_for: [business, technical, blog, legal, docs, academic, literature, speech]

package/rules/emoji-density.yaml

@@ -23,4 +23,4 @@ how_to_fix:
 # 1000 語あたりの個数。件数で数えると長い文書ほど当たる。
 levels: { strict: 3, normal: 8, relaxed: 20 }
 
-use_for: [blog, business, technical]
+use_for: [blog, business, technical, legal, docs, academic, literature, speech]

package/rules/empty-conclusion.yaml

@@ -34,4 +34,5 @@ levels:
   normal: warning
   relaxed: info
 
-use_for: [blog]
+# メール・議事録・プレスリリースの結びは挨拶か連絡先で、判断を書く所ではない。
+use_for: [blog, business/report, business/proposal]

package/rules/empty-intensifier.yaml

@@ -27,4 +27,4 @@ levels:
   normal: 1
   relaxed: 3
 
-use_for: [blog, business, technical]
+use_for: [blog, business, technical, legal, docs, academic, literature, speech]

package/rules/excessive-hedging.yaml

@@ -1,8 +1,11 @@
 id: excessive-hedging
 layer: L2
 status: experimental
-how_to_find: hedging-density
+how_to_find: hedging
 word_list: excessive-hedging
+# 1 つの文の重なりを数えるときの、それだけでは逃げていない包む言い方（「という状況です」、may）と、
+# 逃げの表現のうちどこで成り立つかを言うもの（「場合がある」、in some cases）。
+extra_word_lists: [hedge-frame, hedge-scope]
 uses: [pos]
 severity: warning
 
@@ -11,17 +14,24 @@ name:
   en: Too much hedging
 
 why:
-  ja: 断言を避けるほど、読み手は何が決まったのか分からなくなります。1 つなら慎重さですが、重なると誰も責任を取らない文書になります。
-  en: The more the text avoids claiming, the less the reader can tell what was decided. One hedge is caution; many mean nobody is accountable.
+  ja: 断言を避けるほど、読み手は何が決まったのか分からなくなります。1 つなら慎重さですが、重なると誰も責任を取らない文書になります。chaff は 2 つの見方で探します。1 つの文に逃げを重ねたもの（「〜という状況であると考えられます」「〜かもしれないと思われます」）は、短い文書でも 1 文で指摘します。文書全体で逃げの表現が多すぎるものは、短い文書では測りません。重なりを数えるとき、鉤括弧や引用符で引いた発言の中の逃げは、話した人のものなので数えません。
+  en: The more the text avoids claiming, the less the reader can tell what was decided. One hedge is caution; many mean nobody is accountable. chaff looks two ways. A sentence that stacks hedges ("may possibly", "it could perhaps be argued") is reported on its own, even in a short document. Too many hedges across the whole document is measured only on longer documents. When counting hedges stacked in a sentence, a hedge inside a quotation is the speaker's, not the writer's, and is left out.
 
 message:
   ja: 「{matched}」など、逃げの表現が 1000 語あたり {density} 個あります（{limit} 個まで）
   en: '"{matched}" and other hedges: {density} per 1000 words (limit {limit})'
 
+# 1 つの文に重ねたもの。上の message は文書全体の密度。
+messages:
+  stacked:
+    ja: この文は逃げの表現を {count} つ重ねています（「{matched}」）
+    en: 'This sentence stacks {count} hedges ("{matched}")'
+
 how_to_fix:
-  ja: 言い切れるものは言い切ってください。言い切れないなら、何が分かれば言い切れるのかを書いてください。
-  en: Commit where you can. Where you cannot, say what you would need to know.
+  ja: 言い切れるものは言い切ってください。言い切れないなら、何が分かれば言い切れるのかを書いてください。重ねた逃げは、1 つ残すか、全部外して言い切ってください。
+  en: Commit where you can. Where you cannot, say what you would need to know. Where hedges are stacked, keep one or drop them all and commit.
 
+# 文書全体の、1000 語あたりの数の上限。1 つの文に 2 つ以上重ねたものは、どの段でも指摘する。
 levels: { strict: 3, normal: 6, relaxed: 12 }
 
-use_for: [business, blog, technical]
+use_for: [business, blog, technical, legal, docs, academic, literature, speech]

package/rules/expletive-construction.yaml

@@ -16,7 +16,7 @@ why:
 
 message:
   ja: '"{word} is ..." の形が文書内に {count} 回あります（{limit} 回まで）'
-  en: '"{word} is ..." appears {count} times (limit {limit})'
+  en: '"{word} is ..." appears {count} {count|time|times} (limit {limit})'
 
 how_to_fix:
   ja: 主語を前に出してください。"There is a need to review" を "The board must review" に。
@@ -24,4 +24,4 @@ how_to_fix:
 
 levels: { strict: 1, normal: 3, relaxed: 6 }
 
-use_for: [blog, business]
+use_for: [blog, business, legal, docs, academic, literature, speech]

package/rules/heading-echo.yaml

@@ -27,4 +27,4 @@ levels:
   normal: 60
   relaxed: 75
 
-use_for: [blog, business, technical]
+use_for: [blog, business, technical, legal, docs, academic, literature, speech]

package/rules/hiragana-fukushi.yaml

@@ -25,4 +25,4 @@ how_to_fix:
 
 levels: { strict: 1, normal: 1, relaxed: 3 }
 
-use_for: [blog, business, technical]
+use_for: [blog, business, technical, legal, docs, academic, literature, speech]

package/rules/internal-jargon.yaml

@@ -15,7 +15,7 @@ why:
 
 message:
   ja: 「{matched}」は社内でしか通じないかもしれません（そういう語が {count} 箇所）
-  en: '"{matched}" may only be understood inside your team ({count} such words)'
+  en: '"{matched}" may only be understood inside your team ({count} such {count|word|words})'
 
 how_to_fix:
   ja: 初出のところで普通の言葉に言い換えるか、括弧で説明を添えてください。jargon には辞書形（握る）でも語幹（巻き取）でも書けますが、複合動詞は語幹のほうが確実です。
@@ -24,4 +24,4 @@ how_to_fix:
 # チームが並べた語なので、1 つでも指摘する。並べた時点で「使わない」と決めている。
 levels: { strict: 1, normal: 1, relaxed: 3 }
 
-use_for: [business, blog, technical]
+use_for: [business, blog, technical, legal, docs, academic, literature, speech]

package/rules/latin-spacing.yaml

@@ -6,14 +6,17 @@ languages: [ja]
 severity: warning
 # 番号・識別子として書かれた数を見分けるのに、数の後ろの語の品詞を使う。無ければ全部数える。
 uses: [pos]
+# 番地（千代田区紀尾井町1-3）を、都道府県までの地名の後ろの範囲（東京都2-3 営業日）と分ける。
+# 日付・時刻（9月、2026年、10時5分）を、長さ（3ヶ月、3 時間）と分ける。
+extra_word_lists: [prefecture-unit, date-time-unit, calendar-unit, calendar-year-unit]
 
 name:
   ja: 英数字の前後の空白がそろっていない
   en: Spacing around Latin text is inconsistent
 
 why:
-  ja: 日本語と英字・数字のあいだを空けるか詰めるかは、どちらでも読めます。困るのは一つの文書の中で混ざることで、読み手には違いに意味があるように見えます。chaff はどちらが正しいかを決めず、文書の中で少ないほうを指摘します。英字と、数字の前、数字の後ろは別々に数えます。「を 3回」のように、数字の前は空けて助数詞とは詰める書き方がふつうにあるからです。「3GBの」のように数字に続く単位は、英字ではなく数字の側として数えます。逆に「H30 等」「EC2 で」「Phase 1 は」のように英字で始まって数字で終わる名前は、英字の側として数えます。「073-489-5909」「2026-06-02」のような番号は数量ではないので数えません。題や注の番号として書かれた数（「3.1 リサーチの原則」の節番号、※1 の注番号、行の頭に続き番号で並べた注の番号）と、0 で始まる組を含む番号（〒102-0094）も、後ろの空白が番号と題・項目の区切りなので数えません。
-  en: Whether to put a space between Japanese and Latin letters or digits is a choice either way. What reads badly is mixing both in one document, which suggests the difference means something. chaff does not decide which is right; it points at whichever the document uses less. Letters, the space before a digit and the space after one are counted separately, since spacing before a number but not before its counter is common. A unit after a number (3GB) counts with the number; a name that starts with a letter and ends in a digit (H30, EC2, Phase 1) counts with the letters. A code such as a phone number or a date (073-489-5909, 2026-06-02) is not a quantity and is not counted. Neither is a number written as the label of a title or a note (a section number such as 3.1 before its title, a note number after ※, the numbers of notes listed one per line in sequence) or a code with a part starting with 0 (〒102-0094), since the space after it separates the label from its title or the next item.
+  ja: 日本語と英字・数字のあいだを空けるか詰めるかは、どちらでも読めます。困るのは一つの文書の中で混ざることで、読み手には違いに意味があるように見えます。chaff はどちらが正しいかを決めず、文書の中で少ないほうを指摘します。英字と、数字の前、数字の後ろは別々に数えます。「を 3回」のように、数字の前は空けて助数詞とは詰める書き方がふつうにあるからです。「3GBの」のように数字に続く単位は、英字ではなく数字の側として数えます。逆に「H30 等」「EC2 で」「Phase 1 は」のように英字で始まって数字で終わる名前は、英字の側として数えます。「073-489-5909」「2026-06-02」のような番号は数量ではないので数えません。日付・時刻（「9月」「2026年」「10月1日」「3時」「10時5分」）も、数と単位を詰めて書く決まりなので、その中の境目は数えません（日付の前の空白は数えます）。長さ（「3ヶ月」「3 時間」「5日で」「3年」）は数量として数えます。題や注の番号として書かれた数（「3.1 リサーチの原則」の節番号、※1 の注番号、行の頭に続き番号で並べた注の番号）、0 で始まる組を含む番号（102-0094）、〒の後ろの郵便番号（〒100-8916）、市・区・町まで下りた地名のすぐ後ろの番地（千代田区紀尾井町1-3）も、後ろの空白が番号と題・項目の区切りなので数えません。鉤括弧（「」『』）で引いた題名や発言の中も、空け方は引いた元のものなので数えません。
+  en: Whether to put a space between Japanese and Latin letters or digits is a choice either way. What reads badly is mixing both in one document, which suggests the difference means something. chaff does not decide which is right; it points at whichever the document uses less. Letters, the space before a digit and the space after one are counted separately, since spacing before a number but not before its counter is common. A unit after a number (3GB) counts with the number; a name that starts with a letter and ends in a digit (H30, EC2, Phase 1) counts with the letters. A code such as a phone number or a date (073-489-5909, 2026-06-02) is not a quantity and is not counted. Nor is the inside of a date or a time written with units (9月, 2026年, 10月1日, 3時, 10時5分), which is packed by convention; the space before it still counts. A length of time (3ヶ月, 3 時間, 5日で, 3年) is a quantity and counts. Neither is a number written as the label of a title or a note (a section number such as 3.1 before its title, a note number after ※, the numbers of notes listed one per line in sequence), a code with a part starting with 0 (102-0094), a postal code after 〒 (〒100-8916), or a hyphenated address number right after a city, ward or town (千代田区紀尾井町1-3), since the space after it separates the label from its title or the next item. Nor is the spacing inside a title or a quotation in 「」 or 『』, which is the source's, not the writer's.
 
 message:
   ja: "日本語と{kind}のあいだを{style}（この文書はふつう{usual}。{of} 箇所のうち {count} 箇所が違う）"
@@ -26,4 +29,4 @@ how_to_fix:
 # 何箇所違えば指摘するか。1 は「1 箇所でも混ざっていれば」。
 levels: { strict: 1, normal: 1, relaxed: 3 }
 
-use_for: [business, blog, technical]
+use_for: [business, blog, technical, legal, docs, academic, literature, speech]

package/rules/max-kanji-continuous.yaml

@@ -2,8 +2,9 @@ id: max-kanji-continuous
 layer: L3
 status: experimental
 how_to_find: kanji-run
-# 品詞があれば、住所（地名と数だけでできた連なり）を数えない。無くても文字だけで動く。
+# 品詞があれば、住所（地名と数だけでできた連なり）と 1 つの名前（辞書の固有名詞 1 語、人の姓と名）を数えない。無くても文字だけで動く。
 uses: [pos]
+# chaff.yaml の names に並べた名前は連なりを切る。鉤括弧の中身がまるごと 1 つの連なりなら数えない（書き手が 1 つの名前と示している）。
 # 住所の先頭にしか来ない単位（都道府県）。地名の後ろに付けば、割られた町名ではなく地名の並び。
 extra_word_lists: [prefecture-unit]
 languages: [ja]
@@ -22,9 +23,9 @@ message:
   en: '"{word}" runs {count} kanji together (limit {limit})'
 
 how_to_fix:
-  ja: ひらがなを 1 つ挟むか、助詞で割ってください。「情報処理推進機構の認定試験」に。
-  en: Break it with a particle or kana.
+  ja: ひらがなを 1 つ挟むか、助詞で割ってください。「情報処理推進機構の認定試験」に。割れない正式名称なら、chaff.yaml の names に並べると数えません。鉤括弧でまるごとくくった名前（「英国大使館別荘記念公園」）も数えません。
+  en: Break it with a particle or kana. If it is an official name that cannot be broken, list it under names in chaff.yaml and it is not counted. A name that fills a 「」 quotation exactly is not counted either.
 
 levels: { strict: 6, normal: 8, relaxed: 12 }
 
-use_for: [blog, business, technical]
+use_for: [blog, business, technical, legal, docs, academic, literature, speech]

package/rules/max-paragraph-length.yaml

@@ -14,7 +14,7 @@ why:
 
 message:
   ja: この段落は {count} 文あります（{limit} 文まで）
-  en: This paragraph runs {count} sentences (limit {limit})
+  en: This paragraph runs {count} {count|sentence|sentences} (limit {limit})
 
 how_to_fix:
   ja: 話題の変わり目で段落を割ってください。
@@ -22,4 +22,11 @@ how_to_fix:
 
 levels: { strict: 3, normal: 5, relaxed: 8 }
 
-use_for: [blog, business, technical]
+# 条文・判決・論文の段落は、一つの規定や論点をまとめて書く。corpus のその種類の文書で、normal が最も長い一握りの段落だけを指すように測って置いた。
+by_genre:
+  legal: { strict: 5, normal: 8, relaxed: 12 }
+  legal/statute: { strict: 8, normal: 12, relaxed: 16 }
+  legal/judgment: { strict: 8, normal: 12, relaxed: 16 }
+  academic: { strict: 5, normal: 9, relaxed: 12 }
+
+use_for: [blog, business, technical, legal, docs, academic, literature, speech]

package/rules/max-sentence-length.yaml

@@ -14,7 +14,7 @@ why:
 
 message:
   ja: この文は {count} 文字あります（{limit} 文字まで）
-  en: "This sentence runs {count} words (limit {limit})"
+  en: "This sentence runs {count} {count|word|words} (limit {limit})"
 
 how_to_fix:
   ja: 接続助詞のところで 2 文に割ってください。それだけで読めるようになります。
@@ -46,5 +46,17 @@ by_genre:
   blog/owned-media:
     ja: { strict: 65, normal: 90, relaxed: 125 }
     en: { strict: 16, normal: 22, relaxed: 30 }
+  # 法令・契約・判決・論文は、長い一文がその種類の書き方。corpus のその種類の文書で、normal が最も長い一握りの文だけを指すように測って置いた。
+  legal:
+    ja: { strict: 120, normal: 200, relaxed: 300 }
+    en: { strict: 40, normal: 60, relaxed: 80 }
+  legal/statute:
+    ja: { strict: 200, normal: 300, relaxed: 450 }
+    en: { strict: 80, normal: 130, relaxed: 180 }
+  legal/judgment:
+    ja: { strict: 250, normal: 350, relaxed: 450 }
+  academic:
+    ja: { strict: 100, normal: 140, relaxed: 180 }
+    en: { strict: 35, normal: 50, relaxed: 65 }
 
-use_for: [blog, business, technical]
+use_for: [blog, business, technical, legal, docs, academic, literature, speech]

package/rules/ngram-repetition.yaml

@@ -16,12 +16,12 @@ why:
 
 message:
   ja: 「{word}」が {count} 回出てきます（{limit} 回まで）
-  en: '"{word}" appears {count} times (limit {limit})'
+  en: '"{word}" appears {count} {count|time|times} (limit {limit})'
 
 how_to_fix:
-  ja: 2 回目以降を言い換えるか、まとめて 1 度にしてください。
-  en: Rephrase the repeats, or say it once.
+  ja: 2 回目以降を言い換えるか、まとめて 1 度にしてください。繰り返しているのが組織名や製品名なら、chaff.yaml の names に並べると数えません。
+  en: Rephrase the repeats, or say it once. If what repeats is an organisation or product name, list it under names in chaff.yaml and it is not counted.
 
 levels: { strict: 3, normal: 5, relaxed: 9 }
 
-use_for: [blog, business, technical]
+use_for: [blog, business, technical, legal, docs, academic, literature, speech]

package/rules/no-doubled-joshi.yaml

@@ -12,12 +12,12 @@ name:
   en: Nested repeated particle
 
 why:
-  ja: 「弊社の新製品の販売の計画」のように同じ助詞が読点を挟まずに続くと、どれがどれに係るのか読み手が追えなくなります。読点で区切られた並列は数えていません。
-  en: When the same particle repeats without a break, the reader cannot tell which phrase attaches to which. Items separated by punctuation are not counted.
+  ja: 「弊社の新製品の販売の計画」のように同じ助詞が読点を挟まずに続くと、どれがどれに係るのか読み手が追えなくなります。読点で区切られた並列は数えていません。鉤括弧で引いた題名や発言（「食品中のウイルスの制御のための…」）の中は書き手が言い換えられないので数えず、引いたもの全体を一つの名詞として読みます。
+  en: When the same particle repeats without a break, the reader cannot tell which phrase attaches to which. Items separated by punctuation are not counted. Nor are particles inside a title or a quotation in 「」 or 『』, which the writer cannot rephrase; the quotation as a whole is read as one noun.
 
 message:
   ja: 「{word}」が読点を挟まずに {count} 回続いています（{limit} 回まで）
-  en: '"{word}" repeats {count} times with no break (limit {limit})'
+  en: '"{word}" repeats {count} {count|time|times} with no break (limit {limit})'
 
 how_to_fix:
   ja: 文を割るか、係り先を言い換えてください。「弊社の新製品の販売の計画」を「弊社が新製品を販売する計画」に。
@@ -25,4 +25,4 @@ how_to_fix:
 
 levels: { strict: 1, normal: 2, relaxed: 3 }
 
-use_for: [blog, business, technical]
+use_for: [blog, business, technical, legal, docs, academic, literature, speech]

package/rules/no-em-dash.yaml

@@ -18,7 +18,7 @@ why:
 
 message:
   ja: 1000 字あたり {density} 個のダッシュがあります（{limit} 個まで）
-  en: "{density} dashes per 1000 words (limit {limit})"
+  en: "{density} {density|dash|dashes} per 1000 words (limit {limit})"
 
 how_to_fix:
   ja: 読点か括弧に置き換えてください。挟み込みなら括弧、言い換えなら読点が読みやすいです。
@@ -29,4 +29,4 @@ levels:
   ja: { strict: 1, normal: 3, relaxed: 8 }
   en: { strict: 3, normal: 8, relaxed: 20 }
 
-use_for: [blog, business, technical]
+use_for: [blog, business, technical, legal, docs, academic, literature, speech]

package/rules/no-mixed-desumasu.yaml

@@ -26,4 +26,4 @@ how_to_fix:
 # 少数派が何文までなら「混在」と見るか。これを超えたら、混在ではなく別の文体と判断して黙る。
 levels: { strict: 5, normal: 3, relaxed: 1 }
 
-use_for: [blog, business, technical]
+use_for: [blog, business, technical, legal, docs, academic, literature, speech]

package/rules/no-nakaguro-parallel.yaml

@@ -15,7 +15,7 @@ why:
 
 message:
   ja: この文に中黒が {count} 個あります（{limit} 個まで）
-  en: "{count} middle dots in this sentence (limit {limit})"
+  en: "{count} middle {count|dot|dots} in this sentence (limit {limit})"
 
 how_to_fix:
   ja: 文を割るか、箇条書きにしてください。組の切れ目がはっきりします。
@@ -24,4 +24,4 @@ how_to_fix:
 # 実文書の分布から。1 文 4 個までは読める。
 levels: { strict: 3, normal: 5, relaxed: 8 }
 
-use_for: [blog, business, technical]
+use_for: [blog, business, technical, legal, docs, academic, literature, speech]

package/rules/numbering-gap.yaml

@@ -23,4 +23,4 @@ how_to_fix:
 
 levels: { strict: 1, normal: 1, relaxed: 1 }
 
-use_for: [business, technical, blog]
+use_for: [business, technical, blog, legal, docs, academic, literature, speech]

package/rules/oxford-comma-consistency.yaml

@@ -3,6 +3,7 @@ layer: L3
 status: experimental
 how_to_find: oxford-comma
 languages: [en]
+extra_word_lists: [participle-word]
 severity: info
 
 name:
@@ -23,4 +24,4 @@ how_to_fix:
 
 levels: { strict: 3, normal: 2, relaxed: 1 }
 
-use_for: [blog, business, technical]
+use_for: [blog, business, technical, legal, docs, academic, literature, speech]

package/rules/padded-intro.yaml

@@ -28,4 +28,5 @@ levels:
   normal: 1
   relaxed: 2
 
-use_for: [blog]
+# プレスリリース・メール・議事録の冒頭は理由や用件を言う所で、つかみではない。
+use_for: [blog, business/report, business/proposal, legal, docs, academic, literature, speech]

package/rules/paragraph-length-variance.yaml

@@ -22,4 +22,4 @@ how_to_fix:
 
 levels: { strict: 40, normal: 30, relaxed: 20 }
 
-use_for: [blog]
+use_for: [blog, legal, docs, academic, literature, speech]

package/rules/preamble-length.yaml

@@ -14,7 +14,7 @@ why:
 
 message:
   ja: 最初の見出しまでに {count} 段落あります（{limit} 段落まで）
-  en: "{count} paragraphs before the first heading (limit {limit})"
+  en: "{count} {count|paragraph|paragraphs} before the first heading (limit {limit})"
 
 how_to_fix:
   ja: 結論を先に書くか、前置きを見出しの下へ移してください。
@@ -22,4 +22,4 @@ how_to_fix:
 
 levels: { strict: 1, normal: 2, relaxed: 4 }
 
-use_for: [business]
+use_for: [business, legal, docs, academic, literature, speech]

package/rules/preferred-term.yaml

@@ -24,4 +24,4 @@ how_to_fix:
 # チームが並べた書き方なので、1 つでも指摘する。並べた時点で「使わない」と決めている。
 levels: { strict: 1, normal: 1, relaxed: 3 }
 
-use_for: [business, blog, technical]
+use_for: [business, blog, technical, legal, docs, academic, literature, speech]

package/rules/proper-noun-density.yaml

@@ -3,6 +3,7 @@ layer: L3
 status: experimental
 how_to_find: proper-noun-density
 requires: [pos]
+# chaff.yaml の names に並べた名前は、何語に割れても 1 つと数える。名前そのものは数える（読み手が知らないことは変わらない）。
 severity: info
 
 name:
@@ -15,7 +16,7 @@ why:
 
 message:
   ja: 1000 語あたり {density} 個の固有名詞があります（{limit} 個まで）
-  en: "{density} proper nouns per 1000 words (limit {limit})"
+  en: "{density} proper {density|noun|nouns} per 1000 words (limit {limit})"
 
 how_to_fix:
   ja: 2 度目からは「その製品」「そのチーム」のように受けてください。初出で何者かを一言添えると、知らない人も読めます。
@@ -23,4 +24,4 @@ how_to_fix:
 
 levels: { strict: 20, normal: 40, relaxed: 80 }
 
-use_for: [blog, business, technical]
+use_for: [blog, business, technical, legal, docs, academic, literature, speech]

package/rules/repeated-conjunction.yaml

@@ -16,7 +16,7 @@ why:
 
 message:
   ja: 接続詞で始まる段落が {count} 続いています（{limit} まで）
-  en: "{count} paragraphs in a row open with a conjunction (limit {limit})"
+  en: "{count} {count|paragraph|paragraphs} in a row {count|opens|open} with a conjunction (limit {limit})"
 
 how_to_fix:
   ja: どれか 1 つを残して、他は言いたいことから始めてください。
@@ -24,4 +24,4 @@ how_to_fix:
 
 levels: { strict: 1, normal: 2, relaxed: 4 }
 
-use_for: [business, blog, technical]
+use_for: [business, blog, technical, legal, docs, academic, literature, speech]

package/rules/repeated-sentence-head.yaml

@@ -14,7 +14,7 @@ why:
 
 message:
   ja: 「{head}」で始まる文が {count} 続いています（{limit} まで）
-  en: '{count} sentences in a row open with "{head}" (limit {limit})'
+  en: '{count} {count|sentence|sentences} in a row {count|opens|open} with "{head}" (limit {limit})'
 
 how_to_fix:
   ja: 語順を変えるか、1 文を前の文に繋げてください。
@@ -25,4 +25,4 @@ levels:
   normal: 3
   relaxed: 4
 
-use_for: [blog, business, technical]
+use_for: [blog, business, technical, legal, docs, academic, literature, speech]

package/rules/required-sections.yaml

@@ -23,4 +23,4 @@ how_to_fix:
 # 何個足りなければ指摘するか。1 は「1 つでも足りなければ」。
 levels: { strict: 1, normal: 1, relaxed: 2 }
 
-use_for: [business, blog, technical]
+use_for: [business, blog, technical, legal, docs, academic, literature, speech]

package/rules/rule-of-three.yaml

@@ -14,7 +14,7 @@ why:
 
 message:
   ja: 箇条書き {total} 個のうち {count} 個が 3 項目です（{limit}% まで）
-  en: "{count} of {total} lists have exactly three items ({limit}% allowed)"
+  en: "{count} of {total} {total|list|lists} {count|has|have} exactly three items ({limit}% allowed)"
 
 how_to_fix:
   ja: 数を合わせるために足した項目を消してください。2 つで足りるなら 2 つで。
@@ -22,4 +22,4 @@ how_to_fix:
 
 levels: { strict: 50, normal: 70, relaxed: 90 }
 
-use_for: [blog]
+use_for: [blog, legal, docs, academic, literature, speech]

package/rules/sasete-itadaku.yaml

@@ -1,7 +1,7 @@
 id: sasete-itadaku
 layer: L3
 status: experimental
-how_to_find: phrase-match
+how_to_find: phrase-count
 word_list: sasete-itadaku
 uses: [pos]
 languages: [ja]
@@ -17,7 +17,7 @@ why:
 
 message:
   ja: 「{matched}」が文書内に {count} 回あります（{limit} 回まで）
-  en: '"{matched}" appears {count} times in this document (limit {limit})'
+  en: '"{matched}" appears {count} {count|time|times} in this document (limit {limit})'
 
 how_to_fix:
   ja: 主語を立てて言い切ってください。「検討させていただきます」を「来週までに結論を出します」に。
@@ -25,4 +25,4 @@ how_to_fix:
 
 levels: { strict: 1, normal: 3, relaxed: 6 }
 
-use_for: [business, blog]
+use_for: [business, blog, legal, docs, academic, literature, speech]

package/rules/section-length-uniformity.yaml

@@ -22,4 +22,4 @@ how_to_fix:
 
 levels: { strict: 45, normal: 35, relaxed: 25 }
 
-use_for: [blog]
+use_for: [blog, legal, docs, academic, literature, speech]

package/rules/sentence-initial-conjunction-run.yaml

@@ -16,7 +16,7 @@ why:
 
 message:
   ja: 接続詞で始まる文が {count} 文続いています（{limit} 文まで）
-  en: "{count} sentences in a row open with a conjunction (limit {limit})"
+  en: "{count} {count|sentence|sentences} in a row {count|opens|open} with a conjunction (limit {limit})"
 
 how_to_fix:
   ja: どれか 1 つを残して、他は前の文に繋ぐか独立させてください。
@@ -24,4 +24,4 @@ how_to_fix:
 
 levels: { strict: 1, normal: 2, relaxed: 4 }
 
-use_for: [blog, business]
+use_for: [blog, business, legal, docs, academic, literature, speech]

package/rules/sentence-rhythm.yaml

@@ -27,4 +27,4 @@ levels:
   normal: 30
   relaxed: 20
 
-use_for: [blog]
+use_for: [blog, legal, docs, academic, literature, speech]

package/rules/taigen-dome-in-prose.yaml

@@ -16,7 +16,7 @@ why:
 
 message:
   ja: 本文に体言止めが {count} 文あります（{limit} 文まで）
-  en: "{count} sentences end on a noun in the body text (limit {limit})"
+  en: "{count} {count|sentence|sentences} {count|ends|end} on a noun in the body text (limit {limit})"
 
 how_to_fix:
   ja: 述語を足してください。「〜が課題。」を「〜が課題です。」に。
@@ -24,4 +24,4 @@ how_to_fix:
 
 levels: { strict: 2, normal: 4, relaxed: 8 }
 
-use_for: [blog, business, technical]
+use_for: [blog, business, technical, legal, docs, academic, literature, speech]

package/rules/title-case-consistency.yaml

@@ -10,8 +10,8 @@ name:
   en: Heading capitalisation is inconsistent
 
 why:
-  ja: Title Case と sentence case のどちらが正しいかは決めません。1 つの文書で混ざっていると、見出しの階層が変わったように見えます。
-  en: Neither Title Case nor sentence case is wrong. Mixed within one document, the headings look like they change level.
+  ja: Title Case と sentence case のどちらが正しいかは決めません。1 つの文書で混ざっていると、見出しの階層が変わったように見えます。文書の題名（先頭にある深さ 1 の見出しが 1 つだけのとき）は名前なので比べません。節の見出しが同数に割れたときだけ、題名の流儀に合わせます。
+  en: Neither Title Case nor sentence case is wrong. Mixed within one document, the headings look like they change level. The document's title (a single top-level heading that opens it) is a name and is not compared; when the section headings split evenly, the title's style decides.
 
 message:
   ja: この見出しだけ他と大文字化の流儀が違います（文書の中で {count} 個）
@@ -23,4 +23,4 @@ how_to_fix:
 
 levels: { strict: 3, normal: 2, relaxed: 1 }
 
-use_for: [blog, business, technical]
+use_for: [blog, business, technical, legal, docs, academic, literature, speech]

package/rules/total-mismatch.yaml

@@ -23,4 +23,4 @@ how_to_fix:
 
 levels: { strict: 1, normal: 1, relaxed: 1 }
 
-use_for: [business, technical, blog]
+use_for: [business, technical, blog, legal, docs, academic, literature, speech]

package/rules/undefined-acronym.yaml

@@ -3,7 +3,20 @@ layer: L1
 status: experimental
 how_to_find: undefined-acronym
 word_list: common-acronym
-extra_word_lists: [definition-marker, definition-verb, meridiem, time-zone, currency-code, us-state-code, emphasis-word, numbered-division]
+extra_word_lists:
+  [
+    definition-marker,
+    definition-verb,
+    meridiem,
+    time-zone,
+    currency-code,
+    us-state-code,
+    emphasis-word,
+    numbered-division,
+    honorific,
+    date-time-unit,
+    http-method,
+  ]
 uses: [pos]
 severity: info
 
@@ -17,12 +30,12 @@ why:
 
 message:
   ja: 「{word}」が説明なしで使われています（説明のない略語 {count} 個）
-  en: '"{word}" is used without an expansion ({count} such acronyms)'
+  en: '"{word}" is used without an expansion ({count} such {count|acronym|acronyms})'
 
 how_to_fix:
-  ja: 初出のところで括弧に入れて展開してください。「CI（継続的インテグレーション）」のように。
-  en: Expand it in brackets at first use.
+  ja: 初出のところで括弧に入れて展開してください。「CI（継続的インテグレーション）」のように。読み手が名前として知っている略語（社名など）なら、chaff.yaml の names に並べると求めません。
+  en: Expand it in brackets at first use. If your readers know it as a name (a company, say), list it under names in chaff.yaml and it is not asked for.
 
 levels: { strict: 1, normal: 3, relaxed: 6 }
 
-use_for: [business, technical]
+use_for: [business, technical, legal, docs, academic, literature, speech]

package/rules/unqualified-superlative.yaml

@@ -3,7 +3,7 @@ layer: L2
 status: experimental
 how_to_find: unqualified-superlative
 word_list: superlative
-extra_word_lists: [comparison-marker, superlative-scope]
+extra_word_lists: [comparison-marker, superlative-scope, quantity-noun]
 uses: [pos]
 severity: warning
 
@@ -17,7 +17,7 @@ why:
 
 message:
   ja: 「{matched}」に比べる相手がありません（そういう言い方が {count} 箇所）
-  en: '"{matched}" has nothing to compare against ({count} such claims)'
+  en: '"{matched}" has nothing to compare against ({count} such {count|claim|claims})'
 
 how_to_fix:
   ja: 比較対象か条件を添えてください。「社内の 3 案のうち最も速い」のように。
@@ -25,4 +25,4 @@ how_to_fix:
 
 levels: { strict: 1, normal: 2, relaxed: 4 }
 
-use_for: [business, blog]
+use_for: [business, blog, legal, docs, academic, literature, speech]