chaffjs 0.18.0 → 0.20.0

package/rules/list-item-form-mix.yaml

@@ -0,0 +1,134 @@
+id: list-item-form-mix
+layer: L2
+status: experimental
+how_to_find: list-item-form-mix
+requires: [pos]
+severity: info
+
+name:
+  ja: 箇条書きの項目の形がそろっていない
+  en: List items in mixed forms
+
+why:
+  ja: 一つの箇条書きの項目は、同じ形で並んでいると読み比べやすくなります。名詞で終わる項目（「申込書の提出」）の中に文で終わる項目（「期限を確認する」）が一つだけ混ざると、そこだけ別の種類のことに見えます。chaff はどちらの形が正しいかを決めず、一つの箇条書きの中で少ないほうの形の項目を指摘します。英語の文書では、動詞で始まる項目（Install …）と名詞で始まる項目（The server …）の混ざりも見ます。です・ます と だ・である の混ざりは no-mixed-desumasu が見るので、ここでは見ません。
+  en: Items in one list are easiest to compare when they share a form. When one item is a full sentence among noun phrases, or opens with a verb (Install …) among items that open with a noun (The server …), it reads as a different kind of thing. chaff does not decide which form is right; within one list it points at the items in the less common form.
+
+message:
+  ja: 「{written}」だけ、この箇条書きのほかの項目と形が違います（{of} 項目のうち {count} 項目）
+  en: '"{written}" is in a different form from the other items in this list ({count} of {of})'
+
+messages:
+  ending-phrase:
+    ja: 「{written}」は名詞で終わっています。この箇条書きのほかの項目は文で終わります（{of} 項目のうち {count} 項目）
+    en: '"{written}" is a phrase; the other items in this list are sentences ({count} of {of})'
+  ending-sentence:
+    ja: 「{written}」は文で終わっています。この箇条書きのほかの項目は名詞で終わります（{of} 項目のうち {count} 項目）
+    en: '"{written}" is a sentence; the other items in this list are phrases ({count} of {of})'
+  head-verb:
+    ja: 「{written}」は動詞で始まっています。この箇条書きのほかの項目は名詞で始まります（{of} 項目のうち {count} 項目）
+    en: '"{written}" opens with a verb; the other items in this list open with a noun phrase ({count} of {of})'
+  head-noun:
+    ja: 「{written}」は名詞で始まっています。この箇条書きのほかの項目は動詞で始まります（{of} 項目のうち {count} 項目）
+    en: '"{written}" opens with a noun phrase; the other items in this list open with a verb ({count} of {of})'
+
+how_to_fix:
+  ja: 少ないほうの項目を、ほかの項目と同じ形に書き直してください。中身が違う種類のことなら、別の箇条書きか段落に分けます。
+  en: Rewrite the odd item in the form the others use. If it really is a different kind of thing, move it to its own list or paragraph.
+
+# 少ないほうの形が、その箇条書きの判定できた項目の何パーセントまでなら「混ざっている」と見るか。これを超えたら使い分け。
+levels: { strict: 49, normal: 34, relaxed: 20 }
+
+use_for: [blog, business, technical, docs, academic, legal, literature, speech]
+
+group: consistency
+summary:
+  ja: 一つの箇条書きの中で、名詞で終わる項目と文で終わる項目（英語では動詞で始まる項目と名詞で始まる項目）が混ざっている所
+  en: One list mixing phrases with sentences, or items that open with a verb with items that open with a noun
+
+example:
+  ja:
+    config: { genre: blog/tech }
+    before: |
+      準備するもの：
+
+      - 申込書の記入
+      - 本人確認書類の用意
+      - 手数料を払う
+    after: |
+      準備するもの：
+
+      - 申込書の記入
+      - 本人確認書類の用意
+      - 手数料の支払い
+  en:
+    config: { genre: blog/tech }
+    before: |
+      Before you start:
+
+      - Install the command-line tool
+      - Create an account on the website
+      - The configuration file in your home folder
+    after: |
+      Before you start:
+
+      - Install the command-line tool
+      - Create an account on the website
+      - Put the configuration file in your home folder
+
+not_flagged:
+  ja: 項目が三つに満たない箇条書き、少ないほうが三分の一を超える箇条書き（使い分けと見る）、一語だけの項目、「札：説明」の形の項目、コードやリンクを含む項目、読点や「;」で終わって一つの文を分けて並べた箇条書き、引用の中の箇条書きは見ません。項目の最後の括弧書き（「健康診断書（3か月以内のもの）」）は外して形を見ます。法務・文学・話し言葉・議事録のジャンルでは見ません。
+  en: 'Lists of fewer than three items, lists where the less common form is more than a third (used on purpose), one-word items, "Label: value" items, items holding code or a link, lists whose items end in a comma, a semicolon or "and" (one sentence split into items), and quoted lists are not checked. A capitalised name (Cover Letter) and a word that is also a verb (Design) are not judged by their first word. Legal, literary, speech and meeting-notes genres do not run this rule.'
+level_meaning:
+  ja: 少ないほうの形が、箇条書きの項目の {limit}% 以下のとき指摘
+  en: reported when the less common form is {limit}% of the list's items or less
+rewrite:
+  ja:
+    direction: 少ないほうの項目を、同じ箇条書きのほかの項目の形にそろえてください。名詞で終わる並びなら名詞で、文で終わる並びなら文で終えます。項目の中身は変えません。
+    pairs:
+      - before: |
+          - 申込書の記入
+          - 本人確認書類の用意
+          - 手数料を払う
+        after: |
+          - 申込書の記入
+          - 本人確認書類の用意
+          - 手数料の支払い
+      - before: |
+          - 毎朝ログを確認する
+          - 週に一度バックアップを取る
+          - 月末の請求書の発行
+        after: |
+          - 毎朝ログを確認する
+          - 週に一度バックアップを取る
+          - 月末に請求書を発行する
+    keep:
+      - 項目の順番と数
+      - 項目の中の語と数字
+    avoid:
+      - 形をそろえるために、項目に無かった中身を足す
+      - 多いほうの項目を少ないほうに合わせて書き換える
+  en:
+    direction: Rewrite the odd item in the form the rest of the list uses. If the others are phrases, make it a phrase; if they open with a verb, open it with a verb. Keep what the item says.
+    pairs:
+      - before: |
+          - Install the command-line tool
+          - Create an account on the website
+          - The configuration file in your home folder
+        after: |
+          - Install the command-line tool
+          - Create an account on the website
+          - Put the configuration file in your home folder
+      - before: |
+          - Faster downloads
+          - Smaller files
+          - The settings page has been redesigned.
+        after: |
+          - Faster downloads
+          - Smaller files
+          - A redesigned settings page
+    keep:
+      - the order and number of the items
+      - the words and figures in each item
+    avoid:
+      - adding to an item something it did not say, to make the form fit
+      - rewriting the many items to match the odd one

package/rules/max-kanji-continuous.yaml

@@ -29,6 +29,7 @@ how_to_fix:
 levels: { strict: 6, normal: 8, relaxed: 12 }
 
 use_for: [blog, business, technical, legal, docs, academic, literature, speech]
+sources: [shibasaki-tamaoka-2010, lee-2016]
 
 group: readability
 summary:

package/rules/max-paragraph-length.yaml

@@ -37,6 +37,7 @@ by_genre:
   academic: { strict: 5, normal: 9, relaxed: 12 }
 
 use_for: [blog, business, technical, legal, docs, academic, literature, speech]
+sources: [gov-uk-clear-language]
 
 group: readability
 summary:

package/rules/max-sentence-length.yaml

@@ -73,6 +73,7 @@ by_genre:
     en: { strict: 35, normal: 50, relaxed: 65 }
 
 use_for: [blog, business, technical, legal, docs, academic, literature, speech]
+sources: [shibasaki-tamaoka-2010, yasashii-nihongo-2020, koyobun-2022, gov-uk-clear-language]
 
 group: readability
 summary:
@@ -96,3 +97,28 @@ not_flagged:
 level_meaning:
   ja: 一文 {limit} 字まで
   en: up to {limit} words in a sentence
+rewrite:
+  ja:
+    direction: 接続助詞（〜が、〜ので、〜し）か「、そして」の所で二文に割り、二文目にも主語を書いてください。
+    pairs:
+      - before: 申請書は総務部に提出しますが、期限を過ぎた場合は翌月の扱いになり、その場合は再申請が必要になります。
+        after: 申請書は総務部に提出します。期限を過ぎた申請は翌月の扱いになり、再申請が必要です。
+      - before: 新しい端末は来週届く予定なので、それまでは今の端末を使い、届いたら情報システム部が設定します。
+        after: 新しい端末は来週届く予定です。それまでは今の端末を使います。届いた端末は情報システム部が設定します。
+    keep:
+      - 条件と例外（「〜の場合」）と、それが掛かる先
+    avoid:
+      - 割るときに条件を別の文へ移して、掛かる先を変える
+      - 長い修飾を削って中身を落とす
+  en:
+    direction: Split the sentence at a conjunction (and, but, so, which) and give the second sentence its own subject.
+    pairs:
+      - before: Submit the form to the office, but if you miss the deadline it moves to the next month, in which case you have to apply again.
+        after: Submit the form to the office. A form that misses the deadline moves to the next month and has to be submitted again.
+      - before: The new laptops arrive next week, so keep using the old ones until then, and IT will set the new ones up when they come.
+        after: The new laptops arrive next week. Keep using the old ones until then. IT will set the new ones up when they come.
+    keep:
+      - conditions and exceptions ("if", "unless") and what they apply to
+    avoid:
+      - moving a condition into another sentence so that it applies to something else
+      - dropping content to make the sentence shorter

package/rules/max-ten.yaml

@@ -0,0 +1,59 @@
+id: max-ten
+layer: L3
+status: experimental
+how_to_find: sentence-comma-count
+word_list: ten-mark
+requires: [pos]
+languages: [ja]
+severity: info
+
+name:
+  ja: 一文の読点が多すぎる
+  en: Too many commas in one sentence
+
+why:
+  ja: 一文に読点（、）がいくつも入ると、文が細かく切れて、どこまでが一つのまとまりなのかを読み手が追えなくなります。読点が多いのは、たいてい一文に話を詰め込みすぎている印です。名詞を並べただけの読点（名前、会社名、連絡先）と、鉤括弧で引いたものの中は数えません。
+  en: In Japanese, a sentence cut by many commas (、) leaves the reader unable to tell which pieces belong together. Many commas usually mean the sentence carries too much. Commas that only separate listed nouns (名前、会社名、連絡先) and commas inside 「」 quotations are not counted.
+
+message:
+  ja: 一文に読点が {count} 個あります（{limit} 個まで）
+  en: "{count} commas in one sentence (limit {limit})"
+
+how_to_fix:
+  ja: 意味の切れ目で文を二つに分けてください。
+  en: Split the sentence in two where the meaning breaks.
+
+levels: { strict: 4, normal: 6, relaxed: 8 }
+
+use_for: [business, technical, blog, legal, docs, academic, literature, speech]
+
+group: readability
+summary:
+  ja: 一文の中に読点（、）がいくつも入り、細かく切れている所
+  en: A Japanese sentence cut by many commas (、)
+example:
+  ja:
+    before: |
+      担当者が、会議室で、新人に、資料を、配布し、内容を、丁寧に、説明しました。
+    after: |
+      担当者が会議室で新人に資料を配布しました。続けて、内容を丁寧に説明しました。
+
+not_flagged:
+  ja: 数えるのは読点（、と，）だけです。名詞と名詞のあいだの読点（並べた項目）と、鉤括弧で引いたものの中は数えません。
+  en: Only 、 and ， are counted. Commas between two nouns (listed items) and commas inside 「」 quotations are not.
+level_meaning:
+  ja: 一文の読点 {limit} 個まで
+  en: up to {limit} commas in a sentence
+rewrite:
+  ja:
+    direction: 読点の多い文を、意味の切れ目で二つ以上の文に分けてください。読点を消すだけにはしません。
+    pairs:
+      - before: 担当者が、会議室で、新人に、資料を、配布し、内容を、丁寧に、説明しました。
+        after: 担当者が会議室で新人に資料を配布しました。続けて、内容を丁寧に説明しました。
+      - before: 申請が遅れた場合は、窓口に、電話で、理由を、伝え、指示を、受けてから、書類を、送ってください。
+        after: 申請が遅れた場合は、窓口に電話で理由を伝えてください。指示を受けてから書類を送ってください。
+    keep:
+      - 文が言っている事柄と、その順序
+    avoid:
+      - 読点を消すだけで、長い一文のまま残す
+      - 事柄を足したり落としたりする

package/rules/misconversion.yaml

@@ -0,0 +1,61 @@
+id: misconversion
+layer: L2
+status: experimental
+how_to_find: known-correction
+word_list: misconversion
+uses: [pos]
+languages: [ja]
+severity: warning
+
+name:
+  ja: 変換の誤り
+  en: Wrong kanji conversion
+
+why:
+  ja: 仮名漢字変換は読みの同じ語（意外・以外、初めて・始めて、確率・確立）を取り違えます。どれも正しい語なので、字を見ただけでは誤りに気づきにくいです。chaff は前後の語で誤りと決まる形（「以外と簡単」「始めて会う」「確立が高い」）と、それ自体が誤りの形（不可決、絶対絶命）だけを語彙表から探します。前後で決まらない取り違えは指しません。
+  en: Japanese input methods confuse words with the same reading (意外 and 以外, 初めて and 始めて, 確率 and 確立). Each is a real word, so the slip is hard to see. chaff looks only for forms its lexicon lists, where the words around make the slip certain (以外と簡単, 始めて会う, 確立が高い), or where the form is wrong by itself (不可決, 絶対絶命). A swap the context does not settle is not reported.
+
+message:
+  ja: 「{matched}」は「{suggestion}」の変換の誤りです
+  en: '"{matched}" is a wrong conversion of "{suggestion}"'
+
+how_to_fix:
+  ja: 正しい字に直してください。
+  en: Correct the kanji.
+
+placeholders:
+  matched:
+    ja: 書いた形
+    en: the form as written
+  suggestion:
+    ja: 正しい形
+    en: the intended form
+
+levels: { strict: error, normal: warning, relaxed: info }
+
+use_for: [blog, business, technical, legal, docs, academic, literature, speech]
+
+group: slips
+summary:
+  ja: 「以外と簡単」「始めて会う」「不可決」のような、仮名漢字変換の取り違え
+  en: A Japanese homophone picked by the input method in the wrong place, such as 以外と簡単 for 意外と簡単
+example:
+  ja:
+    before: 設定は以外と簡単でした。
+    after: 設定は意外と簡単でした。
+
+not_flagged:
+  ja: 前後の語で決まらない取り違えは指しません（「以外と」だけでは「日本以外と比べて」と区別できないので、「以外と簡単」「以外と多い」のように後ろの語まで語彙表に書いたものだけを探します）。語の途中には当てません。
+  en: A swap the surrounding words do not settle is not reported (以外と alone also appears in 日本以外と比べて, so only listed phrases such as 以外と簡単 are looked for). A form inside a longer word is not reported.
+rewrite:
+  ja:
+    direction: 指された語を正しい字に直してください。直すのは取り違えた語だけで、文の言い回しは変えません。
+    pairs:
+      - before: 設定は以外と簡単でした。
+        after: 設定は意外と簡単でした。
+      - before: 始めて会う人にも分かるように書きます。
+        after: 初めて会う人にも分かるように書きます。
+    keep:
+      - 文の言い回しと語順
+    avoid:
+      - 前後で決まらない同音の語まで書き換える

package/rules/modal-conflict.yaml

@@ -0,0 +1,106 @@
+id: modal-conflict
+layer: L3
+status: experimental
+how_to_find: modal-conflict
+requires: [structure, pos]
+severity: warning
+
+name:
+  ja: 同じ行為への逆の決まり
+  en: Opposite obligations on the same act
+
+why:
+  ja: 同じ人の同じ行為を、ある文では「しなければならない」「することができる」と、別の文では「してはならない」と書くと、読み手はどちらに従えばよいか分かりません。後から足した条や、別の文書から写した文で起きます。条件や例外を書き分けていれば、二つの文の中身の語が違うので、ここには出ません。
+  en: The same act by the same party written as "must" or "may" in one sentence and "must not" in another leaves the reader unable to tell which to follow. It happens when a clause is added later or copied from another document. A condition or an exception changes the sentence's words, so a carefully scoped pair is not reported.
+
+message:
+  ja: 「{marker}」と書いていますが、{otherLine} 行目では同じ行為を「{other}」と書いています
+  en: 'This says "{marker}", but line {otherLine} says "{other}" about the same act'
+
+how_to_fix:
+  ja: どちらが正しいかを決め、もう一方を消すか、条件や例外（「書面で承諾を得た場合を除き」）を書き足して二つの範囲を分けてください。
+  en: Decide which one holds and delete the other, or add the condition or exception ("unless the Customer agrees in writing") that separates them.
+
+placeholders:
+  marker:
+    ja: してはならない
+    en: must not
+  other:
+    ja: することができる
+    en: may
+  otherLine:
+    ja: 〇
+    en: N
+
+levels: { strict: error, normal: warning, relaxed: info }
+
+use_for: [business, technical, blog, legal, docs, academic, literature, speech]
+
+group: structure
+summary:
+  ja: 同じ主語の同じ行為を、ある文では義務や許可に、別の文では禁止にしている所
+  en: The same act by the same party required or allowed in one sentence and forbidden in another
+example:
+  ja:
+    before: |
+      ## 第5条（再委託）
+
+      受託者は、本件業務を第三者に委託してはならない。
+
+      ## 第9条（体制）
+
+      受託者は、本件業務を第三者に委託することができる。
+    after: |
+      ## 第5条（再委託）
+
+      受託者は、委託者の書面による承諾を得た場合を除き、本件業務を第三者に委託してはならない。
+
+      ## 第9条（体制）
+
+      受託者は、委託者の書面による承諾を得て、本件業務を第三者に委託することができる。
+  en:
+    before: |
+      ## 5. Confidentiality
+
+      The Supplier must not disclose Confidential Information to third parties.
+
+      ## 9. Advisers
+
+      The Supplier may disclose Confidential Information to third parties.
+    after: |
+      ## 5. Confidentiality
+
+      The Supplier must not disclose Confidential Information to third parties.
+
+      ## 9. Advisers
+
+      The Supplier may disclose Confidential Information to its legal advisers.
+
+not_flagged:
+  ja: 中身の語（名詞・動詞・形容詞）がまったく同じ二つの文だけを比べます。様相の語を二つ以上持つ文と、中身の語が一つしか無い文は見ません。「しなければならない」と「することができる」は食い違いと見ません。
+  en: Only two sentences with exactly the same content words (nouns, verbs, adjectives) are compared. A sentence with two or more modal markers, or with fewer than two content words, is not checked. "Must" and "may" are not counted as a conflict.
+rewrite:
+  ja:
+    direction: どちらの文が正しいかを書き手に確かめてください。両方が正しいなら、それぞれの条件や例外を本文から書き足して範囲を分けます。本文に条件が無ければ作らず、書き手に聞きます。
+    pairs:
+      - before: 受託者は、本件業務を第三者に委託してはならない。（第9条）受託者は、本件業務を第三者に委託することができる。
+        after: 受託者は、委託者の書面による承諾を得た場合を除き、本件業務を第三者に委託してはならない。（第9条）受託者は、委託者の書面による承諾を得て、本件業務を第三者に委託することができる。（承諾の条件が本文にあるとき）
+      - before: 利用者は、本サービスを商用に使ってはならない。（第12条）利用者は、本サービスを商用に使うことができる。
+        after: 利用者は、本サービスを商用に使ってはならない。（第12条を消す。書き手が禁止を正しいとしたとき）
+    keep:
+      - 正しいとされた方の決まりの中身
+    avoid:
+      - 本文に無い条件や例外を作る
+      - どちらが正しいかを書き手に聞かずに決める
+  en:
+    direction: Ask the writer which sentence holds. If both do, separate them with the condition or exception the text gives; if the text gives none, ask rather than invent one.
+    pairs:
+      - before: The Supplier must not disclose Confidential Information to third parties. (Section 9) The Supplier may disclose Confidential Information to third parties.
+        after: The Supplier must not disclose Confidential Information to third parties. (Section 9) The Supplier may disclose Confidential Information to its legal advisers. (when Section 9 is about advisers)
+      - before: Users must not resell the Service. (Section 12) Users may resell the Service.
+        after: Users must not resell the Service. (Section 12 deleted, when the writer confirms the ban)
+    keep:
+      - what the rule that holds says
+    avoid:
+      - inventing a condition or exception
+      - picking a side without asking the writer

package/rules/name-variant.yaml

@@ -0,0 +1,88 @@
+id: name-variant
+layer: L3
+status: experimental
+how_to_find: name-variant
+requires: [pos]
+severity: warning
+
+name:
+  ja: 同じ名前の書き分け
+  en: One name written two ways
+
+why:
+  ja: 人や会社や製品の名前を、ある所では「山田太郎」、別の所では「山田太朗」と書くと、読み手は同じ人か別の人か分かりません。契約書なら当事者の特定が揺らぎます。多いのは打ち間違いと、別の文書から写した段落です。どちらの形が正しいかは決めず、文書の中で少ないほうを指します。
+  en: A person, company or product written as "GitHub" in one place and "Github" in another leaves the reader unsure whether they are the same. In a contract it blurs who the party is. The usual causes are a typo and a paragraph pasted from another document. chaff does not decide which form is right; it points at the one the document uses less.
+
+message:
+  ja: 「{name}」は、ほかの所では「{usual}」と書いています
+  en: '"{name}" is written "{usual}" elsewhere in the document'
+
+messages:
+  spelling:
+    ja: 「{name}」は、ほかの所では「{usual}」と書いています（字の大小・幅・記号の違い）
+    en: '"{name}" is written "{usual}" elsewhere in the document (case, width or punctuation)'
+  reading:
+    ja: 「{name}」は、ほかの所では同じ読みの「{usual}」と書いています
+    en: '"{name}" is written "{usual}", read the same, elsewhere in the document'
+  near:
+    ja: 「{name}」は、ほかの所で何度も書いた「{usual}」と一字違いです
+    en: '"{name}" is one letter away from "{usual}", which the document uses more than once'
+
+how_to_fix:
+  ja: 正しい形を確かめ、一つに揃えてください。本当に別の人や会社なら、そのままで構いません。
+  en: Check the right form and use it throughout. If they really are different people or companies, leave them.
+
+placeholders:
+  name:
+    ja: 名前
+    en: the name
+  usual:
+    ja: 別の形
+    en: another form
+
+levels: { strict: error, normal: warning, relaxed: info }
+
+use_for: [business, technical, blog, legal, docs, academic, literature, speech]
+
+group: consistency
+summary:
+  ja: 同じ人・会社・製品の名前を、少しだけ違う形で書いている所（山田太郎 と 山田太朗、GitHub と Github）
+  en: The same person, company or product written in slightly different forms (GitHub and Github, Acme, Inc. and Acme Inc.)
+example:
+  ja:
+    before: |
+      担当は山田太郎です。見積もりは山田太郎が作り、請求書は山田太朗が送ります。
+    after: |
+      担当は山田太郎です。見積もりは山田太郎が作り、請求書も山田太郎が送ります。
+  en:
+    before: |
+      The code lives on GitHub. Reviews happen on GitHub, and releases are tagged on Github.
+    after: |
+      The code lives on GitHub. Reviews happen on GitHub, and releases are tagged on GitHub.
+
+not_flagged:
+  ja: 品詞解析が固有名詞と読んだ語だけを見ます。大文字だけの名前（ACME INC、NASA）は見ません。一字違いの英字の名前は、6 字以上で、多いほうが二度以上、少ないほうが一度だけのときに限ります（Iran と Iraq は別の名前）。
+  en: Only words the tagger reads as proper nouns are checked. Names in capitals only (ACME INC, NASA) are left out. Names one letter apart are reported only when six letters or longer, with the usual form used at least twice and the other once (Iran and Iraq are different names).
+rewrite:
+  ja:
+    direction: 少ないほうの形を、多いほうの形に替えてください。どちらが正しいか本文から分からなければ、書き手に聞きます。別の人や会社なら替えません。
+    pairs:
+      - before: 見積もりは山田太郎が作り、請求書は山田太朗が送ります。
+        after: 見積もりは山田太郎が作り、請求書も山田太郎が送ります。
+      - before: 発注先は株式会社ミナト商事です。納品はミナト商時が行います。
+        after: 発注先は株式会社ミナト商事です。納品はミナト商事が行います。
+    keep:
+      - 名前の正しい形
+    avoid:
+      - 別の人や会社の名前を一つにまとめる
+  en:
+    direction: Replace the less frequent form with the usual one. If the text does not show which is right, ask the writer. Leave names that belong to different people or companies.
+    pairs:
+      - before: Reviews happen on GitHub, and releases are tagged on Github.
+        after: Reviews happen on GitHub, and releases are tagged on GitHub.
+      - before: Acme Inc. signs the order. Payment goes to Acme, Inc. within thirty days.
+        after: Acme Inc. signs the order. Payment goes to Acme Inc. within thirty days.
+    keep:
+      - the name's right form
+    avoid:
+      - merging the names of two different people or companies

package/rules/no-doubled-joshi.yaml

@@ -26,6 +26,7 @@ how_to_fix:
 levels: { strict: 1, normal: 2, relaxed: 3 }
 
 use_for: [blog, business, technical, legal, docs, academic, literature, speech]
+sources: [yamamoto-cheng-2015]
 
 group: readability
 summary:

package/rules/no-em-dash.yaml

@@ -30,6 +30,7 @@ levels:
   en: { strict: 3, normal: 8, relaxed: 20 }
 
 use_for: [blog, business, technical, legal, docs, academic, literature, speech]
+sources: [freeburg-2026]
 
 group: ai-tells
 summary:
@@ -53,5 +54,28 @@ not_flagged:
   ja: 短い文書は測りません。英語では、ダッシュそのものを誤りとは言いません。
   en: Short documents are not measured. In English a dash is not called wrong; only a heavy hand is.
 level_meaning:
-  ja: 1000 字あたり {limit} 個まで
-  en: up to {limit} per 1000 words
+  ja: 1000 字あたりダッシュ {limit} 個まで
+  en: up to {limit} dashes per 1000 words
+rewrite:
+  ja:
+    direction: 挟み込みのダッシュは括弧に、言い換えや補足のダッシュは読点に替えるか、二文に分けてください。
+    pairs:
+      - before: この設定——とくに保存期間——は慎重に決めてください。
+        after: この設定（とくに保存期間）は慎重に決めてください。
+      - before: 答えは一つ——締め切りを守ることです。
+        after: 答えは一つ、締め切りを守ることです。
+    keep:
+      - 挟み込んだ中身と、それが掛かる語
+    avoid:
+      - ダッシュを全角コロンや別の線の記号に替えるだけで済ませる
+  en:
+    direction: Turn an aside between dashes into commas or brackets, and a dash before an explanation into a comma, a colon or a new sentence.
+    pairs:
+      - before: The setting — especially retention — needs care.
+        after: The setting, especially retention, needs care.
+      - before: There is one answer — meet the deadline.
+        after: There is one answer. Meet the deadline.
+    keep:
+      - the aside and what it belongs to
+    avoid:
+      - swapping every dash for a colon or a semicolon

package/rules/no-lead.yaml

@@ -0,0 +1,95 @@
+id: no-lead
+layer: L1
+status: experimental
+how_to_find: no-lead
+requires: [pos]
+severity: info
+
+name:
+  ja: 題の後の段落が題を言い直しているだけ
+  en: The lead only restates the title
+
+why:
+  ja: 題のすぐ後の段落（リード）は、読者がこの先を読むかを決める所です。そこが「この記事では〇〇について説明します」のように題を言い直すだけだと、読者は何も受け取らないまま本文へ進みます。chaff は、リードが題の文字の並びの半分以上を繰り返し、しかも題に無い内容語（名詞・動詞・形容詞・副詞・数）をわずかしか足していないときに言います。日付や書き手の名前だけの行は題を繰り返さないので言いません。
+  en: The paragraph right under the title (the lead) is where a reader decides whether to read on. When it only restates the title ("This article explains X"), the reader gets nothing before the body starts. chaff reports a lead that repeats at least half of the title's character sequence and adds only a few content words (nouns, verbs, adjectives, adverbs, numbers) the title does not have. A line with only a date or a byline does not repeat the title, so it is not reported.
+
+message:
+  ja: 題「{title}」の後の段落は、題に無い語を {count} 個しか足していません
+  en: 'The paragraph after the title "{title}" adds only {count} {count|word|words} the title does not have'
+
+how_to_fix:
+  ja: リードには、題だけでは分からないこと（結論、数字、誰に関係するか、いつからか）を書いてください。言うことが無ければ、リードを消して本文から始めます。
+  en: Put in the lead what the title alone does not say (the conclusion, a figure, who it affects, from when). If there is nothing to add, drop the lead and start with the body.
+
+# 題に無い内容語がこの数より少ないと指摘する。
+levels: { strict: 6, normal: 5, relaxed: 3 }
+
+use_for: [blog, business, technical, docs, academic, legal, literature, speech]
+
+group: structure
+summary:
+  ja: 題のすぐ後の段落が、題を言い直すだけで何も足していない所
+  en: A first paragraph under the title that only says the title again
+example:
+  ja:
+    config: { genre: blog/tech }
+    before: |
+      # 新しい在庫システム
+
+      この記事では、新しい在庫システムについて紹介します。
+    after: |
+      # 新しい在庫システム
+
+      来月から全店の在庫を一つの画面で数えられるようになり、棚卸しは半日で終わります。
+  en:
+    config: { genre: blog/tech }
+    before: |
+      # The new inventory system
+
+      This article introduces the new inventory system.
+    after: |
+      # The new inventory system
+
+      From next month every store counts its stock on one screen, and a stocktake takes half a day.
+
+not_flagged:
+  ja: 題の文字の並びの半分以上を繰り返していない段落（日付、書き手の名前、別の話題で始まるリード）は言いません。題のすぐ下が箇条書き・表・画像なら、リードが無いものとして見ません。題（最初の # 見出し）だけを見ます。法務・文学・話し言葉のジャンルでは見ません。
+  en: A paragraph that repeats less than half of the title's character sequence (a date, a byline, a lead on another point) is not reported. When a list, a table or an image comes right under the title, there is no lead to check. Only the title (the first top-level heading) is checked. Legal, literary and speech genres do not run this rule.
+level_meaning:
+  ja: 題に無い内容語が {limit} 個より少ないとき指摘
+  en: reported when the lead adds fewer than {limit} content words the title does not have
+rewrite:
+  ja:
+    direction: リードを、題だけでは分からないことから書き直してください。結論・数字・対象・時期のうち、本文にあるものを一つか二つ前に出します。題の語を繰り返して「〜について説明します」と予告する文は消します。
+    pairs:
+      - before: |
+          この記事では、新しい在庫システムについて紹介します。
+        after: |
+          来月から全店の在庫を一つの画面で数えられるようになり、棚卸しは半日で終わります。
+      - before: |
+          本ページでは、窓口の受付時間の変更についてお知らせします。
+        after: |
+          4月1日から、窓口の受付は平日の午前9時から午後4時までになります。
+    keep:
+      - 本文にある数字・日付・名前
+      - 題の言葉づかい
+    avoid:
+      - 本文に無い事実をリードに足す
+      - 題をもう一度別の言葉で言い直す
+  en:
+    direction: Rewrite the lead from what the title alone does not tell the reader. Bring forward one or two of the conclusion, a figure, who it affects and when, taken from the body. Cut a sentence that repeats the title to announce what comes next.
+    pairs:
+      - before: |
+          This article introduces the new inventory system.
+        after: |
+          From next month every store counts its stock on one screen, and a stocktake takes half a day.
+      - before: |
+          This page explains the change to our office hours.
+        after: |
+          From April 1 the front desk is open 9 a.m. to 4 p.m. on weekdays.
+    keep:
+      - the figures, dates and names the body gives
+      - the title's wording
+    avoid:
+      - adding to the lead a fact the body does not have
+      - saying the title again in other words

package/rules/no-mixed-desumasu.yaml

@@ -34,6 +34,7 @@ how_to_fix:
 levels: { strict: 5, normal: 3, relaxed: 1 }
 
 use_for: [blog, business, technical, legal, docs, academic, literature, speech]
+sources: [yasashii-nihongo-2020, koyobun-2022, jtf-style-guide]
 
 group: consistency
 summary: