chaffjs 0.18.0 → 0.19.0

package/rules/empty-intensifier.yaml

@@ -47,3 +47,28 @@ not_flagged:
 level_meaning:
   ja: 当てはまる言い回しが {limit} 箇所あれば指摘
   en: reported once there are {limit}
+rewrite:
+  ja:
+    direction: 強める語（「非常に」「言うまでもなく」）を消し、何がどう大事なのかが本文にあれば、それを主語と述語で書いてください。無ければ書き手に聞きます。
+    pairs:
+      - before: 言うまでもなく、バックアップは非常に重要で、消えたデータは戻りません。
+        after: バックアップが無いと、消えたデータは戻りません。
+      - before: この変更は極めて重要です。料金が月額から従量制に変わります。
+        after: この変更で、料金が月額から従量制に変わります。
+    keep:
+      - なぜ大事なのかを書いた部分
+    avoid:
+      - 強める語を別の強める語（「とても」「きわめて」）に替える
+      - 大事な理由を作る
+  en:
+    direction: Delete the intensifier ("extremely", "needless to say") and, if the text says why the thing matters, say that instead. If it does not, ask the writer.
+    pairs:
+      - before: Needless to say, backups are extremely important, because lost data cannot be recovered.
+        after: Without a backup, lost data cannot be recovered.
+      - before: This change is critically important. Billing moves from monthly to usage-based.
+        after: With this change, billing moves from monthly to usage-based.
+    keep:
+      - the part that says why it matters
+    avoid:
+      - swapping one intensifier for another ("very", "truly")
+      - inventing a reason it matters

package/rules/empty-section.yaml

@@ -0,0 +1,74 @@
+id: empty-section
+layer: L1
+status: experimental
+how_to_find: empty-section
+requires: [markdown]
+severity: warning
+
+name:
+  ja: 中身の無い節
+  en: Empty section
+
+why:
+  ja: 見出しのすぐ後ろに、同じ深さか浅い見出しが来ると、その節には何も書かれていません。書くつもりで見出しだけ立てたか、中身を消したときに見出しが残ったものです。目次には載るので、読み手は開いて何も無いことに気づきます。深い見出しが続く（節を小さな節に分けた）ときは中身があるので指摘しません。文書の最後の見出しも、後ろに何も無ければ指摘します。HTML のコメントだけの節は空と数えます。
+  en: A heading followed straight away by a heading of the same or a higher level has nothing under it. A heading was put up to be filled in later, or its content was deleted and the heading left behind. It still shows in the table of contents, and a reader who opens it finds nothing. A heading followed by a deeper one (a section split into subsections) has content and is not reported. The last heading of the document is reported if nothing follows it. A section holding only an HTML comment counts as empty.
+
+message:
+  ja: 見出し「{heading}」の下に中身がありません
+  en: 'Nothing under the heading "{heading}"'
+
+how_to_fix:
+  ja: 節の中身を書くか、見出しを消してください。
+  en: Write the section, or remove the heading.
+
+levels: { strict: error, normal: warning, relaxed: info }
+
+use_for: [business, technical, blog, legal, docs, academic, literature, speech]
+
+group: structure
+summary:
+  ja: 見出しのすぐ後ろに同じ深さか浅い見出しが来て、何も書かれていない節
+  en: A heading with nothing under it before the next heading of the same or a higher level
+example:
+  ja:
+    before: |
+      # 手順書
+
+      ## 準備
+
+      ## 作業
+
+      部品を取り付けます。
+    after: |
+      # 手順書
+
+      ## 準備
+
+      道具をそろえます。
+
+      ## 作業
+
+      部品を取り付けます。
+  en:
+    before: |
+      # Setup guide
+
+      ## Before you start
+
+      ## Steps
+
+      Fit the parts.
+    after: |
+      # Setup guide
+
+      ## Before you start
+
+      Gather the tools.
+
+      ## Steps
+
+      Fit the parts.
+
+not_flagged:
+  ja: すぐ後ろに深い見出しが来る節（小さな節に分けたもの）は指しません。Markdown の文書でだけ動きます。
+  en: A heading followed by a deeper heading (a section split into subsections) is not reported. It runs on Markdown only.

package/rules/excessive-hedging.yaml

@@ -18,7 +18,7 @@ why:
   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} 個まで）
+  ja: 「{matched}」など、逃げの表現が 1000 字あたり {density} 個あります（{limit} 個まで）
   en: '"{matched}" and other hedges: {density} per 1000 words (limit {limit})'
 
 # 1 つの文に重ねたもの。上の message は文書全体の密度。
@@ -31,10 +31,11 @@ how_to_fix:
   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 つ以上重ねたものは、どの段でも指摘する。
+# 文書全体の、1000 語（日本語は 1000 字）あたりの数の上限。1 つの文に 2 つ以上重ねたものは、どの段でも指摘する。
 levels: { strict: 3, normal: 6, relaxed: 12 }
 
 use_for: [business, blog, technical, legal, docs, academic, literature, speech]
+sources: [femmer-2017]
 
 group: wording
 summary:
@@ -52,5 +53,32 @@ not_flagged:
   ja: 逃げの表現が一つだけなら慎重さなので指しません。引用の中の逃げは、書き手ではなく話し手のものなので数えません。
   en: A single hedge is caution and is not reported. A hedge inside a quotation is the speaker's, not the writer's, and is not counted.
 level_meaning:
-  ja: 1000 語あたり {limit} 個まで（一文に重ねた逃げは、文書の長さによらず指摘）
-  en: up to {limit} per 1000 words (hedges stacked in one sentence are reported whatever the length)
+  ja: 1000 字あたり逃げの表現 {limit} 個まで（一文に重ねた逃げは、文書の長さによらず指摘）
+  en: up to {limit} hedges per 1000 words (hedges stacked in one sentence are reported whatever the length)
+rewrite:
+  ja:
+    direction: 重ねた逃げは一つだけ残すか、確かめたことなら全部外して言い切ってください。言い切れないなら、何が分かれば言い切れるかを書きます。
+    pairs:
+      - before: 遅延の原因はキャッシュにある可能性があるかもしれません。
+        after: 遅延の原因はキャッシュかもしれません。
+      - before: この方法で改善できる場合もあると考えられるのではないでしょうか。
+        after: この方法で改善できる場合があります。
+    keep:
+      - 書き手が確かめていないことの推量
+      - 根拠の強さ
+    avoid:
+      - 確かめていないことを言い切りにする
+      - 推量を作った数字（「8 割の確率で」）に替える
+  en:
+    direction: Where hedges are stacked, keep one, or drop them all and commit if the point was checked. Where you cannot commit, say what would settle it.
+    pairs:
+      - before: The delay may possibly be caused by the cache.
+        after: The delay may be caused by the cache.
+      - before: It could perhaps be argued that this approach might help in some cases.
+        after: This approach helps in some cases.
+    keep:
+      - doubt about what the writer has not checked
+      - how strong the evidence is
+    avoid:
+      - committing to something nobody checked
+      - turning a hedge into an invented figure ("80% likely")

package/rules/fullwidth-alnum-consistency.yaml

@@ -0,0 +1,53 @@
+id: fullwidth-alnum-consistency
+layer: L3
+status: experimental
+how_to_find: fullwidth-alnum
+languages: [ja]
+severity: warning
+
+name:
+  ja: 英数字の全角と半角が混ざっている
+  en: Full-width and half-width letters and digits are mixed
+
+why:
+  ja: 英字と数字を全角（ＡＢＣ１２３）で書くか半角（ABC123）で書くかは、どちらでも読めます。困るのは一つの文書の中で混ざることで、検索で別の語になり、貼り付けた文がそこだけ違って見えます。chaff はどちらが正しいかを決めず、英字一字・英字の語・数字一字・数字の並びの組ごとに、文書の中で少ないほうを指摘します（「１桁は全角、２桁以上は半角」と決めている文書は組の中でそろっています）。少ないほうが組の三分の一を超える文書は、使い分けている（数え方の語だけ全角にする、など）と見て言いません。鉤括弧で引いたもの、項目と注の番号（「１．」「（１）」「※１」）、箇条書きの頭の番号、注の番号で始まる行と URL を含む文、日本語の中の英文は数えません。
+  en: Whether Japanese text writes letters and digits full-width (ＡＢＣ１２３) or half-width (ABC123) is a choice either way. What reads badly is mixing both in one document, which makes search treat them as different words and makes a pasted sentence stand out. chaff does not decide which is right; for single letters, words, single digits and longer numbers separately, it points at whichever the document uses less (a document that writes one-digit numbers full-width and longer ones half-width is consistent within each group). It says nothing when the minority is more than a third of its group, since the document then uses the two on purpose (full-width only for counters, for example). Quotations in brackets, item and note numbers (１．, （１）, ※１), a number at the head of a list item, a sentence that starts with a note number or holds a URL, and English sentences inside Japanese text are not counted.
+
+message:
+  ja: 「{written}」と書いています（ほかは「{other}」の書き方。{of} 箇所のうち {count} 箇所が違う）
+  en: '"{written}" here, where the document usually writes "{other}" ({count} of {of})'
+
+messages:
+  fullwidth:
+    ja: 全角の「{written}」と書いています（この文書はふつう半角の「{other}」。{of} 箇所のうち {count} 箇所が違う）
+    en: 'Full-width "{written}" here, where the document usually writes half-width "{other}" ({count} of {of})'
+  halfwidth:
+    ja: 半角の「{written}」と書いています（この文書はふつう全角の「{other}」。{of} 箇所のうち {count} 箇所が違う）
+    en: 'Half-width "{written}" here, where the document usually writes full-width "{other}" ({count} of {of})'
+
+how_to_fix:
+  ja: 文書の多いほうの書き方に合わせてください。チームで決めているなら、STYLE.md に書いておくと迷いません。
+  en: Match the way the rest of the document does it. If the team has decided, write it in the style guide.
+
+# 少ないほうが組の何パーセントまでなら「混ざっている」と見るか。これを超えたら、文書が使い分けている。
+levels: { strict: 49, normal: 34, relaxed: 20 }
+
+use_for: [business, technical, blog, legal, docs, academic, literature, speech]
+
+group: consistency
+summary:
+  ja: 英字や数字を、全角（ＡＢＣ１２３）と半角（ABC123）で混ぜて書いている所
+  en: Letters and digits written both full-width (ＡＢＣ１２３) and half-width (ABC123) in one Japanese document
+example:
+  ja:
+    before: |
+      申込は2024年4月10日までです。説明会は2024年4月3日と２０２４年４月５日に開きます。
+    after: |
+      申込は2024年4月10日までです。説明会は2024年4月3日と2024年4月5日に開きます。
+
+not_flagged:
+  ja: 鉤括弧で引いたもの、項目と注の番号（「１．」「（１）」「※１」）、箇条書きの頭の番号、版の番号の続き（TLS1.2 の 2）、注や URL を含む文は数えません。英字一字・英字の語・数字一字・数字の並びは別々に比べるので、「１桁は全角、２桁以上は半角」はそろっていると見ます。どちらの書き方が正しいかは決めません。
+  en: Quotations in brackets, item and note numbers (１．, （１）, ※１), a number at the head of a list item, the rest of a version number (the 2 of TLS1.2), and notes or sentences with a URL are not counted. Single letters, words, single digits and longer numbers are compared separately, so "one digit full-width, more digits half-width" counts as consistent. Neither way is called right.
+level_meaning:
+  ja: 少ないほうが組の {limit}% 以下のとき指摘
+  en: reported when the minority form is {limit}% of its group or less

package/rules/hankaku-kana.yaml

@@ -0,0 +1,41 @@
+id: hankaku-kana
+layer: L1
+status: experimental
+how_to_find: hankaku-kana
+languages: [ja]
+severity: warning
+
+name:
+  ja: 半角の片仮名がある
+  en: Half-width katakana
+
+why:
+  ja: 「ｱｲｳ」のような半角の片仮名は、古い機械やシステムから貼り付けたときに残る書き方です。全角の「アイウ」と同じ語でも検索で別の語になり、読み上げや字幅もそろいません。半角の句読点・鉤括弧・中黒（｡｢｣､･）も同じです。コードとリンクの中、鉤括弧や引用符で引いた名前（画面に出る表示をそのまま引いたもの）は数えません。
+  en: Half-width katakana such as "ｱｲｳ" is left over from text pasted out of an old system. It is the same word as the full-width "アイウ" but a search treats it as a different one, and a screen reader and the character widths do not match. Half-width Japanese punctuation, brackets and the middle dot (｡｢｣､･) are the same. Code, link text and a name quoted in brackets or quotation marks (a label copied from a screen) are not counted.
+
+message:
+  ja: 半角の片仮名「{kana}」があります（全角は「{fullwidth}」）
+  en: 'Half-width katakana "{kana}" (full-width: "{fullwidth}")'
+
+how_to_fix:
+  ja: 全角の片仮名に直してください。システムの表示をそのまま引くなら、鉤括弧で囲んでください。
+  en: Write it in full-width katakana. If it quotes a system's display as it is, put it in brackets.
+
+levels: { strict: error, normal: warning, relaxed: info }
+
+use_for: [business, technical, blog, legal, docs, academic, literature, speech]
+
+group: slips
+summary:
+  ja: 「ｱｲｳ」のような半角の片仮名と、半角の句読点・鉤括弧・中黒
+  en: Half-width katakana such as "ｱｲｳ", and half-width Japanese punctuation
+example:
+  ja:
+    before: |
+      申込書はﾒｰﾙで送ってください。
+    after: |
+      申込書はメールで送ってください。
+
+not_flagged:
+  ja: コードとリンクの中、鉤括弧や引用符で引いた名前（「ｶﾅ表示」のような画面の表示）は数えません。
+  en: Code, link text and a name quoted in brackets or quotation marks (a screen label such as 「ｶﾅ表示」) are not counted.

package/rules/image-alt-text.yaml

@@ -1,6 +1,6 @@
 id: image-alt-text
 layer: L1
-status: experimental
+status: stable
 how_to_find: image-alt-text
 requires: [markdown]
 severity: warning

package/rules/invisible-character.yaml

@@ -0,0 +1,63 @@
+id: invisible-character
+layer: L1
+status: experimental
+how_to_find: invisible-character
+severity: warning
+
+name:
+  ja: 見えない字がある
+  en: Invisible character
+
+why:
+  ja: ゼロ幅の空白、途中に残った BOM、任意の改行位置の印（ソフトハイフン）、文字の向きの指定、制御文字は、画面では見えないまま本文に残ります。Web ページや PDF から貼り付けると入り、検索に当たらない語、押しても開かない URL、動かないコマンドの原因になります。向きの指定や、字の後ろに隠したタグ文字は、読み手に見える文と機械が読む文を食い違わせることにも使えるので、安全のための目印でもあります。見出しや箇条の印の後ろのノーブレークスペースは印を印でなくし、日本語の隣のノーブレークスペースは貼り付けの名残です。コードの中も数えます（コピーしたコマンドが動かなくなるため）。絵文字をつなぐ接合子、アラビア文字やインドの文字の接合子、右から左に書く文字の隣の向きの印と分離の印、地域の旗のタグ文字、字に一つ付いた異体字の指定は書き方の一部なので数えません。向きを強制する印（LRO・RLO）は、どこにあっても指摘します。
+  en: A zero-width space, a byte order mark left mid-text, a soft hyphen, a direction mark and a control character stay in the text without showing on screen. They come in with text pasted from a web page or a PDF, and make a word that search does not find, a URL that does not open and a command that does not run. Direction marks and tag characters hidden after a letter can also make what a reader sees differ from what a machine reads, so they are a safety signal too. A no-break space after a heading or list marker stops the marker from working, and one next to Japanese text is left over from a paste. Code is checked too, since a copied command stops working. A joiner inside an emoji or in Arabic or Indic script, a direction mark or isolate next to right-to-left text, the tag characters of a regional flag and a single variation selector after a character are part of the writing and are not counted. A direction override (LRO, RLO) is always reported.
+
+message:
+  ja: 見えない字（{code}）があります
+  en: "Invisible character ({code})"
+
+messages:
+  zero-width:
+    ja: ゼロ幅の字（{code}）が {count} 字あります。検索やコピーで語が切れます
+    en: "{count} zero-width {count|character|characters} ({code}): search and copy break the word here"
+  soft-hyphen:
+    ja: 見えないソフトハイフン（{code}）が {count} 字あります。検索で語が切れます
+    en: "{count} soft {count|hyphen|hyphens} ({code}): search breaks the word here"
+  direction:
+    ja: 文字の向きの指定（{code}）が {count} 字あります。見える順と読まれる順が食い違うことがあります
+    en: "{count} direction {count|mark|marks} ({code}): the order a reader sees can differ from the order a machine reads"
+  control:
+    ja: 制御文字（{code}）が {count} 字あります
+    en: "{count} control {count|character|characters} ({code})"
+  hidden:
+    ja: 字の後ろに隠れた印（{code}）が {count} 字あります。読み手に見えない文を運べます
+    en: "{count} hidden {count|tag|tags} ({code}) after a character: they can carry text a reader cannot see"
+  nbsp:
+    ja: 普通の空白の所にノーブレークスペース（{code}）があります
+    en: "A no-break space ({code}) where an ordinary space belongs"
+
+how_to_fix:
+  ja: 見えない字を消してください。ノーブレークスペースは普通の空白にしてください。エディタの「不可視文字を表示」で場所が見えます。
+  en: Delete the invisible character, and replace a no-break space with an ordinary space. An editor's "show invisibles" setting shows where they are.
+
+levels: { strict: error, normal: warning, relaxed: info }
+
+use_for: [business, technical, blog, legal, docs, academic, literature, speech]
+
+group: slips
+summary:
+  ja: ゼロ幅の空白、途中の BOM、ソフトハイフン、文字の向きの指定、制御文字、隠れたタグ文字のような、画面に出ない字
+  en: Characters that do not show on screen, such as a zero-width space, a stray byte order mark, a soft hyphen, a direction mark or hidden tag characters
+example:
+  ja:
+    before: "申込書は\u200B総務課へ送ってください。\n"
+    after: |
+      申込書は総務課へ送ってください。
+  en:
+    before: "Send the form to the\u200B office.\n"
+    after: |
+      Send the form to the office.
+
+not_flagged:
+  ja: 絵文字をつなぐ接合子、アラビア文字やインドの文字の接合子、右から左に書く文字の隣の向きの印、地域の旗のタグ文字、字に一つ付いた異体字の指定、ファイルの頭の BOM、英文の語と語のあいだのノーブレークスペースは指しません。
+  en: A joiner inside an emoji or in Arabic or Indic script, a direction mark next to right-to-left text, the tag characters of a regional flag, a single variation selector after a character, a byte order mark at the start of the file and a no-break space between English words are not reported.

package/rules/katakana-long-vowel.yaml

@@ -14,8 +14,8 @@ name:
   en: The final ー of katakana words is inconsistent
 
 why:
-  ja: 「コンピューター」と「コンピュータ」のように、カタカナ語の語末の「ー」は付ける書き方と省く書き方があります。どちらも正しく、困るのは一つの文書の中で混ざることです。読み手は別のものかと迷い、検索でも片方を取りこぼします。設定が無ければ、同じ語が両方で書かれた所だけを指摘し、違う語どうし（サーバーとブラウザ）は比べません。options の ending を drop か keep にすると、決めた書き方に合わない語をすべて指摘します。音は「コ・ン・ピュ・ー・タ・ー」で 6 音と数えます（小さい「ャュョァィゥェォ」は前の字と合わせて 1 音、「ッ」「ン」「ー」は 1 音ずつ）。辞書が固有名詞と知っている語（ディズニー）と、chaff.yaml の names に並べた名前は見ません。
-  en: A katakana loanword can be written with or without its final long-vowel mark (コンピューター / コンピュータ). Both are right; what reads badly is mixing them in one document, which makes a reader wonder whether they differ and makes a search miss one. With no setting chaff points only at a word written both ways, and does not compare different words (サーバー and ブラウザ). Setting ending under options to drop or keep points at every word written the other way. Morae are counted as コ・ン・ピュ・ー・タ・ー, six (a small ャュョァィゥェォ joins the kana before it; ッ, ン and ー are one each). Words the dictionary knows as proper nouns (ディズニー) and the names under names in chaff.yaml are left alone.
+  ja: 「コンピューター」と「コンピュータ」のように、カタカナ語の語末の「ー」は付ける書き方と省く書き方があります。どちらも正しく、困るのは一つの文書の中で混ざることです。読み手は別のものかと迷い、検索でも片方を取りこぼします。設定が無ければ、同じ語が両方で書かれた所だけを指摘し、違う語どうし（サーバーとブラウザ）は比べません。options の ending を drop か keep にすると、決めた書き方に合わない語をすべて指摘します。音は語末の「ー」を除いて「コ・ン・ピュ・ー・タ」で 5 音と数えます（小さい「ャュョァィゥェォ」は前の字と合わせて 1 音、「ッ」「ン」と語中の「ー」は 1 音ずつ。JIS Z 8301:2011 表 G.3 の数え方）。辞書が固有名詞と知っている語（ディズニー）と、chaff.yaml の names に並べた名前は見ません。
+  en: A katakana loanword can be written with or without its final long-vowel mark (コンピューター / コンピュータ). Both are right; what reads badly is mixing them in one document, which makes a reader wonder whether they differ and makes a search miss one. With no setting chaff points only at a word written both ways, and does not compare different words (サーバー and ブラウザ). Setting ending under options to drop or keep points at every word written the other way. Morae are counted before the final ー, as コ・ン・ピュ・ー・タ, five (a small ャュョァィゥェォ joins the kana before it; ッ, ン and a ー inside the word are one each), as JIS Z 8301:2011 Table G.3 counts. Words the dictionary knows as proper nouns (ディズニー) and the names under names in chaff.yaml are left alone.
 
 message:
   ja: 「{matched}」は語末の「ー」がほかと違います（「{preferred}」）
@@ -59,17 +59,17 @@ options:
         ja: 決めない。文書の中でそろっているかだけを見る
         en: No side taken; only checks that the document is consistent
       drop:
-        ja: min_morae 音以上の語の語末の「ー」を省く（電子情報通信学会、JIS Z 8301:2011 まで）
-        en: Drop the final ー on words of min_morae morae or more (IEICE; JIS Z 8301 up to 2011)
+        ja: min_morae 音以上の語の、英語の -er、-or、-ar に当たる語末の「ー」（ア段の字の後ろ）を省く（電子情報通信学会、JIS Z 8301:2011 まで）
+        en: Drop the final ー that stands for English -er, -or, -ar (after a kana of the ア row) on words of min_morae morae or more (IEICE; JIS Z 8301 up to 2011)
       keep:
         ja: 語末の「ー」を付ける（文化庁「外来語の表記」、JIS Z 8301:2019）。「ー」の無い語は、辞書が「ー」付きで知っている語（メモリ）か、文書がほかで「ー」付きで書く語だけを見る
         en: Keep the final ー (the Agency for Cultural Affairs' 外来語の表記; JIS Z 8301:2019). A word without one is checked only when the dictionary knows it with one (メモリ) or the document writes it with one elsewhere
   min_morae:
     kind: count
-    default: 3
+    default: 2
     about:
-      ja: 何音以上の語を見るか。語末の「ー」も 1 音と数える（コンピューターは 6 音、カーは 2 音）
-      en: The shortest word checked, in morae, counting the final ー (コンピューター is six, カー two)
+      ja: 何音以上の語を見るか。語末の「ー」は数えない（コンピューターは 5 音、カバーは 2 音、カーは 1 音）
+      en: The shortest word checked, in morae before the final ー (コンピューター is five, カバー two, カー one)
   except:
     kind: words
     default: []
@@ -78,6 +78,7 @@ options:
       en: Words left alone; listing either way of writing one exempts both
 
 use_for: [business, blog, technical, legal, docs, academic, literature, speech]
+sources: [koyobun-2022, gairaigo-1991, jis-z8301-2019, jtf-style-guide]
 
 group: consistency
 summary:
@@ -91,8 +92,8 @@ example:
       新しいコンピューターを買いました。古いコンピューターは来月捨てます。
 
 not_flagged:
-  ja: 違う語どうし（サーバーとブラウザ）は比べません。2 音の語（カー）、辞書が固有名詞と知っている語、chaff.yaml の names に並べた名前も見ません。
-  en: Different words (サーバー and ブラウザ) are not compared. Two-mora words (カー), words the dictionary knows as proper nouns and the names under names in chaff.yaml are left alone.
+  ja: 違う語どうし（サーバーとブラウザ）は比べません。「ー」の前が 1 音の語（カー）、辞書が固有名詞と知っている語、chaff.yaml の names に並べた名前も見ません。「ー」を付けると別の語になる語（知ってるフリ／フリー、タブ／タブー、ベタ／ベター）は、語彙表 long-vowel-distinct に並べたものを同じ語として比べず、keep でも「ー」を足させません。drop は ュー・エー・イーなどで終わる語（メニュー、グレー、コピー）を見ません。
+  en: Different words (サーバー and ブラウザ) are not compared. Words of one mora before the final ー (カー), words the dictionary knows as proper nouns and the names under names in chaff.yaml are left alone. A word that becomes another word with a final ー (フリ and フリー, タブ (tab) and タブー (taboo), ベタ and ベター) is not compared, nor asked for a ー by keep, when it is in the long-vowel-distinct word list. drop leaves words ending in ュー, エー, イー and the like alone (メニュー, グレー, コピー).
 level_meaning:
   ja: 違う書き方の語が {limit} 箇所あれば指摘
   en: reported once {limit} words go the other way

package/rules/latin-spacing.yaml

@@ -9,20 +9,26 @@ uses: [pos]
 # 番地（千代田区紀尾井町1-3）を、都道府県までの地名の後ろの範囲（東京都2-3 営業日）と分ける。
 # 日付・時刻（9月、2026年、令和8年、10時5分）を、長さ（3ヶ月、3 時間）と分ける。
 # 番号と組んで名前を付ける語（問3、第1節）を見分ける。
-extra_word_lists: [prefecture-unit, date-time-unit, calendar-unit, calendar-year-unit, calendar-era, numbered-label]
+extra_word_lists: [prefecture-unit, date-time-unit, calendar-unit, calendar-year-unit, calendar-era, numbered-label, item-number]
 
 name:
   ja: 英数字の前後の空白がそろっていない
   en: Spacing around Latin text is inconsistent
 
 why:
-  ja: 日本語と英字・数字のあいだを空けるか詰めるかは、どちらでも読めます。困るのは一つの文書の中で混ざることで、読み手には違いに意味があるように見えます。chaff はどちらが正しいかを決めず、文書の中で少ないほうを指摘します。英字と、数字の前、数字の後ろは別々に数えます。「を 3回」のように、数字の前は空けて助数詞とは詰める書き方がふつうにあるからです。「3GBの」のように数字に続く単位は、英字ではなく数字の側として数えます。逆に「H30 等」「EC2 で」「Phase 1 は」のように英字で始まって数字で終わる名前は、英字の側として数えます。「073-489-5909」「2026-06-02」のような番号は数量ではないので数えません。日付・時刻（「9月」「2026年」「令和8年」「10月1日」「3時」「10時5分」）も、数と単位を詰めて書く決まりなので、その中の境目も、前の境目（「は 9月」「午後3時」）も数えません。長さ（「3ヶ月」「3 時間」「5日で」「3年」）は数量として数えます。題や注の番号として書かれた数（「3.1 リサーチの原則」の節番号、※1 の注番号、行の頭に続き番号で並べた注の番号、番号が増えていく箇条書きの頭の番号、「問3」「図2」のように語のすぐ後ろに書いた番号）、0 で始まる組を含む番号（102-0094）、〒の後ろの郵便番号（〒100-8916）、市・区・町まで下りた地名のすぐ後ろの番地（千代田区紀尾井町1-3）も、後ろの空白が番号と題・項目の区切りなので数えません。「第1節 AI の…」の「第1節」の後ろの空白も同じです。鉤括弧（「」『』）で引いた題名や発言の中も、空け方は引いた元のものなので数えません。
-  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 a date or a time written with units (9月, 2026年, 令和8年, 10月1日, 3時, 10時5分), which is packed by convention; neither its inside nor the space before it (は 9月, 午後3時) 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, numbers opening the items of a list that go up, a number written right after a word such as 問 or 図), 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. The same goes for the space after a division such as 第1節. Nor is the spacing inside a title or a quotation in 「」 or 『』, which is the source's, not the writer's.
+  ja: 日本語と英字・数字のあいだを空けるか詰めるかは、どちらでも読めます。困るのは一つの文書の中で混ざることで、読み手には違いに意味があるように見えます。chaff はどちらが正しいかを決めず、文書の中で少ないほうを指摘します。英字と、数字の前、数字の後ろは別々に数えます。「を 3回」のように、数字の前は空けて助数詞とは詰める書き方がふつうにあるからです。「3GBの」のように数字に続く単位は、英字ではなく数字の側として数えます。逆に「H30 等」「EC2 で」「Phase 1 は」のように英字で始まって数字で終わる名前は、英字の側として数えます。「073-489-5909」「2026-06-02」のような番号や、「1.0.0」のような版番号は数量ではないので数えません。日付・時刻（「9月」「2026年」「令和8年」「10月1日」「3時」「10時5分」）も、数と単位を詰めて書く決まりなので、その中の境目も、前の境目（「は 9月」「午後3時」）も数えません。長さ（「3ヶ月」「3 時間」「5日で」「3年」）は数量として数えます。題や注の番号として書かれた数（「3.1 リサーチの原則」の節番号、※1 の注番号、行の頭に続き番号で並べた注の番号、番号が増えていく箇条書きの頭の番号、「問3」「図2」のように語のすぐ後ろに書いた番号）、0 で始まる組を含む番号（102-0094）、〒の後ろの郵便番号（〒100-8916）、市・区・町まで下りた地名のすぐ後ろの番地（千代田区紀尾井町1-3）も、後ろの空白が番号と題・項目の区切りなので数えません。「第1節 AI の…」の「第1節」の後ろの空白も同じです。鉤括弧（「」『』）で引いた題名や発言の中も、リンクの文字の中も、空け方は引いた元のものなので数えません。
+  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, a date or a version (073-489-5909, 2026-06-02, 1.0.0) is not a quantity and is not counted. Nor is a date or a time written with units (9月, 2026年, 令和8年, 10月1日, 3時, 10時5分), which is packed by convention; neither its inside nor the space before it (は 9月, 午後3時) 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, numbers opening the items of a list that go up, a number written right after a word such as 問 or 図), 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. The same goes for the space after a division such as 第1節. Nor is the spacing inside a title or a quotation in 「」 or 『』, or inside the text of a link, which is the source's, not the writer's.
 
 message:
   ja: "日本語と{kind}のあいだを{style}（この文書はふつう{usual}。{of} 箇所のうち {count} 箇所が違う）"
   en: "Spacing between Japanese and {kind} differs here ({count} of {of})"
 
+# 少ないほうが 5 箇所以上で、全体の 2 割を超えるとき。書き損じではなく書き方が二通りあるので、1 件にまとめて両方の数を言う。
+messages:
+  mixed:
+    ja: "日本語と{kind}のあいだを、空ける所が {spaced} 箇所、詰める所が {touching} 箇所あります。この文書には書き方が二通りあります"
+    en: "Spacing between Japanese and {kind} is done two ways in this document ({spaced} spaced, {touching} not)"
+
 how_to_fix:
   ja: 文書の多いほうの書き方に合わせてください。チームで決めているなら、STYLE.md に書いておくと迷いません。
   en: Match the way the rest of the document does it. If the team has decided, write it in the style guide.
@@ -31,6 +37,7 @@ how_to_fix:
 levels: { strict: 1, normal: 1, relaxed: 3 }
 
 use_for: [business, blog, technical, legal, docs, academic, literature, speech]
+sources: [koyobun-2022, jtf-style-guide]
 
 group: consistency
 summary:
@@ -44,8 +51,8 @@ example:
       表は Excel で作り、Word に貼ります。図は PowerPoint で描きます。最後に PDF にします。
 
 not_flagged:
-  ja: 電話番号や日付のような番号、単位つきの日付や時刻（9月、10時5分）、見出しの番号、「」の中は数えません。どちらの空け方が正しいかは決めません。
-  en: Codes such as phone numbers and dates, dates and times with units (9月, 10時5分), heading numbers and quotations are not counted. Neither way is called right.
+  ja: 電話番号や日付のような番号、版番号（1.0.0）、単位つきの日付や時刻（9月、10時5分）、見出しの番号、行の頭の項目の番号（「一 JIS…」の一、イ）の後ろ、「」の中、リンクの文字の中は数えません。どちらの空け方が正しいかは決めません。少ないほうが全体の 2 割を超えるほど多ければ（5 箇所以上）、1 箇所ずつではなく、書き方が二通りあることを 1 件で言います。
+  en: Codes such as phone numbers, dates and version numbers (1.0.0), dates and times with units (9月, 10時5分), heading numbers, the space after an item number at the head of a line (一 JIS…), quotations and the text of links are not counted. Neither way is called right. When the less common way is more than a fifth of the places (and at least five), it is reported once, as a document written two ways, rather than place by place.
 level_meaning:
   ja: 少ないほうの空け方が {limit} 箇所あれば指摘
   en: reported once {limit} places go against the document's habit

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/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