chaffjs 0.19.0 → 0.21.0

package/rules/known-misspelling.yaml

@@ -0,0 +1,77 @@
+id: known-misspelling
+layer: L2
+status: stable
+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:
+  depth: light
+  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/kutoten-consistency.yaml

@@ -1,6 +1,6 @@
 id: kutoten-consistency
 layer: L3
-status: experimental
+status: stable
 how_to_find: kutoten-consistency
 languages: [ja]
 severity: warning

package/rules/latin-abbreviation-form.yaml

@@ -0,0 +1,58 @@
+id: latin-abbreviation-form
+layer: L1
+status: stable
+how_to_find: latin-abbreviation
+word_list: latin-abbreviation
+languages: [en]
+severity: info
+
+name:
+  ja: e.g. と i.e. のピリオドの欠け
+  en: e.g. or i.e. missing a period
+
+why:
+  ja: 英語の「e.g.」「i.e.」は、ピリオドを全部付けるか（e.g.）、全部落とすか（eg、イギリスの官公庁の書き方）のどちらかです。一部だけ付けた「e.g」「eg.」は書き損じに見えます。略語は言語ごとの語彙表にあります。
+  en: '"e.g." and "i.e." take all their periods ("e.g.") or none ("eg", as GOV.UK writes it). With only some ("e.g", "eg.") they read as a slip. The abbreviations are listed in the lexicon.'
+
+message:
+  ja: 「{matched}」はピリオドが一部だけです
+  en: '"{matched}" has some of its periods but not all'
+
+how_to_fix:
+  ja: ピリオドを全部付けるか（e.g.）、全部落としてください（eg）。文書の中でほかに使っている形に合わせます。
+  en: Write all the periods ("e.g.") or none ("eg"), as the rest of the document does.
+
+levels: { strict: 1, normal: 1, relaxed: 2 }
+
+use_for: [business, technical, blog, legal, docs, academic, literature, speech]
+
+group: slips
+summary:
+  ja: 英語で、「e.g」「eg.」のように、e.g. と i.e. のピリオドが一部だけの所
+  en: '"e.g" or "eg." for "e.g.", and the same for "i.e."'
+example:
+  en:
+    before: |
+      Bring a document, e.g a passport.
+    after: |
+      Bring a document, e.g. a passport.
+
+not_flagged:
+  ja: ピリオドを全部落とした「eg」「ie」は、一つの書き方なので指しません。
+  en: '"eg" and "ie" with no periods are a house style and are not reported.'
+level_meaning:
+  ja: "{limit} 箇所あれば指摘"
+  en: reported once there are {limit}
+rewrite:
+  depth: light
+  en:
+    direction: Write the abbreviation with all its periods, or with none if the rest of the document writes it that way.
+    pairs:
+      - before: Bring a document, e.g a passport.
+        after: Bring a document, e.g. a passport.
+      - before: Use the short form, ie. the one on the card.
+        after: Use the short form, i.e. the one on the card.
+    keep:
+      - the rest of the sentence
+    avoid:
+      - replacing the abbreviation with a phrase the sentence did not have

package/rules/latin-spacing.yaml

@@ -1,9 +1,9 @@
 id: latin-spacing
 layer: L3
-status: experimental
+status: stable
 how_to_find: latin-spacing
 languages: [ja]
-severity: warning
+severity: info
 # 番号・識別子として書かれた数を見分けるのに、数の後ろの語の品詞を使う。無ければ全部数える。
 uses: [pos]
 # 番地（千代田区紀尾井町1-3）を、都道府県までの地名の後ろの範囲（東京都2-3 営業日）と分ける。
@@ -36,6 +36,10 @@ how_to_fix:
 # 何箇所違えば指摘するか。1 は「1 箇所でも混ざっていれば」。
 levels: { strict: 1, normal: 1, relaxed: 3 }
 
+# 技術文書は、識別子やコマンド名の前後で空け方が揺れやすい。一箇所でも指すと group の文書の過半に出たので、測って上げた（spec §21.1）。
+by_genre:
+  technical: { strict: 1, normal: 2, relaxed: 4 }
+
 use_for: [business, blog, technical, legal, docs, academic, literature, speech]
 sources: [koyobun-2022, jtf-style-guide]
 

package/rules/link-text-url-mismatch.yaml

@@ -0,0 +1,72 @@
+id: link-text-url-mismatch
+layer: L1
+status: stable
+how_to_find: link-text-url-mismatch
+requires: [markdown]
+severity: warning
+
+name:
+  ja: リンクの言葉の URL と行き先が違う
+  en: Link text shows one address, the link goes to another
+
+why:
+  ja: 「[https://example.com/guide](https://other.example/page)」のように、リンクの言葉が URL で、その URL と実際の行き先のサイトが違うリンクです。読み手は見えている URL に行くつもりで押し、別のサイトに着きます。URL を書き換えたときに片方だけ直した跡であることが多く、なりすましの手口と同じ形でもあります。サイト（ホスト）が同じなら、短く見せた URL として指しません。
+  en: A link whose text is an address ("[https://example.com/guide](https://other.example/page)") that names a different site from where the link goes. The reader clicks expecting the address they see and lands somewhere else. It is usually what is left when a URL was changed in one place only, and it is also the shape phishing uses. When the site (host) is the same, a shortened display is not reported.
+
+message:
+  ja: リンクの言葉は「{shown}」ですが、行き先は「{target}」です
+  en: 'The link text shows "{shown}" but the link goes to "{target}"'
+
+how_to_fix:
+  ja: 言葉と行き先のどちらが正しいかを確かめ、もう一方を合わせてください。行き先の名前を言葉にすると、この食い違いは起きません（[導入の手引き](https://…)）。
+  en: Check which of the two is right and make the other match. Naming the target in words ("[the setup guide](https://…)") avoids the mismatch altogether.
+
+levels: { strict: error, normal: warning, relaxed: info }
+
+use_for: [business, technical, blog, legal, docs, academic, literature, speech]
+
+group: slips
+summary:
+  ja: 「[https://a.example](https://b.example)」のように、言葉に見える URL と行き先のサイトが違うリンク
+  en: A link whose text is a URL on one site and whose target is on another
+example:
+  ja:
+    before: |
+      新しい手引きは [https://docs.example.com/guide](https://old.example.net/guide) にあります。
+    after: |
+      新しい手引きは [https://docs.example.com/guide](https://docs.example.com/guide) にあります。
+  en:
+    before: |
+      The new guide is at [https://docs.example.com/guide](https://old.example.net/guide) now.
+    after: |
+      The new guide is at [https://docs.example.com/guide](https://docs.example.com/guide) now.
+
+not_flagged:
+  ja: 同じサイトの URL を短く見せたもの（[github.com/a](https://github.com/a/b)）、言葉が URL でないリンク、行き先が相対パスやページ内のリンク、参照の形のリンク（[言葉][1]）は指しません。www. の有無と大文字小文字は同じと読みます。
+  en: A shortened display of an address on the same site ("[github.com/a](https://github.com/a/b)"), link text that is not an address, relative or in-page targets, and reference-style links ("[text][1]") are not reported. "www." and letter case are ignored.
+rewrite:
+  depth: light
+  ja:
+    direction: リンクの言葉と行き先のうち、正しいほうにもう一方を合わせてください。どちらが正しいか文から分からなければ、変えずに書き手に確かめます。
+    pairs:
+      - before: 手引きは [https://docs.example.com/guide](https://old.example.net/guide) にあります。
+        after: 手引きは [https://docs.example.com/guide](https://docs.example.com/guide) にあります。
+      - before: 申込は [www.example.jp/apply](https://example.org/apply) から。
+        after: 申込は [www.example.jp/apply](https://www.example.jp/apply) から。
+    keep:
+      - 文の言っていること
+      - 正しいほうの URL
+    avoid:
+      - どちらが正しいかを推し量って、両方を三つ目の URL に変える
+  en:
+    direction: Make the link text and the target agree, keeping whichever is right. If the text does not say which, leave it and ask the writer.
+    pairs:
+      - before: The guide is at [https://docs.example.com/guide](https://old.example.net/guide) now.
+        after: The guide is at [https://docs.example.com/guide](https://docs.example.com/guide) now.
+      - before: Apply at [www.example.com/apply](https://example.org/apply) today.
+        after: Apply at [www.example.com/apply](https://www.example.com/apply) today.
+    keep:
+      - what the sentence says
+      - the address that is right
+    avoid:
+      - guessing and changing both to a third address

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

@@ -0,0 +1,140 @@
+id: list-item-form-mix
+layer: L2
+status: stable
+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]
+off_for:
+  legal: "An enumeration of conditions mixes 〜こと and 〜とき by what each condition is."
+  literature: "Length, rhythm, repetition and register are the author's choices in literature, and dialogue mixes styles. Only what one work can hold itself to runs: consistent spacing and commas, and numbering without gaps."
+  speech: "A speech opens with greetings and closes with thanks: that is its form, not padding."
+  business/meeting-notes: "Minutes jot points down as they come: a noun, a remark, a decision, side by side."
+
+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:
+  depth: light
+  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

@@ -1,6 +1,6 @@
 id: max-kanji-continuous
 layer: L3
-status: experimental
+status: stable
 how_to_find: kanji-run
 # 品詞があれば、住所（地名と数だけでできた連なり）と 1 つの名前（辞書の固有名詞 1 語、人の姓と名）を数えない。無くても文字だけで動く。
 uses: [pos]
@@ -8,7 +8,7 @@ uses: [pos]
 # 住所の先頭にしか来ない単位（都道府県）。地名の後ろに付けば、割られた町名ではなく地名の並び。
 extra_word_lists: [prefecture-unit]
 languages: [ja]
-severity: warning
+severity: info
 
 name:
   ja: 漢字が続きすぎている
@@ -28,7 +28,15 @@ how_to_fix:
 
 levels: { strict: 6, normal: 8, relaxed: 12 }
 
+# ビジネス文書、特にお知らせは、組織名や制度名を漢字のまま並べる。既定の上限では group の文書の過半に出たので、測って上げた（spec §21.1）。
+by_genre:
+  business: { strict: 8, normal: 10, relaxed: 14 }
+
 use_for: [blog, business, technical, legal, docs, academic, literature, speech]
+off_for:
+  legal: "Legal drafting repeats its terms and its sentence heads on purpose, puts the actor in the passive (shall be deemed), and joins long noun compounds (個人情報取扱事業者). This rule would only flag the form."
+  literature: "Length, rhythm, repetition and register are the author's choices in literature, and dialogue mixes styles. Only what one work can hold itself to runs: consistent spacing and commas, and numbering without gaps."
+  speech/transcript: "A transcript records what was said: its sentences, repeats and register are the speaker's, not the writer's to fix."
 sources: [shibasaki-tamaoka-2010, lee-2016]
 
 group: readability

package/rules/max-paragraph-length.yaml

@@ -2,7 +2,7 @@ id: max-paragraph-length
 layer: L1
 status: stable
 how_to_find: paragraph-length
-severity: warning
+severity: info
 
 name:
   ja: 段落が長すぎる
@@ -37,6 +37,9 @@ by_genre:
   academic: { strict: 5, normal: 9, relaxed: 12 }
 
 use_for: [blog, business, technical, legal, docs, academic, literature, speech]
+off_for:
+  literature: "Length, rhythm, repetition and register are the author's choices in literature, and dialogue mixes styles. Only what one work can hold itself to runs: consistent spacing and commas, and numbering without gaps."
+  speech/transcript: "A transcript records what was said: its sentences, repeats and register are the speaker's, not the writer's to fix."
 sources: [gov-uk-clear-language]
 
 group: readability

package/rules/max-sentence-length.yaml

@@ -2,7 +2,7 @@ id: max-sentence-length
 layer: L1
 status: stable
 how_to_find: sentence-length
-severity: warning
+severity: info
 
 name:
   ja: 一文が長すぎる
@@ -34,28 +34,31 @@ levels:
   ja: { strict: 70, normal: 100, relaxed: 140 }
   en: { strict: 18, normal: 25, relaxed: 35 }
 
-# ジャンルで読まれかたが違う。spec §9 の初期値。
-# 社内メールの 1 文と随筆の 1 文に同じ上限を課すと、どちらかが必ず間違う。
+# ジャンルで読まれかたが違う。社内メールの 1 文と随筆の 1 文に同じ上限を課すと、どちらかが必ず間違う。
+# 技術文書・ブログ・ビジネス文書・説明書の normal は、人の書いた文書で測って置いた（spec §21.1、yarn rules:measure）。
+# 既定の上限では group の文書の大半に出て、group ごと止まっていた。いまは過半を十分下回るが、info で出る線は超える。
 by_genre:
+  technical:
+    ja: { strict: 100, normal: 140, relaxed: 180 }
+    en: { strict: 30, normal: 40, relaxed: 50 }
+  blog:
+    ja: { strict: 120, normal: 160, relaxed: 200 }
+    en: { strict: 30, normal: 40, relaxed: 50 }
+  blog/essay:
+    ja: { strict: 140, normal: 180, relaxed: 220 }
+    en: { strict: 35, normal: 45, relaxed: 55 }
+  business:
+    ja: { strict: 100, normal: 140, relaxed: 180 }
+    en: { strict: 35, normal: 45, relaxed: 55 }
+  # メールは短く書く。spec §9 の初期値のまま、他のビジネス文書より上限を低く置く。
   business/email:
     ja: { strict: 50, normal: 70, relaxed: 100 }
     en: { strict: 12, normal: 18, relaxed: 25 }
-  business/meeting-notes:
-    ja: { strict: 60, normal: 80, relaxed: 110 }
-    en: { strict: 14, normal: 20, relaxed: 28 }
-  business/proposal:
-    ja: { strict: 65, normal: 90, relaxed: 125 }
-    en: { strict: 16, normal: 22, relaxed: 30 }
-  business/press-release:
-    ja: { strict: 65, normal: 90, relaxed: 125 }
-    en: { strict: 16, normal: 22, relaxed: 30 }
-  blog/essay:
+  docs:
     ja: { strict: 100, normal: 140, relaxed: 180 }
-    en: { strict: 25, normal: 35, relaxed: 45 }
-  blog/owned-media:
-    ja: { strict: 65, normal: 90, relaxed: 125 }
-    en: { strict: 16, normal: 22, relaxed: 30 }
+    en: { strict: 30, normal: 40, relaxed: 50 }
   # 法令・契約・判決・論文は、長い一文がその種類の書き方。corpus のその種類の文書で、normal が最も長い一握りの文だけを指すように測って置いた。
+  # 法務は、この上限でも文書の過半に出るので既定では動かない（genres.yaml）。
   legal:
     ja: { strict: 120, normal: 200, relaxed: 300 }
     en: { strict: 40, normal: 60, relaxed: 80 }
@@ -65,14 +68,18 @@ by_genre:
   legal/judgment:
     ja: { strict: 250, normal: 350, relaxed: 450 }
   # 英語の定義は、限定を重ねた名詞句の一文になる。英語の用語集で測り、normal が列挙を詰めた定義や長い注記だけを指すように置いた。
-  # 日本語は既定の上限のままで、すでに最も長い一握りだけを指していた。
+  # 日本語は説明書の上限のまま。
   docs/glossary:
-    en: { strict: 30, normal: 40, relaxed: 50 }
+    en: { strict: 40, normal: 50, relaxed: 60 }
   academic:
     ja: { strict: 100, normal: 140, relaxed: 180 }
     en: { strict: 35, normal: 50, relaxed: 65 }
 
 use_for: [blog, business, technical, legal, docs, academic, literature, speech]
+off_for:
+  literature: "Length, rhythm, repetition and register are the author's choices in literature, and dialogue mixes styles. Only what one work can hold itself to runs: consistent spacing and commas, and numbering without gaps."
+  speech/transcript: "A transcript records what was said: its sentences, repeats and register are the speaker's, not the writer's to fix."
+  legal: measured by yarn rules:measure
 sources: [shibasaki-tamaoka-2010, yasashii-nihongo-2020, koyobun-2022, gov-uk-clear-language]
 
 group: readability
@@ -82,9 +89,9 @@ summary:
 example:
   ja:
     before: |
-      新しい料金体系は先週の会議で営業部から提案があったもので来月から試験的に導入することになりましたが、既存の顧客への説明のしかたと請求システムを直す時期がまだ決まっていないため、担当者を決めたうえで今週中に進め方を相談したいと考えています。
+      新しい料金体系は先週の会議で営業部から提案があったもので来月から試験的に導入することになりましたが、既存の顧客への説明のしかたと請求システムを直す時期がまだ決まっておらず、社内の手引きを書き直す人もまだ決まっていないため、担当者を決めたうえで今週中に進め方を相談したいと考えています。
     after: |
-      新しい料金体系を、来月から試験的に導入します。既存の顧客への説明のしかたと、請求システムを直す時期はまだ決まっていません。今週中に担当者を決め、進め方を相談します。
+      新しい料金体系を、来月から試験的に導入します。既存の顧客への説明のしかたと、請求システムを直す時期はまだ決まっていません。社内の手引きを書き直す人も未定です。今週中に担当者を決め、進め方を相談します。
   en:
     before: |
       The new pricing, which the sales team proposed at last week's meeting, will be trialled from next month, but because we have not yet decided how to explain it to existing customers or when to change the billing system, we would like to agree on a plan this week.
@@ -98,6 +105,7 @@ level_meaning:
   ja: 一文 {limit} 字まで
   en: up to {limit} words in a sentence
 rewrite:
+  depth: light
   ja:
     direction: 接続助詞（〜が、〜ので、〜し）か「、そして」の所で二文に割り、二文目にも主語を書いてください。
     pairs:

package/rules/max-ten.yaml

@@ -0,0 +1,62 @@
+id: max-ten
+layer: L3
+status: stable
+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]
+off_for:
+  legal: measured by yarn rules:measure
+
+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:
+  depth: light
+  ja:
+    direction: 読点の多い文を、意味の切れ目で二つ以上の文に分けてください。読点を消すだけにはしません。
+    pairs:
+      - before: 担当者が、会議室で、新人に、資料を、配布し、内容を、丁寧に、説明しました。
+        after: 担当者が会議室で新人に資料を配布しました。続けて、内容を丁寧に説明しました。
+      - before: 申請が遅れた場合は、窓口に、電話で、理由を、伝え、指示を、受けてから、書類を、送ってください。
+        after: 申請が遅れた場合は、窓口に電話で理由を伝えてください。指示を受けてから書類を送ってください。
+    keep:
+      - 文が言っている事柄と、その順序
+    avoid:
+      - 読点を消すだけで、長い一文のまま残す
+      - 事柄を足したり落としたりする

package/rules/misconversion.yaml

@@ -0,0 +1,62 @@
+id: misconversion
+layer: L2
+status: stable
+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:
+  depth: light
+  ja:
+    direction: 指された語を正しい字に直してください。直すのは取り違えた語だけで、文の言い回しは変えません。
+    pairs:
+      - before: 設定は以外と簡単でした。
+        after: 設定は意外と簡単でした。
+      - before: 始めて会う人にも分かるように書きます。
+        after: 初めて会う人にも分かるように書きます。
+    keep:
+      - 文の言い回しと語順
+    avoid:
+      - 前後で決まらない同音の語まで書き換える