chaffjs 0.27.1 → 0.29.0

package/rules/obligation-without-deadline.yaml

@@ -0,0 +1,95 @@
+id: obligation-without-deadline
+layer: L2
+status: stable
+how_to_find: obligation-without-deadline
+severity: info
+
+name:
+  ja: 時を決めてする義務に、期限が無い
+  en: A duty to act with no deadline (shall pay, shall return)
+
+why:
+  ja: 支払う、引き渡す、返還する、通知するといった義務は、いつまでにするかが決まって初めて、守ったか破ったかを決められます。期限の無い「甲は、委託料を支払う」では、一年後に払っても違反と言えません。期限をどう書くかは書き手が決めることなので、chaff は、ほかの義務の多くに期限（7日以内に、毎月末日までに）を書いた文書の中で、期限を一つも書いていない義務（語の一覧は言語ごとの語彙表にあります）を少ないほうとして指します。期限を書いた文が、期限の無い義務の文より多いときだけです。
+  en: 'A duty to pay, deliver, return or notify can be met or missed only once it has a time. "The Customer shall pay the fees" with no time is not breached by paying a year later. How to write limits is the drafter''s choice, so chaff points only at the minority: in a document where more sentences state a limit (within seven days, by the fifth business day) than hold a duty with none, it points at those duties (each language''s word list has the acts read).'
+
+message:
+  ja: 「{word}」義務に期限がありません。いつまでにするかを書くと、守ったかどうかを決められます
+  en: '"{word}" is a duty with no deadline; a time makes it one that can be met or missed'
+
+how_to_fix:
+  ja: 「解除の日から30日以内に」「毎月末日までに」のように、起点と日数か日付で期限を書いてください。
+  en: 'State when the act is due: a start and a number of days ("within thirty days of termination") or a date ("by the fifth business day of each month").'
+
+levels: { strict: warning, normal: info, relaxed: info }
+
+use_for: [legal, docs, academic, literature, speech]
+off_for:
+  docs: "A deadline is a contract's obligation: the contract genre checks it."
+  academic: "A deadline is a contract's obligation: the contract genre checks it."
+  literature: "A deadline is a contract's obligation: the contract genre checks it."
+  speech: "A deadline is a contract's obligation: the contract genre checks it."
+  legal/statute: "A statute sets duties whose time other provisions or regulations fix; a bare 支払う there is not a missing term."
+  legal/judgment: "A court decision quotes the statutes and contracts it reads; their duties are not the decision's own."
+  legal/patent: "A patent sets no deadlines: return and deliver describe steps of a process."
+
+group: wording
+summary:
+  ja: ほかの義務に期限を書いた契約で、支払う・引き渡す・返還する・通知する義務に期限を書いていない所
+  en: A duty to pay, deliver, return or notify with no deadline, in a contract that gives its other duties one
+example:
+  ja:
+    config: { genre: legal/contract }
+    before: |
+      第1条　乙は、毎月5日までに、前月の業務を甲に報告する。
+
+      第2条　甲は、報告を受けた日から10日以内に、結果を乙に通知する。
+
+      第3条　甲は、本契約が解除されたときは、解除の日までの委託料を乙に支払う。
+    after: |
+      第1条　乙は、毎月5日までに、前月の業務を甲に報告する。
+
+      第2条　甲は、報告を受けた日から10日以内に、結果を乙に通知する。
+
+      第3条　甲は、本契約が解除されたときは、解除の日から30日以内に、解除の日までの委託料を乙に支払う。
+  en:
+    config: { genre: legal/contract }
+    before: |
+      1. The Supplier shall deliver each report by the fifth business day of the month.
+
+      2. The Customer shall pay each invoice within thirty days of receiving it.
+
+      3. On termination, the Supplier shall return all Confidential Information to the Customer.
+    after: |
+      1. The Supplier shall deliver each report by the fifth business day of the month.
+
+      2. The Customer shall pay each invoice within thirty days of receiving it.
+
+      3. On termination, the Supplier shall return all Confidential Information to the Customer within ten days.
+
+not_flagged:
+  ja: 期限を書いた文が、期限の無い義務の文より多くない文書では、書き手がそう書くと決めたとみなして指しません。同じ文に期限（7日以内、毎月末日までに、直ちに）があれば指しません。「速やかに」「遅滞なく」だけの期限は vague-deadline が見ます。権利を定める文（「返還を請求することができる」）と、金額を書いた文（「月額150,000円を支払う」は値段を決める文で、いつ払うかは別の条が決めます）は見ません。義務は文の終わりの述語で読み、条件の中の語（「通知したときは」）は見ません。法令・判決・特許は見ません。契約書・規約のジャンルで見ます。
+  en: 'A document where sentences stating a limit are not more than those holding a duty with none is taken to write its duties that way on purpose, and is not reported. A sentence that states a limit (within seven days, by the fifth business day, immediately) is not reported; one with "promptly" alone is vague-deadline''s. A sentence that grants a right (may) or states an amount (shall pay a monthly fee of $9,000, which sets the price; another clause says when) is not read. "by email" says how, not when, and is not a limit. Statutes, court decisions and patents are not read; the contract genre runs this rule.'
+rewrite:
+  depth: light
+  ja:
+    direction: 義務の文に、起点と日数か日付で期限を加えます。日数は書き手が決めることなので、決まっていなければ書き手に確かめます。
+    pairs:
+      - before: 甲は、解除の日までの委託料を日割りで計算して支払う。
+        after: 甲は、解除の日までの委託料を日割りで計算し、解除の日から30日以内に支払う。
+      - before: 乙は、納入を受けたときは、検査を行い、その結果を甲に通知する。
+        after: 乙は、納入を受けた日から7日以内に検査を行い、その結果を甲に通知する。
+    keep:
+      - 義務を負う当事者と、すること
+    avoid:
+      - 日数を書き手に確かめずに決める
+  en:
+    direction: Add a time to the duty, as a start and a number of days or a date. The number is the writer's decision; if it is not known, ask.
+    pairs:
+      - before: On a written request, each Party shall return the other Party's Confidential Information.
+        after: Within fifteen days of a written request, each Party shall return the other Party's Confidential Information.
+      - before: The Company will notify you of any change to these Terms by email.
+        after: The Company will notify you of any change to these Terms by email at least thirty days before it takes effect.
+    keep:
+      - the party bound and what it must do
+    avoid:
+      - choosing the number of days without asking the writer

package/rules/one-sentence-paragraph-run.yaml

@@ -26,7 +26,6 @@ use_for: [business, technical, blog, legal, docs, academic, literature, speech]
 off_for:
   legal: "A clause, a definition or a claim is a paragraph of one sentence by form."
   literature: "Dialogue and verse set each line apart."
-  academic: measured by yarn rules:measure
 
 group: readability
 summary:
@@ -65,8 +64,8 @@ example:
       In the room, no food or drink is allowed. Put the desks back when you leave.
 
 not_flagged:
-  ja: 上限までの一文の段落、見出し・箇条書き・表・コードを挟んだ段落、改行一つでつないだ行は数えません。法務と文学のジャンルでは既定で止めています（条項や定義、台詞や詩の行は、一文ずつ立てるのが形のため）。
-  en: One-sentence paragraphs up to the limit, paragraphs separated by a heading, a list, a table or code, and lines joined by a single line break are not counted together. The legal and literature presets turn it off, since a clause, a definition, a line of dialogue or of verse stands alone by form.
+  ja: 上限までの一文の段落、見出し・箇条書き・表・コードを挟んだ段落、改行一つでつないだ行、文の終わりの印（。．.!?）で終わらない段落（「日時：」のような札、項目、平文にした表の欄）は数えません。法務と文学のジャンルでは既定で止めています（条項や定義、台詞や詩の行は、一文ずつ立てるのが形のため）。
+  en: One-sentence paragraphs up to the limit, paragraphs separated by a heading, a list, a table or code, lines joined by a single line break, and paragraphs that do not end with a sentence mark (a label such as Date:, a field, a cell of a table written as plain text) are not counted together. The legal and literature presets turn it off, since a clause, a definition, a line of dialogue or of verse stands alone by form.
 level_meaning:
   ja: 一文だけの段落の連続 {limit} 個まで
   en: up to {limit} one-sentence paragraphs in a row

package/rules/parameter-table-mismatch.yaml

@@ -0,0 +1,90 @@
+id: parameter-table-mismatch
+layer: L1
+status: stable
+how_to_find: parameter-table
+# The header words of a parameter table (Parameter, 引数) come from the parameter-header lexicon.
+requires: [markdown]
+severity: warning
+
+name:
+  ja: 引数の表とシグネチャが合わない
+  en: Parameter table that does not match the signature
+
+why:
+  ja: API リファレンスで、関数のシグネチャと、その下の引数の表が違う引数を並べていると、読み手はどちらが正しいか分からず、無い引数を渡したり、必要な引数を知らずに終わったりします。引数を足したり名前を変えたりしたときに、片方だけを直すと起きます。コードブロックがちょうど一つの関数を宣言し（function や def、または戻り値の型が付いたもの）、次の見出しかコードブロックより前に、最初の列の見出しが「引数」や「Parameter」の表があるとき、両者を比べます。表にだけある引数は表の行を、シグネチャにだけある引数はシグネチャを指します。
+  en: When an API reference's signature and the parameter table under it list different parameters, the reader cannot tell which is right, and passes a parameter that does not exist or never learns of one that does. It happens when a parameter is added or renamed in one place only. When a code block declares exactly one function (with function or def, or with a return type) and a table whose first header is Parameter or Argument follows it before the next heading or code block, the two are compared. A parameter only in the table is pointed out on its row, and one only in the signature on the signature.
+
+message:
+  ja: 「{function}」の引数の表とシグネチャで、「{name}」が片方にしかありません
+  en: "`{name}` is in only one of the signature of `{function}` and its parameter table"
+
+how_to_fix:
+  ja: 実際の関数の引数を確かめて、表かシグネチャのどちらかを直してください。
+  en: Check the function's real parameters, and correct the table or the signature.
+
+levels: { strict: error, normal: warning, relaxed: info }
+
+use_for: [technical, docs, blog, legal, academic, literature, speech]
+off_for:
+  legal: "Signatures and parameter tables belong to technical writing."
+  academic: "Signatures and parameter tables belong to technical writing."
+  literature: "Signatures and parameter tables belong to technical writing."
+  speech: "Signatures and parameter tables belong to technical writing."
+
+group: facts
+summary:
+  ja: API リファレンスで、引数の表とシグネチャの引数が食い違う所
+  en: A parameter in only one of a signature and the parameter table under it
+example:
+  ja:
+    config: { genre: technical/readme }
+    before: |
+      ## measure
+
+      ```ts
+      measure(text: string, tabSize = 4): number
+      ```
+
+      | 引数 | 型 | 説明 |
+      | --- | --- | --- |
+      | `text` | string | 幅を測る行 |
+      | `tabWidth` | number | タブ1つの幅 |
+    after: |
+      ## measure
+
+      ```ts
+      measure(text: string, tabSize = 4): number
+      ```
+
+      | 引数 | 型 | 説明 |
+      | --- | --- | --- |
+      | `text` | string | 幅を測る行 |
+      | `tabSize` | number | タブ1つの幅 |
+  en:
+    config: { genre: technical/readme }
+    before: |
+      ## measure
+
+      ```ts
+      measure(text: string, tabSize = 4): number
+      ```
+
+      | Parameter | Type | Description |
+      | --- | --- | --- |
+      | `text` | string | The line to measure |
+      | `tabWidth` | number | The width of one tab |
+    after: |
+      ## measure
+
+      ```ts
+      measure(text: string, tabSize = 4): number
+      ```
+
+      | Parameter | Type | Description |
+      | --- | --- | --- |
+      | `text` | string | The line to measure |
+      | `tabSize` | number | The width of one tab |
+
+not_flagged:
+  ja: 関数の呼び出し（wrap(text, 10);）、二つ以上の関数を宣言したコードブロック、分割代入の引数（{ a, b }）、self や this、最初の列の見出しが引数でない表（オプション、項目）、見出しやほかのコードブロックを挟んだ表、行の頭に | の無い表は比べません。型を名前の前に書く宣言（Java の String wrap(String text)）は読みません。表の「options.prefix」は options の項目として読みます。
+  en: "A call (wrap(text, 10);), a code block that declares two or more functions, a destructured parameter ({ a, b }), self and this, a table whose first header is not a parameter word (Option, Field), a table after another heading or code block, and a table whose rows do not start with | are not compared. A declaration with its types before the names (Java's String wrap(String text)) is not read. options.prefix in a table is read as a field of options."

package/rules/percent-sum-mismatch.yaml

@@ -10,8 +10,8 @@ name:
   en: Shares of a whole that do not add up to 100%
 
 why:
-  ja: 構成比や内訳の百分率を足して 100% にならないと、読み手はどの数字が違うのか、項目が抜けたのかを確かめることになります。項目を足したり消したり、数字を一つだけ直したりしたときに起きます。表のその列の見出しか、箇条書きや表のすぐ上の文・見出しに、全体を分けた割合の語（構成比、内訳、シェア）があるときだけ足します。一つの文に並べた内訳（「構成比は、Aが50%、Bが30%、Cが25%」）も、その文に割合の語があり百分率が三つ以上あれば足します。丸めの誤差は、項目ごとに最後の桁の半分まで（少なくとも 1 ポイント）認めます。
-  en: When the shares of a whole do not add up to 100%, the reader has to work out which figure is wrong or which item is missing. It happens when an item is added or removed, or when one figure is changed. The percentages are added only when the column's header, or the sentence or heading right above the list or the table, names the parts of a whole (breakdown, market share, composition). A breakdown written in one sentence ("software made up 50% of sales, maintenance 30% and training 25%") is added too, when the sentence has such a word and three or more percentages. Rounding is allowed, up to half the last digit per item (at least one point).
+  ja: 構成比や内訳の百分率を足して 100% にならないと、読み手はどの数字が違うのか、項目が抜けたのかを確かめることになります。項目を足したり消したり、数字を一つだけ直したりしたときに起きます。表のその列の見出しか、箇条書きや表のすぐ上の文・見出しに、全体を分けた割合の語（構成比、内訳、シェア）があるときだけ足します。表の列の見出しが「割合」「配点」「比率」「ウェイト」だけ（単位の括弧は除く）の列も、全体を分けた割合として足します。ただし表のすぐ上の文や見出し、または表の行が率（前年比、達成率、金利）を名指していれば足しません。一つの文に並べた内訳（「構成比は、Aが50%、Bが30%、Cが25%」）も、その文に割合の語があり百分率が三つ以上あれば足します。割合の語が無くても、最後の百分率が全体の残り（「その他が 5%」）なら、その文は一つの全体を分けたものとして足します。ただし、百分率のすぐ前後に値の動いた向きの語（伸びた、増加）がある文は変化を並べたものなので足しません。丸めの誤差は、項目ごとに最後の桁の半分まで（少なくとも 1 ポイント）認めます。
+  en: When the shares of a whole do not add up to 100%, the reader has to work out which figure is wrong or which item is missing. It happens when an item is added or removed, or when one figure is changed. The percentages are added only when the column's header, or the sentence or heading right above the list or the table, names the parts of a whole (breakdown, market share, composition). A column whose header is only "Weight", "Share", "Percentage" or "Proportion" (a unit in brackets aside) is added too, unless the sentence or heading right above the table, or one of its rows, names a rate (growth, interest rate, year over year). A breakdown written in one sentence ("software made up 50% of sales, maintenance 30% and training 25%") is added too, when the sentence has such a word and three or more percentages, or when its last percentage is the rest of the whole ("other 5%"), which only the parts of one whole have, unless a word for which way values moved stands right next to a percentage (grew 45%). Rounding is allowed, up to half the last digit per item (at least one point).
 
 message:
   ja: 内訳の割合の和が {sum} で、100% になりません

package/rules/phone-number-variant.yaml

@@ -0,0 +1,68 @@
+id: phone-number-variant
+layer: L3
+status: stable
+how_to_find: phone-number-variant
+word_list: phone-label
+# The labels (電話, Phone, FAX) and what each labels come from the language's phone-label lexicon; numbers after labels of
+# different kinds (a phone and a fax number) are never compared.
+languages: [ja, en]
+severity: warning
+
+name:
+  ja: 電話番号の数字の入れ違い
+  en: Phone number with two digits swapped
+
+why:
+  ja: 問合せ先の電話番号は、本文の上と下、申込先と問合せ先のように何度も書かれます。一か所だけ「0120-123-456」が「0120-123-465」になっていると、読み手はどちらが正しいか分からず、間違った方にかけることもあります。隣り合う二つの数字の入れ違いは、打ち間違いで最も多い形です。「電話」「TEL」のような同じ種類の語の後ろに書いた番号どうしを比べ、隣り合う二つの数字だけが入れ違った番号を指します。
+  en: 'A contact number is written more than once: at the top and the bottom, under "How to apply" and under "Contact". When one place reads 0120-123-465 for 0120-123-456, the reader cannot tell which is right and may call the wrong one. Two neighbouring digits swapped is the commonest slip in typing a number. chaff compares the numbers written after labels of the same kind (Phone, Tel, call) and reports one that is another with two neighbouring digits swapped.'
+
+message:
+  ja: 電話番号「{written}」は、「{other}」の隣り合う数字が入れ違っています
+  en: "The phone number {written} is {other} with two neighbouring digits swapped"
+
+how_to_fix:
+  ja: 正しい番号を確かめて、もう一方を直してください。
+  en: Check which number is right and correct the other.
+
+levels: { strict: error, normal: warning, relaxed: warning }
+
+use_for: [business, technical, blog, legal, docs, academic, literature, speech]
+off_for:
+  literature: A story's phone numbers are made up and need not agree; one may differ on purpose.
+  speech: A transcript writes what was said, numbers misspoken and corrected included.
+
+group: facts
+summary:
+  ja: 同じ文書で、電話番号の隣り合う数字が一か所だけ入れ違っている所（0120-123-456 と 0120-123-465）
+  en: One phone number written elsewhere with two neighbouring digits swapped (0120-123-456 and 0120-123-465)
+example:
+  ja:
+    before: |
+      # お知らせ
+
+      申込先　電話：0120-123-456
+
+      問合せ先　電話：0120-123-465
+    after: |
+      # お知らせ
+
+      申込先　電話：0120-123-456
+
+      問合せ先　電話：0120-123-456
+  en:
+    before: |
+      # Notice
+
+      To apply, phone: 0120-123-456
+
+      Contact, phone: 0120-123-465
+    after: |
+      # Notice
+
+      To apply, phone: 0120-123-456
+
+      Contact, phone: 0120-123-456
+
+not_flagged:
+  ja: 番号と同じ行で、前に「電話」「TEL」「お問合せ」のような語がある番号だけを読みます。語の無い数字の並び、種類の違う番号（電話とFAX）、数字が一つだけ違う番号（代表と直通、本店と支店の番号はよくそうなります）、離れた数字の入れ違いは指しません。数字が9桁から13桁で、ハイフンか括弧で区切ったものだけを番号と見ます。
+  en: "Only numbers with a label (phone, tel, call) before them on their line are read. Unlabelled runs of digits, numbers of different kinds (a phone and a fax number), numbers that differ in one digit (a main line and a direct line often do) and swaps of digits that are not neighbours are not reported. A number is 9 to 13 digits, grouped by hyphens or brackets."

package/rules/prerequisite-after-step.yaml

@@ -0,0 +1,78 @@
+id: prerequisite-after-step
+layer: L3
+status: stable
+how_to_find: prerequisite-order
+# The openers come from the language's prerequisite-opener lexicon; a procedure is a numbered list of three or more items.
+languages: [ja, en]
+severity: info
+
+name:
+  ja: 手順の後に書いた前提
+  en: Prerequisite written after the steps
+
+why:
+  ja: 「作業を始める前に、注文サービスを止めておきます。」が番号付きの手順の後にあると、読み手はそれを読む時には手順を終えています。前提・必要な権限・準備は、手順の前に書くものです。文を足したり節を並べ替えたりしたときに起きます。節の中で、番号付きの手順（三つ以上）より後に「作業を始める前に」「始める前に」で始まる文があるとき指します。
+  en: 'When "Before you begin, stop the order service." comes after the numbered steps, the reader has done the steps by the time they read it. Prerequisites, permissions and preparation go before the steps. It happens when a sentence is added at the end or sections are reordered. A sentence opening with "Before you begin" or "Before you start" after a numbered procedure (three steps or more) in the same section is reported.'
+
+message:
+  ja: 手順の前にするべきことを、手順の後に書いています
+  en: This prerequisite comes after the steps it applies to
+
+how_to_fix:
+  ja: この文を、手順の前（「始める前に」の節か、手順のすぐ上）に移してください。
+  en: Move the sentence before the steps, into a "Before you begin" section or right above the list.
+
+levels: { strict: warning, normal: info, relaxed: info }
+
+use_for: [technical, docs, blog, legal, academic, literature, speech]
+off_for:
+  legal: "Code blocks, shell prompts, command headings and numbered steps belong to technical writing."
+  academic: "Code blocks, shell prompts, command headings and numbered steps belong to technical writing."
+  literature: "Code blocks, shell prompts, command headings and numbered steps belong to technical writing."
+  speech: "Code blocks, shell prompts, command headings and numbered steps belong to technical writing."
+
+group: structure
+summary:
+  ja: 節の番号付きの手順より後にある、「作業を始める前に」「始める前に」で始まる文
+  en: A sentence opening with "Before you begin" after the numbered steps of its section
+example:
+  ja:
+    config: { genre: docs/manual }
+    before: |
+      # 復元する
+
+      1. コンソールを開きます。
+      2. バックアップを選びます。
+      3. ［復元を開始］を押します。
+
+      作業を始める前に、注文サービスを止めておきます。
+    after: |
+      # 復元する
+
+      作業を始める前に、注文サービスを止めておきます。
+
+      1. コンソールを開きます。
+      2. バックアップを選びます。
+      3. ［復元を開始］を押します。
+  en:
+    config: { genre: docs/manual }
+    before: |
+      # Restore
+
+      1. Open the console.
+      2. Select the backup.
+      3. Click **Start Restore**.
+
+      Before you begin, stop the order service.
+    after: |
+      # Restore
+
+      Before you begin, stop the order service.
+
+      1. Open the console.
+      2. Select the backup.
+      3. Click **Start Restore**.
+
+not_flagged:
+  ja: 番号付きの手順が三つ以上ある節の、その手順より後の文だけを読みます。手順の前にある前提、後の節の手順のための前提（その節の手順より前にあるもの）、「手順 4 の前に」のように一つの手順を名指す文、読点の続かない「始める前に戻すには」、引用やコードの中の手順は指しません。技術文書・手順書・ブログでだけ動きます。
+  en: 'Only sentences after a numbered procedure of three or more steps in the same section are read. A prerequisite before its steps, one for a later section''s steps (written before those steps), a sentence naming one step ("Before step 4, split the file" or "Before you begin step 3"), and a procedure in a block quote or a code block are not reported. Technical documents, manuals and blogs only.'

package/rules/quote-unnamed-speaker.yaml

@@ -0,0 +1,67 @@
+id: quote-unnamed-speaker
+layer: L2
+status: stable
+how_to_find: quote-unnamed-speaker
+word_list: unnamed-speaker
+# The roles (アナリスト, an analyst), the words that may follow a role at the head of the speaker's phrase, titles and the
+# words pointing back come from the language's unnamed-speaker word list; the words that give a quotation to someone from
+# quote-attribution.
+extra_word_lists: [quote-attribution]
+languages: [ja, en]
+severity: info
+
+name:
+  ja: 名前の無い話し手の言葉を引いている
+  en: A quotation given to a speaker with no name
+
+why:
+  ja: プレスリリースや報告書は、引いた言葉で主張を支えます。「業界のアナリストは『…』と述べています」の話し手が誰なのかが書かれていないと、読み手はその人に確かめることも、その人の立場を量ることもできません。書き手が自分の言いたいことを名前の無い誰かに言わせている、と読まれることもあります。chaff はその人が本当に言ったかを知りませんが、確かめる相手が書かれていないことは言えます。鉤括弧や引用符で引いた言葉のすぐ前かすぐ後ろに話し手が書かれていて、その話し手が「アナリスト」「関係者」のような役の語だけで、名前が無いときに指します（役の語の一覧は言語ごとの語彙表 unnamed-speaker にあります）。
+  en: 'Press releases and reports back their claims with quotations. When the speaker of "Few products do this," said an analyst is not named, the reader can neither check with that person nor weigh where they stand, and may read it as the writer''s own claim put in an unnamed mouth. chaff cannot know who said what, but it can say that nobody to check with is named. It points at a quotation in quotation marks whose speaker, right before or right after it, is only a role ("an analyst", "a source", "officials"; the roles are in each language''s unnamed-speaker word list) with no name.'
+
+message:
+  ja: 「{quote}」の話し手が「{speaker}」とだけ書かれていて、名前がありません
+  en: '"{quote}" is given to "{speaker}", who is not named'
+
+how_to_fix:
+  ja: 話し手の名前と所属を書いてください（「ミナトリサーチのアナリスト、森花子氏は」）。名前を出せない相手なら、その言葉に頼らない書き方にするか、調査報告のような題名のある文書を出典にしてください。
+  en: 'Name the speaker and where they work ("said Hanako Mori, an analyst at Minato Research"). If the person cannot be named, do not lean on the quotation: say it without it, or cite a document named by its title.'
+
+levels: { strict: warning, normal: info, relaxed: info }
+
+use_for: [business/press-release, business/report, legal, docs, academic, literature, speech]
+off_for:
+  legal: "A quotation given to an unnamed role: only press releases and reports turn this on; quote-without-source reads quotations elsewhere."
+  docs: "A quotation given to an unnamed role: only press releases and reports turn this on; quote-without-source reads quotations elsewhere."
+  academic: "A quotation given to an unnamed role: only press releases and reports turn this on; quote-without-source reads quotations elsewhere."
+  literature: "A quotation given to an unnamed role: only press releases and reports turn this on; quote-without-source reads quotations elsewhere."
+  speech: "A quotation given to an unnamed role: only press releases and reports turn this on; quote-without-source reads quotations elsewhere."
+
+group: facts
+summary:
+  ja: 「業界のアナリストは『…』と述べています」のように、名前の無い話し手の言葉を引いた所
+  en: A quotation given to a speaker named only by a role ("…," said an analyst)
+example:
+  ja:
+    config: { genre: business/press-release }
+    before: |
+      # 新版の提供について
+
+      業界のアナリストは「在庫を一画面で見られる製品は、中小企業ではまだ少ない」と述べています。
+    after: |
+      # 新版の提供について
+
+      ミナトリサーチのアナリストの森花子氏は「在庫を一画面で見られる製品は、中小企業ではまだ少ない」と述べています。
+  en:
+    config: { genre: business/press-release }
+    before: |
+      # The new version
+
+      "Few products for small businesses show all their stock on one screen," said an analyst.
+    after: |
+      # The new version
+
+      "Few products for small businesses show all their stock on one screen," said Hanako Mori, an analyst at Minato Research.
+
+not_flagged:
+  ja: 話し手に名前があれば見ません。役の語の後ろに名前が続くもの（アナリストの森花子氏）、話し手の句に「氏」「さん」「様」「教授」のような名前に付く語があるものは、名前を出したと見ます。一人に決まる役（代表取締役社長、当社CEO）は役の語の一覧に無いので見ません。「同アナリスト」「このアナリスト」のように前に名前を出した人を指し直すもの、題名を示した文書（『2026年版在庫白書』によれば）、役の語が話し手でないもの（専門家会議の報告書）も見ません。10字に満たない短い引用は語や名前を引いたものと見て読みません。プレスリリースと報告書だけで見ます。ほかの文書で人の言葉に出典が無いことは quote-without-source が見ます。
+  en: 'A speaker with a name is not reported: a name after the role ("analyst Hanako Mori"), a name before it ("Hanako Mori, an analyst"), or a title (Ms, Dr). A role that is one person (the CEO of Acme) is not in the word list. A role that points back at someone named before ("the analyst", "our spokesperson"), a document named by its title, and a role that is not the speaker ("an official statement") are not reported. A quotation shorter than ten characters names a word or a thing and is not read. Only press releases and reports are read; elsewhere, quote-without-source looks for a quotation with no source.'

package/rules/quote-without-source.yaml

@@ -9,16 +9,16 @@ name:
   en: A quotation given to someone, with no source
 
 why:
-  ja: 「〜は『…』と述べている」のように人の言葉として引いた文は、読み手がその人の言葉だと信じて読みます。出典が無いと、本当にその人がそう言ったのか、言い回しが正しいのかを誰も確かめられません。人から人へ伝わるうちに言葉が変わったり、言った人が入れ替わったりするのは、引用でいちばんよく起きる誤りです。chaff はその人が本当に言ったかを知りませんが、確かめる手がかりが無いことは言えます。鉤括弧や引用符で引いた文の直後か少し前に、誰かに帰する言い回し（「と述べ」「によれば」。語の一覧は言語ごとの語彙表にあります）があり、同じ段落にリンクも脚注も番号の引用も括弧の中の年も無いときに指します。
-  en: 'A quotation given to someone ("X once said …", "according to X") is read as that person''s words. With no source, nobody can check that the person said it, or said it that way; words change and speakers swap as a quotation is passed along, which is the commonest error in quoting. chaff cannot know who said what, but it can say there is nothing to check the quotation against. It points at a quotation in quotation marks given to someone by the words right after it or shortly before it ("said", "according to"; the words are in each language''s word list), in a paragraph with no link, no footnote, no numbered citation and no year in brackets.'
+  ja: 「〜は『…』と述べている」のように人の言葉として引いた文は、読み手がその人の言葉だと信じて読みます。出典が無いと、本当にその人がそう言ったのか、言い回しが正しいのかを誰も確かめられません。人から人へ伝わるうちに言葉が変わったり、言った人が入れ替わったりするのは、引用でいちばんよく起きる誤りです。chaff はその人が本当に言ったかを知りませんが、確かめる手がかりが無いことは言えます。鉤括弧や引用符で引いた文の直後か少し前に、誰かに帰する言い回し（「と述べ」「によれば」。語の一覧は言語ごとの語彙表にあります）があり、同じ段落にリンクも脚注も番号の引用も括弧の中の年も無いときに指します。Markdown の引用（`>`）の終わりかすぐ次の行に「— 名前」と書いた引用も、名前の行と引用の中に出典が無ければ指します。
+  en: 'A quotation given to someone ("X once said …", "according to X") is read as that person''s words. With no source, nobody can check that the person said it, or said it that way; words change and speakers swap as a quotation is passed along, which is the commonest error in quoting. chaff cannot know who said what, but it can say there is nothing to check the quotation against. It points at a quotation in quotation marks given to someone by the words right after it or shortly before it ("said", "according to"; the words are in each language''s word list), in a paragraph with no link, no footnote, no numbered citation and no year in brackets. A Markdown block quotation (`>`) with a dash line ("— Name") as its last line or right after it is given to someone too, and is pointed at when neither the quotation nor that line gives a source.'
 
 message:
   ja: 「{quote}」を人の言葉として引いていますが、出典（リンク、脚注、書誌）がありません
   en: '"{quote}" is given to someone, but no source (a link, a footnote, a reference) is given'
 
 how_to_fix:
-  ja: 同じ段落に出典を書いてください。Web で読めるならリンクを、本や論文なら「（著者, 書名, 年）」か脚注を付けます。出典が見つからないなら、言い回しを確かめられるまで人の言葉としては引かないでください。出典を書いたら、`chaff cite <出典> <引用.json>` で、その言葉が出典に本当にあるかを照らせます（chaff --format json の quote がそのまま使えます）。
-  en: 'Name the source in the same paragraph: a link when it can be read online, or "(Author, Title, year)" or a footnote for a book or a paper. If no source can be found, do not give the words to the person until they can be checked. With the source in hand, `chaff cite <source> <quotes.json>` checks that the words are really there (each finding''s quote in chaff --format json is the text to check).'
+  ja: 同じ段落に出典を書いてください。Web で読めるならリンクを、本や論文なら「（著者, 書名, 年）」か脚注を付けます。出典が見つからないなら、言い回しを確かめられるまで人の言葉としては引かないでください。`chaff cite --scaffold <文書>` がこうした引用を引用.json のひな形にするので、source に出典のファイルを書いて `chaff cite <引用.json>` を動かせば、その言葉が出典に本当にあるかを照らせます。
+  en: 'Name the source in the same paragraph: a link when it can be read online, or "(Author, Title, year)" or a footnote for a book or a paper. If no source can be found, do not give the words to the person until they can be checked. `chaff cite --scaffold <document>` writes these quotations as a quotes.json to fill in: put the source''s file in each `source`, and `chaff cite <quotes.json>` checks that the words are really there.'
 
 levels: { strict: warning, normal: info, relaxed: info }
 
@@ -57,5 +57,5 @@ example:
       As one engineer put it, "adding people to a late project only makes it later" ([source](https://example.com/essay)). Before adding people, ask whether the work can be split.
 
 not_flagged:
-  ja: 短い鉤括弧（「保存」ボタン、「出典」という語）は語や名前を引いたもので、人の言葉ではないので見ません。誰かに帰する言い回しが引用のすぐ後ろ（「…」と述べた）か少し前（によれば「…」）に無い引用は、書き手自身の言葉か、題名や言い換えなので見ません。同じ段落にリンク、URL、脚注（[^1]）、番号の引用（[3]）、括弧の中の年（（1975）、（1999年））があれば、出典を書いたと見ます。出典が正しいかは見ません。それは `chaff cite` が照らします。記事（ブログ、エッセイ）と論文で見ます。組織の記事は取材した人の言葉を、プレスリリースや報告書は自分たちの言葉や題名で示した文書を引くので、手順書、仕様、契約や法令、小説、話し言葉とあわせて既定で止めています。
-  en: 'A short quotation (the "Save" button, the word "source") names a word or a thing, not someone''s words, and is not read. A quotation with no such words right after it or shortly before it is the writer''s own words, a title or a paraphrase. A link, a URL, a footnote ([^1]), a numbered citation ([3]) or a year in brackets ((1975)) in the same paragraph counts as a source. Whether the source is right is not checked here: `chaff cite` checks that. Blog posts, essays and papers are read. An organisation''s articles quote the people they interviewed, and press releases and reports quote their own people or documents named by title, so they are left out by default, with manuals, specifications, contracts and statutes, fiction and speech.'
+  ja: 短い鉤括弧（「保存」ボタン、「出典」という語）は語や名前を引いたもので、人の言葉ではないので見ません。誰かに帰する言い回しが引用のすぐ後ろ（「…」と述べた）か少し前（によれば「…」）に無い引用は、書き手自身の言葉か、題名や言い換えなので見ません。「…」と述べる方が適切です、「…」と書くべきです、のように言い方を勧める続きは、人の言葉を引いていないので見ません（続きの一覧は語彙表 quote-advice にあります）。引用の前に誰かに帰する言い回しがあれば（山田氏によれば「…」と言う方が適切だ）、勧めでも人の言葉として見ます。同じ段落にリンク、URL、脚注（[^1]）、番号の引用（[3]）、括弧の中の年（（1975）、（1999年））があれば、出典を書いたと見ます。「— 名前」の行が無い `>` の引用は、誰の言葉かを示していないので見ません。「— 名前、書名（1975）」のように名前の行に年やリンクがあれば、出典を書いたと見ます。出典が正しいかは見ません。それは `chaff cite` が照らします。記事（ブログ、エッセイ）と論文で見ます。組織の記事は取材した人の言葉を、プレスリリースや報告書は自分たちの言葉や題名で示した文書を引くので、手順書、仕様、契約や法令、小説、話し言葉とあわせて既定で止めています。
+  en: 'A short quotation (the "Save" button, the word "source") names a word or a thing, not someone''s words, and is not read. A quotation with no such words right after it or shortly before it is the writer''s own words, a title or a paraphrase. In Japanese, words right after the quotation that suggest a wording rather than quote it (「…」と述べる方が適切です) are not read either, unless a word before the quotation gives it to someone; the word list quote-advice holds them. English has no such list yet. A link, a URL, a footnote ([^1]), a numbered citation ([3]) or a year in brackets ((1975)) in the same paragraph counts as a source. A `>` block quotation with no dash line ("— Name") does not say whose words it holds and is not read; a dash line with a year or a link ("— Name, Title (1975)") counts as a source. Whether the source is right is not checked here: `chaff cite` checks that. Blog posts, essays and papers are read. An organisation''s articles quote the people they interviewed, and press releases and reports quote their own people or documents named by title, so they are left out by default, with manuals, specifications, contracts and statutes, fiction and speech.'

package/rules/requirement-smell.yaml

@@ -4,7 +4,7 @@ status: stable
 how_to_find: requirement-smell
 # 要求の文の目印と、三つの見つけ方の語。語はすべて言語ごとの語彙表にある。
 word_list: requirement-marker
-extra_word_lists: [requirement-loophole, requirement-open-end, requirement-either]
+extra_word_lists: [requirement-loophole, requirement-open-end, requirement-either, definition-statement]
 uses: [pos]
 severity: info
 
@@ -74,5 +74,5 @@ example:
     config: { genre: technical/spec }
 
 not_flagged:
-  ja: 要求の文でない文（説明や背景）、法令、ブログやビジネス文書は見ません。語彙表にない言い方は指しません。
-  en: Sentences that state no requirement (background, explanation), statutes, and blogs and business documents are not checked. Phrases not on chaff's lists are not reported.
+  ja: 要求の文でない文（説明や背景）、法令、ブログやビジネス文書は見ません。語彙表にない言い方は指しません。文書が定めた名前の「等」（以下「委託先等」という、銀行等（…をいう。）、定義の号の頭の語）と、監査等委員会のように後ろへ語が続く「等」は、列挙を閉じているので指しません。
+  en: Sentences that state no requirement (background, explanation), statutes, and blogs and business documents are not checked. Phrases not on chaff's lists are not reported. An open-ended word inside a name the document defines (a quoted term, or one defined in the brackets after it) is not reported.

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

@@ -3,7 +3,8 @@ layer: L3
 status: stable
 how_to_find: conjunction-run
 word_list: sentence-opener
-languages: [en]
+languages: [ja, en]
+uses: [pos]
 severity: info
 
 name:
@@ -11,8 +12,8 @@ name:
   en: Run of sentences opening with a conjunction
 
 why:
-  ja: 接続詞で始まる文は 1 つなら効きますが、続くとどの文も前の文の付け足しに見えて、何が主張なのかが分からなくなります。
-  en: One sentence opening with "And" or "But" lands. A run of them makes every sentence read as an afterthought.
+  ja: 「そして」「しかし」「また」（英語の And、But）で始まる文は 1 つなら効きますが、続くとどの文も前の文の付け足しに見えて、何が主張なのかが分からなくなります。語の一覧は言語ごとの語彙表にあります。
+  en: One sentence opening with "And" or "But" (そして, しかし) lands. A run of them makes every sentence read as an afterthought. The words are listed in the lexicon.
 
 message:
   ja: 接続詞で始まる文が {count} 文続いています（{limit} 文まで）
@@ -32,9 +33,14 @@ off_for:
 
 group: readability
 summary:
-  ja: 英語で、And や But で始まる文が続く所
-  en: A run of sentences that open with "And", "But" or "So"
+  ja: 「そして」「しかし」（And、But）で始まる文が続く所
+  en: A run of sentences that open with "And", "But" or "So" (そして, しかし)
 example:
+  ja:
+    before: |
+      月曜に更新を出しました。しかし、ログイン画面が壊れました。そして、直すのに二日かかりました。また、その間は一部の人が入れませんでした。
+    after: |
+      月曜に出した更新で、ログイン画面が壊れました。直すのに二日かかり、その間は一部の人が入れませんでした。
   en:
     before: |
       We shipped the update on Monday. But the login page broke. And the fix took two days. So some customers could not sign in.
@@ -42,8 +48,8 @@ example:
       We shipped the update on Monday, and the login page broke. The fix took two days, during which some customers could not sign in.
 
 not_flagged:
-  ja: And や But で始まる文が一つだけなら指しません。
-  en: One sentence opening with "And" or "But" is not reported.
+  ja: 接続詞で始まる文が一つだけなら指しません。日本語では、話し言葉の文頭（でも、だから、なので）は colloquial-opener が、「さらに」「加えて」は stock-transition が見るので数えません。
+  en: One sentence opening with "And" or "But" is not reported. In Japanese, spoken openers (でも, だから, なので) are colloquial-opener's and さらに, 加えて are stock-transition's, so they are not counted.
 level_meaning:
   ja: 接続詞で始まる文の連続 {limit} 文まで
   en: up to {limit} sentences in a row opening with a conjunction

package/rules/summary-fact-mismatch.yaml

@@ -11,8 +11,8 @@ name:
   en: A summary value that differs from the body
 
 why:
-  ja: 冒頭や「概要」の節は、本文を読まない人も読みます。そこに書いた値が本文と違うと、要約だけを読んだ人が間違った値を持ち帰ります。本文を直したあとに、要約を直し忘れると起きます。最初の見出しより前の文と、概要・要約・まとめの節の「項目：値」「項目は値です」を、本文の同じ項目の値と比べます。本文の値が一通りに揃っていて、要約の値がそれと違うときだけ指します。
-  en: 'The opening and the summary are read by people who never read the body. A value there that differs from the body sends them away with the wrong one. It happens when the body is corrected and the summary is not. Values written as "Item: value" or "The item is value" before the first heading, or in a section headed Summary, Abstract or Overview, are compared with the body''s values for the same item; it is pointed out only when the body gives one value throughout and the summary gives another.'
+  ja: 冒頭や「概要」の節は、本文を読まない人も読みます。そこに書いた値が本文と違うと、要約だけを読んだ人が間違った値を持ち帰ります。本文を直したあとに、要約を直し忘れると起きます。最初の見出しより前の文と、概要・要約・まとめの節の「項目：値」「項目は値です」を、本文の同じ項目の値と比べます。英語の文書では、名前の無い数も、数える動詞と数えるもの（We gained 52 new customers）が同じ本文の数と比べます。要約の「誤りの率は 2.4% から 1.6% に」は、本文が同じ項目を二つの条件（導入前と導入後、無いときとあるとき、2025年と2026年）で書いた二つの値と組にして比べます。冒頭の「11月9日から提供します」のような出来事の日付は、本文で同じ出来事の語（提供、発売、開催）と日付を一つずつ持つ文の日付と比べます。本文の値が一通りに揃っていて、要約の値がそれと違うときだけ指します。
+  en: 'The opening and the summary are read by people who never read the body. A value there that differs from the body sends them away with the wrong one. It happens when the body is corrected and the summary is not. Values written as "Item: value" or "The item is value" before the first heading, or in a section headed Summary, Abstract or Overview, are compared with the body''s values for the same item, and so is a count with no label, by the verb and the words of what it counts ("We gained 52 new customers"). A summary''s "lowered the error rate from 2.4% to 1.6%" is paired with the two values the body gives the same item under two conditions (before and after, without and with, 2025 and 2026). The date of an event in the opening ("will release it on November 9, 2026") is compared with a body sentence that has a word for the same event (release, launch, held) and one date. It is pointed out only when the body gives one value throughout and the summary gives another.'
 
 message:
   ja: 冒頭・要約の「{label}」 {value} が、本文の {other} と違います
@@ -69,8 +69,8 @@ example:
       The fee is $350.
 
 not_flagged:
-  ja: 本文に同じ項目の値が二通り以上あるとき（回ごと、対象ごとの値）は、要約がどれと合うべきか決まらないので言いません。単位の違う値、条件の付いた値（「3,000円から」）も比べません。
-  en: When the body gives the item more than one value (per session, per group), which one the summary should match is not settled, so nothing is said. Values in different units and values with a condition ("from $300") are not compared.
+  ja: 本文に同じ項目の値が二通り以上あるとき（回ごと、対象ごとの値）は、要約がどれと合うべきか決まらないので言いません。単位の違う値、条件の付いた値（「3,000円から」）も比べません。「XからYに」は、本文の文に同じ項目の名前があり、二つの値のどちらの条件も読めたときだけ比べます。幅（ranging from 10 to 20）は変化ではないので比べません。出来事の日付は、年月日まで書いた日付どうしだけを比べます。日付が二つある文（期間）や、別の出来事の語も持つ文（発表した日と提供する日）、冒頭の文に無い名前（別の製品）を持つ本文の文は比べません。
+  en: When the body gives the item more than one value (per session, per group), which one the summary should match is not settled, so nothing is said. Values in different units and values with a condition ("from $300") are not compared. A "from X to Y" is compared only when a body sentence names the same item and the condition of each of its two values can be read; a range ("ranging from 10 to 20") is not a change and is left alone. An event's date is compared only when both dates give the year, month and day; a sentence with two dates (a period) or with the words of another event (the day it was announced and the day of the release) is not read, nor is a body sentence that names something the opening sentence does not (another product).
 rewrite:
   depth: light
   ja: