chaffjs 0.25.0 → 0.26.0

package/rules/defined-term-form.yaml

@@ -10,8 +10,8 @@ name:
   en: A defined term used in another form
 
 why:
-  ja: 契約では、定義した語は定義した形のまま使うのが決まりです。「本サービス」と定義したあとで「「本サービス」」とかぎ括弧を付け直すと、新しく定義し直したのか、同じものなのかが読み手に分かりません。英語では "Services" と定義した語を "services" と小文字で書くと、定義した意味なのか、ふつうの意味なのかが分かれ、争いのもとになります。定義の後ろで、かぎ括弧や引用符に入れ直した語と、大文字で定義した語を小文字で書いた所（大文字の使用より少ないとき）を指します。
-  en: 'A contract uses each defined term exactly as defined. Quoting a term again after its definition ("the "Services"") leaves the reader asking whether it is being defined anew. Writing "services" where "Services" is defined splits the defined sense from the ordinary one, which is where disputes start. chaff points at a term set in quotes again after its definition, and at a capitalised term written in lower case (when the capitalised uses are more).'
+  ja: 契約では、定義した語は定義した形のまま使うのが決まりです。「本サービス」と定義したあとで「「本サービス」」とかぎ括弧を付け直すと、新しく定義し直したのか、同じものなのかが読み手に分かりません。英語では "Services" と定義した語を "services" と小文字で書くと、定義した意味なのか、ふつうの意味なのかが分かれ、争いのもとになります。「本業務」と定義して「本件業務」と書くと、別の業務を指すのかと読めます。定義の後ろで、かぎ括弧や引用符に入れ直した語、大文字で定義した語を小文字で書いた所（大文字の使用より少ないとき）、頭の「本」と「本件」を入れ替えた語（その形も定義した語なら除きます）を指します。
+  en: 'A contract uses each defined term exactly as defined. Quoting a term again after its definition ("the "Services"") leaves the reader asking whether it is being defined anew. Writing "services" where "Services" is defined splits the defined sense from the ordinary one, which is where disputes start. In Japanese, 本件業務 written where 本業務 is defined reads as another task. chaff points at a term set in quotes again after its definition, at a capitalised term written in lower case (when the capitalised uses are more), and at a Japanese term written with its other prefix (本 for 本件 or the other way round), unless that form is defined too.'
 
 message:
   ja: 定義した「{term}」と違う形で使っています
@@ -24,6 +24,9 @@ messages:
   case:
     ja: 「{term}」は {line} 行目で大文字で定義した語ですが、ここは小文字です
     en: '"{term}" is defined with a capital on line {line}, but written in lower case here'
+  prefix:
+    ja: 「{term}」は {line} 行目で定義した語ですが、ここは「{written}」と書いています
+    en: '"{term}" is defined on line {line}, but written "{written}" here'
 
 how_to_fix:
   ja: 定義した語はかぎ括弧を付けずに使い、英語では定義のとおり大文字で始めてください。ふつうの意味で使うなら、別の言葉に替えます。
@@ -41,8 +44,8 @@ off_for:
 
 group: consistency
 summary:
-  ja: 契約や規約で、定義した語を定義のあとでかぎ括弧に入れ直したり、大文字で定義した語を小文字で書いたりしている所
-  en: A defined term quoted again after its definition, or a capitalised defined term written in lower case
+  ja: 契約や規約で、定義した語を定義のあとでかぎ括弧に入れ直したり、大文字で定義した語を小文字で書いたり、「本業務」を「本件業務」と書いたりしている所
+  en: A defined term quoted again after its definition, a capitalised defined term written in lower case, or a Japanese term with its other prefix (本件業務 for 本業務)
 example:
   ja:
     config: { genre: legal/contract }
@@ -78,8 +81,8 @@ example:
       3. You must not resell the Services.
 
 not_flagged:
-  ja: 定義そのもの（以下「本サービス」という、「本サービス」とは）、定義より前の使用（use-before-definition が見ます）、文の頭の大文字、小文字の使用が {limit} 個を超えるか大文字の使用より多い語（ふつうの意味で使っているとみなす）は指しません。定義の文の中の使用（「顧客」とは、表紙に「顧客」と書いた者をいう）も見ません。法令・規程のジャンルは、定義を指すために語をかぎ括弧に入れるので見ません。
-  en: 'The definitions themselves ("Services" means, (the "Services")), uses before the definition (use-before-definition reads those), capitals at the start of a sentence, and terms written in lower case more than {limit} times or more often than capitalised (taken as the ordinary word used on purpose) are not reported, nor is a use inside the defining sentence ("Customer" means the party named "Customer"). Statutes and regulations quote a term to point at its definition, so that genre does not run this rule.'
+  ja: 定義そのもの（以下「本サービス」という、「本サービス」とは）、定義より前の使用（use-before-definition が見ます）、文の頭の大文字、小文字の使用が {limit} 個を超えるか大文字の使用より多い語（ふつうの意味で使っているとみなす）は指しません。定義の文の中の使用（「顧客」とは、表紙に「顧客」と書いた者をいう）も見ません。法令・規程のジャンルは、定義を指すために語をかぎ括弧に入れるので見ません。「本」と「本件」を入れ替えた形は、その形も定義した語であるとき、長い語の一部（見本物品）のときは見ません。
+  en: 'The definitions themselves ("Services" means, (the "Services")), uses before the definition (use-before-definition reads those), capitals at the start of a sentence, and terms written in lower case more than {limit} times or more often than capitalised (taken as the ordinary word used on purpose) are not reported, nor is a use inside the defining sentence ("Customer" means the party named "Customer"). Statutes and regulations quote a term to point at its definition, so that genre does not run this rule. A term with its other prefix (本件業務 for 本業務) is not reported when that form is defined too, or inside a longer word (見本物品).'
 level_meaning:
   ja: 小文字の使用が {limit} 個以下で、大文字の使用より少ないとき指摘
   en: lower-case uses reported when they are {limit} or fewer and fewer than the capitalised ones

package/rules/demonstrative-opener-run.yaml

@@ -4,7 +4,7 @@ status: stable
 how_to_find: opener-run
 word_list: demonstrative-opener
 requires: [pos]
-languages: [ja]
+languages: [ja, en]
 severity: info
 
 name:
@@ -13,15 +13,15 @@ name:
 
 why:
   ja: 「これは」「その結果」「この方法は」のように指示語で始まる文が続くと、読み手は一文ごとに「どれのことか」を前に戻って確かめることになります。指すものが一つ前の文なのか、もっと前なのかも曖昧になります。数えるのは同じ段落の中の連続だけです。
-  en: In Japanese, sentence after sentence opening with a demonstrative (これは, その結果) sends the reader back each time to find what it points at, and blurs whether it means the last sentence or one before. Only runs within one paragraph are counted.
+  en: Sentence after sentence opening with a word that points back (This, That, It; これは, その結果) sends the reader back each time to find what it points at, and blurs whether it means the last sentence or one before. Only runs within one paragraph are counted.
 
 message:
   ja: 「{word}」など、指示語で始まる文が {count} 文続いています（{limit} 文まで）
-  en: '{count} sentences in a row open with a demonstrative such as "{word}" (limit {limit})'
+  en: '{count} sentences in a row open with a word that points back, such as "{word}" (limit {limit})'
 
 how_to_fix:
   ja: 指示語のどれかを、指している名詞に置き換えてください（その結果 → 調査の結果）。
-  en: Replace one of the demonstratives with the noun it points at (その結果 → 調査の結果).
+  en: Replace one of the demonstratives with the noun it points at (This → The new procedure; その結果 → 調査の結果).
 
 levels: { strict: 1, normal: 2, relaxed: 3 }
 
@@ -30,17 +30,22 @@ use_for: [business, technical, blog, legal, docs, academic, literature, speech]
 group: readability
 summary:
   ja: 「これは」「その」「この」のような指示語で始まる文が、同じ段落の中で続く所
-  en: Japanese sentences in a row, within one paragraph, that open with a demonstrative (これ, その)
+  en: Sentences in a row, within one paragraph, that open with a word pointing back (This, That, It; これ, その)
 example:
   ja:
     before: |
       新しい手順を導入しました。これは作業を減らすためです。その結果、残業が減りました。この効果は来月も続く見込みです。
     after: |
       新しい手順を導入しました。作業を減らすためです。その結果、残業が減りました。残業の減少は来月も続く見込みです。
+  en:
+    before: |
+      We introduced a new procedure. This was meant to cut the work. It reduced overtime. That effect should continue next month.
+    after: |
+      We introduced a new procedure. This was meant to cut the work. The procedure reduced overtime, and the reduction should continue next month.
 
 not_flagged:
-  ja: 段落が変われば数え直します。「それぞれ」のように一語になったものと、接続詞の「そして」は数えません。
-  en: The count restarts at each paragraph. Words such as それぞれ and the conjunction そして are not counted.
+  ja: 段落が変われば数え直します。「それぞれ」のように一語になったものと、接続詞の「そして」は数えません。英語では、「This Agreement」「This section」のように文書そのものを指す書き出しと、「It is worth」「It seems」のように後ろを指す It は数えません。
+  en: The count restarts at each paragraph. Words such as それぞれ and the conjunction そして are not counted. In English, an opening that names the document itself ("This Agreement", "This section") and an "it" that stands for what follows ("It is worth", "It seems") are not counted.
 level_meaning:
   ja: 指示語で始まる文 {limit} 文の連続まで
   en: up to {limit} such sentences in a row
@@ -58,3 +63,15 @@ rewrite:
     avoid:
       - 指しているものを取り違える
       - 指示語を別の指示語（同様に、前述の）に替えるだけ
+  en:
+    direction: Of the demonstratives in the run, replace the ones whose referent is furthest away with the noun they point at. One that points at the sentence just before may stay.
+    pairs:
+      - before: We introduced a new procedure. This was meant to cut the work. It reduced overtime. That effect should continue next month.
+        after: We introduced a new procedure. This was meant to cut the work. The procedure reduced overtime, and the reduction should continue next month.
+      - before: The audit found three gaps. These came from an old manual. It is two years old. This will be fixed next month.
+        after: The audit found three gaps. They came from a manual that is two years old. We will revise the manual next month.
+    keep:
+      - what each word points at, and the order of the sentences
+    avoid:
+      - mistaking what a word points at
+      - swapping one pointer for another (the above, the former, said)

package/rules/no-mixed-desumasu.yaml

@@ -51,8 +51,8 @@ example:
       新しい料金は来月から始まります。請求書の形式も変わります。支払いの期限は月末です。古い料金は三月で終わります。
 
 not_flagged:
-  ja: どちらの調子が正しいかは決めません。多いほうに揃っていない、少ないほうの文だけを指します。本文と箇条書きは別々に数えます。箇条書きの中の少ないほうが文書全体では多いほうなら、その文は指しません。
-  en: Neither register is called right; only the sentences in the minority are pointed at. The body and each list are counted apart, and a sentence in a list's minority is left alone when its register is the document's majority.
+  ja: どちらの調子が正しいかは決めません。多いほうに揃っていない、少ないほうの文だけを指します。本文と箇条書きは別々に数えます。箇条書きの中の少ないほうが文書全体では多いほうなら、その文は指しません。項目や段落の頭の太字の札（「- **速く書ける。** 説明です。」の「速く書ける。」）は見出しと同じく文に数えません。
+  en: Neither register is called right; only the sentences in the minority are pointed at. The body and each list are counted apart, and a sentence in a list's minority is left alone when its register is the document's majority. A bold label that opens an item or a paragraph and is followed by more text on its line is a heading, not a sentence.
 level_meaning:
   ja: 少ないほうの調子の文が {limit} 文以下のとき、それを指摘
   en: reported when the minority register has {limit} sentences or fewer

package/rules/orthographic-variant.yaml

@@ -56,8 +56,8 @@ example:
       Send the form by email. We answer every email within a day. Attach the receipt to the email.
 
 not_flagged:
-  ja: 読みが同じでも漢字の違う語（書く・描く）、補助動詞・形式名詞と本来の使い方の書き分け（見て下さい・資料を下さい）、書き分けが意味の違いになる語（成る・なる、言う・いう）、語末の「ー」だけの違い（katakana-long-vowel が見ます）、鉤括弧や引用符の中、chaff.yaml の names に書いた名前は見ません。英字は、頭の字の大文字小文字（Email と email）と、大文字だけの語（強調や略語）を書き方の違いにしません。少ないほうが三分の一を超えるときも言いません。文学のジャンルでは既定で止めています（その時代の書き方のため）。
-  en: The case of a word's first letter (Email, email; Long-Term, long-term) is not a spelling, nor is a word in capitals only (emphasis or an acronym). Hyphenated words that are another word (re-sign, resign), part of an address (github.com), anything in quotation marks and the team's names are not compared. Nothing is reported when the minority is more than a third. The literature preset turns it off, since old spelling belongs to its time.
+  ja: 読みが同じでも漢字の違う語（書く・描く）、補助動詞・形式名詞と本来の使い方の書き分け（見て下さい・資料を下さい）、書き分けが意味の違いになる語（成る・なる、言う・いう）、語末の「ー」だけの違い（katakana-long-vowel が見ます）、鉤括弧や引用符の中、語の直後のふりがなの括弧の中（HTTP（えいちてぃーてぃーぴー））、chaff.yaml の names に書いた名前は見ません。名詞に続けて書いたかなの名詞（全員ぶん）と慣用句の動詞（気をつける）は、同じ読みの語（文、名札を付ける）と別に比べます。英字は、頭の字の大文字小文字（Email と email）と、大文字だけの語（強調や略語）を書き方の違いにしません。少ないほうが三分の一を超えるときも言いません。文学のジャンルでは既定で止めています（その時代の書き方のため）。
+  en: The case of a word's first letter (Email, email; Long-Term, long-term) is not a spelling, nor is a word in capitals only (emphasis or an acronym). Hyphenated words that are another word (re-sign, resign), part of an address (github.com), anything in quotation marks, a Japanese reading in brackets right after a word (HTTP（えいちてぃーてぃーぴー）) and the team's names are not compared. Nothing is reported when the minority is more than a third. The literature preset turns it off, since old spelling belongs to its time.
 level_meaning:
   ja: 少ないほうが語の {limit}% 以下のとき指摘
   en: reported when the minority spelling is {limit}% of the word's uses or less

package/rules/party-role-name.yaml

@@ -0,0 +1,94 @@
+id: party-role-name
+layer: L3
+status: stable
+how_to_find: party-role-name
+requires: [structure]
+severity: info
+
+name:
+  ja: 当事者を、定めた呼び名でなく立場の語で書いている
+  en: A party named by its role instead of the name the contract gave it
+
+why:
+  ja: 「株式会社しおさい技研（以下「乙」という。）」と定めた契約で、途中から「受託者」と書くと、読み手は受託者が乙のことか、別の誰か（再委託先など）なのかを確かめることになります。ひな形の条項を貼り合わせたときに、元の契約の呼び方が残ると起きます。文の途中で括弧に入れて当事者の呼び名を定めた文書で、その後ろに書いた立場の語（委託者・受託者・開示者・受領者・売主・買主・運営者、the Vendor、the Recipient など）を指します。語は言語ごとの語彙表にあります。
+  en: Once a contract says "Harbour Works Ltd (the "Supplier")", writing "the Vendor" later makes the reader check whether the Supplier is meant or someone else, such as a subcontractor. It happens when clauses from another template are pasted in with that template's names. In a document that gives its parties short names in brackets, chaff points at each later role word (the Vendor, the Recipient, the Company, 受託者, 売主) that the document did not define. The words are in each language's word list.
+
+message:
+  ja: 「{role}」は、この契約が当事者に定めた呼び名（{names}）ではありません
+  en: '"{role}" is not a name this contract gave a party ({names})'
+
+how_to_fix:
+  ja: 定めた呼び名（甲・乙など）に書き換えてください。当事者でない人を指すなら、その人を定義してから使います。
+  en: Use the name the contract gave the party. If someone else is meant, define them first.
+
+levels: { strict: warning, normal: info, relaxed: info }
+
+use_for: [legal, docs, academic, literature, speech]
+off_for:
+  docs: "Defined terms and short names are a contract's apparatus: the legal genres check them."
+  academic: "Defined terms and short names are a contract's apparatus: the legal genres check them."
+  literature: "Defined terms and short names are a contract's apparatus: the legal genres check them."
+  speech: "Defined terms and short names are a contract's apparatus: the legal genres check them."
+  legal/statute: "A statute names people by their role (委託者, the employer) on purpose: it defines no parties."
+
+group: consistency
+summary:
+  ja: 当事者を「甲」「乙」と定めたあとで、「委託者」「受託者」のような立場の語で書いている所
+  en: A party given a short name ("the Supplier") and later called by a role word (the Vendor)
+example:
+  ja:
+    config: { genre: legal/contract }
+    before: |
+      # 業務委託契約書
+
+      株式会社みなと製作所（以下「甲」という。）と北浜商事株式会社（以下「乙」という。）は、次のとおり契約を結ぶ。
+
+      第1条　受託者は、甲の会議室の予約を代わりに行う。
+    after: |
+      # 業務委託契約書
+
+      株式会社みなと製作所（以下「甲」という。）と北浜商事株式会社（以下「乙」という。）は、次のとおり契約を結ぶ。
+
+      第1条　乙は、甲の会議室の予約を代わりに行う。
+  en:
+    config: { genre: legal/contract }
+    before: |
+      # Services Agreement
+
+      This agreement is between Harbour Works Ltd (the "Supplier") and North Trading Inc (the "Customer").
+
+      1. The Customer pays the Vendor within thirty days of each invoice.
+    after: |
+      # Services Agreement
+
+      This agreement is between Harbour Works Ltd (the "Supplier") and North Trading Inc (the "Customer").
+
+      1. The Customer pays the Supplier within thirty days of each invoice.
+
+not_flagged:
+  ja: 当事者の呼び名を定める前（「売主 有限会社たちばな木工（以下「甲」という。）」の売主）、定めた語そのもの（「開示者」と定義した文書の開示者）、定義した語の一部、長い語の一部（再委託先、委託者側）は見ません。当事者の定義は、呼び名が甲・乙・当社のような語か立場の語であるもの、または括弧のすぐ前に会社の形（株式会社、Ltd）があるものだけを読みます。法務のジャンルで見ます。法令・規程は当事者を定めず、立場の語で人を呼ぶので見ません。
+  en: 'Uses before the parties are named, a role word the document defines itself ("Recipient" means), a role word inside a defined term (Receiving Party) or a longer word, and a lower-case role word (the vendor, an ordinary noun) are not reported. A party is read from a short name in brackets that is a party word (we) or a role word itself, or that follows a company name (Ltd, Inc.). The legal genres run this rule, except statutes, which name people by their role and define no parties.'
+rewrite:
+  depth: light
+  ja:
+    direction: 立場の語を、定めた呼び名に置き換えてください。どちらの当事者か分からなければ、書き手に確かめます。当事者でない人を指しているなら、その人を定義します。
+    pairs:
+      - before: 受託者は、甲の会議室の予約を代わりに行う。
+        after: 乙は、甲の会議室の予約を代わりに行う。
+      - before: 委託者は、毎月末日までに委託料を支払う。
+        after: 甲は、毎月末日までに委託料を支払う。
+    keep:
+      - 条の番号と中身
+    avoid:
+      - 甲と乙を取り違える
+  en:
+    direction: Replace the role word with the name the contract gave the party. If it is not clear which party is meant, ask the writer. If someone else is meant, define them.
+    pairs:
+      - before: The Customer pays the Vendor within thirty days.
+        after: The Customer pays the Supplier within thirty days.
+      - before: The Recipient shall return all documents on request.
+        after: The Customer shall return all documents on request.
+    keep:
+      - the clause numbers and their content
+    avoid:
+      - swapping the parties

package/rules/quote-without-source.yaml

@@ -0,0 +1,61 @@
+id: quote-without-source
+layer: L2
+status: stable
+how_to_find: quote-without-source
+severity: info
+
+name:
+  ja: 人の言葉として引いた文に出典がない
+  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.'
+
+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).'
+
+levels: { strict: warning, normal: info, relaxed: info }
+
+use_for: [blog, academic, docs, legal, literature, speech]
+off_for:
+  blog/owned-media: "An organisation's article quotes the people it interviewed: the interview is the source."
+  docs: "A manual quotes messages, labels and commands, not people's words."
+  legal: "A contract or a statute quotes its own terms and other provisions, which are cited by article."
+  literature: "A story's quotations are its characters' words."
+  speech: "A speech or a transcript gives its own words, and quotes from memory by design."
+
+group: facts
+summary:
+  ja: 「〜は『…』と述べた」のように人の言葉として引いたのに、同じ段落に出典の無い所
+  en: A quotation given to someone ("X said …") in a paragraph that gives no source
+example:
+  ja:
+    config: { genre: blog/tech }
+    before: |
+      # 遅れた計画
+
+      ある研究者は「遅れているプロジェクトに人を足すと、さらに遅れる」と述べている。人を足す前に、仕事を分けられるかを考えたい。
+    after: |
+      # 遅れた計画
+
+      ある研究者は「遅れているプロジェクトに人を足すと、さらに遅れる」と述べている（[出典](https://example.com/essay)）。人を足す前に、仕事を分けられるかを考えたい。
+  en:
+    config: { genre: blog/tech }
+    before: |
+      # Late projects
+
+      As one engineer put it, "adding people to a late project only makes it later." Before adding people, ask whether the work can be split.
+    after: |
+      # Late projects
+
+      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.'

package/rules/total-mismatch.yaml

@@ -10,12 +10,12 @@ name:
   en: A total that is not the sum of its items
 
 why:
-  ja: 見積や請求の「合計」が、上に並べた金額の和と合わないと、読み手はどちらが正しいのかを計算し直すことになります。行を足したり消したりしたあとに、合計だけ直し忘れると起きます。箇条書きか表で、合計の語（合計・小計）で始まる行を、同じ単位で同じ列の金額の和と比べます。小計のあとの総計のように、足し方が何通りかあるときは、どの足し方でも合わないときだけ指します。
-  en: When the total of a quote or an invoice is not the sum of the amounts listed above it, the reader has to add them up again to find out which is right. It happens when a line is added or removed and the total is not updated. In a list or a table, a line starting with a total word (Total, Subtotal) is compared with the sum of the amounts in the same unit and column above it. When there is more than one way to add them up, such as a grand total after a subtotal and tax, it is pointed out only when none of them matches.
+  ja: 見積や請求の「合計」が、上に並べた金額の和と合わないと、読み手はどちらが正しいのかを計算し直すことになります。行を足したり消したりしたあとに、合計だけ直し忘れると起きます。箇条書きか表で、合計の語（合計・小計）で始まる行を、同じ単位で同じ列の金額の和と比べます。契約書のように一つの文に書いた合計（「保守費60,000円、運用費30,000円とし、合計100,000円とする」「月額150,000円（内訳：…）」）も、その文に並べた同じ単位の金額の和と比べます。小計のあとの総計のように、足し方が何通りかあるときは、どの足し方でも合わないときだけ指します。
+  en: When the total of a quote or an invoice is not the sum of the amounts listed above it, the reader has to add them up again to find out which is right. It happens when a line is added or removed and the total is not updated. In a list or a table, a line starting with a total word (Total, Subtotal) is compared with the sum of the amounts in the same unit and column above it. A total written in a sentence, as contracts do ("$6,000 for hosting and $3,000 for support, for a total of $9,000", "$8 per month, made up of …"), is compared with the amounts in the same unit listed in that sentence. When there is more than one way to add them up, such as a grand total after a subtotal and tax, it is pointed out only when none of them matches.
 
 message:
-  ja: 合計「{written}」が、上の金額の和（{sum}）と合いません
-  en: "The total {written} is not the sum of the amounts above it ({sum})"
+  ja: 合計「{written}」が、内訳の金額の和（{sum}）と合いません
+  en: "The total {written} is not the sum of its items ({sum})"
 
 how_to_fix:
   ja: 内訳の金額と合計のどちらが正しいかを確かめて、片方を直してください。
@@ -30,8 +30,8 @@ sources: [de-marneffe-2008]
 
 group: facts
 summary:
-  ja: 見積もりや請求書で、合計が上に並べた金額の和と合わない所
-  en: A total in a quote or an invoice that is not the sum of the amounts above it
+  ja: 見積もりや請求書、契約書で、合計が内訳に並べた金額の和と合わない所
+  en: A total in a quote, an invoice or a contract that is not the sum of the amounts it is made up of
 example:
   ja:
     before: |
@@ -61,5 +61,5 @@ example:
       | Total | $8,000 |
 
 not_flagged:
-  ja: 単位や列の違う金額は足しません。足し方が何通りもあるとき（小計と税のあとの総計など）は、どれとも合わないときだけ指します。
-  en: Amounts in another unit or column are not added. Where there is more than one way to add them up, it is reported only when none matches.
+  ja: 単位や列の違う金額は足しません。足し方が何通りもあるとき（小計と税のあとの総計など）は、どれとも合わないときだけ指します。文の中では、合計の語（合計・総額）のすぐ後ろの金額か内訳の語（内訳は）のすぐ前の金額だけを合計と読み、内訳の金額が二つ以上あるときだけ比べます。並びの一部（単価や上限など、合計の語から離れた金額を除いた並び）の和か、一つを引いた額（値引き）と合えば指しません。
+  en: Amounts in another unit or column are not added. Where there is more than one way to add them up, it is reported only when none matches. In a sentence, only the amount right after a total phrase (a total of) or right before a breakdown phrase (made up of) is read as a total, and only when two or more items in its unit are listed. It is not reported when the items nearest the phrase add up to it, or when it matches with one item taken away (a discount).

package/rules/vague-deadline.yaml

@@ -0,0 +1,95 @@
+id: vague-deadline
+layer: L2
+status: stable
+how_to_find: vague-deadline
+severity: info
+
+name:
+  ja: 期限を「速やかに」のような語で残している
+  en: A time limit left to the reader (promptly)
+
+why:
+  ja: 契約の義務に「速やかに」「遅滞なく」とだけ書くと、何日目までなら守ったことになるのかを、当事者がそれぞれ自分に都合よく読みます。争いになったとき、守ったかどうかを決める物差しがありません。期限は「通知を受けた日から7日以内に」のように数で書くと、誰が読んでも同じに決まります。期限をどう書くかは書き手が決めることなので、chaff は、ほかの期限の多くを数で書いた文書の中で、期限を読み手に決めさせる語（語の一覧は言語ごとの語彙表にあります）を少ないほうとして指します。数の期限（日以内、営業日）を書いた文が、その語を書いた文より多いときだけで、その語と同じ文に数の期限があれば指しません。
+  en: 'An obligation written with "promptly" or "without undue delay" alone lets each party read the deadline its own way, and a dispute has no measure of whether it was met. A number ("within seven days of receiving notice") reads the same to everyone. 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 in numbers (days, business days) than hold a word that leaves the limit to the reader (each language''s word list has them), it points at those words, unless their own sentence states a number too.'
+
+message:
+  ja: 「{word}」では期限が決まりません。何日以内かを数で書くと、守ったかどうかを決められます
+  en: '"{word}" sets no deadline; a number of days makes it one that can be met or missed'
+
+how_to_fix:
+  ja: 「通知を受けた日から7日以内に」のように、起点と日数で期限を書いてください。急ぐことを伝えたいだけなら、「速やかに、遅くとも7日以内に」のように数の期限を添えます。
+  en: 'Write the limit as a start and a number of days ("within seven days of receiving notice"). To stress urgency too, add the number: "promptly, and in any case within seven days".'
+
+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 uses 速やかに, 遅滞なく and 直ちに as graded terms of art, and promptly as a duty it does not quantify."
+  legal/judgment: "A court decision quotes the statutes and contracts it reads (遅滞なく報告しなければならない); their limits are not the decision's own."
+  legal/patent: "A patent sets no deadlines: promptly describes a step of a process (promptly cooled)."
+
+group: wording
+summary:
+  ja: ほかの期限を日数で書いた契約で、一部の期限だけを「速やかに」「遅滞なく」と書いた所
+  en: A deadline written as "promptly" or "without undue delay" in a contract that gives its other deadlines in days
+example:
+  ja:
+    config: { genre: legal/contract }
+    before: |
+      第1条　乙は、毎月5日までに、前月の業務を甲に報告する。
+
+      第2条　甲は、報告を受けた日から10日以内に、結果を乙に通知する。
+
+      第3条　乙は、甲から求めを受けたときは、速やかに資料を提出する。
+    after: |
+      第1条　乙は、毎月5日までに、前月の業務を甲に報告する。
+
+      第2条　甲は、報告を受けた日から10日以内に、結果を乙に通知する。
+
+      第3条　乙は、甲から求めを受けた日から7日以内に、資料を提出する。
+  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. The Supplier shall notify the Customer promptly of any breach.
+    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. The Supplier shall notify the Customer of any breach within five business days of becoming aware of it.
+
+not_flagged:
+  ja: 数の期限を書いた文が、期限を読み手に決めさせる語を書いた文より多くない文書では、書き手がそう書くと決めたとみなして指しません。同じ文に日数の期限（7日以内、5営業日）があれば指しません（「速やかに、遅くとも7日以内に」）。権利を定める文（「速やかに本契約を解除することができる」）は、誰かが守る期限ではないので見ません。今すぐを言う「直ちに」と、解除の手続きの決まった言い方「相当の期間を定めて催告し」は見ません。法令は「速やかに」「遅滞なく」「直ちに」を段の違う決まった語として使うので見ません。判決は法令や契約を引いて書くので、特許は期限を定めないので見ません。契約書・規約のジャンルで見ます。
+  en: 'A document where sentences stating a limit in numbers are not more than those with a vague one is taken to write its limits that way on purpose, and is not reported. A sentence that also states a limit in numbers ("promptly, and in any case within seven days") is not reported, nor one that grants a right ("We may promptly suspend your account"), which sets no deadline anyone must meet. A bare unit ("24 hours a day") does not count as a limit in numbers; "within … days" does. "Immediately", which means at once, is not read. Statutes use "promptly" and "without delay" as terms of art, court decisions quote statutes and contracts, and patents set no deadlines, so none of them is read; the contract genre runs this rule.'
+rewrite:
+  depth: light
+  ja:
+    direction: 「速やかに」「遅滞なく」を、起点と日数の期限に書き換えます。日数は書き手が決めることなので、決まっていなければ書き手に確かめます。
+    pairs:
+      - before: 乙は、速やかに資料を提出する。
+        after: 乙は、甲の求めを受けた日から7日以内に、資料を提出する。
+      - before: 甲は、前項の請求を受けたときは、遅滞なく修補する。
+        after: 甲は、前項の請求を受けた日から14日以内に修補する。
+    keep:
+      - 義務を負う当事者と、すること
+    avoid:
+      - 日数を書き手に確かめずに決める
+  en:
+    direction: Replace "promptly" or "without undue delay" with a start and a number of days. The number is the writer's decision; if it is not known, ask.
+    pairs:
+      - before: The Supplier shall notify the Customer promptly.
+        after: The Supplier shall notify the Customer within five business days.
+      - before: The Customer shall pay each invoice within a reasonable time.
+        after: The Customer shall pay each invoice within thirty days of receiving it.
+    keep:
+      - the party bound and what it must do
+    avoid:
+      - choosing the number of days without asking the writer

package/rules/weasel-word.yaml

@@ -4,7 +4,7 @@ status: stable
 how_to_find: phrase-match
 word_list: weasel-word
 requires: [pos]
-languages: [en]
+languages: [ja, en]
 severity: info
 
 name:
@@ -12,8 +12,8 @@ name:
   en: Weasel words
 
 why:
-  ja: 英語の「many experts say」「it is widely believed」「studies show」は、主張を名前の無い大勢や、どれとも言わない研究に預けます。読み手は誰がそう言ったのかを確かめられず、書き手は主張に責任を持たずに済みます。言い回しは言語ごとの語彙表にあります。
-  en: '"Many experts say", "it is widely believed" and "studies show" lend a claim to an unnamed crowd or to research no one names. The reader cannot check who said it, and the writer need not stand behind it. The phrases are listed in the lexicon.'
+  ja: 「〜と言われています」「多くの専門家が」「ある研究によると」（英語の many experts say, studies show）は、主張を名前の無い大勢や、どれとも言わない研究に預けます。読み手は誰がそう言ったのかを確かめられず、書き手は主張に責任を持たずに済みます。言い回しは言語ごとの語彙表にあります。
+  en: '"Many experts say", "it is widely believed" and "studies show" (と言われています, ある研究によると) lend a claim to an unnamed crowd or to research no one names. The reader cannot check who said it, and the writer need not stand behind it. The phrases are listed in the lexicon.'
 
 message:
   ja: 「{matched}」は、誰が言ったのかを言っていません
@@ -33,9 +33,14 @@ off_for:
 
 group: wording
 summary:
-  ja: 英語で、「many experts say」「studies show」のように、主張を名前の無い誰かに預ける言い回し
-  en: Phrases such as "many experts say" and "studies show" that credit a claim to no one in particular
+  ja: 「〜と言われています」「ある研究によると」（many experts say, studies show）のように、主張を名前の無い誰かに預ける言い回し
+  en: Phrases such as "many experts say" and "studies show" (と言われています, ある研究によると) that credit a claim to no one in particular
 example:
+  ja:
+    before: |
+      在宅勤務は生産性を上げると言われています。
+    after: |
+      2023年のスタンフォード大学の調査（1,600人）では、在宅勤務で生産性が4%上がりました。
   en:
     before: |
       Many experts say remote work raises output.
@@ -43,13 +48,26 @@ example:
       A 2023 Stanford study of 1,600 staff found remote work raised output by 4%.
 
 not_flagged:
-  ja: 一覧にある言い回しだけを見ます。英語の文書だけで動きます。すぐ後ろに出典が書いてあっても指摘します（文の中で研究の名前を言えるため）。
-  en: Only the phrases on chaff's list are checked, and only in English documents. A citation right after the phrase does not silence it, since the sentence can name the study itself.
+  ja: 一覧にある言い回しだけを見ます。すぐ後ろに出典が書いてあっても指摘します（文の中で研究の名前を言えるため）。日本語では、前に出典が来やすい「研究によると」「専門家によると」は「ある」「最近の」「多くの」が付いた形だけを、「と言われる」は「と言われている」だけを見ます（「よく言われる話」のように言い回しを話題にするものは見ません）。「一般的に」だけでは指しません。
+  en: Only the phrases on chaff's list are checked. A citation right after the phrase does not silence it, since the sentence can name the study itself. In Japanese, 研究によると and 専門家によると, which often follow their source, are checked only as ある・最近の・多くの forms, と言われる only as と言われている (not よく言われる, which mostly talks about the saying itself), and 一般的に alone is not checked.
 level_meaning:
   ja: 当てはまる言い回しが {limit} 箇所あれば指摘
   en: reported once there are {limit}
 rewrite:
   depth: light
+  ja:
+    direction: 名前の無い大勢（多くの専門家、ある研究）を、本文や出典が名指す人や研究に置き換えてください。名指していなければ作らずに書き手に聞くか、書き手自身の主張として書きます。
+    pairs:
+      - before: ある研究によると、短い会議は時間を節約します［3］。
+        after: 山田（2021）は、15分の会議で各チームの時間が週2時間減ったと報告しています［3］。
+      - before: 旧APIのほうが遅いと言われています。
+        after: 5月の負荷試験では、旧APIのほうが30%遅い結果でした。
+    keep:
+      - 出典の番号やリンク
+      - 主張そのもの
+    avoid:
+      - 本文に無い研究や名前を作る
+      - 別の名前の無い大勢（一部の研究者）に替えるだけ
   en:
     direction: Replace the unnamed crowd ("many experts", "studies") with the person or study the text or its sources name. If they name none, do not invent one; ask the writer, or state the claim as the writer's own.
     pairs:

package/skills/chaff/SKILL.md

@@ -70,8 +70,18 @@ relaxing a rule.
   limit itself (`max-sentence-length: 260`).
 - `prefer:` maps spellings to the team's (`e-mail: email`); `preferred-term: normal` turns the rule on.
 - Unknown rule names and unreadable values are reported on stderr — read stderr after editing `chaff.yaml`.
-- `genre:` sets the kind of document; `by_path` sets one per folder; `--genre` overrides both for one run.
-  `rules:` wins over the genre's preset.
+- `genre:` sets the kind of document. `by_path` sets it per path, as a list of `files` globs, each with `genre`,
+  `language` or `profile`, and an entry in any other shape is reported on stderr and not used:
+
+  ```yaml
+  by_path:
+    - files: ["guides/**/*.md"]
+      genre: docs/manual
+  ```
+
+  A file's front matter `genre:` (or `type:`) sets that one file, when neither `genre:` nor a matching `by_path`
+  entry does. Strongest first: `--genre` for one run, then `by_path`, `genre:`, front matter, the path, the content,
+  and `blog/tech`. `rules:` wins over the genre's preset.
 
 ## Turn a team's style note into chaff.yaml
 

package/src/adapter-import.ts

@@ -0,0 +1,3 @@
+// How a language package is imported: by name, at run time. A build without a file system puts its own module in this one's place.
+
+export const importPackage = (specifier: string): Promise<unknown> => import(specifier);

package/src/adapter-load.ts

@@ -1,3 +1,4 @@
+import { importPackage } from "./adapter-import.ts";
 import type { LanguageAdapter } from "./plugin.ts";
 
 const ADAPTER_PACKAGE: Readonly<Record<string, string>> = { ja: "@chaffjs/lang-ja", en: "@chaffjs/lang-en" };
@@ -102,7 +103,7 @@ const importFirst = async (specifiers: readonly string[], language: string, impo
  * core だけで起動し、文字種で言語を当ててから、その言語のアダプタを読む。
  * 全言語を静的に import すると、使わない言語のぶんまで npx の初回取得が膨らむ。
  */
-export const loadAdapter = async (language: string, importer: Importer = (specifier) => import(specifier)): Promise<LanguageAdapter> => {
+export const loadAdapter = async (language: string, importer: Importer = importPackage): Promise<LanguageAdapter> => {
   const { specifier, module } = await importFirst(packagesFor(language), language, importer);
   if (typeof module !== "object" || module === null) throw new Error(`${specifier} did not export a module`);
   const candidate = pickExport(module);