chaffjs 0.7.0 → 0.9.0

package/dist/watch.js.map

@@ -1 +1 @@
-{"version":3,"file":"watch.js","sourceRoot":"","sources":["../src/watch.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"watch.js","sourceRoot":"","sources":["../src/watch.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "chaffjs",
-  "version": "0.7.0",
+  "version": "0.9.0",
   "description": "Prose validation harness. Finds what is hard to read, and never rewrites it for you.",
   "keywords": [
     "chaff",
@@ -40,7 +40,9 @@
     "README.md",
     "bin",
     "dist",
+    "profiles",
     "rules",
+    "skills",
     "src"
   ],
   "engines": {
@@ -52,8 +54,8 @@
   },
   "dependencies": {
     "@anthropic-ai/sdk": "^0.125.0",
-    "@chaffjs/lang-en": "0.6.0",
-    "@chaffjs/lang-ja": "0.6.0",
+    "@chaffjs/lang-en": "0.7.0",
+    "@chaffjs/lang-ja": "0.8.0",
     "mdast-util-from-markdown": "^2.0.3",
     "mdast-util-frontmatter": "^2.0.1",
     "mdast-util-gfm-table": "^2.0.0",

package/profiles/statute.yaml

@@ -0,0 +1,62 @@
+id: statute
+
+name:
+  ja: 法令
+  en: Statute
+
+why:
+  ja: 法令は条・項・号の番地を漢数字で書き（第二十二条第二項）、各号・及び・本文のような語で番地をつなぎます。番地は割れない一つの単位で、漢字の連なりとして数えません。
+  en: A statute writes its addresses in kanji numerals (第二十二条第二項) and joins them with words such as 各号, 及び or 本文. An address is one unit that cannot be broken up, and is not counted as a run of kanji.
+
+# 設定（chaff.yaml の profile / by_path）が無いときに、内容から選ぶ。この形の行が min_lines 行以上あれば法令として読む。
+detect:
+  ja:
+    line: "^第[〇一二三四五六七八九十百千]+条(?:の[〇一二三四五六七八九十百千]+)*[　 ]"
+    min_lines: 3
+
+ja:
+  # 番地の書き方。第 + 漢数字 + 単位、枝番号（の二）が続いてもよい。
+  # 「前二項」「前三条」は直前の二つの項・三つの条を指す番地で、数量ではない。「前二年」は期間なので書かない。
+  addresses:
+    - "第[〇一二三四五六七八九十百千]+[条項号章節款目編](?:の[〇一二三四五六七八九十百千]+)*"
+    - "前[〇一二三四五六七八九十百千]+[条項号章節款目編]"
+  # 番地と番地のあいだ、番地の後ろに付く語。
+  connectives: [各号, 各項, 及, 又, 若, 並, 中, 本文, 前段, 後段, 但書, 同条, 乃至]
+  # 番地の並びのすぐ後ろに来てよい文字。漢字が続けば、番地ではなく普通の語（第一条件、第五条中央銀行、前二項目標）。
+  address_end: "[^\\p{Script=Han}]|$"
+  # 条の見出しは、条の前の行に括弧だけで書く（「（解雇の予告）」）。括弧の中が、すぐ次の条の見出しになる。
+  caption: "^[ \\t\u3000]*[（(]([^（）()]{1,40})[）)][ \\t\u3000]*$"
+  # 書いた場所から番地が決まる参照（前条・次項・同号・本条・前各項・前二項・前条第二項）。
+  relative:
+    before: [前]
+    after: [次]
+    same: [同]
+    current: [本]
+    every: [各]
+    count: "[〇一二三四五六七八九十百千]+"
+    # 単位の語と、lang-ja が付ける木の深さ（編 -2・章 -1・節 0・条 1・項 2・号 3）。
+    units: { 編: -2, 章: -1, 節: 0, 条: 1, 項: 2, 号: 3 }
+    suffix_prefix: 第
+    # 法令は第 1 項に番号を振らない。
+    implicit_first: 項
+    # 漢字の後ろの「前条」は語の一部（事前条件）。後ろの決まりは address_end と connectives を使う。
+    not_after: "\\p{Script=Han}"
+    # 読み替え（「『前条』とあるのは『…』と読み替える」）の括弧の中の前条・同項は、読み替える先の文の言葉。
+    substitution: { open: 「, close: 」, after: [とあるのは], before: [とあるのは, とあるのは、] }
+    # 条を書かない「第一項」「第二号」は、書いた条・項の中を指す。
+    inside: [項, 号]
+    # 並びをつなぐもの（正規表現）。「第三十三条第七項若しくは第九項」の「第九項」は、前の参照（第三十三条）の続き。
+    # 号の下の「イ」「ロ」と枝番号の「の二」も、並びの途中に挟まる番地の一部。
+    joiners:
+      - 及び
+      - 並びに
+      - 若しくは
+      - 又は
+      - から
+      - まで
+      - ただし書
+      - 、
+      - "[イロハニホヘトチリヌルヲワカヨタレソツネナラム]"
+      - "の[〇一二三四五六七八九十百千]+"
+    # 並びの途中に挟まる括弧書き。
+    aside: { open: （, close: ） }

package/skills/chaff/SKILL.md

@@ -0,0 +1,81 @@
+---
+name: chaff
+description: "Check prose with chaff (npx chaffjs): run it on Markdown or text, read each finding, fix the text or record why not, and tune chaff.yaml with rules --json and relax --why. Use when asked to lint, proofread or tighten documents, or to set up a team's writing rules."
+---
+
+# Checking writing with chaff
+
+chaff finds what makes writing hard to read — long sentences, padding, mixed styles, broken references in a
+contract — and never rewrites anything. Reading the findings and changing the text is your part. Japanese and
+English documents both work; the language is detected per file.
+
+## Run it
+
+```sh
+npx chaffjs <file|dir|glob>...     # human-readable, one block per finding (a folder or glob picks up .md / .markdown / .mdx; name a .txt file directly)
+npx chaffjs . --compact            # two lines per finding: line:col severity message, then the rule id
+npx chaffjs <file> --experimental  # also the experimental rules
+```
+
+A run exits 1 when a finding is an `error`. It also exits 1 when it could not check anything: no file to
+check, an unknown `--genre`, no package for the language. So a clean exit means the files were checked.
+
+After the findings comes the list of rules that did not run, and why. Only the default output shows it;
+`--compact` gives just their number. Read it before saying a document is clean.
+
+A run over several files prints only the files that have findings. To call one file clean, run chaff on that
+file alone and read its list.
+
+## For each finding, choose one of three
+
+| | When | How |
+| --- | --- | --- |
+| Fix the text | The finding is right | Edit the sentence. Keep the meaning, the facts and the numbers; change only how it is said. |
+| Silence that spot | Right in general, wrong here (a quotation, a term that must repeat) | `<!-- stet: rule-id — reason -->` before it; `stet-section` / `stet-file` for wider scope. Always give the reason. |
+| Change the rule | Wrong for this team or genre | `npx chaffjs relax <rule-id> --why "reason"` (or `strict` / `off`). The reason and date are written into `chaff.yaml`. |
+
+`npx chaffjs explain <rule-id>` shows why a rule exists, its levels and the current one. Read it before
+relaxing a rule.
+
+## Tune chaff.yaml
+
+- `npx chaffjs init` writes a commented `chaff.yaml` when there is none (an existing one is left as it is), and
+  adds `.chaff-cache/` and `.env*` to `.gitignore`.
+- `npx chaffjs rules --json` prints every rule with its levels, the setting in effect (`now`) and why a rule is
+  off. Read it instead of guessing rule names or limits.
+- A level is `strict` / `normal` / `relaxed` / `off`; when even `relaxed` is too tight, a positive number is the
+  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 (`npx chaffjs genres` lists them); `--genre` overrides it for one run.
+
+## Structured documents
+
+- `npx chaffjs tree <file>` shows a contract or specification as a tree of addresses (`3.2` for 第3条第2項 or
+  Section 3.2). `--experimental` adds the structure rules: references to missing provisions, numbering gaps,
+  terms defined twice.
+- `npx chaffjs cite <source> <quotes.json>` checks that quotations (`[{ "address", "quote" }]`) are really in
+  the source; exit 1 if any is not. Use it to back every quotation you put in an answer or a summary.
+
+## When chaff is wrong
+
+If a finding is wrong for the text (a false positive), or chaff missed something it should catch, draft a report
+for the chaff project:
+
+```sh
+npx chaffjs feedback <file> --rule <rule-id> [--line N]   # a wrong finding
+npx chaffjs feedback <file> --missed --line N             # something missed
+```
+
+It writes `.chaff-feedback.md`: chaff's version, Node and OS, the file name, the one finding, the two lines on
+each side of it, and the reported rule's setting in `chaff.yaml` (all of `chaff.yaml` only with `--with-config`).
+When a rule has several findings in the file, add `--line` to pick one. It prints how to send the draft
+(`gh issue create …`, or a link that carries the title only). It sends nothing. Show the draft to the person and let
+them decide; their document may be private.
+
+## Do not
+
+- Do not change what a document says to satisfy a rule. If a finding cannot be fixed without changing the
+  meaning, leave it and say so.
+- Do not turn a rule off to make a run pass; relax it with a reason the team would accept.
+- Do not report "no findings" without reading the not-run list.

package/src/adapter-load.ts

@@ -59,13 +59,41 @@ const LANGUAGE_ID = /^[a-z]{2,3}$/u;
 export const packageFor = (language: string): string | undefined =>
   ADAPTER_PACKAGE[language] ?? (LANGUAGE_ID.test(language) ? `@chaffjs/lang-${language}` : undefined);
 
-const importAdapter = async (specifier: string, language: string): Promise<unknown> => {
+/**
+ * 探す順。公式（`@chaffjs/lang-<言語>`）が先で、無ければ第三者の `chaff-lang-<言語>`。
+ * `@typescript-eslint/*` と `eslint-plugin-*` の分け方と同じで、README にもそう書いてある。同梱の言語は表のものだけ。
+ */
+export const packagesFor = (language: string): readonly string[] => {
+  if (ADAPTER_PACKAGE[language] !== undefined) return [ADAPTER_PACKAGE[language]];
+  return LANGUAGE_ID.test(language) ? [`@chaffjs/lang-${language}`, `chaff-lang-${language}`] : [];
+};
+
+export type Importer = (specifier: string) => Promise<unknown>;
+
+/**
+ * そのパッケージ自体が入っていないときだけ真。入っているパッケージが自分の依存を見つけられないときも同じ
+ * ERR_MODULE_NOT_FOUND になるので、Node の文言が探した名前を挙げているかで分ける。
+ */
+export const isAbsent = (err: unknown, specifier: string): boolean =>
+  err instanceof Error && "code" in err && err.code === "ERR_MODULE_NOT_FOUND" && err.message.includes(`'${specifier}'`);
+
+/** 入っている最初のものを読む。入っていないのは次へ。入っていて壊れているものは、次へ行かずにそのまま投げる。 */
+const importFirst = async (specifiers: readonly string[], language: string, importer: Importer): Promise<{ specifier: string; module: unknown }> => {
+  const [first, ...rest] = specifiers;
+  if (first === undefined) throw new Error(`no adapter for language "${language}"`);
   try {
-    return await import(specifier);
+    return { specifier: first, module: await importer(first) };
   } catch (err) {
-    const missing = err instanceof Error && "code" in err && err.code === "ERR_MODULE_NOT_FOUND";
-    if (missing) throw new Error(`言語 ${language} のパッケージ ${specifier} が入っていません（npm i -D ${specifier}）`, { cause: err });
-    throw err;
+    if (!isAbsent(err, first)) throw err;
+    if (rest.length > 0) return importFirst(rest, language, importer);
+    const all = packagesFor(language);
+    const install = `npm i -D ${all[0] ?? first}`;
+    // Only the requested language is known here; a Japanese message for Japanese, English for any other.
+    const message =
+      language === "ja"
+        ? `言語 ${language} のパッケージが入っていません（${all.join(" か ")}。${install}）`
+        : `No package for language ${language} is installed (${all.join(" or ")}; ${install})`;
+    throw new Error(message, { cause: err });
   }
 };
 
@@ -74,13 +102,16 @@ const importAdapter = async (specifier: string, language: string): Promise<unkno
  * core だけで起動し、文字種で言語を当ててから、その言語のアダプタを読む。
  * 全言語を静的に import すると、使わない言語のぶんまで npx の初回取得が膨らむ。
  */
-export const loadAdapter = async (language: string): Promise<LanguageAdapter> => {
-  const specifier = packageFor(language);
-  if (specifier === undefined) throw new Error(`no adapter for language "${language}"`);
-  const module = await importAdapter(specifier, language);
+export const loadAdapter = async (language: string, importer: Importer = (specifier) => import(specifier)): 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);
   const broken = checkAdapter(candidate);
-  if (broken !== undefined || !isAdapter(candidate)) throw new Error(`${specifier} が LanguageAdapter を export していません: ${broken ?? ""}`);
+  if (broken !== undefined || !isAdapter(candidate)) {
+    const why = broken ?? "";
+    throw new Error(
+      language === "ja" ? `${specifier} が LanguageAdapter を export していません: ${why}` : `${specifier} does not export a LanguageAdapter: ${why}`,
+    );
+  }
   return candidate;
 };

package/src/address-chain.ts

@@ -0,0 +1,113 @@
+import type { DocumentProfile, Span } from "./plugin.ts";
+
+/**
+ * 番地は、つなぎの語（各号・及び・本文 …）を挟んで続く。番地とつなぎの並び全体を一つとして探す。
+ * 番地の書き方、つなぎの語、並びの後ろに来てよい文字は文書の種類（profiles/*.yaml）が持ち、ここは並べ方だけを知る。
+ *
+ * 番地は、その位置で正規表現が当たるとおりに一度だけ取り、後ろに合わせて縮めない。縮めると「第五十二条の二中央銀行」の
+ * 「第五十二条」が番地になってしまう。並びは、番地かつなぎの語で終わる切れ目のうち、後ろの決まりを満たす最も長いところまで。
+ */
+const escape = (word: string): string => word.replace(/[.*+?^${}()|[\]\\]/gu, "\\$&");
+
+type Compiled = { readonly find: RegExp; readonly address: RegExp; readonly connective: RegExp | undefined; readonly end: RegExp | undefined };
+
+const compile = (profile: DocumentProfile): Compiled | undefined => {
+  if (profile.addresses.length === 0) return undefined;
+  const address = `(?:${profile.addresses.join("|")})`;
+  return {
+    find: new RegExp(address, "gu"),
+    address: new RegExp(address, "uy"),
+    connective: profile.connectives.length === 0 ? undefined : new RegExp(`(?:${profile.connectives.map(escape).join("|")})`, "uy"),
+    end: profile.addressEnd === undefined ? undefined : new RegExp(`(?=${profile.addressEnd})`, "uy"),
+  };
+};
+
+const compiled = new WeakMap<DocumentProfile, Compiled | undefined>();
+
+const patternsOf = (profile: DocumentProfile): Compiled | undefined => {
+  if (!compiled.has(profile)) compiled.set(profile, compile(profile));
+  return compiled.get(profile);
+};
+
+/** at から pattern が当たれば、その終わり。空の一致は当たらなかったことにする。 */
+const matchEnd = (pattern: RegExp | undefined, text: string, at: number): number | undefined => {
+  if (pattern === undefined) return undefined;
+  pattern.lastIndex = at;
+  const found = pattern.exec(text);
+  return found === null || found[0] === "" ? undefined : at + found[0].length;
+};
+
+const endsHere = (patterns: Compiled, text: string, at: number): boolean => {
+  if (patterns.end === undefined) return true;
+  patterns.end.lastIndex = at;
+  return patterns.end.test(text);
+};
+
+type Cut = { readonly end: number; readonly addresses: number };
+
+/** at から続くつなぎの語を読み、その切れ目を cuts に足す。読み終えた位置を返す。 */
+const readConnectives = (patterns: Compiled, text: string, at: number, addresses: number, cuts: Cut[]): number => {
+  let position = at;
+  for (let next = matchEnd(patterns.connective, text, position); next !== undefined; next = matchEnd(patterns.connective, text, position)) {
+    position = next;
+    cuts.push({ end: position, addresses });
+  }
+  return position;
+};
+
+/**
+ * 番地の後ろから並びを読み、切れ目（番地かつなぎの語の終わり）と、そこまでの番地を集める。
+ * 並びは設定しだいでいくらでも長くなるので、再帰せずに読む。
+ */
+const readChain = (patterns: Compiled, text: string, first: Span): { spans: Span[]; cuts: Cut[] } => {
+  const spans: Span[] = [first];
+  const cuts: Cut[] = [{ end: first.end, addresses: 1 }];
+  let at = first.end;
+  for (;;) {
+    const next = readConnectives(patterns, text, at, spans.length, cuts);
+    const addressEnd = matchEnd(patterns.address, text, next);
+    if (addressEnd === undefined) return { spans, cuts };
+    spans.push({ start: next, end: addressEnd });
+    cuts.push({ end: addressEnd, addresses: spans.length });
+    at = addressEnd;
+  }
+};
+
+/** start から始まる並び。後ろの決まりを満たす切れ目が無ければ、並びではない。 */
+const chainAt = (patterns: Compiled, text: string, start: number): { readonly spans: readonly Span[]; readonly end: number } | undefined => {
+  const firstEnd = matchEnd(patterns.address, text, start);
+  if (firstEnd === undefined) return undefined;
+  const { spans, cuts } = readChain(patterns, text, { start, end: firstEnd });
+  const cut = [...cuts].reverse().find((candidate) => endsHere(patterns, text, candidate.end));
+  return cut === undefined ? undefined : { spans: spans.slice(0, cut.addresses), end: cut.end };
+};
+
+/** 1 文字先。絵文字のような 2 単位の文字の途中に止まると、同じ位置の空の一致を繰り返す。 */
+const nextCharacter = (text: string, at: number): number => at + ((text.codePointAt(at) ?? 0) > 0xffff ? 2 : 1);
+
+/**
+ * 並びとして認めた範囲の中の番地の範囲。「第一条件」「前二項中央銀行」のように後ろが語に続くものは、並びにならないので含まない。
+ * 漢字の連なりを数える側も数量を読む側も、同じ範囲を使う。
+ */
+export const addressSpans = (text: string, profile: DocumentProfile | undefined): Span[] => {
+  const patterns = profile === undefined ? undefined : patternsOf(profile);
+  if (patterns === undefined) return [];
+  const spans: Span[] = [];
+  patterns.find.lastIndex = 0;
+  for (let found = patterns.find.exec(text); found !== null; found = patterns.find.exec(text)) {
+    const chain = chainAt(patterns, text, found.index);
+    spans.push(...(chain?.spans ?? []));
+    patterns.find.lastIndex = chain === undefined ? nextCharacter(text, found.index) : chain.end;
+  }
+  return spans;
+};
+
+/** 番地を空白にする。空白が連なりを切るので、番地は数えられず、前後は別の連なりになる。 */
+export const maskAddresses = (text: string, profile: DocumentProfile | undefined): string => {
+  const spans = addressSpans(text, profile);
+  if (spans.length === 0) return text;
+  const pieces: string[] = [];
+  spans.forEach((span, index) => pieces.push(text.slice(spans[index - 1]?.end ?? 0, span.start), " "));
+  pieces.push(text.slice(spans.at(-1)?.end ?? 0));
+  return pieces.join("");
+};

package/src/cli-args.ts

@@ -0,0 +1,9 @@
+/**
+ * Options of the commands that take files to check, whose value is the next argument. That value is not a file.
+ * `--why` (relax), `--format` and `--language` (tree) belong to commands that read their own arguments.
+ */
+export const VALUE_FLAGS: readonly string[] = ["--sarif", "--genre", "--rule", "--line"];
+
+/** The arguments that name what to check: everything that is neither an option nor an option's value. */
+export const targetsOf = (args: readonly string[]): string[] =>
+  args.filter((arg, index) => !arg.startsWith("--") && !(index > 0 && VALUE_FLAGS.includes(args[index - 1] ?? "")));

package/src/cli-text.ts

@@ -0,0 +1,186 @@
+// What the command line says, in Japanese and English. Per-file text follows the file's language; the rest
+// follows hostLanguage (chaff.yaml's language, else the terminal's locale).
+import type { Texts } from "./ui.ts";
+
+/** Where a file's genre came from, as the header names it. */
+export type GenreSource = "--genre" | "by_path" | "config" | "default" | "front-matter" | "path" | "content";
+
+const USAGE_JA = `chaff — 文章の読みにくいところを見つけます。文章は書き換えません。
+
+  chaff <file|dir|glob>...       検査する（設定も API key も要りません）
+  chaff .                        この場所の Markdown を全部
+  chaff test <file|dir>...       意味を読む検査も動かす（API key が要ります）
+                                 判定役は chaff.yaml の ai_backend で選びます
+  chaff init                     chaff.yaml を作る
+  chaff eval <dir>               手元の文書で閾値を測り直す
+  chaff explain <rule>           そのルールの意図と根拠を読む
+  chaff genres                   ジャンルの一覧
+  chaff tree <file> [--format sexp|json]  文書を番地の付いた木にする（条・項・定義・参照）
+  chaff cite <原文> <引用.json>           回答の引用（番地と引用文）が原文にあるかを確かめる
+  chaff rules --json             いまの設定を JSON で出す（AI に渡す用）
+  chaff baseline <dir>           いまある指摘を棚上げする（既存の repo に入れるとき）
+  chaff suppressions <dir>       stet で黙らせている指摘を数える
+  chaff relax|strict|off <rule> [--why "理由"]
+  chaff skill [--global]         Claude Code の skill を入れる（.claude/skills/chaff/、--global で ~/.claude/）
+  chaff feedback <file> --rule <rule> [--line N] | --missed --line N
+                                 誤った指摘・見逃しの報告の下書きを作る（何も送らない。--with-config で chaff.yaml 全体も載せる）
+
+  --compact         エンジニア向けの 1 行形式
+  --experimental    試験中の rule も動かす
+  --genre <ジャンル>  この実行だけジャンルを決める（chaff.yaml より優先）
+  --show-baseline   棚上げした分も含めて全部見る
+  --watch           保存のたびに見直し、変わったところだけ出す
+  --dry-run         test で、何を AI に送るかだけを見る（API を呼びません）
+  --sarif <path>    指摘を SARIF で書き出す（GitHub の PR の行に出すため）
+
+この箇所だけ黙らせる:  <!-- stet: rule-id — 理由 -->
+
+値は strict / normal / relaxed / off の 4 つから選びます。
+`;
+
+const USAGE_EN = `chaff — finds what makes writing hard to read. It never rewrites the text.
+
+  chaff <file|dir|glob>...       check (no config or API key needed)
+  chaff .                        every Markdown file here
+  chaff test <file|dir>...       also run the checks that read meaning (needs an API key)
+                                 the judge is chosen by ai_backend in chaff.yaml
+  chaff init                     create chaff.yaml
+  chaff eval <dir>               re-measure the limits on your own documents
+  chaff explain <rule>           read what a rule is for and why
+  chaff genres                   list the genres
+  chaff tree <file> [--format sexp|json]  the document as a tree of addresses (sections, clauses, definitions, references)
+  chaff cite <source> <quotes.json>       check that quoted passages (address and text) are in the source
+  chaff rules --json             the current settings as JSON (to give to an AI)
+  chaff baseline <dir>           shelve today's findings (when adding chaff to an existing repository)
+  chaff suppressions <dir>       count the findings silenced with stet
+  chaff relax|strict|off <rule> [--why "reason"]
+  chaff skill [--global]         install the Claude Code skill (.claude/skills/chaff/; --global for ~/.claude/)
+  chaff feedback <file> --rule <rule> [--line N] | --missed --line N
+                                 draft a report of a wrong or missed finding (sends nothing; --with-config adds all of chaff.yaml)
+
+  --compact         one line per finding, for engineers
+  --experimental    run the experimental rules too
+  --genre <genre>   the genre for this run only (wins over chaff.yaml)
+  --show-baseline   show the shelved findings too
+  --watch           re-check on every save and print only what changed
+  --dry-run         with test, show what would be sent to the AI (no API call)
+  --sarif <path>    write the findings as SARIF (for comments on a GitHub PR)
+
+Silence one spot:  <!-- stet: rule-id — reason -->
+
+A rule's level is one of strict / normal / relaxed / off.
+`;
+
+export type CliText = {
+  readonly usage: string;
+  readonly languageName: (language: string) => string;
+  readonly genreSource: Readonly<Record<GenreSource, string>>;
+  readonly header: (path: string, genre: string, language: string, from: string, shelved: number, hushed: number) => string;
+  readonly noMarkdown: (targets: string) => string;
+  readonly noMarkdownHere: string;
+  readonly noAdapter: (language: string) => string;
+  readonly unknownGenre: (genre: string) => string;
+  readonly unknownRule: (id: string) => string;
+  readonly unknownRuleWithList: (id: string, list: string) => string;
+  readonly unnamed: string;
+  readonly sarifWritten: (path: string, count: number) => string;
+  readonly unchanged: string;
+  readonly findingsUnit: string;
+  readonly watching: (files: number, findings: number) => string;
+  readonly watchHint: string;
+  readonly baselineDone: (files: number, entries: number, file: string) => readonly string[];
+  readonly genres: (list: readonly string[]) => string;
+  readonly unit: (ruleId: string, language: string) => string;
+};
+
+export const CLI_TEXT: Texts<CliText> = {
+  ja: {
+    usage: USAGE_JA,
+    languageName: (language) => (language === "ja" ? "日本語" : "英語"),
+    genreSource: {
+      "--genre": "--genre",
+      by_path: "chaff.yaml の by_path",
+      config: "chaff.yaml",
+      default: "既定",
+      "front-matter": "front matter",
+      path: "パス",
+      content: "内容",
+    },
+    header: (path, genre, language, from, shelved, hushed) =>
+      [`${path}   ${genre} · ${language}   ジャンルは${from}から`, shelved > 0 ? `   棚上げ ${shelved} 件` : "", hushed > 0 ? `   stet ${hushed} 件` : ""].join(
+        "",
+      ),
+    noMarkdown: (targets) => `Markdown が 1 つも見つかりませんでした: ${targets}`,
+    noMarkdownHere: "Markdown が 1 つも見つかりませんでした。",
+    noAdapter: (language) => `言語 "${language}" のアダプタがありません。`,
+    unknownGenre: (genre) => `ジャンル "${genre}" はありません。npx chaff genres で一覧が出ます。`,
+    unknownRule: (id) => `${id} というルールはありません。npx chaff rules --json で一覧が出ます。`,
+    unknownRuleWithList: (id, list) => `${id} というルールはありません。\n一覧:\n${list}`,
+    unnamed: "(名前なし)",
+    sarifWritten: (path, count) => `\n  SARIF を書きました: ${path}（${count} 件）`,
+    unchanged: "変わりませんでした",
+    findingsUnit: " 件",
+    watching: (files, findings) => `\n  ${files} ファイルを見ています。いまの指摘は ${findings} 件です。`,
+    watchHint: "  保存するたびに、変わったところだけ出します。止めるには Ctrl-C。\n",
+    baselineDone: (files, entries, file) => [
+      "",
+      `  ${files} ファイルを走査しました。`,
+      "",
+      `  ${entries} 件の指摘を ${file} に記録しました。`,
+      "  以後、これらは報告されません。新しく増えたものだけが出ます。",
+      "",
+      `  ${file} を commit してください。`,
+      "",
+    ],
+    genres: (list) =>
+      ["", "  使えるジャンル:", ...list.map((genre) => `    ${genre}`), "", "  chaff.yaml の genre に書くか、--genre で指定します。", ""].join("\n"),
+    unit: (ruleId, language) => {
+      if (ruleId === "bold-density") return "1000 字あたりの箇所数";
+      if (ruleId !== "max-sentence-length") return "回";
+      return language === "ja" ? "文字" : "語";
+    },
+  },
+  en: {
+    usage: USAGE_EN,
+    languageName: (language) => (language === "ja" ? "Japanese" : "English"),
+    genreSource: {
+      "--genre": "--genre",
+      by_path: "by_path in chaff.yaml",
+      config: "chaff.yaml",
+      default: "the default",
+      "front-matter": "front matter",
+      path: "the path",
+      content: "the content",
+    },
+    header: (path, genre, language, from, shelved, hushed) =>
+      [`${path}   ${genre} · ${language}   genre from ${from}`, shelved > 0 ? `   ${shelved} shelved` : "", hushed > 0 ? `   ${hushed} stet` : ""].join(""),
+    noMarkdown: (targets) => `No Markdown files found: ${targets}`,
+    noMarkdownHere: "No Markdown files found.",
+    noAdapter: (language) => `No language package for "${language}".`,
+    unknownGenre: (genre) => `There is no genre "${genre}". npx chaff genres lists them.`,
+    unknownRule: (id) => `There is no rule named ${id}. npx chaff rules --json lists them.`,
+    unknownRuleWithList: (id, list) => `There is no rule named ${id}.\nRules:\n${list}`,
+    unnamed: "(no name)",
+    sarifWritten: (path, count) => `\n  Wrote SARIF: ${path} (${count} finding${count === 1 ? "" : "s"})`,
+    unchanged: "no change",
+    findingsUnit: " findings",
+    watching: (files, findings) => `\n  Watching ${files} file${files === 1 ? "" : "s"}. ${findings} finding${findings === 1 ? "" : "s"} now.`,
+    watchHint: "  Each save prints only what changed. Ctrl-C to stop.\n",
+    baselineDone: (files, entries, file) => [
+      "",
+      `  Checked ${files} file${files === 1 ? "" : "s"}.`,
+      "",
+      `  Recorded ${entries} finding${entries === 1 ? "" : "s"} in ${file}.`,
+      "  They will not be reported again; only new ones will.",
+      "",
+      `  Commit ${file}.`,
+      "",
+    ],
+    genres: (list) => ["", "  Genres:", ...list.map((genre) => `    ${genre}`), "", "  Set one with genre in chaff.yaml, or with --genre.", ""].join("\n"),
+    unit: (ruleId, language) => {
+      if (ruleId === "bold-density") return "places per 1000 characters";
+      if (ruleId !== "max-sentence-length") return "times";
+      return language === "ja" ? "characters" : "words";
+    },
+  },
+};