chaffjs 0.16.0 → 0.17.0

package/rules/heading-echo.yaml

@@ -2,6 +2,7 @@ id: heading-echo
 layer: L1
 status: stable
 how_to_find: heading-echo
+uses: [pos]
 severity: warning
 
 name:

package/rules/max-paragraph-length.yaml

@@ -9,8 +9,8 @@ name:
   en: Paragraph too long
 
 why:
-  ja: 1 段落に文を詰めると、読み手はどこで息継ぎしていいか分からなくなります。
-  en: A dense paragraph gives the reader nowhere to pause.
+  ja: 1 段落に文を詰めると、読み手はどこで息継ぎしていいか分からなくなります。短い文をいくつ並べても壁にはならないので、段落が普通の長さの文を上限の数だけ並べたより長いときだけ指摘します。
+  en: A dense paragraph gives the reader nowhere to pause. Short sentences do not make a wall, so it is reported only when it is also longer than that many sentences of ordinary length.
 
 message:
   ja: この段落は {count} 文あります（{limit} 文まで）
@@ -22,6 +22,13 @@ how_to_fix:
 
 levels: { strict: 3, normal: 5, relaxed: 8 }
 
+# 普通の長さの文 1 つの長さ。単位は adapter の lengthUnit（日本語は文字、英語は語）。
+# 文の数が上限を超えても、段落の長さが「上限 × この長さ」以下なら指摘しない。子ども向けの文章のように短い文を重ねた段落は、息継ぎの場所がいくらでもある。
+# corpus で、これより短い段落は短い文の積み重ね（子ども向けの解説、リリースの一覧、Q&A）だけだった。上限と掛けるので、段階・ジャンル・chaff.yaml の数値がそのまま効く。
+full_sentence:
+  ja: 70
+  en: 18
+
 # 条文・判決・論文の段落は、一つの規定や論点をまとめて書く。corpus のその種類の文書で、normal が最も長い一握りの段落だけを指すように測って置いた。
 by_genre:
   legal: { strict: 5, normal: 8, relaxed: 12 }

package/rules/max-sentence-length.yaml

@@ -55,6 +55,10 @@ by_genre:
     en: { strict: 80, normal: 130, relaxed: 180 }
   legal/judgment:
     ja: { strict: 250, normal: 350, relaxed: 450 }
+  # 英語の定義は、限定を重ねた名詞句の一文になる。英語の用語集で測り、normal が列挙を詰めた定義や長い注記だけを指すように置いた。
+  # 日本語は既定の上限のままで、すでに最も長い一握りだけを指していた。
+  docs/glossary:
+    en: { strict: 30, normal: 40, relaxed: 50 }
   academic:
     ja: { strict: 100, normal: 140, relaxed: 180 }
     en: { strict: 35, normal: 50, relaxed: 65 }

package/rules/oxford-comma-consistency.yaml

@@ -3,7 +3,7 @@ layer: L3
 status: experimental
 how_to_find: oxford-comma
 languages: [en]
-extra_word_lists: [participle-word]
+extra_word_lists: [participle-word, example-marker, pair-opener]
 severity: info
 
 name:

package/rules/stray-space.yaml

@@ -0,0 +1,38 @@
+id: stray-space
+layer: L3
+status: experimental
+how_to_find: stray-space
+# どの境目が一続きの語句の中かは、語の品詞で決める。品詞が無ければ動かない。
+requires: [pos]
+languages: [ja]
+severity: warning
+
+name:
+  ja: 語句の途中に空白がある
+  en: Stray space inside a phrase
+
+why:
+  ja: 「こころさんが 払った」「確認 しました」のように、一続きに読む語句の途中に空白が入ると、読み手はそこで区切れるのかと迷います。打ち直しや貼り付けで残りやすく、目で見ても気づきにくい空白です。chaff は二つの境目を別々に数えます。助詞の後ろ（「が 払った」、文節の切れ目）と、文節を始められない語の前（「アプリ が」の助詞、「行き ます」の助動詞、「確認 しました」の「する」）です。文節ごとに空けて書く分かち書き（子ども向けの文や、日本語を学ぶ人向けの文）は書き方の一つなので、chaff はどちらが正しいかを決めず、文書の中で空けたほうが少ないときだけ、その空白を指摘します。名詞どうしのあいだ（「担当 田中」の名札と値、「赤坂 文弥」の名前、「サムネイル キャッシュ」の複合語）は書き方として空けることが多いので数えません。句点で終わらない行（歌、名札と値、表のような行）、見出し、表、行頭の全角空白の字下げ、行頭の項目の記号（「イ　」）の後ろ、Markdown の改行、鉤括弧（「」『』）で引いたものの中、英字・数字との境目（latin-spacing が見ます）も数えません。
+  en: A space inside what reads as one phrase in Japanese (こころさんが 払った, 確認 しました) makes the reader wonder whether the phrase breaks there. It is typically left over from retyping or pasting and is easy to miss by eye. chaff counts two kinds of joint separately, after a particle (が 払った, the break between phrases) and before a word that cannot start a phrase (a particle as in アプリ が, an auxiliary as in 行き ます, or する after a noun as in 確認 しました). Spacing every phrase (分かち書き, as in text for children or for learners of Japanese) is a way of writing, so chaff does not decide which is right; it reports the spaces only when the document spaces less often than it does not. A space between two nouns (a label and its value as in 担当 田中, a name as in 赤坂 文弥, a compound as in サムネイル キャッシュ) is often written on purpose and is not counted. Neither are lines that do not end with a full stop (verse, labels and values, table-like lines), headings, tables, a full-width indent at the start of a line, the space after an item mark at the start of a line (イ　), a Markdown line break, the inside of a quotation in 「」 or 『』, or a boundary with Latin letters or digits (latin-spacing looks at those).
+
+message:
+  ja: "「{before}」と「{after}」のあいだに空白があります（この文書では {of} 箇所のうち {count} 箇所が空いている）"
+  en: 'Space between "{before}" and "{after}" ({count} of {of} in this document are spaced)'
+
+messages:
+  between-phrases:
+    ja: "助詞「{before}」と「{after}」のあいだに空白があります（この文書は文節のあいだをふつう詰めて書く。{of} 箇所のうち {count} 箇所が空いている）"
+    en: 'Space after the particle "{before}" before "{after}" (this document usually writes phrases without a space; {count} of {of} are spaced)'
+  inside-phrase:
+    ja: "「{before}」と「{after}」は一続きの語句ですが、あいだに空白があります（{of} 箇所のうち {count} 箇所が空いている）"
+    en: '"{before}" and "{after}" read as one phrase but are separated by a space ({count} of {of} are spaced)'
+
+how_to_fix:
+  ja: 空白を消して詰めてください。文節ごとに空ける書き方をしているなら、文書全体でそろえてください。
+  en: Delete the space. If the document spaces its phrases on purpose, do so throughout.
+
+# 何箇所空いていれば指摘するか。1 は「1 箇所でも空いていれば」。
+levels: { strict: 1, normal: 1, relaxed: 3 }
+
+# 歌の行は句点で終わらないので、ジャンルを問わず数えない。
+use_for: [business, blog, technical, legal, docs, academic, literature, speech]

package/rules/undefined-acronym.yaml

@@ -14,6 +14,7 @@ extra_word_lists:
     emphasis-word,
     numbered-division,
     honorific,
+    name-title,
     date-time-unit,
     http-method,
   ]

package/src/calendar-number.ts

@@ -1,5 +1,5 @@
 import { digitRunAround } from "./number-name.ts";
-import type { Span, Token } from "./plugin.ts";
+import type { ProseDocument, Span, Token } from "./plugin.ts";
 
 /**
  * 日付・時刻として書かれた数（9月、3時、2026年、10月1日、10時5分）。数を詰めて書くのが決まりで、空け方の好みではない。
@@ -12,17 +12,17 @@ import type { Span, Token } from "./plugin.ts";
  */
 export type CalendarUnits = { readonly chained: readonly string[]; readonly positional: ReadonlySet<string>; readonly year: ReadonlySet<string> };
 
-/** 日付・時刻の数の並び。first は日付の頭の数、inner は前の単位に続く数（2026年9月の 9）。 */
-export type CalendarRun = { readonly run: Span; readonly place: "first" | "inner" };
+/** 日付・時刻の数の並び。first は日付の頭の数、inner は前の単位に続く数（2026年9月の 9）。unit は数の後ろの単位（月）。 */
+export type CalendarRun = { readonly run: Span; readonly place: "first" | "inner"; readonly unit: string };
 
 /** 数の並びと、その後ろの単位の終わり（文の中の位置）。rank は chained の中の単位の順（無ければ -1）、anchored は単位だけで日付・時刻と分かるもの。 */
-type Part = { readonly run: Span; readonly unitEnd: number; readonly rank: number; readonly anchored: boolean };
+type Part = { readonly run: Span; readonly unit: string; readonly unitEnd: number; readonly rank: number; readonly anchored: boolean };
 
 const DIGIT = /\d/u;
 const CALENDAR_YEAR = /^\d{4}$/u;
 
 /** text の中の数の並び（数字・小数点・ハイフン）を左から。 */
-const digitRuns = (text: string): Span[] => {
+export const digitRuns = (text: string): Span[] => {
   const runs: Span[] = [];
   let at = 0;
   while (at < text.length) {
@@ -46,7 +46,7 @@ const partOf = (text: string, run: Span, tokens: readonly Token[], base: number,
   const unit = tokens.find((token) => token.span.start === base + pastSpace(text, run.end));
   if (unit === undefined || !isUnit(unit.surface, units)) return undefined;
   const rank = units.chained.indexOf(unit.surface);
-  return { run, unitEnd: unit.span.end - base, rank, anchored: isAnchor(text.slice(run.start, run.end), unit.surface, units) };
+  return { run, unit: unit.surface, unitEnd: unit.span.end - base, rank, anchored: isAnchor(text.slice(run.start, run.end), unit.surface, units) };
 };
 
 /** 前の組の単位のすぐ後ろ（空白 1 つまで）から始まり、単位が前より小さい組か。 */
@@ -71,5 +71,14 @@ export const calendarRuns = (text: string, tokens: readonly Token[] | undefined,
   const parts = digitRuns(text).flatMap((run) => partOf(text, run, tokens, base, units) ?? []);
   return chainsOf(text, parts)
     .filter((chain) => chain.some((part) => part.anchored))
-    .flatMap((chain) => chain.map((part, index): CalendarRun => ({ run: part.run, place: index === 0 ? "first" : "inner" })));
+    .flatMap((chain) => chain.map((part, index): CalendarRun => ({ run: part.run, place: index === 0 ? "first" : "inner", unit: part.unit })));
 };
+
+const patternList = (doc: ProseDocument, id: string): string[] => (doc.lexicons[id] ?? []).map((entry) => entry.pattern);
+
+/** 文書の言語の、日付・時刻の単位の語彙表。表の無い言語では空で、日付・時刻の数は見つからない。 */
+export const calendarUnitsOf = (doc: ProseDocument): CalendarUnits => ({
+  chained: patternList(doc, "date-time-unit"),
+  positional: new Set(patternList(doc, "calendar-unit")),
+  year: new Set(patternList(doc, "calendar-year-unit")),
+});

package/src/closing-numbers.ts

@@ -0,0 +1,72 @@
+import { calendarRuns, digitRuns, type CalendarUnits } from "./calendar-number.ts";
+import type { ProseDocument, Section, Sentence, Span } from "./plugin.ts";
+
+/** 文書の一続きの文字列と、その中の文。base は text の先頭の位置で、文の span は文書全体の座標。 */
+export type Passage = { readonly text: string; readonly base: number; readonly sentences: readonly Sentence[] };
+
+/** 結びの節と、それより前の文書全体（見出し・表・コードも）。 */
+export const closingAndEarlier = (doc: ProseDocument, last: Section): { closing: Passage; earlier: Passage } => ({
+  closing: { text: doc.source.slice(last.span.start, last.span.end), base: last.span.start, sentences: last.sentences },
+  earlier: { text: doc.source.slice(0, last.span.start), base: 0, sentences: doc.sentences.filter((sentence) => sentence.span.end <= last.span.start) },
+});
+
+const DIGIT = /\d/u;
+
+/** 最後の数字まで。文末の「412.」の点や、範囲の「3-」のハイフンは数の一部ではない。前のハイフンは符号（-1%）なので残す。 */
+const valueOf = (text: string, run: Span): string => {
+  const raw = text.slice(run.start, run.end);
+  const lastDigit = [...raw].findLastIndex((char) => DIGIT.test(char));
+  return raw.slice(0, lastDigit + 1);
+};
+
+/** passage の中で、品詞の付いた文の字。見出しや表の字は文ではないので付かない。 */
+const taggedChars = (passage: Passage): Uint8Array => {
+  const tagged = new Uint8Array(passage.text.length);
+  passage.sentences
+    .filter((sentence) => sentence.tokens !== undefined)
+    .forEach((sentence) => tagged.fill(1, Math.max(0, sentence.span.start - passage.base), Math.max(0, sentence.span.end - passage.base)));
+  return tagged;
+};
+
+/** 文の中の日付・時刻の数の単位を、passage の中の位置で。文ごとに読むので、長い文書でも語を探す範囲は文の中だけ。 */
+const calendarUnitsAt = (passage: Passage, units: CalendarUnits): ReadonlyMap<number, string> =>
+  new Map(
+    passage.sentences.flatMap((sentence) =>
+      calendarRuns(sentence.text, sentence.tokens, sentence.span.start, units).map(({ run, unit }): [number, string] => [
+        sentence.span.start - passage.base + run.start,
+        unit,
+      ]),
+    ),
+  );
+
+/** 品詞の無いところの数の、すぐ後ろ（空白 1 つまで）に字面で続く日付・時刻の単位のうち、いちばん長いもの。無ければ空。 */
+const unitAsWritten = (text: string, run: Span, units: CalendarUnits): string => {
+  const at = text[run.end] === " " ? run.end + 1 : run.end;
+  const following = [...units.chained, ...units.positional, ...units.year].filter((unit) => text.startsWith(unit, at));
+  return following.reduce((longest, unit) => (unit.length > longest.length ? unit : longest), "");
+};
+
+/**
+ * passage の中の数の、比べるときの名前を左から。日付・時刻の数は単位ごと（9月）、それ以外は数そのもの（412）。
+ * 文の中は品詞で見分ける（calendar-number.ts）。見出しや表は品詞が無いので、数の後ろの字で見分ける（題の「9月の報告」）。
+ */
+const numberKeys = (passage: Passage, units: CalendarUnits): string[] => {
+  const unitAt = calendarUnitsAt(passage, units);
+  const tagged = taggedChars(passage);
+  return digitRuns(passage.text).map((run) => {
+    const value = valueOf(passage.text, run);
+    const firstDigit = run.start + passage.text.slice(run.start, run.end).search(DIGIT);
+    const unit = tagged[firstDigit] === 1 ? (unitAt.get(run.start) ?? "") : unitAsWritten(passage.text, run, units);
+    return `${value}${unit}`;
+  });
+};
+
+/**
+ * 結びの数のうち、それより前（見出し・表も）に書いていないもの（重ならないように、書いた順）。
+ * 前に同じ名前で書いた数（題の「9月」と結びの「9月」、本文の「412 件」と結びの「412 件」）は新しくない。
+ * 日付・時刻と数量は別のもので、本文の「9 件」があっても結びの「9月末」は新しく、題の「9月」があっても結びの「9 件」は新しい。
+ */
+export const newNumbers = (closing: Passage, earlier: Passage, units: CalendarUnits): string[] => {
+  const stated = new Set(numberKeys(earlier, units));
+  return [...new Set(numberKeys(closing, units).filter((key) => !stated.has(key)))];
+};

package/src/commands/test.ts

@@ -11,10 +11,10 @@ import { counted } from "../render/plural.ts";
 import { CHECKS_FILE, loadChecks, type UserCheck } from "../checks.ts";
 import { CACHE_DIR, credentialHint, describeFailure, hasCredentials, type JudgeOptions } from "../judge.ts";
 import { ENV_FILE, loadEnvFile } from "../env.ts";
-import { planSemantic, runSemantic } from "../run-semantic.ts";
+import { planSemantic, runSemantic, semanticNeeds } from "../run-semantic.ts";
 import { machineBanner, renderPlan, renderSemantic } from "../render/semantic.ts";
 import type { Config } from "../config/load.ts";
-import type { Finding, RuleDefinition } from "../plugin.ts";
+import type { Finding, ProseDocument, RuleDefinition } from "../plugin.ts";
 import type { BackendName, Failure } from "../backends/types.ts";
 import { profileFor } from "../profile/for-file.ts";
 import { CLI_TEXT } from "../cli-text.ts";
@@ -83,6 +83,20 @@ export type TestContext = {
   readonly clients?: Pick<JudgeOptions, "anthropicClient" | "openaiClient">;
 };
 
+type SemanticDocument = { readonly doc: ProseDocument; readonly rules: RuleDefinition[]; readonly language: string; readonly genre: string };
+
+/** 意味を読む検査に渡す文書。絞り込みが品詞を使うなら、解析器を読み込んでから作る。dry-run も本番も同じ文書を見る。 */
+const semanticDocument = async (path: string, config: Config, resolveGenre: TestContext["resolveGenre"]): Promise<SemanticDocument> => {
+  const source = plainSource(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 } = resolveGenre(path, source, config);
+  const rules = loadRules(language);
+  await adapter.prepare?.(semanticNeeds(rules, config.rules, genre));
+  const doc = buildDocument(path, source, adapter, teamRules(config), profileFor(config, path, source, language, genre));
+  return { doc, rules, language, genre };
+};
+
 type Judged = { path: string; outcome: Awaited<ReturnType<typeof runSemantic>>; rules: RuleDefinition[]; language: string };
 
 const judgeAll = async (
@@ -94,12 +108,7 @@ const judgeAll = async (
 ): Promise<Judged[]> =>
   Promise.all(
     paths.map(async (path) => {
-      const source = plainSource(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 } = resolveGenre(path, source, config);
-      const doc = buildDocument(path, source, adapter, teamRules(config), profileFor(config, path, source, language, genre));
-      const rules = loadRules(language);
+      const { doc, rules, language, genre } = await semanticDocument(path, config, resolveGenre);
       return { path, outcome: await runSemantic(doc, rules, checks, config.rules, genre, options), rules, language };
     }),
   );
@@ -114,12 +123,8 @@ const dryRun = async (
 ): Promise<void> => {
   const plans = await Promise.all(
     paths.map(async (path) => {
-      const source = plainSource(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 } = resolveGenre(path, source, config);
-      const doc = buildDocument(path, source, adapter, teamRules(config), profileFor(config, path, source, language, genre));
-      return { path, jobs: planSemantic(doc, loadRules(language), checks, config.rules, genre), sentences: doc.sentences.length, language };
+      const { doc, rules, language, genre } = await semanticDocument(path, config, resolveGenre);
+      return { path, jobs: planSemantic(doc, rules, checks, config.rules, genre), sentences: doc.sentences.length, language };
     }),
   );
   plans.forEach(({ path, jobs, sentences, language }) => console.log(renderPlan(path, jobs, sentences, language).join("\n")));

package/src/detectors/acronym-context.ts

@@ -2,6 +2,7 @@ import { escapeRegExp } from "../orthography.ts";
 import { ROMAN_NUMERAL } from "./roman-numeral.ts";
 import { citationKeySpans } from "./citation-key.ts";
 import { dottedNameSpans } from "./dotted-name.ts";
+import { letterJoinedNameSpans } from "./letter-joined-name.ts";
 import { loneNumeralSpans, nameNumeralSpans } from "./name-numeral.ts";
 import { placeholderSpans } from "./placeholder.ts";
 import { seriesLabelSpans } from "./series-label.ts";
@@ -25,6 +26,8 @@ export type NotationWords = {
   readonly divisions: readonly string[];
   /** 速記録が大文字で書く発言者の姓の前に置く敬称（Mr.、Mrs.、Madam）。 */
   readonly honorifics: readonly string[];
+  /** 大文字で書く姓の前に置く肩書き（Prime Minister、Governor）。後ろに略語も来る（the President NASA memo）ので、名前の形を求める。 */
+  readonly titles: readonly string[];
   /** 日付・時刻の数字の後ろに書く単位（年、月、日、時、分）。その前の同じ大文字の繰り返し（YY年）は書式の置き場所。 */
   readonly dateTimeUnits: readonly string[];
 };
@@ -49,6 +52,17 @@ const divisionOf = (words: readonly string[]): string => oneOf(words.flatMap((wo
 /** 敬称のすぐ後ろの大文字の姓（Mr. HAWLEY、Dr. O'NEIL）。速記録は発言者をこう書き、略語ではない。 */
 const SURNAME_IN_CAPITALS = String.raw`[A-Z]+(?:['’-][A-Z]+)*(?![\p{L}\p{N}_])`;
 
+/**
+ * 肩書きの後ろの大文字の語が姓と読めるのは、名前の形のときだけ。行頭の発言者の印（Senator HAWLEY.、Chairman JORDAN:）か、
+ * 日本政府の英文が「姓 名」の順に書くローマ字の名前（Prime Minister ABE Shinzo）。the President NASA memo と
+ * The Secretary GDPR: Article 5 の略語は数える。
+ */
+const GIVEN_NAME_AFTER = String.raw`(?=\s+\p{Lu}\p{Ll}+(?![\p{L}\p{N}_]))`;
+const titledName = (titles: string): readonly RegExp[] => [
+  new RegExp(String.raw`(?<=(?:^|\n)[ \t]*)${titles}\s+${SURNAME_IN_CAPITALS}(?=[.:])`, "gu"),
+  new RegExp(String.raw`(?<![\p{L}\p{N}_])${titles}\s+${SURNAME_IN_CAPITALS}${GIVEN_NAME_AFTER}`, "gu"),
+];
+
 // 強調の記号は空白に置き換えてある（**3:30** PM）ので、部品の間の空白は数を問わない。
 const patternsOf = (words: NotationWords): readonly RegExp[] => [
   new RegExp(String.raw`${CLOCK_12}\s*${oneOf(words.meridiem)}`, "gu"),
@@ -59,6 +73,7 @@ const patternsOf = (words: NotationWords): readonly RegExp[] => [
   new RegExp(oneOf(words.emphasis), "gu"),
   new RegExp(String.raw`(?<![\p{L}\p{N}_])${divisionOf(words.divisions)}\s+${ROMAN_NUMERAL}(?![\p{L}\p{N}_&])`, "gu"),
   new RegExp(String.raw`(?<![\p{L}\p{N}_])${oneOf(words.honorifics)}\s+${SURNAME_IN_CAPITALS}`, "gu"),
+  ...titledName(oneOf(words.titles)),
 ];
 
 export type NotAcronymSpans = (text: string) => Span[];
@@ -73,6 +88,7 @@ export const notAcronymSpansOf = (words: NotationWords): NotAcronymSpans => {
     ...patterns.flatMap((pattern) => [...text.matchAll(pattern)].map((match) => ({ start: match.index, end: match.index + match[0].length }))),
     ...citationKeySpans(text),
     ...dottedNameSpans(text),
+    ...letterJoinedNameSpans(text),
     ...nameNumeralSpans(text),
     ...loneNumeralSpans(text),
     ...seriesLabelSpans(text),

package/src/detectors/acronym-expansion.ts

@@ -12,6 +12,7 @@ import { escapeRegExp } from "../orthography.ts";
  *   （single nucleotide polymorphism：SNP）  括弧の最後の項目が略語で、コロンの前の語の頭文字と揃う
  *   人事部（以下「HR」という。）      括弧の中が定義の語と略語だけ
  *   overnight reverse repurchase agreement (ON RRP)  括弧の中が空白で繋いだ略語だけで、前の名前から文字が順に拾える
+ *   Partnership On Wide Energy and Resources Resilience Asia (POWERR Asia)  括弧の中が略語と添えた語で、前の名前の頭文字と揃う
  * 括弧と略語の間には、引用符（(“MNDA”)、（「MNDA」））と空白だけを許す。
  */
 const WRAP = String.raw`[\s"“”'‘’「」『』]*`;
@@ -149,12 +150,28 @@ const isJointBracketedAt = (body: string, acronym: string, at: number): boolean
   return abbreviates(body.slice(0, start), body.slice(start, close));
 };
 
+/** 括弧の中で略語に添えた、大文字で始まる語（(POWERR Asia)、(ZEC Initiative)）と、閉じる括弧。 */
+const QUALIFIER = new RegExp(String.raw`^(?<words>(?: [A-Z][a-z]+)+)${WRAP}[)）]`, "u");
+
+/**
+ * 括弧の中が略語と、それに添えた語だけの形。括弧の前の名前の頭文字が略語と揃うときだけ展開と見なす（(NASA Goddard) は揃わない）。
+ * 添えた語が名前の終わりにもあれば（… Resilience Asia (POWERR Asia)）、それを除いて比べる。
+ */
+const isQualifiedAt = (body: string, acronym: string, at: number): boolean => {
+  if (!OPENED.test(body.slice(Math.max(0, at - NEAR), at))) return false;
+  const end = at + acronym.length;
+  const words = QUALIFIER.exec(body.slice(end, end + DEFINITION_REACH))?.groups?.["words"];
+  if (words === undefined) return false;
+  const name = body.slice(0, at).replace(ANY_OPENED, "").trimEnd();
+  return spellsOut(name.endsWith(words) ? name.slice(0, -words.length) : name, acronym);
+};
+
 const isBracketedAt = (body: string, acronym: string, at: number): boolean => {
   const after = body.slice(at + acronym.length, at + acronym.length + NEAR);
   const before = body.slice(Math.max(0, at - NEAR), at);
   if (OPENS.test(after) || (OPENED.test(before) && CLOSES.test(after))) return true;
   if (SQUARE_OPENED.test(before) && SQUARE_CLOSES.test(after) && spellsOut(body.slice(0, at), acronym)) return true;
-  return isSeparatedAt(body, acronym, at) || isNamedBeforeAt(body, acronym, at) || isJointBracketedAt(body, acronym, at);
+  return isSeparatedAt(body, acronym, at) || isNamedBeforeAt(body, acronym, at) || isJointBracketedAt(body, acronym, at) || isQualifiedAt(body, acronym, at);
 };
 
 /**
@@ -167,6 +184,120 @@ const EQUALS_DEFINITION = /^\s*[=＝]\s*(?=\p{L})\S*?[\p{Ll}\p{Lo}]/u;
 const isEqualsDefinedAt = (body: string, acronym: string, at: number): boolean =>
   EQUALS_DEFINITION.test(body.slice(at + acronym.length, at + acronym.length + DEFINITION_REACH));
 
+/**
+ * 用語集の見出し語としての略語（## AFD、| AFD |、**AFD**:、- AFD —）。名前は見出し語のすぐ後ろ、つまり次の行・隣のセル・
+ * 区切りの後ろに書く。見出しと表は文にならないので、文をつないだ本文ではなく source の行を見る。
+ */
+const TERM = String.raw`[A-Z][A-Z&-]*[A-Z]`;
+const STRONG = /\*\*|__/gu;
+const LIST_MARK = String.raw`(?:[-*+]|\d+[.)])\s+`;
+const TERM_SEPARATOR = String.raw`(?:[:：]|\s[-–—]|[–—])`;
+/** 行が略語だけの見出し・段落（## AFD、AFD:、**AFD**）。 */
+const TERM_LINE = new RegExp(String.raw`^(?:#{1,6}\s+)?(?<term>${TERM})\s*(?<colon>[:：])?(?:\s+#+)?$`, "u");
+/** 見出しか強調の印。印の無い「RTO:」の行はメモの見出しにも書くので、コロンを付けた略語だけの行は印があるときだけ見出し語と読む。 */
+const MARKED_LINE = /^(?:#|\*\*|__)/u;
+/**
+ * 箇条書きの頭の略語と区切りの後ろの名前（- AFD — Area…）か、強調した略語とその後ろの名前（**AFD**: Area…、**AFD** Area…）。
+ * 印の無い行頭の略語とコロン（RTO: Review ticket ownership.）は、メモの見出しにも書くので見出し語と読まない。
+ */
+const TERM_LEAD = new RegExp(
+  String.raw`^(?:(?:${LIST_MARK})?(?<strong>\*\*|__)(?<strongTerm>${TERM})\s*(?:[:：]\s*)?\k<strong>\s*${TERM_SEPARATOR}?|${LIST_MARK}(?<term>${TERM})\s*${TERM_SEPARATOR})\s*(?<rest>\S.*)$`,
+  "u",
+);
+const TABLE_ROW = /^\s*\|.*\|\s*$/u;
+const WHOLE_TERM = new RegExp(String.raw`^${TERM}$`, "u");
+/** 名前の終わり。文の終わり、区切り、括弧、空白で挟んだハイフン。読点は名前の中にも書く（Aviation, Range, and Aerospace Meteorology）ので、その前でも比べる。 */
+const NAME_END = /[.;:：(（。|]|\s[-–—]\s|[–—]/u;
+const NAME_COMMA = /[,，、]/u;
+const LEADING_MARKS = /^[\s:：>*+-]+/u;
+
+/** 項目の頭の名前と、その読点の前まで（Service Level Agreement, a contract → Service Level Agreement）。 */
+const namesOf = (text: string): string[] => {
+  const clause = (text.replaceAll(STRONG, "").replace(LEADING_MARKS, "").split(NAME_END)[0] ?? "").trim();
+  return [clause, (clause.split(NAME_COMMA)[0] ?? "").trim()].filter((name) => name !== "");
+};
+
+/** 1 語の名前を縮めた略語（ABV → Above、ABNDT → Abundant）。名前は小文字を含む語で、略語そのもの（SEO.）ではない。 */
+const shortensWord = (name: string, acronym: string): boolean => !/\s/u.test(name) && /\p{Ll}/u.test(name) && abbreviates(name, acronym);
+
+const spellsName = (text: string, acronym: string): boolean => namesOf(text).some((name) => namesAcronym(name, acronym) || shortensWord(name, acronym));
+
+const cellsOf = (row: string): string[] =>
+  row
+    .trim()
+    .replace(/^\||\|$/gu, "")
+    .split("|")
+    .map((cell) => cell.replaceAll(STRONG, "").trim());
+
+/** 表の行で、略語だけのセルの隣（後ろか前）のセルが名前のもの。 */
+const tableTerms = (row: string): string[] => {
+  const cells = cellsOf(row);
+  return cells.filter(
+    (cell, index) => WHOLE_TERM.test(cell) && [cells[index + 1], cells[index - 1]].some((next) => next !== undefined && spellsName(next, cell)),
+  );
+};
+
+const leadTerm = (line: string): string[] => {
+  const lead = TERM_LEAD.exec(line.trim());
+  const term = lead?.groups?.["strongTerm"] ?? lead?.groups?.["term"];
+  return term !== undefined && spellsName(lead?.groups?.["rest"] ?? "", term) ? [term] : [];
+};
+
+/** 見出し語から名前までに見る行の数。空行が 2 つ挟まっても、次の段落を見る。 */
+const NEXT_LINE_REACH = 3;
+
+/** 略語だけの行と、その次の空でない行が名前のもの。 */
+const lineTerm = (lines: readonly string[], index: number): string[] => {
+  const line = (lines[index] ?? "").trim();
+  const groups = TERM_LINE.exec(line.replaceAll(STRONG, ""))?.groups;
+  const term = groups?.["term"];
+  if (term === undefined || (groups?.["colon"] !== undefined && !MARKED_LINE.test(line))) return [];
+  const next = lines.slice(index + 1, index + 1 + NEXT_LINE_REACH).find((line) => line.trim() !== "");
+  return next !== undefined && spellsName(next, term) ? [term] : [];
+};
+
+const FENCE = /^ {0,3}(?<fence>`{3,}|~{3,})/u;
+const FRONT_MATTER_EDGE = /^(?:---|\.\.\.)\s*$/u;
+
+type FenceScan = { readonly open: string | undefined; readonly kept: string[] };
+
+/** 閉じる行は記号の並びだけ。後ろに語がある行（```ts）は囲みの中の行。 */
+const CLOSING_FENCE = /^ {0,3}(?<fence>`{3,}|~{3,})\s*$/u;
+
+const closes = (line: string, open: string): boolean => CLOSING_FENCE.exec(line)?.groups?.["fence"]?.startsWith(open) === true;
+
+/** コードの囲みの中の行（開き・閉じの行も）を空にする。閉じるのは同じ記号で、開きと同じか長い並び。 */
+const withoutFences = (lines: readonly string[]): string[] =>
+  lines.reduce<FenceScan>(
+    (scan, line) => {
+      const fence = FENCE.exec(line)?.groups?.["fence"];
+      const inside = scan.open !== undefined || fence !== undefined;
+      scan.kept.push(inside ? "" : line);
+      if (scan.open === undefined) return { open: fence, kept: scan.kept };
+      return { open: closes(line, scan.open) ? undefined : scan.open, kept: scan.kept };
+    },
+    { open: undefined, kept: [] },
+  ).kept;
+
+/** 文書の頭の front matter（--- で始まり --- か ... で閉じる）の行数。無ければ 0。 */
+const frontMatterLength = (lines: readonly string[]): number =>
+  lines[0]?.trim() === "---" ? lines.findIndex((line, index) => index > 0 && FRONT_MATTER_EDGE.test(line)) + 1 : 0;
+
+/** 4 桁以上の字下げはコードとして書ける。入れ子の箇条書きと見分けずに外す（外しても、略語が報告されるほうへ倒れるだけ）。 */
+const INDENTED = /^(?: {4}|\t)/u;
+
+/** 本文として読まない行（front matter、コードの囲み、字下げしたコード）を空にした行。行の位置は変えない。 */
+const proseLines = (lines: readonly string[]): string[] => {
+  const skipped = frontMatterLength(lines);
+  return withoutFences(lines.map((line, index) => (index < skipped || INDENTED.test(line) ? "" : line)));
+};
+
+/** 用語集の見出し語として、すぐ後ろに名前を書いた略語。 */
+export const termEntryAcronyms = (source: string): ReadonlySet<string> => {
+  const lines = proseLines(source.split(/\r?\n/u));
+  return new Set(lines.flatMap((line, index) => (TABLE_ROW.test(line) ? tableTerms(line) : [...lineTerm(lines, index), ...leadTerm(line)])));
+};
+
 export type ExpandedAt = (body: string, acronym: string, at: number) => boolean;
 
 /** body の at にある略語が、その場で展開・定義されているか。語彙表から一度だけ組み立てて、略語ごとに呼ぶ。 */