chaffjs 0.6.0 → 0.8.0

package/src/cli.ts

@@ -16,6 +16,7 @@ import { runEval } from "./commands/eval.ts";
 import { runTest } from "./commands/test.ts";
 import { frontMatterGenre, guessGenre } from "./genre.ts";
 import { GENRES, runInit } from "./init.ts";
+import { targetsOf } from "./cli-args.ts";
 import { loadRules } from "./rule-load.ts";
 import { renderCompact } from "./render/compact.ts";
 import { renderExplain } from "./render/explain.ts";
@@ -23,62 +24,50 @@ import { renderFriendly } from "./render/friendly.ts";
 import { rulesJson } from "./render/rules-json.ts";
 import { renderSarif } from "./render/sarif.ts";
 import { VERSION } from "./version.ts";
-import { runTree, treeTargets } from "./commands/tree.ts";
+import { runTree, treeTargets, type TreeContext } from "./commands/tree.ts";
 import { citeTargets, runCite } from "./commands/cite.ts";
+import { runSkill } from "./commands/skill.ts";
+import { homedir } from "node:os";
+import { ruleProblems } from "./config/rule-problems.ts";
 import { renderSummary, type FileOutcome } from "./render/summary.ts";
 import { neededBy, runRules } from "./run.ts";
 import type { Level, RuleDefinition } from "./plugin.ts";
+import { CLI_TEXT, type CliText, type GenreSource } from "./cli-text.ts";
+import { hostLanguage, uiLanguageOf, type UiLanguage } from "./ui.ts";
 
-const USAGE = `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 "理由"]
-
-  --compact         エンジニア向けの 1 行形式
-  --experimental    試験中の rule も動かす
-  --show-baseline   棚上げした分も含めて全部見る
-  --watch           保存のたびに見直し、変わったところだけ出す
-  --dry-run         test で、何を AI に送るかだけを見る（API を呼びません）
-  --sarif <path>    指摘を SARIF で書き出す（GitHub の PR の行に出すため）
-
-この箇所だけ黙らせる:  <!-- stet: rule-id — 理由 -->
-
-値は strict / normal / relaxed / off の 4 つから選びます。
-`;
+/** Text for output that is not about one document. */
+const hostText = (config: Config): CliText => CLI_TEXT[hostLanguage(config.language, process.env)];
 
 const readConfig = (): Config => (existsSync(join(process.cwd(), CONFIG_FILE)) ? loadConfig(join(process.cwd(), CONFIG_FILE)) : EMPTY);
 
-const resolveGenre = (path: string, source: string, config: Config): { genre: string; from: string } => {
-  // パスごとの上書きが最優先。「全体はこう、ここだけは違う」を書けるようにする。
+const resolveGenre = (path: string, source: string, config: Config, cliGenre?: string): { genre: string; from: GenreSource } => {
+  // コマンドで指定したものが最優先。その実行だけの指定だから、設定より強い。
+  if (cliGenre !== undefined) return { genre: cliGenre, from: "--genre" };
+  // パスごとの上書きが次。「全体はこう、ここだけは違う」を書けるようにする。
   const override = applyByPath(config.byPath, config.baseDir, path);
-  if (override.genre !== undefined) return { genre: override.genre, from: `${CONFIG_FILE} の by_path` };
-  if (config.genre !== undefined) return { genre: config.genre, from: CONFIG_FILE };
+  if (override.genre !== undefined) return { genre: override.genre, from: "by_path" };
+  if (config.genre !== undefined) return { genre: config.genre, from: "config" };
   const guess = guessGenre(path, source, frontMatterGenre(source));
-  return guess === undefined ? { genre: "blog/tech", from: "既定" } : { genre: guess.genre, from: guess.from };
+  return guess === undefined ? { genre: "blog/tech", from: "default" } : { genre: guess.genre, from: guess.from };
 };
 
+/** resolveGenre with this run's --genre, for the commands that take it as a dependency. */
+const genreFrom =
+  (argv: readonly string[]) =>
+  (path: string, source: string, config: Config): { genre: string; from: GenreSource } =>
+    resolveGenre(path, source, config, flag(argv, "--genre"));
+
 const findRule = (rules: readonly RuleDefinition[], id: string | undefined): RuleDefinition | undefined => rules.find((rule) => rule.id === id);
 
 const changeSetting = (command: Level, ruleId: string | undefined, why: string | undefined): number => {
   const config = readConfig();
-  const rule = findRule(loadRules(config.language ?? "ja"), ruleId);
+  const language = config.language ?? hostLanguage(undefined, process.env);
+  const rule = findRule(loadRules(language), ruleId);
   if (rule === undefined) {
-    console.error(`${ruleId ?? "(名前なし)"} というルールはありません。npx chaff rules --json で一覧が出ます。`);
+    console.error(hostText(config).unknownRule(ruleId ?? hostText(config).unnamed));
     return 1;
   }
-  const outcome = applyLevel(join(process.cwd(), CONFIG_FILE), rule, command, why, config.language ?? "ja", process.env["USER"] ?? "unknown");
+  const outcome = applyLevel(join(process.cwd(), CONFIG_FILE), rule, command, why, language, process.env["USER"] ?? "unknown");
   console.log(outcome.message);
   return outcome.ok ? 0 : 1;
 };
@@ -98,22 +87,22 @@ type Inspected = {
   readonly all: readonly string[];
 };
 
-const headerFor = (path: string, genre: string, from: string, language: string, shelved: number, hushed: number): string => {
-  const shelf = shelved > 0 ? `   棚上げ ${shelved} 件` : "";
-  const stet = hushed > 0 ? `   stet ${hushed} 件` : "";
-  return `${path}   ${genre} \u00b7 ${language === "ja" ? "日本語" : "英語"}   ジャンルは${from}から${shelf}${stet}`;
+/** The first line for a file, in the file's language. */
+const headerFor = (path: string, genre: string, from: GenreSource, language: string, shelved: number, hushed: number): string => {
+  const text = CLI_TEXT[uiLanguageOf(language)];
+  return text.header(path, genre, text.languageName(language), text.genreSource[from], shelved, hushed);
 };
 
 const inspect = async (path: string, config: Config, argv: readonly string[]): Promise<Inspected> => {
   const source = await readFile(path, "utf8");
   const language = applyByPath(config.byPath, config.baseDir, path).language ?? config.language ?? guessLanguage(source).language;
   const adapter = await loadAdapter(language);
-  const { genre, from } = resolveGenre(path, source, config);
+  const { genre, from } = resolveGenre(path, source, config, flag(argv, "--genre"));
   const rules = loadRules(language);
   const experimental = config.experimental || argv.includes("--experimental");
   await adapter.prepare?.(neededBy(rules, config.rules, experimental, genre, language));
   const doc = buildDocument(path, source, adapter, teamRules(config));
-  const raw = runRules(doc, rules, config.rules, experimental, genre);
+  const raw = runRules(doc, rules, config.rules, experimental, genre, config.limits);
   // 応答は 3 つ。stet で黙らせたものは、ここで落とす。
   const applied = applySuppressions(
     source,
@@ -148,26 +137,42 @@ const writeSarif = (results: readonly Inspected[], argv: readonly string[]): voi
   );
   mkdirSync(dirname(path), { recursive: true });
   writeFileSync(path, renderSarif(located, VERSION), "utf8");
-  console.log(`\n  SARIF を書きました: ${path}（${located.length} 件）`);
+  console.log(hostText(readConfig()).sarifWritten(path, located.length));
+};
+
+/** 効いていない設定は、結果の前に一度だけ言う。標準エラーに出すので、JSON や SARIF の出力は汚さない。 */
+const warnRuleProblems = (config: Config, language: string): void => {
+  ruleProblems(config, loadRules(language), hostLanguage(config.language, process.env)).forEach((problem) => console.error(`chaff: ${problem}`));
+};
+
+/** Several files end with one summary: in their language when they share one, else the host's. */
+const summaryLanguage = (results: readonly Inspected[], config: Config): UiLanguage => {
+  const languages = new Set(results.map((result) => uiLanguageOf(result.language)));
+  const [only] = [...languages];
+  return languages.size === 1 && only !== undefined ? only : hostLanguage(config.language, process.env);
 };
 
 const lint = async (targets: readonly string[], argv: readonly string[]): Promise<number> => {
   const paths = collectTargets(targets);
+  const config = readConfig();
   if (paths.length === 0) {
     // 0 件を成功にすると「CI は通っているが何も検証していない」状態が続く。§14。
-    console.error(`Markdown が 1 つも見つかりませんでした: ${targets.join(", ")}`);
+    console.error(hostText(config).noMarkdown(targets.join(", ")));
     return 1;
   }
-  const config = readConfig();
   const language = config.language ?? "ja";
   if (packageFor(language) === undefined) {
-    console.error(`言語 "${language}" のアダプタがありません。`);
+    console.error(hostText(config).noAdapter(language));
     return 1;
   }
+  warnRuleProblems(config, language);
   const results = await Promise.all(paths.map((path) => inspect(path, config, argv)));
   writeSarif(results, argv);
   results.filter((result) => result.outcome.findings.length > 0 || paths.length === 1).forEach((result) => console.log(result.text));
-  renderSummary(results.map((result) => result.outcome)).forEach((line) => console.log(line));
+  renderSummary(
+    results.map((result) => result.outcome),
+    summaryLanguage(results, config),
+  ).forEach((line) => console.log(line));
   return results.some((result) => result.outcome.findings.some((finding) => finding.severity === "error")) ? 1 : 0;
 };
 
@@ -177,11 +182,13 @@ const lint = async (targets: readonly string[], argv: readonly string[]): Promis
  */
 const runWatch = async (targets: readonly string[], argv: readonly string[]): Promise<number> => {
   const paths = collectTargets(targets);
+  const config = readConfig();
+  const text = hostText(config);
   if (paths.length === 0) {
-    console.error(`Markdown が 1 つも見つかりませんでした: ${targets.join(", ")}`);
+    console.error(text.noMarkdown(targets.join(", ")));
     return 1;
   }
-  const config = readConfig();
+  warnRuleProblems(config, config.language ?? "ja");
   const seen = new Map<string, Snapshot>();
   const once = async (path: string, first: boolean): Promise<void> => {
     const result = await inspect(path, config, argv);
@@ -189,13 +196,13 @@ const runWatch = async (targets: readonly string[], argv: readonly string[]): Pr
     const before = seen.get(path) ?? {};
     seen.set(path, after);
     if (first) return;
-    const change = describeChange(before, after);
-    console.log(`${clock()}  ${path}  ${change ?? "変わりませんでした"}`);
+    const change = describeChange(before, after, text.findingsUnit);
+    console.log(`${clock()}  ${path}  ${change ?? text.unchanged}`);
   };
   await Promise.all(paths.map((path) => once(path, true)));
   const totals = [...seen.values()].reduce((sum, snapshot) => sum + Object.values(snapshot).reduce((inner, count) => inner + count, 0), 0);
-  console.log(`\n  ${paths.length} ファイルを見ています。いまの指摘は ${totals} 件です。`);
-  console.log("  保存するたびに、変わったところだけ出します。止めるには Ctrl-C。\n");
+  console.log(text.watching(paths.length, totals));
+  console.log(text.watchHint);
   const stop = watchPaths(paths, (path) => void once(path, false));
   process.on("SIGINT", () => {
     stop();
@@ -206,49 +213,33 @@ const runWatch = async (targets: readonly string[], argv: readonly string[]): Pr
 
 const explain = (ruleId: string | undefined): number => {
   const config = readConfig();
-  const language = config.language ?? "ja";
+  // The rule's limits differ by language (characters for Japanese, words for English): explain in the one being written.
+  const language = config.language ?? hostLanguage(undefined, process.env);
+  const text = CLI_TEXT[uiLanguageOf(language)];
   const rules = loadRules(language);
   const rule = findRule(rules, ruleId);
   if (rule === undefined) {
     const list = rules.map((entry) => `  ${entry.id}`).join("\n");
-    console.error(`${ruleId ?? "(名前なし)"} というルールはありません。\n一覧:\n${list}`);
+    console.error(text.unknownRuleWithList(ruleId ?? text.unnamed, list));
     return 1;
   }
   const current = config.rules[rule.id] ?? (rule.status === "experimental" && !config.experimental ? "off" : "normal");
-  console.log(renderExplain(rule, current, language, unitOf(rule.id, language), config.genre));
+  console.log(renderExplain(rule, current, language, text.unit(rule.id, language), config.genre));
   return 0;
 };
 
-/** 閾値の単位。explain で「4 とは何の 4 か」を示すため。 */
-const unitOf = (ruleId: string, language: string): string => {
-  if (ruleId === "bold-density") return "1000 字あたりの箇所数";
-  if (ruleId !== "max-sentence-length") return "回";
-  return language === "ja" ? "文字" : "語";
-};
-
 const runBaseline = async (targets: readonly string[], argv: readonly string[]): Promise<number> => {
   const paths = collectTargets(targets.length > 0 ? targets : ["."]);
+  const config = readConfig();
   if (paths.length === 0) {
-    console.error("Markdown が 1 つも見つかりませんでした。");
+    console.error(hostText(config).noMarkdownHere);
     return 1;
   }
-  const config = readConfig();
   const results = await Promise.all(paths.map((path) => inspect(path, config, [...argv, "--show-baseline"])));
   const entries = results.flatMap((result) => result.all);
   const file = join(process.cwd(), BASELINE_FILE);
   writeBaseline(file, entries);
-  console.log(
-    [
-      "",
-      `  ${paths.length} ファイルを走査しました。`,
-      "",
-      `  ${entries.length} 件の指摘を ${BASELINE_FILE} に記録しました。`,
-      "  以後、これらは報告されません。新しく増えたものだけが出ます。",
-      "",
-      `  ${BASELINE_FILE} を commit してください。`,
-      "",
-    ].join("\n"),
-  );
+  console.log(hostText(config).baselineDone(paths.length, entries.length, BASELINE_FILE).join("\n"));
   return 0;
 };
 
@@ -256,55 +247,75 @@ const runSuppressions = async (targets: readonly string[], argv: readonly string
   const paths = collectTargets(targets.length > 0 ? targets : ["."]);
   const config = readConfig();
   const results = await Promise.all(paths.map((path) => inspect(path, config, [...argv, "--show-baseline"])));
-  console.log(renderSuppressions(results.map((result) => result.perFile)));
+  console.log(
+    renderSuppressions(
+      results.map((result) => result.perFile),
+      hostLanguage(config.language, process.env),
+    ),
+  );
   return 0;
 };
 
 type Handler = (argv: readonly string[]) => number | Promise<number>;
 
 /** `--` で始まらない引数。対象のパス。 */
-const positional = (argv: readonly string[]): string[] => argv.slice(1).filter((arg) => !arg.startsWith("--"));
+const positional = (argv: readonly string[]): string[] => targetsOf(argv.slice(1));
 
 const showRules = (): number => {
   const config = readConfig();
-  const language = config.language ?? "ja";
+  const language = config.language ?? hostLanguage(undefined, process.env);
+  warnRuleProblems(config, language);
   console.log(rulesJson(loadRules(language), config, language, config.genre ?? "blog/tech"));
   return 0;
 };
 
 const showGenres = (): number => {
-  console.log(["", "  使えるジャンル:", ...GENRES.map((genre) => `    ${genre}`), "", "  chaff.yaml の genre に書くか、--genre で指定します。", ""].join("\n"));
+  console.log(hostText(readConfig()).genres(GENRES));
   return 0;
 };
 
+const treeContext = (): TreeContext => {
+  const config = readConfig();
+  return { config, flag, ui: hostLanguage(config.language, process.env) };
+};
+
 /** 分岐を数珠つなぎにせず表にする。足すときに main を太らせない。 */
 const HANDLERS: Readonly<Record<string, Handler>> = {
   init: (argv) => {
-    runInit(process.cwd(), flag(argv, "--genre") ?? "blog/tech").forEach((line) => console.log(line));
+    runInit(process.cwd(), flag(argv, "--genre") ?? "blog/tech", hostLanguage(readConfig().language, process.env)).forEach((line) => console.log(line));
     return 0;
   },
   genres: showGenres,
   rules: showRules,
   explain: (argv) => explain(argv[1]),
-  eval: (argv) => runEval(positional(argv), argv, { config: readConfig(), resolveGenre, flag }),
-  tree: (argv) => runTree(treeTargets(argv), argv, { config: readConfig(), flag }),
-  cite: (argv) => runCite(citeTargets(argv), argv, { config: readConfig(), flag }),
-  test: (argv) => runTest(positional(argv), argv, { config: readConfig(), resolveGenre, inspect }),
+  eval: (argv) => runEval(positional(argv), argv, { config: readConfig(), resolveGenre: genreFrom(argv), flag }),
+  tree: (argv) => runTree(treeTargets(argv), argv, treeContext()),
+  cite: (argv) => runCite(citeTargets(argv), argv, treeContext()),
+  test: (argv) => runTest(positional(argv), argv, { config: readConfig(), resolveGenre: genreFrom(argv), inspect }),
   baseline: (argv) => runBaseline(positional(argv), argv),
   suppressions: (argv) => runSuppressions(positional(argv), argv),
   relax: (argv) => changeSetting("relaxed", argv[1], flag(argv, "--why")),
   strict: (argv) => changeSetting("strict", argv[1], flag(argv, "--why")),
   off: (argv) => changeSetting("off", argv[1], flag(argv, "--why")),
+  skill: (argv) => runSkill(argv, { cwd: process.cwd(), home: homedir(), ui: hostLanguage(readConfig().language, process.env) }),
 };
 
+/** Every subcommand. Anything else on the command line is a file to check. */
+export const COMMANDS: readonly string[] = Object.keys(HANDLERS);
+
 export const main = async (argv: readonly string[]): Promise<number> => {
   const first = argv[0];
   if (first === undefined || first === "--help" || first === "-h") {
-    console.log(USAGE);
+    console.log(hostText(readConfig()).usage);
     return first === undefined ? 1 : 0;
   }
+  const cliGenre = flag(argv, "--genre");
+  if (cliGenre !== undefined && !GENRES.includes(cliGenre)) {
+    console.error(hostText(readConfig()).unknownGenre(cliGenre));
+    return 1;
+  }
   const handler = HANDLERS[first];
   if (handler !== undefined) return handler(argv);
-  const targets = (first === "lint" ? argv.slice(1) : argv).filter((arg) => !arg.startsWith("--"));
+  const targets = targetsOf(first === "lint" ? argv.slice(1) : argv);
   return argv.includes("--watch") ? runWatch(targets, argv) : lint(targets, argv);
 };

package/src/commands/cite.ts

@@ -1,7 +1,7 @@
 import { checkCitations, type Citation, type CitationResult } from "../structure/cite.ts";
 import { readSource, readTree, type TreeContext } from "./tree.ts";
+import type { Texts, UiLanguage } from "../ui.ts";
 
-const USAGE = "使い方: chaff cite <原文> <引用.json> [--format text|json] [--language ja|en|…]";
 const FORMATS = ["text", "json"];
 const QUOTE_WIDTH = 40;
 const VALUED = ["--format", "--language"];
@@ -15,37 +15,70 @@ const isCitation = (value: unknown): value is Citation => isRecord(value) && typ
 
 export type ParsedCitations = { readonly citations: readonly Citation[] } | { readonly error: string };
 
-const parseJson = (text: string): { readonly value: unknown } | { readonly error: string } => {
+const parseJson = (text: string, ui: UiLanguage): { readonly value: unknown } | { readonly error: string } => {
   try {
     return { value: JSON.parse(text) };
   } catch (err) {
-    return { error: `JSON として読めません: ${err instanceof Error ? err.message : String(err)}` };
+    return { error: TEXT[ui].notJson(err instanceof Error ? err.message : String(err)) };
   }
 };
 
 /** 引用の一覧。[{ address, quote }] の配列だけを受け取る。形が違えば理由を返す。 */
-export const parseCitations = (text: string): ParsedCitations => {
-  const parsed = parseJson(text);
+export const parseCitations = (text: string, ui: UiLanguage = "ja"): ParsedCitations => {
+  const parsed = parseJson(text, ui);
   if ("error" in parsed) return parsed;
-  if (!Array.isArray(parsed.value)) return { error: '引用は配列で渡してください: [{ "address": "3.2", "quote": "…" }]' };
+  if (!Array.isArray(parsed.value)) return { error: TEXT[ui].notArray };
   const entries: readonly unknown[] = parsed.value;
   const bad = entries.findIndex((entry) => !isCitation(entry));
-  if (bad !== -1) return { error: `${String(bad + 1)} 件目に address（文字列）と quote（文字列）がありません` };
+  if (bad !== -1) return { error: TEXT[ui].badEntry(bad + 1) };
   return { citations: entries.filter(isCitation).map((entry) => ({ address: entry.address, quote: entry.quote })) };
 };
 
-const MESSAGES: Readonly<Record<CitationResult["status"], (result: CitationResult) => string>> = {
-  ok: () => "一致",
-  "missing-address": (result) => `番地 ${result.citation.address} は原文にありません`,
-  "quote-elsewhere": (result) => `引用文は ${result.citation.address} ではなく ${result.foundAt ?? "番地の外"}（${String(result.line ?? "?")} 行目）にあります`,
-  "quote-not-found": () => "引用文が原文のどこにもありません",
+type CiteText = {
+  readonly usage: string;
+  readonly quoted: (text: string) => string;
+  readonly notJson: (why: string) => string;
+  readonly notArray: string;
+  readonly badEntry: (n: number) => string;
+  readonly results: Readonly<Record<CitationResult["status"], (result: CitationResult) => string>>;
 };
 
-const describe = (result: CitationResult): string => {
+const TEXT: Texts<CiteText> = {
+  ja: {
+    quoted: (text) => `「${text}」`,
+    usage: "使い方: chaff cite <原文> <引用.json> [--format text|json] [--language ja|en|…]",
+    notJson: (why) => `JSON として読めません: ${why}`,
+    notArray: '引用は配列で渡してください: [{ "address": "3.2", "quote": "…" }]',
+    badEntry: (n) => `${String(n)} 件目に address（文字列）と quote（文字列）がありません`,
+    results: {
+      ok: () => "一致",
+      "missing-address": (result) => `番地 ${result.citation.address} は原文にありません`,
+      "quote-elsewhere": (result) =>
+        `引用文は ${result.citation.address} ではなく ${result.foundAt ?? "番地の外"}（${String(result.line ?? "?")} 行目）にあります`,
+      "quote-not-found": () => "引用文が原文のどこにもありません",
+    },
+  },
+  en: {
+    quoted: (text) => ` "${text}"`,
+    usage: "usage: chaff cite <source> <quotes.json> [--format text|json] [--language ja|en|…]",
+    notJson: (why) => `Not valid JSON: ${why}`,
+    notArray: 'Give the quotations as an array: [{ "address": "3.2", "quote": "…" }]',
+    badEntry: (n) => `Entry ${String(n)} needs address (a string) and quote (a string)`,
+    results: {
+      ok: () => "matches",
+      "missing-address": (result) => `address ${result.citation.address} is not in the source`,
+      "quote-elsewhere": (result) =>
+        `the quotation is not at ${result.citation.address} but at ${result.foundAt ?? "no address"} (line ${String(result.line ?? "?")})`,
+      "quote-not-found": () => "the quotation is nowhere in the source",
+    },
+  },
+};
+
+const describe = (result: CitationResult, text: CiteText): string => {
   const mark = result.status === "ok" ? "✓" : "✗";
   const oneLine = result.citation.quote.replace(/\s+/gu, " ").trim();
   const quote = oneLine.length > QUOTE_WIDTH ? `${oneLine.slice(0, QUOTE_WIDTH)}…` : oneLine;
-  return `${mark} ${result.citation.address}「${quote}」: ${MESSAGES[result.status](result)}`;
+  return `${mark} ${result.citation.address}${text.quoted(quote)}: ${text.results[result.status](result)}`;
 };
 
 /**
@@ -56,12 +89,12 @@ export const runCite = async (targets: readonly string[], argv: readonly string[
   const [sourcePath, citationsPath] = targets;
   const format = context.flag(argv, "--format") ?? "text";
   if (sourcePath === undefined || citationsPath === undefined || targets.length !== 2 || !FORMATS.includes(format)) {
-    console.error(USAGE);
+    console.error(TEXT[context.ui ?? "ja"].usage);
     return 1;
   }
-  const citationsText = await readSource(citationsPath);
+  const citationsText = await readSource(citationsPath, context);
   if (citationsText === undefined) return 1;
-  const parsed = parseCitations(citationsText);
+  const parsed = parseCitations(citationsText, context.ui ?? "ja");
   if ("error" in parsed) {
     console.error(`${citationsPath}: ${parsed.error}`);
     return 1;
@@ -69,6 +102,6 @@ export const runCite = async (targets: readonly string[], argv: readonly string[
   const read = await readTree(sourcePath, argv, context);
   if (read === undefined) return 1;
   const results = checkCitations(read.source, read.tree, parsed.citations);
-  console.log(format === "json" ? JSON.stringify(results, null, 2) : results.map(describe).join("\n"));
+  console.log(format === "json" ? JSON.stringify(results, null, 2) : results.map((result) => describe(result, TEXT[context.ui ?? "ja"])).join("\n"));
   return results.every((result) => result.status === "ok") ? 0 : 1;
 };

package/src/commands/eval.ts

@@ -58,6 +58,7 @@ export const runEval = async (targets: readonly string[], argv: readonly string[
         rules,
         genre,
         language,
+        config.limits,
       ),
       docs.length,
       paths.length,

package/src/commands/skill.ts

@@ -0,0 +1,74 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+import type { Texts, UiLanguage } from "../ui.ts";
+
+/** The skill ships in the package, beside rules/. Two levels up from src/commands or dist/commands. */
+export const SKILL_SOURCE = join(dirname(fileURLToPath(import.meta.url)), "..", "..", "skills", "chaff", "SKILL.md");
+
+/** Where Claude Code reads a skill: this folder's .claude/skills, or the user's. */
+export const skillTarget = (root: string): string => join(root, ".claude", "skills", "chaff", "SKILL.md");
+
+export type SkillOutcome = { readonly status: "written" | "updated" | "same" | "kept"; readonly path: string };
+
+/**
+ * Writes the skill. A file that is already there and differs may have been edited by hand, so it is replaced
+ * only with `force`; the same file is left alone.
+ */
+export const installSkill = (skill: string, target: string, force: boolean): SkillOutcome => {
+  if (existsSync(target)) {
+    const current = readFileSync(target, "utf8");
+    if (current === skill) return { status: "same", path: target };
+    if (!force) return { status: "kept", path: target };
+    writeFileSync(target, skill, "utf8");
+    return { status: "updated", path: target };
+  }
+  mkdirSync(dirname(target), { recursive: true });
+  writeFileSync(target, skill, "utf8");
+  return { status: "written", path: target };
+};
+
+const TEXT: Texts<Readonly<Record<SkillOutcome["status"], (path: string) => string>>> = {
+  ja: {
+    written: (path) => `Claude Code の skill を書きました: ${path}\nClaude Code を開き直すと /chaff で使えます。`,
+    updated: (path) => `skill を新しい版に置き換えました: ${path}`,
+    same: (path) => `skill は既に最新です: ${path}`,
+    kept: (path) => `${path} は手で直されているかもしれないので、置き換えていません。\n置き換えるときは --force を付けてください。`,
+  },
+  en: {
+    written: (path) => `Wrote the Claude Code skill: ${path}\nReopen Claude Code and it is available as /chaff.`,
+    updated: (path) => `Replaced the skill with the new version: ${path}`,
+    same: (path) => `The skill is up to date: ${path}`,
+    kept: (path) => `${path} may have been edited by hand, so it was not replaced.\nAdd --force to replace it.`,
+  },
+};
+
+const FAILED: Texts<(path: string, why: string) => string> = {
+  ja: (path, why) => `skill を ${path} に書けませんでした: ${why}`,
+  en: (path, why) => `Could not write the skill to ${path}: ${why}`,
+};
+
+/** The outcome, or why the file system refused. */
+const attempt = (install: () => SkillOutcome): SkillOutcome | { readonly failure: string } => {
+  try {
+    return install();
+  } catch (err) {
+    return { failure: err instanceof Error ? err.message : String(err) };
+  }
+};
+
+export type SkillContext = { readonly cwd: string; readonly home: string; readonly ui: UiLanguage };
+
+/** `chaff skill [--global] [--force]`: installs or updates the skill. Exit 1 when a differing file was kept. */
+export const runSkill = (argv: readonly string[], context: SkillContext): number => {
+  const target = skillTarget(argv.includes("--global") ? context.home : context.cwd);
+  const outcome = attempt(() => installSkill(readFileSync(SKILL_SOURCE, "utf8"), target, argv.includes("--force")));
+  if ("failure" in outcome) {
+    console.error(FAILED[context.ui](target, outcome.failure));
+    return 1;
+  }
+  const say = TEXT[context.ui][outcome.status](outcome.path);
+  if (outcome.status === "kept") console.error(say);
+  else console.log(say);
+  return outcome.status === "kept" ? 1 : 0;
+};

package/src/commands/tree.ts

@@ -7,15 +7,35 @@ import { buildStructure } from "../structure/of.ts";
 import { toSexp } from "../structure/sexp.ts";
 import type { Config } from "../config/load.ts";
 import type { StructureNode } from "../plugin.ts";
+import type { Texts, UiLanguage } from "../ui.ts";
 
 export type TreeContext = {
   readonly config: Config;
   readonly flag: (argv: readonly string[], name: string) => string | undefined;
+  /** The language chaff speaks in here. Japanese when left out. */
+  readonly ui?: UiLanguage;
 };
 
-const FORMATS = ["sexp", "json"];
+const TEXT: Texts<{
+  readonly usage: string;
+  readonly unreadable: (path: string, why: string) => string;
+  readonly noStructure: (path: string, language: string) => string;
+}> = {
+  ja: {
+    usage: "使い方: chaff tree <file>... [--format sexp|json] [--language ja|en|…]",
+    unreadable: (path, why) => `${path} を読めませんでした: ${why}`,
+    noStructure: (path, language) => `${path}: 言語 ${language} のパッケージは文書の構造を読めません（structure がありません）`,
+  },
+  en: {
+    usage: "usage: chaff tree <file>... [--format sexp|json] [--language ja|en|…]",
+    unreadable: (path, why) => `Could not read ${path}: ${why}`,
+    noStructure: (path, language) => `${path}: the ${language} package cannot read a document's structure (it has no structure)`,
+  },
+};
 
-const USAGE = "使い方: chaff tree <file>... [--format sexp|json] [--language ja|en|…]";
+export const treeText = (context: TreeContext): (typeof TEXT)["ja"] => TEXT[context.ui ?? "ja"];
+
+const FORMATS = ["sexp", "json"];
 
 /** 値を取るフラグ。その次の引数は値で、対象のファイルではない。 */
 const VALUED = ["--format", "--language"];
@@ -23,11 +43,11 @@ const VALUED = ["--format", "--language"];
 export const treeTargets = (argv: readonly string[]): string[] =>
   argv.slice(1).filter((arg, index, all) => !arg.startsWith("--") && !VALUED.includes(all[index - 1] ?? ""));
 
-export const readSource = async (path: string): Promise<string | undefined> => {
+export const readSource = async (path: string, context: TreeContext): Promise<string | undefined> => {
   try {
     return await readFile(path, "utf8");
   } catch (err) {
-    console.error(`${path} を読めませんでした: ${err instanceof Error ? err.message : String(err)}`);
+    console.error(treeText(context).unreadable(path, err instanceof Error ? err.message : String(err)));
     return undefined;
   }
 };
@@ -49,12 +69,12 @@ export type SourceTree = { readonly source: string; readonly tree: StructureNode
  * chaff tree と chaff cite が同じ木を見るように、ここを一つにしておく。
  */
 export const readTree = async (path: string, argv: readonly string[], context: TreeContext): Promise<SourceTree | undefined> => {
-  const source = await readSource(path);
+  const source = await readSource(path, context);
   if (source === undefined) return undefined;
   const language = treeLanguage(path, source, argv, context);
   const adapter = await loadAdapter(language);
   if (adapter.structure === undefined) {
-    console.error(`${path}: 言語 ${language} のパッケージは文書の構造を読めません（structure がありません）`);
+    console.error(treeText(context).noStructure(path, language));
     return undefined;
   }
   // 日本語は形態素で数量と日付を読む。解析器が無ければ単位の表で読むので、木は作れる。
@@ -86,7 +106,7 @@ export const inOrder = async (paths: readonly string[], each: (path: string) =>
 export const runTree = async (paths: readonly string[], argv: readonly string[], context: TreeContext): Promise<number> => {
   const format = context.flag(argv, "--format") ?? "sexp";
   if (paths.length === 0 || !FORMATS.includes(format)) {
-    console.error(USAGE);
+    console.error(treeText(context).usage);
     return 1;
   }
   const printed = await inOrder(paths, (path) => printTree(path, argv, context));