chaffjs 0.18.0 → 0.20.0

package/rules/heading-numbering-mix.yaml

@@ -0,0 +1,140 @@
+id: heading-numbering-mix
+layer: L1
+status: experimental
+how_to_find: heading-numbering
+requires: [markdown]
+severity: warning
+
+name:
+  ja: 見出しの番号の付け方が揃っていない
+  en: Heading numbering mixed
+
+why:
+  ja: 「1. 概要」「2. 手順」と番号を付けた見出しの隣に番号の無い「まとめ」があったり、「1.」「2.」の隣に「3）」や「第4章」があったりすると、読み手は番号の無い見出しが別の扱いなのか、番号が抜けたのか迷います。目次や参照（「3 章で述べた」）とも合わなくなります。どちらの付け方が正しいかは決めず、同じ親の下の同じ深さの見出し（兄弟）のうち少ないほうを指します。番号を持つ語（第1章、Chapter 1）と、番号を付けないのがふつうの前後の見出し（目次、参考文献）は言語ごとの語彙表にあります。
+  en: A numbered "1. Overview" and "2. Steps" next to an unnumbered "Summary", or "1." and "2." next to "3)" or "Chapter 4", leave the reader unsure whether the odd one is meant to be different or lost its number, and the numbers stop matching the table of contents and cross-references. chaff does not pick a style; among headings with the same parent and depth (siblings) it points at the minority. Words that carry a number (Chapter 1, 第1章) and front and back matter that is never numbered (Contents, References) are in each language's lexicon.
+
+message:
+  ja: 見出し「{heading}」の番号の付け方が、兄弟の見出し（「{example}」など {count} 個）と違います
+  en: 'The heading "{heading}" is numbered differently from its siblings ("{example}" and {count} in all)'
+messages:
+  unnumbered:
+    ja: 見出し「{heading}」だけ番号がありません（兄弟の見出しは「{example}」など {count} 個が番号付き）
+    en: 'The heading "{heading}" has no number, while {count} of its siblings do ("{example}")'
+  numbered:
+    ja: 見出し「{heading}」だけ番号があります（兄弟の見出しは「{example}」など {count} 個が番号なし）
+    en: 'The heading "{heading}" is numbered, while {count} of its siblings are not ("{example}")'
+  style:
+    ja: 見出し「{heading}」の番号の書き方が、兄弟の見出し（「{example}」など {count} 個）と違います
+    en: 'The heading "{heading}" writes its number differently from {count} of its siblings ("{example}")'
+
+how_to_fix:
+  ja: 兄弟の見出しで番号の付け方を揃えてください。番号の無い見出しを本文の外に置くつもりなら、親を分けてください。
+  en: Number sibling headings the same way. If the unnumbered one is meant to sit outside the numbered body, give it a different parent.
+
+placeholders:
+  heading:
+    ja: 見出し
+    en: the heading
+  example:
+    ja: 兄弟の見出し
+    en: a sibling
+  count:
+    ja: 〇
+    en: N
+
+levels: { strict: error, normal: warning, relaxed: info }
+
+use_for: [business, technical, blog, legal, docs, academic, literature, speech]
+
+group: structure
+summary:
+  ja: 「1. 概要」「2. 手順」「まとめ」や「1.」「2.」「3）」のように、兄弟の見出しで番号の付け方が混ざっている所
+  en: Sibling headings numbered in mixed ways, such as "1. Overview", "2. Steps", "Summary"
+example:
+  ja:
+    before: |
+      # 報告
+
+      ## 1. 概要
+
+      概要です。
+
+      ## 2. 手順
+
+      手順です。
+
+      ## まとめ
+
+      まとめです。
+    after: |
+      # 報告
+
+      ## 1. 概要
+
+      概要です。
+
+      ## 2. 手順
+
+      手順です。
+
+      ## 3. まとめ
+
+      まとめです。
+  en:
+    before: |
+      # Report
+
+      ## 1. Overview
+
+      The overview.
+
+      ## 2. Steps
+
+      The steps.
+
+      ## Summary
+
+      The summary.
+    after: |
+      # Report
+
+      ## 1. Overview
+
+      The overview.
+
+      ## 2. Steps
+
+      The steps.
+
+      ## 3. Summary
+
+      The summary.
+
+not_flagged:
+  ja: 兄弟が三つ未満の所、少ないほうと多いほうが同じ数の所、深さや親の違う見出しどうし（「1.」の下の「1.1」）は比べません。前後の見出し（目次、参考文献、付録）は兄弟に数えません。見出しの頭の数でも、区切りの記号の無い数（「2026年の計画」「3つの理由」）は番号と読みません。
+  en: Fewer than three siblings, a tie between the two sides, and headings at different depths or under different parents ("1." and "1.1") are not compared. Front and back matter (Contents, References, Appendix) is not counted among the siblings. A number at the head of a heading without a separator ("2026 roadmap", "3 reasons") is not read as a heading number.
+rewrite:
+  ja:
+    direction: 兄弟の見出しで、多いほうの番号の付け方に揃えてください。番号の無い見出しに番号を足すか、番号の書き方（1. と 1））を一つにします。見出しの言葉は変えません。
+    pairs:
+      - before: 「## 1. 概要」「## 2. 手順」「## まとめ」
+        after: 「## 1. 概要」「## 2. 手順」「## 3. まとめ」
+      - before: 「## 1. 背景」「## 2. 方針」「## 3）課題」
+        after: 「## 1. 背景」「## 2. 方針」「## 3. 課題」
+    keep:
+      - 見出しの言葉と順番
+      - 見出しの深さ
+    avoid:
+      - 番号を付けない見出しを本文の中に残したまま、ほかの見出しの番号を外す
+  en:
+    direction: Number the sibling headings the way most of them are numbered. Add the missing number, or write every number in one style ("1." or "1)"). Keep the heading text.
+    pairs:
+      - before: '"## 1. Overview", "## 2. Steps", "## Summary"'
+        after: '"## 1. Overview", "## 2. Steps", "## 3. Summary"'
+      - before: '"## 1. Background", "## 2. Plan", "## 3) Risks"'
+        after: '"## 1. Background", "## 2. Plan", "## 3. Risks"'
+    keep:
+      - the heading text and order
+      - the heading depth
+    avoid:
+      - stripping the numbers from the other headings to match the odd one

package/rules/homophone-slip.yaml

@@ -0,0 +1,58 @@
+id: homophone-slip
+layer: L2
+status: experimental
+how_to_find: phrase-match
+word_list: homophone-slip
+requires: [pos]
+languages: [en]
+severity: warning
+
+name:
+  ja: 取り違えた同音語（its / it's、their / there）
+  en: Homophone typed for another (its / it's, their / there)
+
+why:
+  ja: 英語の「its」と「it's」、「their」と「there」と「they're」は音が同じで、打ち間違えても綴りの点検では見つかりません。chaff は、次の語で意味が一つに決まる組だけを見ます（「it's own」は「its own」しかなく、「their are」は「there are」しかない）。次の語で決まらない組（its time、they're people）は見ません。組は言語ごとの語彙表にあります。
+  en: '"Its" and "it''s", "their", "there" and "they''re" sound alike, and a spell checker passes either. chaff looks only at pairs where the next word settles which was meant: "it''s own" can only be "its own", "their are" can only be "there are". Pairs the next word does not settle ("its time", "they''re people") are not checked. The pairs are listed in the lexicon.'
+
+message:
+  ja: 「{matched}」は、取り違えた同音語です
+  en: '"{matched}" has one homophone typed for another'
+
+how_to_fix:
+  ja: 意図した語に直してください（it's own → its own、their are → there are、could of → could have）。
+  en: Use the word you meant ("it's own" → "its own", "their are" → "there are", "could of" → "could have").
+
+levels: { strict: 1, normal: 1, relaxed: 2 }
+
+use_for: [business, technical, blog, legal, docs, academic, literature, speech]
+
+group: slips
+summary:
+  ja: 英語で、「it's own」「their are」のように、次の語から見て取り違えたと決まる同音語
+  en: '"It''s own", "their are" and other homophones the next word shows were typed for another'
+example:
+  en:
+    before: |
+      The team kept it's own schedule. Their are two reviews left.
+    after: |
+      The team kept its own schedule. There are two reviews left.
+
+not_flagged:
+  ja: 一覧にある組だけを見ます。英語の文書だけで動きます。次の語で決まらない「its time」「they're people」は見ません。小説と話し言葉では使いません（方言や話しぶりをわざと綴るため）。
+  en: Only the pairs on chaff's list are checked, and only in English documents. Pairs the next word does not settle ("its time", "they're people") are not. Not used in fiction or speeches, which spell dialect on purpose.
+level_meaning:
+  ja: 取り違えが {limit} 箇所あれば指摘
+  en: reported once there are {limit}
+rewrite:
+  en:
+    direction: Correct only the confused word, to the form the lexicon gives.
+    pairs:
+      - before: The service restarts on it's own.
+        after: The service restarts on its own.
+      - before: Their are three open tickets.
+        after: There are three open tickets.
+    keep:
+      - every other word in the sentence
+    avoid:
+      - rewriting the sentence while correcting the word

package/rules/idiom-misuse.yaml

@@ -0,0 +1,60 @@
+id: idiom-misuse
+layer: L3
+status: experimental
+how_to_find: misuse-match
+word_list: idiom-misuse
+uses: [pos]
+languages: [ja]
+severity: warning
+
+name:
+  ja: 慣用句の誤用
+  en: Misused Japanese idiom
+
+why:
+  ja: 「的を得る」「汚名挽回」のように、二つの慣用句が混ざった形や、語を取り違えた形です。意味は通じても、読み手には言葉を知らない書き手に見え、文書全体が信用されにくくなります。
+  en: A Japanese idiom with a word swapped or two idioms blended (的を得る for 的を射る). The meaning comes through, but the reader takes the writer for careless, and trusts the rest less.
+
+message:
+  ja: 「{matched}」は誤用とされる形です。「{correct}」と書きます
+  en: '"{matched}" is the misused form; the idiom is "{correct}"'
+
+how_to_fix:
+  ja: 正しい形に直してください。「的を得た意見」は「的を射た意見」です。
+  en: Write the established form. 的を得た意見 becomes 的を射た意見.
+
+levels: { strict: 1, normal: 1, relaxed: 2 }
+
+use_for: [blog, business, legal, docs, academic, literature, speech]
+
+group: wording
+summary:
+  ja: 「的を得る」「汚名挽回」のように、取り違えたと決まっている慣用句
+  en: A Japanese idiom in a form dictionaries and style guides list as a mistake (的を得る for 的を射る)
+example:
+  ja:
+    before: 課長の指摘は的を得ていました。
+    after: 課長の指摘は的を射ていました。
+
+not_flagged:
+  ja: 一覧にある形だけを見ます。辞書によって認め方が分かれる形（「押しも押されもしない」）は載せていません。小説の台詞のように、わざと崩した言い方があるので、文学のジャンルでは見ません。
+  en: Only the forms on chaff's list are checked. Forms dictionaries disagree on are not listed. Literature does not run this rule, since dialogue may misuse an idiom on purpose.
+level_meaning:
+  ja: 当てはまる形が {limit} 箇所あれば指摘
+  en: reported once there are {limit}
+rewrite:
+  ja:
+    direction: 指摘された慣用句を、指摘が示す正しい形に置き換えてください。活用（得た→射た）と前後の語はそのまま残します。
+    pairs:
+      - before: 課長の指摘は的を得ていました。
+        after: 課長の指摘は的を射ていました。
+      - before: 次の大会で汚名挽回を狙います。
+        after: 次の大会で汚名返上を狙います。
+      - before: 油断して足元をすくわれた。
+        after: 油断して足をすくわれた。
+    keep:
+      - 文の意味と、慣用句の活用の形
+      - 引用の中の言葉（人の発言をそのまま写した所）
+    avoid:
+      - 慣用句を消して、平らな言い方に書き換える
+      - 正しい形の候補が二つあるとき（汚名返上と名誉挽回）、文の意味に合わないほうを選ぶ

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-density.yaml

@@ -0,0 +1,93 @@
+id: katakana-density
+layer: L3
+status: experimental
+how_to_find: katakana-density
+# Katakana runs are read from the characters, so the rule needs no morphology. chaff.yaml の names に並べた名前は数えない。
+languages: [ja]
+severity: info
+
+name:
+  ja: カタカナ語が多い
+  en: Too many katakana loanwords
+
+why:
+  ja: 「アジェンダ」「エビデンス」「コンセンサス」のようなカタカナ語が続くと、その言葉に慣れない読み手は意味を追えなくなります。書いた人には普段の言葉なので、多さに気づきにくいところです。
+  en: A run of katakana loanwords (アジェンダ, エビデンス, コンセンサス) loses readers who do not use those words every day. To the writer they are ordinary, so the density goes unnoticed.
+
+message:
+  ja: カタカナ語が 1000 字あたり {density} 語あります（{limit} 語まで）。多いのは「{words}」です
+  en: "{density} katakana loanwords per 1000 characters (limit {limit}); the most used: {words}"
+
+how_to_fix:
+  ja: 日本語で言える語から言い換えてください（アジェンダ→議題、エビデンス→根拠）。製品名や、読み手が使っている用語はそのままでかまいません。
+  en: Replace the ones that have a plain Japanese word (議題 for アジェンダ, 根拠 for エビデンス). Product names and terms the readers use themselves can stay.
+
+# 1000 字あたりの語の数。2022 年より前の Qiita の日本語記事（人が書いた技術記事）で測った分布の上の方に置く。
+# 測り方は PR に残した（数字はここに書かない）。
+levels: { strict: 45, normal: 55, relaxed: 65 }
+
+use_for: [blog, business, legal, docs, academic, literature, speech]
+
+group: wording
+summary:
+  ja: 「アジェンダ」「エビデンス」のようなカタカナ語が、人の書いた技術記事より多い文書
+  en: A Japanese document with more katakana loanwords per 1000 characters than human-written technical articles
+example:
+  ja:
+    before: |
+      今回のアジェンダは、プロジェクトのスコープとスケジュールのレビューです。エビデンスをベースにコンセンサスを取り、ネクストアクションをアサインします。
+
+      クライアントのニーズをヒアリングし、ソリューションのコンセプトをブラッシュアップします。リソースのアロケーションはマネージャーがジャッジします。
+
+      タスクのプライオリティをアップデートし、マイルストーンのリスクをシェアします。フィードバックはチャットでリマインドします。
+
+      ステークホルダーとのミーティングでは、KPI のトレンドをダッシュボードでモニタリングします。ボトルネックはチームでブレインストーミングします。
+
+      ナレッジのドキュメントはテンプレートでフォーマットをアラインし、オンボーディングのマニュアルにマージします。
+
+      パートナーとのアライアンスでは、コストとベネフィットのバランスをシミュレーションします。
+
+      プロセスのボトルネックをアナリティクスでビジュアライズし、オペレーションのコンプライアンスをチェックします。
+
+      カスタマーサクセスのメンバーは、ユーザーのインサイトをインタビューでキャッチアップします。
+
+      セールスのパイプラインは、ウィークリーのレポートでマネジメントにエスカレーションします。
+    after: |
+      今回の議題は、計画の範囲と日程の見直しです。根拠をもとに合意を取り、次にすることの担当を決めます。
+
+      お客様の求めることを聞き取り、解決策の考え方を磨きます。人と予算の割り振りは課長が決めます。
+
+      仕事の優先順位を改め、節目ごとの危うさを伝え合います。意見は連絡用の画面で念を押します。
+
+      関係する部署との会議では、目標の数字の動きを一覧の画面で見守ります。つかえている所は皆で案を出し合います。
+
+      知っていることの記録は、決まった型で書き方を揃え、新しく来た人向けの手引きにまとめます。
+
+      取引先と手を組むときは、かかる費用と得られるものの釣り合いを試算します。
+
+      仕事の流れでつかえている所を数字で見えるようにし、決まりどおりに進んでいるかを確かめます。
+
+      お客様を支える係の人は、使う人の本音を聞き取りで拾い上げます。
+
+      営業の見込みの一覧は、毎週の報告で上の人に上げます。
+
+not_flagged:
+  ja: 短い文書は測りません。コードの中の語と、chaff.yaml の names に並べた名前は数えません。製品名も外来語と区別できないので数えますが、上限は人の書いた技術記事の多さに合わせてあり、普通の技術文書はたいてい収まります。
+  en: Short documents are not measured. Words in code and the names listed in chaff.yaml are not counted. Product names are counted, as they cannot be told apart, but the limit sits above most human-written technical articles.
+level_meaning:
+  ja: カタカナ語が 1000 字あたり {limit} 語まで
+  en: "katakana loanwords: up to {limit} per 1000 characters"
+rewrite:
+  ja:
+    direction: 多いと示されたカタカナ語から、日本語で言えるものを言い換えてください。読み手が毎日使う用語と製品名は残します。
+    pairs:
+      - before: 今回のアジェンダは、スケジュールのレビューです。
+        after: 今回の議題は、日程の見直しです。
+      - before: エビデンスをベースにコンセンサスを取ります。
+        after: 根拠をもとに合意を取ります。
+    keep:
+      - 製品名・サービス名・人名
+      - 読み手が使っている技術用語（サーバー、ブラウザ）
+    avoid:
+      - 日本語にすると意味がずれる語まで言い換える
+      - カタカナ語を漢語の硬い言葉に置き換えて、かえって読みにくくする

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/known-misspelling.yaml

@@ -0,0 +1,76 @@
+id: known-misspelling
+layer: L2
+status: experimental
+how_to_find: known-correction
+word_list: known-misspelling
+uses: [pos]
+severity: warning
+
+name:
+  ja: よくある書き誤り
+  en: Common misspelling
+
+why:
+  ja: 「シュミレーション」「コミニュケーション」「ふいんき」「とゆう」のように、耳で覚えた形や打ち間違いのまま残りやすい語があります。読み手は誤りに気づくと、ほかの所の正しさまで疑います。誤った形と正しい形の組は言語ごとの語彙表にあり、chaff は語彙表にある形だけを指します。語の途中には当てません（「ですすべて」の「ですす」は指しません）。
+  en: Some words are easy to misspell by ear or by habit ("definately", "seperate", "recieve"). A reader who notices one starts to doubt the rest of the document. The pairs of misspelling and spelling are in each language's lexicon, and chaff reports only the forms listed there. A form inside a longer word is not reported ("teh" in "Tehran").
+
+message:
+  ja: 「{matched}」は「{suggestion}」の書き誤りです
+  en: '"{matched}" is a misspelling of "{suggestion}"'
+
+how_to_fix:
+  ja: 正しい形に直してください。固有名詞としてその字で書いているなら、chaff.yaml の names に足すと指さなくなります。
+  en: Correct the spelling. If the word is a name spelled that way on purpose, add it to names in chaff.yaml.
+
+placeholders:
+  matched:
+    ja: 書いた語
+    en: the word as written
+  suggestion:
+    ja: 正しい形
+    en: the spelling
+
+levels: { strict: error, normal: warning, relaxed: info }
+
+use_for: [blog, business, technical, legal, docs, academic, literature, speech]
+
+group: slips
+summary:
+  ja: 「シュミレーション」「コミニュケーション」「ふいんき」のような、よくある書き誤り
+  en: A common misspelling, such as "definately" or "seperate"
+example:
+  ja:
+    before: 来週、シュミレーションの結果を共有します。
+    after: 来週、シミュレーションの結果を共有します。
+  en:
+    before: The two reports are seperate documents.
+    after: The two reports are separate documents.
+
+not_flagged:
+  ja: 語彙表にない誤りは指しません。どちらも使われる書き方（コンピュータ／コンピューター、エンターテイメント／エンターテインメント）は誤りとせず、表記ゆれの rule に任せます。語の途中の同じ字の並び（「ですすべて」）と、チームが names に並べた語は指しません。
+  en: Misspellings not in the lexicon are not reported. Spellings that are both in use (British and American, judgement and judgment) are left to the consistency rules. A form inside a longer word ("teh" in "Tehran") and words listed under names in chaff.yaml are not reported.
+rewrite:
+  ja:
+    direction: 指された語を語彙表の正しい形に直してください。直すのはその語だけで、文の言い回しは変えません。
+    pairs:
+      - before: シュミレーションの結果を共有します。
+        after: シミュレーションの結果を共有します。
+      - before: 以下のとうり、手順を変えました。
+        after: 以下のとおり、手順を変えました。
+    keep:
+      - 文の言い回しと語順
+      - 固有名詞としてその字で書いた名前
+    avoid:
+      - 指された語の近くの言い回しまで書き換える
+  en:
+    direction: Replace the flagged word with the spelling the lexicon gives. Change only that word.
+    pairs:
+      - before: The two reports are seperate documents.
+        after: The two reports are separate documents.
+      - before: We will definately ship on Friday.
+        after: We will definitely ship on Friday.
+    keep:
+      - the wording around the word
+      - a name that is spelled that way on purpose
+    avoid:
+      - rewording the sentence while fixing the spelling

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