chaffjs 0.25.0 → 0.27.0

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/percent-sum-mismatch.yaml

@@ -10,8 +10,8 @@ name:
   en: Shares of a whole that do not add up to 100%
 
 why:
-  ja: 構成比や内訳の百分率を足して 100% にならないと、読み手はどの数字が違うのか、項目が抜けたのかを確かめることになります。項目を足したり消したり、数字を一つだけ直したりしたときに起きます。表のその列の見出しか、箇条書きや表のすぐ上の文・見出しに、全体を分けた割合の語（構成比、内訳、シェア）があるときだけ足します。丸めの誤差は、項目ごとに最後の桁の半分まで（少なくとも 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). Rounding is allowed, up to half the last digit per item (at least one point).
+  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).
 
 message:
   ja: 内訳の割合の和が {sum} で、100% になりません
@@ -56,5 +56,5 @@ example:
       - Europe: 40%
 
 not_flagged:
-  ja: 割合の語の無い百分率（利用率、伸び率）、複数回答の集計、符号の付いた増減（+3%）、合計の行がある表（合計が内訳の和と合わない の対象）、項目が一つだけのものは足しません。
-  en: 'Percentages not named as shares (rates, growth), multiple-answer counts, signed changes (+3%), a table with a total row (left to "A total that is not the sum of its items"), and a single item are not added.'
+  ja: 割合の語の無い百分率（利用率、伸び率）、複数回答の集計、符号の付いた増減（+3%）、合計の行がある表（合計が内訳の和と合わない の対象）、項目が一つだけのものは足しません。一つの文の内訳は、和が 100% から 10 ポイントより離れていれば言いません（大きい項目だけを挙げた文や、別の全体・前の年の割合を並べた文）。
+  en: 'Percentages not named as shares (rates, growth), multiple-answer counts, signed changes (+3%), a table with a total row (left to "A total that is not the sum of its items"), and a single item are not added. A breakdown in one sentence whose sum is more than 10 points from 100% is not reported: it names only the larger parts, or shares of different wholes or of two periods.'

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/relative-date-mismatch.yaml

@@ -10,8 +10,8 @@ name:
   en: A relative date that does not match its base date
 
 why:
-  ja: 「10月2日に申し込み、3日後の10月6日に通知」のように、相対の期間と日付を一緒に書くと、読み手はどちらが正しいのか分かりません。日程をずらしたときに、日付か期間の片方だけを直すと起きます。「3日後の」「1か月前の」のすぐ後ろの日付を、同じ文で前にある日付（文が「2週間後、」で始まるなら前の文の日付）に期間を足した（前なら引いた）日と比べます。
-  en: 'When a relative length and a date are written together ("Applications open on May 1, 2026. Two weeks later, on May 16, 2026, …"), the reader cannot tell which is right. It happens when a schedule moves and only the date or only the length is changed. The date right after "N days later" or "N weeks earlier" is compared with the nearest earlier date in the same sentence (or in the previous sentence when the sentence opens with the relative length), plus or minus the length.'
+  ja: 「10月2日に申し込み、3日後の10月6日に通知」のように、相対の期間と日付を一緒に書くと、読み手はどちらが正しいのか分かりません。日程をずらしたときに、日付か期間の片方だけを直すと起きます。「3日後の」「1か月前の」のすぐ後ろの日付を、同じ文で前にある日付（文が「2週間後、」で始まるなら前の文の日付）に期間を足した（前なら引いた）日と比べます。メールや議事録の「来週月曜（10月12日）」「明日（10月7日）」も、メールや議事録の頭の日付の欄（「日付：」「日時：」）の日付から数えた日と比べます。週は月曜からとも日曜からとも、「来週月曜」はすぐ次の月曜とも読み、どの読み方にも合わない日付だけを指します。
+  en: 'When a relative length and a date are written together ("Applications open on May 1, 2026. Two weeks later, on May 16, 2026, …"), the reader cannot tell which is right. It happens when a schedule moves and only the date or only the length is changed. The date right after "N days later" or "N weeks earlier" is compared with the nearest earlier date in the same sentence (or in the previous sentence when the sentence opens with the relative length), plus or minus the length. A day word in an email or minutes ("next Monday (October 12)", "tomorrow (October 7)") is compared with the day it counts to from the date field at the head of the email or the minutes ("Date:"). A week may start on Monday or on Sunday, and "next Monday" may be the coming Monday; only a date that fits none of these readings is reported.'
 
 message:
   ja: "{base}の{relative}なら{expected}のはずですが、{target}と書かれています"
@@ -42,8 +42,8 @@ example:
       Applications close on May 1, 2026. Two weeks later, on May 15, 2026, results are sent.
 
 not_flagged:
-  ja: 期間のすぐ後ろ（「の」や読点だけを挟む）に日付があるときだけ見ます。基準の日付が同じ文（文の頭の「2週間後、」なら前の文）に無いもの、「3営業日後」のように単位が日・週・月・年でないものは見ません。
-  en: Only a date right after the relative length (with "on" or punctuation between) is checked. A relative length with no date before it in the same sentence (or the previous one, when the sentence opens with it), and units other than days, weeks, months and years ("3 business days later"), are left alone.
+  ja: 期間のすぐ後ろ（「の」や読点だけを挟む）に日付があるときだけ見ます。基準の日付が同じ文（文の頭の「2週間後、」なら前の文）に無いもの、「3営業日後」のように単位が日・週・月・年でないものは見ません。「来週月曜」「明日」は、頭に日付の欄が無い文書、すぐ後ろに日付の無い語、引用した返信の中の語、日付を名指す見出しの節（「## 10月1日の会」）の語は見ません。
+  en: Only a date right after the relative length (with "on" or punctuation between) is checked. A relative length with no date before it in the same sentence (or the previous one, when the sentence opens with it), and units other than days, weeks, months and years ("3 business days later"), are left alone. A day word ("next Monday", "tomorrow") is left alone when the document has no date field at its head, when no date follows the word, in a quoted reply, and in a section whose heading names a date ("## October 1 meeting").
 rewrite:
   depth: light
   ja:

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/undefined-acronym.yaml

@@ -49,6 +49,7 @@ use_for: [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."
+  academic: measured by yarn rules:measure
 sources: [plain-2011, jis-z8301-2019]
 
 group: readability

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/version-mismatch.yaml

@@ -0,0 +1,77 @@
+id: version-mismatch
+layer: L1
+status: stable
+how_to_find: version-mismatch
+requires: [markdown]
+severity: warning
+
+name:
+  ja: 説明の版とコードの版が違う
+  en: The version in the text is not the one in the code
+
+why:
+  ja: 「2.3.0 を入れます」のすぐ下のコマンドが「tidyq@2.4.0」だと、読み手はどちらを入れればよいか分かりません。新しい版を出したときに、コード例か説明の片方だけを直すと起きます。コードブロックのすぐ上の段落に書いた版（2.3.0 のように点で三つに区切った番号）を、そのコードブロックにある版と比べます。コードに版がちょうど一つあり、段落の版がそれと違うとき指します。
+  en: 'When "Install version 2.3.0" sits right above a command that installs tidyq@2.4.0, the reader cannot tell which to install. It happens when a release updates the example or the text but not both. chaff compares a version written in the paragraph right above a code block (a number in three dotted parts, such as 2.3.0) with the version the block shows. It reports when the block shows exactly one version and the paragraph names another.'
+
+message:
+  ja: 「{written}」と書いていますが、すぐ下のコードは {code} です
+  en: '"{written}" is written, but the code below has {code}'
+
+how_to_fix:
+  ja: 説明とコードのどちらが今の版かを確かめて、もう一方を直してください。
+  en: Check which of the text and the code has the current version, and correct the other.
+
+levels: { strict: error, normal: warning, 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: facts
+summary:
+  ja: コードブロックのすぐ上の説明が名指す版と、コードの版が違う所
+  en: A version named right above a code block that the block does not use
+example:
+  ja:
+    config: { genre: technical/readme }
+    before: |
+      # インストール
+
+      npm から 2.3.0 を入れます。
+
+      ```bash
+      npm install --global tidyq@2.4.0
+      ```
+    after: |
+      # インストール
+
+      npm から 2.4.0 を入れます。
+
+      ```bash
+      npm install --global tidyq@2.4.0
+      ```
+  en:
+    config: { genre: technical/readme }
+    before: |
+      # Installation
+
+      Install version 2.3.0 from npm:
+
+      ```bash
+      npm install --global tidyq@2.4.0
+      ```
+    after: |
+      # Installation
+
+      Install version 2.4.0 from npm:
+
+      ```bash
+      npm install --global tidyq@2.4.0
+      ```
+
+not_flagged:
+  ja: 版の無いコードブロック、版が二つ以上あるコードブロック（「2.3.0 から 2.4.0 へ」の更新）、範囲の端や起点として書いた版（「2.3.0 から」「20.0.0 以上」）、別のプログラムの名前のすぐ後ろの版（「Node.js 18.17.0 が必要」）、見出しや箇条書きや表の版、版だけの行、二つに区切った番号（22.04、3.1）と先頭が四桁の番号（2024.01.15）は比べません。
+  en: 'A code block with no version or with two or more (an upgrade from one to the other), a version written as a bound or a starting point ("from 2.3.0", "20.0.0 or later"), a version right after the name of another program ("Requires Node.js 18.17.0"), a version in a heading, a list item, a table or a line of its own, and numbers in two parts (22.04, 3.1) or with a four-digit first part (2024.01.15) are not compared.'

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);