chaffjs 0.8.0 → 0.9.0

package/dist/structure/relative-resolve.js

@@ -0,0 +1,175 @@
+const NUMBERED = new Set(["chapter", "article", "item"]);
+const placeOf = (node) => NUMBERED.has(node.kind) && node.level !== undefined ? { address: node.address, level: node.level, range: node.ordinalTo !== undefined } : undefined;
+/** 番号の付いた子。Markdown の見出し（section）は番号の外なので、その中まで見る。 */
+const numberedChildren = (node, level) => node.children.flatMap((child) => {
+    if (NUMBERED.has(child.kind))
+        return child.level === level ? [child] : [];
+    return child.kind === "section" ? numberedChildren(child, level) : [];
+});
+/** 同じ親の下で同じ深さのもの。番号の無い最初のもの（法令の第 1 項）があるなら、それを先頭に足す。 */
+const siblingsUnder = (parent, level, implicitLevel) => {
+    const children = numberedChildren(parent, level);
+    const explicit = children.flatMap((child) => {
+        const place = placeOf(child);
+        return place === undefined ? [] : [place];
+    });
+    const firstOrdinal = children[0]?.ordinal;
+    const implicit = level === implicitLevel && parent.level === level - 1 && firstOrdinal !== 1;
+    return implicit ? [{ address: `${parent.address}.1`, level }, ...explicit] : explicit;
+};
+/** 書いた場所を含む、その深さのまとまり。第 1 項の本文にいて項が開いていなければ、番号の無い第 1 項。 */
+const anchorAt = (path, level, context) => {
+    const index = path.findLastIndex((node) => NUMBERED.has(node.kind) && node.level === level);
+    const node = path[index];
+    if (node !== undefined) {
+        const place = placeOf(node);
+        // 親は番号の付いた一つ上のまとまり。あいだの Markdown の見出しは飛ばす。無ければ文書（条より外のまとまり）。
+        const parent = path.slice(0, index).findLast((candidate) => NUMBERED.has(candidate.kind) && (candidate.level ?? 0) < level) ?? path[0];
+        if (place === undefined || parent === undefined)
+            return undefined;
+        return { place, siblings: node.kind === "article" ? context.articles : siblingsUnder(parent, level, context.implicitLevel) };
+    }
+    const parent = path.findLast((candidate) => NUMBERED.has(candidate.kind) && candidate.level === level - 1);
+    if (level !== context.implicitLevel || parent === undefined)
+        return undefined;
+    const siblings = siblingsUnder(parent, level, context.implicitLevel);
+    const first = siblings[0];
+    return first === undefined ? undefined : { place: first, siblings };
+};
+/**
+ * by だけ前後にずらす。範囲の行（第四十三条から第五十五条まで 削除）は中の条を一つずつ持たないので、数えてまたげば行き先がずれる。
+ * 前に数えて範囲をまたぐか範囲に当たる、後ろに数えて範囲をまたぐなら決めない。後ろに数えて範囲に当たるのは、その最初の条なので正しい。
+ */
+const shifted = (anchor, by) => {
+    const index = anchor.siblings.findIndex((place) => place.address === anchor.place.address);
+    if (index === -1)
+        return undefined;
+    const crossed = by > 0 ? anchor.siblings.slice(index + 1, index + by) : anchor.siblings.slice(Math.max(0, index + by), index);
+    return crossed.some((place) => place.range === true) ? undefined : anchor.siblings[index + by];
+};
+/** 前の全部（前各項）は、前に一つでもあれば最初のもの。 */
+const allBefore = (anchor) => (shifted(anchor, -1) === undefined ? undefined : anchor.siblings[0]);
+/**
+ * 前・次・本で決まる場所。「各」（count 0）は前の全部なので、最初のものを指す。
+ */
+const byPosition = (way, count, anchor) => {
+    if (way === "current")
+        return anchor.place;
+    if (way === "after")
+        return shifted(anchor, Math.max(count, 1));
+    return count === 0 ? allBefore(anchor) : shifted(anchor, -count);
+};
+/** 同: その前の参照の番地を、この深さまで切る。条より外のまとまりは番地の形が違うので扱わない。 */
+const bySame = (level, last) => (last === undefined ? undefined : { address: last.target, level });
+/** 並びの続き: 元の参照の番地を、この深さまで切る。元の参照の番地が決まらなければ決めない。 */
+const continued = (level, node, context) => {
+    const origin = context.byStart.get(node.span.start - Number(node.attrs["continues"]));
+    if (origin === undefined || context.articleLevel === undefined || level < context.articleLevel)
+        return undefined;
+    const parts = origin.target.split(".");
+    const kept = level - context.articleLevel + 1;
+    return parts.length < kept ? undefined : { target: parts.slice(0, kept).join("."), document: origin.document };
+};
+/**
+ * 参照が名指しした深さを覚える。名指しは、書き出しの深さ（第〇条なら条、前項なら項）から番地の深さまで。
+ * 番地を深さで切る起点は条。条より外のまとまりは番地の形が違うので覚えない。
+ */
+const remember = (context, target, document, from) => {
+    const articleLevel = context.articleLevel;
+    // 章・節は番地の形（ch1）が条から始まらないので覚えない。覚えると「同条」が章を指してしまう。
+    if (articleLevel === undefined || from < articleLevel)
+        return;
+    const parts = target.split(".");
+    parts.forEach((_, index) => {
+        const level = articleLevel + index;
+        if (level >= from)
+            context.last.set(level, { target: parts.slice(0, index + 1).join("."), document });
+    });
+};
+/** 「第二項第三号」を足す。一つ深いものは続け、二つ深い号は番号の無い第 1 項の中（x.1.n）に置く。 */
+const withSuffix = (place, suffix, implicitLevel) => suffix
+    .split(",")
+    .filter((part) => part !== "")
+    .reduce((current, part) => {
+    const [depth, value] = part.split(":").map(Number);
+    if (current === undefined || depth === undefined || value === undefined)
+        return undefined;
+    if (depth === current.level + 1)
+        return { address: `${current.address}.${String(value)}`, level: depth };
+    if (implicitLevel === current.level + 1 && depth === current.level + 2)
+        return { address: `${current.address}.1.${String(value)}`, level: depth };
+    return undefined;
+}, place);
+/** 番号の無い第 1 項（x.1）は、条そのものでもある。 */
+const fallbackOf = (place, implicitLevel) => place.level === implicitLevel && place.address.endsWith(".1") ? place.address.slice(0, -".1".length) : undefined;
+const baseOf = (way, node, anchor, last, context) => {
+    const level = Number(node.attrs["level"]);
+    if (way === "same")
+        return bySame(level, last);
+    if (way === "continue") {
+        const origin = continued(level, node, context);
+        return origin === undefined ? undefined : { address: origin.target, level };
+    }
+    return anchor === undefined ? undefined : byPosition(way, Number(node.attrs["count"]), anchor);
+};
+/** 同と並びの続きは、元の参照が他の文書を指していれば、それを引き継ぐ。前・次・本はこの文書の中。 */
+const documentOf = (way, node, last, context) => {
+    if (way === "same")
+        return last?.document;
+    return way === "continue" ? continued(Number(node.attrs["level"]), node, context)?.document : undefined;
+};
+const resolveOne = (node, path, context) => {
+    const way = String(node.attrs["relative"]);
+    const level = Number(node.attrs["level"]);
+    const last = context.last.get(level);
+    const anchor = way === "same" || way === "continue" ? undefined : anchorAt(path, level, context);
+    const base = baseOf(way, node, anchor, last, context);
+    const place = base === undefined ? undefined : withSuffix(base, String(node.attrs["suffix"] ?? ""), context.implicitLevel);
+    if (place === undefined)
+        return undefined;
+    const fallback = fallbackOf(place, context.implicitLevel);
+    const document = documentOf(way, node, last, context);
+    const attrs = {
+        target: place.address,
+        label: String(node.attrs["label"]),
+        ...(fallback === undefined ? {} : { fallback }),
+        ...(document === undefined ? {} : { document }),
+    };
+    return { ...node, attrs };
+};
+const isRelative = (node) => node.kind === "reference" && node.attrs["relative"] !== undefined;
+/** 文書の順に読み、参照ごとに「その前の参照」を覚える。 */
+const walk = (node, path, context) => {
+    if (isRelative(node)) {
+        const resolved = resolveOne(node, path, context);
+        const target = resolved === undefined ? undefined : String(resolved.attrs["target"]);
+        const document = optional(resolved?.attrs["document"]);
+        if (target !== undefined)
+            context.byStart.set(node.span.start, { target, document });
+        if (target !== undefined)
+            remember(context, target, document, Number(node.attrs["names"] ?? node.attrs["level"]));
+        return resolved;
+    }
+    if (node.kind === "reference") {
+        const target = String(node.attrs["target"]);
+        const document = optional(node.attrs["document"]);
+        context.byStart.set(node.span.start, { target, document });
+        remember(context, target, document, context.articleLevel ?? 0);
+    }
+    const inside = [...path, node];
+    const children = node.children.flatMap((child) => {
+        const kept = walk(child, inside, context);
+        return kept === undefined ? [] : [kept];
+    });
+    return { ...node, children };
+};
+const optional = (value) => (value === undefined ? undefined : String(value));
+const articlesOf = (node) => {
+    const place = node.kind === "article" ? placeOf(node) : undefined;
+    return [...(place === undefined ? [] : [place]), ...node.children.flatMap(articlesOf)];
+};
+export const resolveRelative = (tree, implicitLevel) => {
+    const articles = articlesOf(tree);
+    return walk(tree, [], { articles, articleLevel: articles[0]?.level, implicitLevel, last: new Map(), byStart: new Map() }) ?? tree;
+};
+//# sourceMappingURL=relative-resolve.js.map

package/dist/structure/relative-resolve.js.map

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

package/dist/structure/unread.d.ts

@@ -0,0 +1,8 @@
+import type { StructureNode } from "../plugin.ts";
+export type Unread = {
+    readonly clauses: number;
+    readonly units: number;
+};
+/** 読めていなければ、本文の条項番号の数と木の番号の数。読めていれば undefined。 */
+export declare const unreadStructure: (source: string, tree: StructureNode) => Unread | undefined;
+//# sourceMappingURL=unread.d.ts.map

package/dist/structure/unread.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unread.d.ts","sourceRoot":"","sources":["../../src/structure/unread.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAoBlD,MAAM,MAAM,MAAM,GAAG;IAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAY1E,kDAAkD;AAClD,eAAO,MAAM,eAAe,GAAI,QAAQ,MAAM,EAAE,MAAM,aAAa,KAAG,MAAM,GAAG,SAK9E,CAAC"}

package/dist/structure/unread.js

@@ -0,0 +1,34 @@
+/**
+ * 番号の付いた条項が本文にあるのに、木にほとんど入っていない文書。PDF から取り出した契約書は、字下げが深かったり
+ * 行が本文につながったりして、番号の行として読めないことが多い。そのとき構造の rule は「0 件」ではなく「読めなかった」と言う。
+ */
+const NUMBERED = new Set(["chapter", "article", "item"]);
+/**
+ * 「11.3. Liability Cap」「2.1 Term」: 二段以上の番号と、大文字で始まる語。行頭か、文の区切り（「. 12.10. Waiver」）の後ろ。
+ * 語の後ろの番号（「Version 1.2 Released」「Figure 2.1 Revenue」）は条項ではない。
+ * 「1.   TERM OF CONTRACT」: 行頭の一段の番号と、大文字だけの語。本文の箇条書き（「1. First」）とは分ける。
+ */
+const CLAUSE_NUMBERS = [/(?:^[ \t]{0,20}|[.;:][ \t]{1,10})\d{1,3}(?:\.\d{1,3}){1,4}\.?[ \t]{1,10}\p{Lu}/gmu, /^[ \t]{0,20}\d{1,3}\.[ \t]{1,10}\p{Lu}{2}/gmu];
+/** 本文の条項番号がこれ以上あれば、番号で組んだ文書。 */
+const MIN_CLAUSES = 5;
+/** 木に入った番号が本文の条項番号のこの割合に届かなければ、読めていない。 */
+const READ_SHARE = 0.25;
+const numberedUnits = (tree) => {
+    let count = 0;
+    const pending = [tree];
+    for (let node = pending.pop(); node !== undefined; node = pending.pop()) {
+        if (NUMBERED.has(node.kind))
+            count += 1;
+        pending.push(...node.children);
+    }
+    return count;
+};
+/** 読めていなければ、本文の条項番号の数と木の番号の数。読めていれば undefined。 */
+export const unreadStructure = (source, tree) => {
+    const clauses = CLAUSE_NUMBERS.reduce((total, pattern) => total + [...source.matchAll(pattern)].length, 0);
+    if (clauses < MIN_CLAUSES)
+        return undefined;
+    const units = numberedUnits(tree);
+    return units < clauses * READ_SHARE ? { clauses, units } : undefined;
+};
+//# sourceMappingURL=unread.js.map

package/dist/structure/unread.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unread.js","sourceRoot":"","sources":["../../src/structure/unread.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,CAAC,SAAS,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC;AAEzD;;;;GAIG;AACH,MAAM,cAAc,GAAG,CAAC,mFAAmF,EAAE,8CAA8C,CAAC,CAAC;AAE7J,gCAAgC;AAChC,MAAM,WAAW,GAAG,CAAC,CAAC;AACtB,0CAA0C;AAC1C,MAAM,UAAU,GAAG,IAAI,CAAC;AAIxB,MAAM,aAAa,GAAG,CAAC,IAAmB,EAAU,EAAE;IACpD,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,MAAM,OAAO,GAAoB,CAAC,IAAI,CAAC,CAAC;IACxC,KAAK,IAAI,IAAI,GAAG,OAAO,CAAC,GAAG,EAAE,EAAE,IAAI,KAAK,SAAS,EAAE,IAAI,GAAG,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC;QACxE,IAAI,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC;YAAE,KAAK,IAAI,CAAC,CAAC;QACxC,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC;IACjC,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC,CAAC;AAEF,kDAAkD;AAClD,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,MAAc,EAAE,IAAmB,EAAsB,EAAE;IACzF,MAAM,OAAO,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,CAAC,KAAK,GAAG,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IAC3G,IAAI,OAAO,GAAG,WAAW;QAAE,OAAO,SAAS,CAAC;IAC5C,MAAM,KAAK,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;IAClC,OAAO,KAAK,GAAG,OAAO,GAAG,UAAU,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;AACvE,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "chaffjs",
-  "version": "0.8.0",
+  "version": "0.9.0",
   "description": "Prose validation harness. Finds what is hard to read, and never rewrites it for you.",
   "keywords": [
     "chaff",
@@ -40,6 +40,7 @@
     "README.md",
     "bin",
     "dist",
+    "profiles",
     "rules",
     "skills",
     "src"
@@ -53,8 +54,8 @@
   },
   "dependencies": {
     "@anthropic-ai/sdk": "^0.125.0",
-    "@chaffjs/lang-en": "0.6.0",
-    "@chaffjs/lang-ja": "0.7.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

@@ -17,10 +17,14 @@ npx chaffjs . --compact            # two lines per finding: line:col severity me
 npx chaffjs <file> --experimental  # also the experimental rules
 ```
 
-A run exits 1 when a finding is an `error`, and also 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 (the default output only; `--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, so to call one file clean,
-run chaff on that file alone and read its list.
+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
 
@@ -53,6 +57,22 @@ relaxing a rule.
 - `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

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

@@ -2,7 +2,7 @@
  * 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"];
+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[] =>

package/src/cli-text.ts

@@ -22,6 +22,8 @@ const USAGE_JA = `chaff — 文章の読みにくいところを見つけます
   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 も動かす
@@ -53,6 +55,8 @@ const USAGE_EN = `chaff — finds what makes writing hard to read. It never rewr
   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

package/src/cli.ts

@@ -27,6 +27,7 @@ import { VERSION } from "./version.ts";
 import { runTree, treeTargets, type TreeContext } from "./commands/tree.ts";
 import { citeTargets, runCite } from "./commands/cite.ts";
 import { runSkill } from "./commands/skill.ts";
+import { runFeedback, settingsOf } from "./commands/feedback.ts";
 import { homedir } from "node:os";
 import { ruleProblems } from "./config/rule-problems.ts";
 import { renderSummary, type FileOutcome } from "./render/summary.ts";
@@ -34,6 +35,7 @@ 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";
+import { profileFor } from "./profile/for-file.ts";
 
 /** Text for output that is not about one document. */
 const hostText = (config: Config): CliText => CLI_TEXT[hostLanguage(config.language, process.env)];
@@ -82,6 +84,7 @@ type Inspected = {
   readonly rules: readonly RuleDefinition[];
   /** ファイルごとの言語。by_path で 1 つの repo に 2 言語が混ざる。 */
   readonly language: string;
+  readonly genre: string;
   readonly outcome: FileOutcome;
   readonly perFile: PerFile;
   readonly all: readonly string[];
@@ -101,7 +104,7 @@ const inspect = async (path: string, config: Config, argv: readonly string[]): P
   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 doc = buildDocument(path, source, adapter, teamRules(config), profileFor(config, path, source, language));
   const raw = runRules(doc, rules, config.rules, experimental, genre, config.limits);
   // 応答は 3 つ。stet で黙らせたものは、ここで落とす。
   const applied = applySuppressions(
@@ -118,6 +121,7 @@ const inspect = async (path: string, config: Config, argv: readonly string[]): P
     text,
     rules,
     language,
+    genre,
     outcome: { path, findings: split.fresh, notRun: raw.skipped.length },
     perFile: { path, suppressed: applied.suppressed, reasonless: applied.unusedReasonless },
     all: applied.kept.map((finding) => fingerprint(path, finding)),
@@ -297,6 +301,21 @@ const HANDLERS: Readonly<Record<string, Handler>> = {
   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")),
+  feedback: (argv) => {
+    const config = readConfig();
+    return runFeedback(positional(argv), argv, {
+      cwd: process.cwd(),
+      ui: hostLanguage(config.language, process.env),
+      version: VERSION,
+      runtime: `Node ${process.version} · ${process.platform} ${process.arch}`,
+      flag,
+      settingsOf: (ruleIds) => settingsOf(config, ruleIds),
+      check: async (path) => {
+        const inspected = await inspect(path, config, [...argv, "--show-baseline"]);
+        return { findings: inspected.outcome.findings, rules: inspected.rules, language: inspected.language, genre: inspected.genre };
+      },
+    });
+  },
   skill: (argv) => runSkill(argv, { cwd: process.cwd(), home: homedir(), ui: hostLanguage(readConfig().language, process.env) }),
 };
 

package/src/commands/eval.ts

@@ -9,6 +9,7 @@ import { evaluate } from "../eval.ts";
 import { renderEval } from "../render/eval.ts";
 import { neededBy } from "../run.ts";
 import type { Config } from "../config/load.ts";
+import { profileFor } from "../profile/for-file.ts";
 
 export type Context = {
   readonly config: Config;
@@ -35,7 +36,7 @@ export const runEval = async (targets: readonly string[], argv: readonly string[
       const adapter = await loadAdapter(language);
       const { genre } = resolveGenre(path, source, config);
       await adapter.prepare?.(neededBy(loadRules(language), config.rules, config.experimental, genre, language));
-      return { doc: buildDocument(path, source, adapter, teamRules(config)), language, genre };
+      return { doc: buildDocument(path, source, adapter, teamRules(config), profileFor(config, path, source, language)), language, genre };
     }),
   );
   const language = docs[0]?.language ?? "ja";