hanlint 0.0.18 → 0.0.19

package/src/index.js

@@ -1,13 +1,13 @@
 // @ts-check
 /**
- * hanlint: 한국어 글에서 AI 와 사람이 반복해서 어기는 결함을 결정적으로 잡는 린터. 공개 표면은 이 파일 한 곳이다.
+ * hanlint: 한국어 글에서 규칙으로 잡을 수 있는 잘못을 찾는 검사기. 공개 API는 이 파일 한 곳에 있다.
  *
  * ```js
  * import { lintText, lintFile } from "hanlint";
  * for (const f of lintFile("글.md")) console.log(f.line, f.rule, f.why);
  * ```
  *
- * 합격과 불합격을 판정하지 않는다. 지적 목록이 비어 있다는 것은 세어서 잡히는 결함이 없다는 뜻이다.
+ * 합격과 불합격을 판정하지 않는다. 지적 목록이 비어 있다는 것은 규칙으로 잡을 수 있는 잘못이 없다는 뜻이다.
  * 같은 공개 API를 Node와 브라우저가 공유한다. 파일 경로를 읽는 API만 Node 전용이다.
  */
 import { readExternal } from "./data/read.js";
@@ -84,7 +84,7 @@ export {
 export const version = loadVersion();
 
 /**
- * 글을 한 번 읽어 지문을 만든다.
+ * 글을 한 번 읽어 분석 결과를 만든다.
  * @param {string} text
  * @param {import("./config/settings.js").Config} [config]
  * @param {string | null} [path]
@@ -104,7 +104,7 @@ export function lintText(text, config = defaultConfig(), path = null) {
 }
 
 /**
- * 파일을 UTF-8 로 읽어 검사한다.
+ * 파일을 UTF-8로 읽어 검사한다.
  * @param {string} path
  * @param {import("./config/settings.js").Config} [config]
  */
@@ -112,7 +112,7 @@ export function lintFile(path, config = defaultConfig()) {
   return lintText(readExternal(path), config, path);
 }
 
-/** 지적, 문체 본보기, 승인 고침과 지문을 같은 분석에서 제공한다. @param {string} text @param {import("./config/settings.js").Config} config */
+/** 지적, 문체 예시, 승인 고침과 분석 결과를 같은 분석에서 준다. @param {string} text @param {import("./config/settings.js").Config} config */
 export function inspectText(text, config = defaultConfig()) {
   const document = fingerprint(text, config);
   const findings = runAll(document, config);
@@ -132,7 +132,7 @@ export function learnText(before, after, config = defaultConfig()) {
   };
 }
 
-/** 자유 원고의 표면과 H2 순서를 비교한다. 빈 글과 반복 제목도 관찰하며 승인 계약을 만들지 않는다. @param {string} before @param {string} after @param {import("./config/settings.js").Config} config */
+/** 자유 원고의 숫자·링크·코드와 H2 순서를 비교한다. 빈 글과 반복 제목도 관찰하며 승인 계약을 만들지 않는다. @param {string} before @param {string} after @param {import("./config/settings.js").Config} config */
 export function compareRevision(before, after, config = defaultConfig()) {
   const original = before.normalize("NFC");
   const outline = { level: 2, headings: headingsOf(parseMarkdown(original), 2).map((heading) => heading.text) };

package/src/learn/edits.js

@@ -1,5 +1,5 @@
 // @ts-check
-/** Python learn/edits.py와 같은 원문 문장 대응 및 지적 소멸 후보다. */
+/** Python learn/edits.py와 같은 방법으로 문장을 짝짓고, 지적이 사라진 문장 짝을 후보로 낸다. */
 import { sourceSentenceTexts } from "../fingerprint/sourceSentence.js";
 import { readerKind } from "../fingerprint/readerState.js";
 import { localCue, SENTENCE } from "../rules/finding.js";
@@ -21,7 +21,7 @@ export function learnExemplars(beforeDoc, afterDoc, beforeFindings, afterFinding
     if (!afterText || before.text.trim() === afterPlain) continue;
     seen.add(key);
     learned.push({ rule: finding.rule, before: (rawBefore.get(before.index) ?? before.text).trim(), after: afterText,
-      moved: "실제 수정본의 문장으로 바꿈", why: finding.why, beforeLine: before.line,
+      moved: "실제로 고친 문장으로 바꿨다", why: finding.why, beforeLine: before.line,
       afterLines: [...new Set(after.map((item) => item.line))], sentence: before.text.trim(),
       cue: localCue(finding), reader: readerKind(before, beforeDoc.reader.beforeSentence[finding.at]),
       ...(preset ? { presets: [preset] } : {}),

package/src/learn/operations.js

@@ -1,5 +1,5 @@
 // @ts-check
-/** Python learn/operations.py의 표면 치환 후보와 증거 묶음. */
+/** Python learn/operations.py의 치환 후보와 증거 묶음. */
 import { operationFromApproval } from "../data/operations.js";
 import { sourceSentenceTexts } from "../fingerprint/sourceSentence.js";
 import { changedSentencePairs } from "./pairs.js";

package/src/regex.js

@@ -1,6 +1,6 @@
 // @ts-check
 /**
- * 파이썬 re 와 같은 뜻으로 쓰는 얇은 껍질. search 는 첫 자리, at 은 문자열 첫머리에서만, all 은 전부.
+ * 파이썬 re와 같은 뜻으로 쓰는 얇은 껍질. search는 첫 일치, at은 문자열 첫머리에서만, all은 전부.
  * 정규식 문법은 데이터 파일과 규칙에서 파이썬과 같은 부분집합만 쓴다 (lookbehind 포함, 이름 그룹 없음).
  */
 
@@ -41,7 +41,7 @@ export function compile(source, flags = "") {
   };
 }
 
-/** 정규식 특수문자를 이스케이프한다 (파이썬 re.escape 의 쓰임새). @param {string} text */
+/** 정규식 특수문자를 이스케이프한다 (파이썬 re.escape의 쓰임새). @param {string} text */
 export function escape(text) {
   return text.replace(SPECIALS, (c) => BACKSLASH + c);
 }

package/src/report/compactReport.js

@@ -1,5 +1,5 @@
 // @ts-check
-/** 한 줄에 지적 하나. AI 와 스크립트가 읽는 형식이다. 파이썬 report/compactReport.py 와 같은 글자다. */
+/** 한 줄에 지적 하나. AI와 스크립트가 읽는 형식이다. 파이썬 report/compactReport.py와 같은 글자다. */
 
 /** 줄바꿈과 이어진 공백을 하나로 눕힌다. 한 줄은 이 형식의 계약이다. @param {string} text */
 function flat(text) {
@@ -10,8 +10,8 @@ function flat(text) {
 export function renderCompact(path, findings) {
   return findings
     .map((f) => {
-      const label = f.severity === "notice" ? "notice: " : "";
-      const fixLabel = f.severity === "notice" ? "검토할 대안" : "고친 뒤";
+      const label = f.severity === "notice" ? "경고: " : "";
+      const fixLabel = f.severity === "notice" ? "제안" : "고친 뒤";
       return `${path}:${f.line} [${f.rule}] ${label}${flat(f.why)}` + (f.fix ? `  ${fixLabel}: ${flat(f.fix)}` : "");
     })
     .join("\n");

package/src/report/fingerprintJson.js

@@ -1,7 +1,7 @@
 // @ts-check
 /**
- * 지문 계층의 JSON 꼴. 파이썬 report/fingerprintJson.py 와 같은 키 순서다. 층마다 한 번씩만 적고 위층은
- * 아래층을 index 로 가리킨다. 실수는 소수 여섯째 자리로 맞춰 두 구현이 같은 글자를 낸다.
+ * 지문 계층의 JSON 꼴. 파이썬 report/fingerprintJson.py와 같은 키 순서다. 층마다 한 번씩만 적고 위층은
+ * 아래층을 index로 가리킨다. 실수는 소수 여섯째 자리로 맞춰 두 구현이 같은 글자를 낸다.
  */
 
 import { roundHalfEven } from "../text.js";

package/src/report/githubReport.js

@@ -1,5 +1,5 @@
 // @ts-check
-/** GitHub Actions 의 워크플로 명령 꼴. PR 에 줄 단위 주석이 붙는다. */
+/** GitHub Actions의 워크플로 명령 꼴. PR에 줄 단위 주석이 붙는다. */
 
 /** @param {string} path @param {import("../rules/finding.js").Finding[]} findings */
 export function renderGithub(path, findings) {

package/src/report/jsonReport.js

@@ -1,7 +1,7 @@
 // @ts-check
 /**
- * 기계가 읽는 형식. 평가 루프의 0층 입력이다. 파이썬 json.dumps(indent=2, ensure_ascii=False) 와 같은 글자다.
- * 지적마다 `exemplar` 를 붙인다. 승인 원문 완전 일치 `patch`는 맞는 지적에만 별도로 붙인다.
+ * 기계가 읽는 형식. 평가 루프의 0층 입력이다. 파이썬 json.dumps(indent=2, ensure_ascii=False)와 같은 글자다.
+ * 지적마다 `exemplar`를 붙인다. 승인 원문 완전 일치 `patch`는 맞는 지적에만 별도로 붙인다.
  * 실제 수정 차이는 파이썬의 exemplarLift와 patchMemory 실험 스크립트에서 따로 잰다.
  */
 import { exemplarFor } from "../data/exemplars.js";

package/src/report/registerMatch.js

@@ -1,5 +1,5 @@
 // @ts-check
-/** 한 문체로 저장한 본보기와 문형을 검사한 글의 문체에 맞춘다. */
+/** 한 문체로 저장한 예시와 문형을 검사한 글의 문체에 맞춘다. */
 import { HAPNIDA, REGISTERS, convertTemplate } from "../analysis/grammar/index.js";
 
 /** 섞임과 없음은 데이터 정본의 합니다체를 유지한다. @param {string | null | undefined} register */
@@ -14,7 +14,7 @@ export function exemplarInRegister(exemplar, register) {
   const after = convertTemplate(exemplar.after, target);
   if (before.skipped || after.skipped) {
     throw new Error(
-      exemplar.rule + " 본보기의 서술어를 못 풀었다: " + (before.skipped + after.skipped),
+      exemplar.rule + " 예시의 서술어를 못 풀었다: " + (before.skipped + after.skipped),
     );
   }
   return { rule: exemplar.rule, before: before.text, after: after.text, moved: exemplar.moved, presets: exemplar.presets };

package/src/report/sheet.js

@@ -1,7 +1,7 @@
 // @ts-check
 /**
  * 글 시트. 소스에서 뽑은 글 마디와 지적을 마크다운 표 하나로 내고, 사람이 고친 표를 다시 읽는다.
- * 뜻과 칸의 정본은 파이썬 report/sheet.py 다. 여기는 같은 글자를 낸다.
+ * 뜻과 칸의 정본은 파이썬 report/sheet.py다. 여기는 같은 글자를 낸다.
  */
 
 import { parseMarkdown } from "../document/parseMarkdown.js";
@@ -19,12 +19,12 @@ const ROW_PATTERN = /^\|(.*)\|$/;
  * @property {string} text
  * @property {import("../rules/finding.js").Finding[]} findings
  * @property {string} fix 사람이 표에 적은 고친 글. 뽑을 때는 비어 있다
- * @property {number} column 1부터 세는 칸. 0 이면 모른다
+ * @property {number} column 1부터 세는 칸. 0이면 모른다
  */
 
 /** @param {string} text */
 /**
- * 지적이 하나이고 그 지적에 고침이 있으면 고침 칸에 미리 적는다. 뜻은 파이썬 report/sheet.py 의 prefilledFix 가 소유한다.
+ * 지적이 하나이고 그 지적에 고침이 있으면 고침 칸에 미리 적는다. 뜻은 파이썬 report/sheet.py의 prefilledFix가 소유한다.
  * @param {import("../document/sourceText.js").SourceLiteral} literal
  * @param {import("../rules/finding.js").Finding[]} findings
  */
@@ -35,8 +35,8 @@ function prefilledFix(literal, findings) {
 }
 
 /**
- * (라벨, 소스) 마다 글을 뽑아 규칙을 돌리고 표의 행을 만든다. 지적은 `error` 만 남긴다.
- * 소스를 읽는 쪽 (CLI 는 디스크, 브라우저는 저장소) 이 다르므로 읽기는 밖에 두고 문자열만 받는다.
+ * (라벨, 소스)마다 글을 뽑아 규칙을 돌리고 표의 행을 만든다. 지적은 `error`만 남긴다.
+ * 소스를 읽는 쪽 (CLI는 디스크, 브라우저는 저장소)이 다르므로 읽기는 밖에 두고 문자열만 받는다.
  * @param {Iterable<{ label: string, source: string }>} sources
  * @param {import("../config/settings.js").Config} config
  * @param {boolean} [everything] 지적이 없는 글도 넣는다
@@ -63,7 +63,7 @@ export function unescapeCell(text) {
   return text.replaceAll("\\|", "|").replaceAll("\\\\", "\\");
 }
 
-/** `| a | b |` 를 칸으로. `\|` 는 칸 경계가 아니다. @param {string} line @returns {string[] | null} */
+/** `| a | b |`를 칸으로. `\|`는 칸 경계가 아니다. @param {string} line @returns {string[] | null} */
 export function splitRow(line) {
   const match = ROW_PATTERN.exec(line.trim());
   if (!match) return null;
@@ -91,7 +91,7 @@ const CUE = /^`[^`]+`/;
 
 
 /**
- * `column` (1부터) 에 `old` 가 그대로 있으면 그 자리만 `new` 로 바꾼다.
+ * `column` (1부터)에 `old`가 그대로 있으면 그 자리만 `new`로 바꾼다.
  * @param {string} lineText @param {number} column @param {string} old @param {string} replacement @returns {[string, boolean]}
  */
 function replaceAt(lineText, column, old, replacement) {
@@ -101,8 +101,8 @@ function replaceAt(lineText, column, old, replacement) {
 }
 
 /**
- * 한 파일의 소스에 표의 행들을 되돌려 쓴다. [새 소스, 적용한 자리, 실패한 자리와 이유]. 뜻은 파이썬 report/sheet.py 의
- * applyRows 가 소유한다. 한 줄에 고침이 여럿이면 뒤 칸부터 바꾼다. 줄은 `\n` 으로만 나누므로 `\r` 은 남아 CRLF 파일이 그대로다.
+ * 한 파일의 소스에 표의 행들을 되돌려 쓴다. [새 소스, 적용한 자리, 실패한 자리와 이유]. 뜻은 파이썬 report/sheet.py의
+ * applyRows가 소유한다. 한 줄에 고침이 여럿이면 뒤 칸부터 바꾼다. 줄은 `\n` 으로만 나누므로 `\r`은 남아 CRLF 파일이 그대로다.
  * @param {string} source @param {SheetRow[]} rows @returns {[string, string[], string[]]}
  */
 export function applyRows(source, rows) {
@@ -140,8 +140,8 @@ export function applyRows(source, rows) {
 }
 
 /**
- * 규칙마다 한 번. 첫 지적의 이유는 온전히, 같은 규칙의 나머지는 단서 (이유 앞의 `…`) 만 `(또 …)` 로 잇는다.
- * 뜻은 파이썬 report/sheet.py 의 findingCell 이 소유한다.
+ * 규칙마다 한 번. 첫 지적의 이유는 온전히, 같은 규칙의 나머지는 단서 (이유 앞의 `…`)만 `(또 …)`로 잇는다.
+ * 뜻은 파이썬 report/sheet.py의 findingCell이 소유한다.
  * @param {import("../rules/finding.js").Finding[]} findings
  */
 function findingCell(findings) {
@@ -168,7 +168,7 @@ function placeOf(row) {
   return row.column > 0 ? `${row.file}:${row.line}:${row.column}` : `${row.file}:${row.line}`;
 }
 
-/** `경로:줄:칸` 이나 `경로:줄` 을 [경로, 줄, 칸] 으로. 칸이 없으면 0. 꼴이 아니면 경로가 null. @param {string} place @returns {[string | null, number, number]} */
+/** `경로:줄:칸`이나 `경로:줄`을 [경로, 줄, 칸]으로. 칸이 없으면 0. 꼴이 아니면 경로가 null. @param {string} place @returns {[string | null, number, number]} */
 export function splitPlace(place) {
   const last = place.lastIndexOf(":");
   if (last < 0 || !/^[0-9]+$/.test(place.slice(last + 1))) return [null, 0, 0];
@@ -185,7 +185,7 @@ export function renderSheet(rows, preset, fileCount) {
     "# hanlint sheet",
     "",
     `프리셋 ${preset}, 파일 ${fileCount}개, 글 ${rows.length}개, 지적 있는 글 ${flagged}개. ` +
-      "고침 칸에 새 글을 적고 `hanlint sheet apply 이파일.md` 로 되돌려 쓴다. 다른 칸은 고치지 않는다.",
+      "고침 칸에 새 글을 적고 `hanlint sheet apply 이파일.md`로 되돌려 쓴다. 다른 칸은 고치지 않는다.",
     "",
     `| ${HEADER.join(" | ")} |`,
     `| ${HEADER.map(() => "---").join(" | ")} |`,
@@ -216,7 +216,7 @@ export function renderSheetJson(rows, preset, fileCount) {
 }
 
 /**
- * 사람이 고친 표를 읽는다. 머리글과 구분선은 넘기고 `고침` 이 있는 줄만 남긴다.
+ * 사람이 고친 표를 읽는다. 머리글과 구분선은 넘기고 `고침`이 있는 줄만 남긴다.
  * @param {string} markdown @returns {{ rows: SheetRow[], problems: string[] }}
  */
 export function parseSheet(markdown) {
@@ -230,13 +230,13 @@ export function parseSheet(markdown) {
     if (cells === null) return;
     if (cells.slice(0, HEADER.length).join("") === HEADER.join("") || cells.every((cell) => cell.replace(/-/g, "") === "")) return;
     if (cells.length !== HEADER.length) {
-      problems.push(`${lineNumber}행: 칸이 ${cells.length}개다. ${HEADER.length}개여야 한다`);
+      problems.push(`${lineNumber}번째 줄: 칸이 ${cells.length}개다. ${HEADER.length}개여야 한다`);
       return;
     }
     const place = unescapeCell(cells[1]);
     const [file, line, column] = splitPlace(place);
     if (file === null) {
-      problems.push(`${lineNumber}행: 자리 \`${place}\` 가 경로:줄 이나 경로:줄:칸 꼴이 아니다`);
+      problems.push(`${lineNumber}번째 줄: 경로:줄이나 경로:줄:칸 형식이 아닌 자리: \`${place}\``);
       return;
     }
     const fix = unescapeCell(cells[4]);

package/src/report/textReport.js

@@ -1,12 +1,12 @@
 // @ts-check
 /**
- * 사람이 읽는 지적 목록. `파일:줄` 로 시작해 편집기가 바로 연다. 파이썬 report/textReport.py 와 같은 글자다.
- * 끝에 본보기를 붙인다. 전과 후를 제 줄에 둔다. 왜 한 줄이 아닌지는 파이썬 report/textReport.py 가 소유한다.
+ * 사람이 읽는 지적 목록. `파일:줄`로 시작해 편집기가 바로 연다. 파이썬 report/textReport.py와 같은 글자다.
+ * 끝에 예시를 붙인다. 전과 후를 제 줄에 둔다. 왜 한 줄이 아닌지는 파이썬 report/textReport.py가 소유한다.
  */
 import { exemplarFor, shortened, twoLines } from "../data/exemplars.js";
 import { exemplarInRegister } from "./registerMatch.js";
 
-/** 그 글에 나온 규칙의 본보기. 이름 순이고 규칙 하나에 세 줄이다. @param {import("../rules/finding.js").Finding[]} findings @param {string | null | undefined} register @param {string | null | undefined} preset @param {import("../data/exemplars.js").Exemplar[]} customExemplars */
+/** 그 글에 나온 규칙의 예시. 이름 순이고 규칙 하나에 세 줄이다. @param {import("../rules/finding.js").Finding[]} findings @param {string | null | undefined} register @param {string | null | undefined} preset @param {import("../data/exemplars.js").Exemplar[]} customExemplars */
 function exemplarLines(findings, register, preset, customExemplars) {
   const lines = [];
   let cut = false;
@@ -19,15 +19,15 @@ function exemplarLines(findings, register, preset, customExemplars) {
     lines.push(`  [${name}]`, `    전  ${before}`, `    후  ${after}`);
   }
   if (!lines.length) return [];
-  const head = "본보기 (고치기 전, 고친 뒤)";
-  return [cut ? `${head}. 잘린 것은 hanlint explain <규칙>` : head, ...lines];
+  const head = "예시 (고치기 전, 고친 뒤)";
+  return [cut ? `${head}. 잘린 것은 hanlint explain <규칙>으로 본다` : head, ...lines];
 }
 
-/** 본보기 아래에 붙이는 선택지. 지적 자리별이며 순위는 없다. @param {import("../rules/finding.js").Finding[]} findings */
+/** 예시 아래에 붙이는 선택지. 지적 자리별이며 순위는 없다. @param {import("../rules/finding.js").Finding[]} findings */
 function candidateLines(findings) {
   const chosen = findings.filter((finding) => finding.candidates.length);
   if (!chosen.length) return [];
-  const lines = ["후보 (기계가 고르지 않음)"];
+  const lines = ["후보 (hanlint가 하나를 고르지 않았다)"];
   for (const finding of chosen) {
     lines.push(`  ${finding.line}줄 [${finding.rule}]`);
     for (const candidate of finding.candidates) lines.push(`    - ${candidate.text} (${candidate.why})`);
@@ -35,7 +35,7 @@ function candidateLines(findings) {
   return lines;
 }
 
-/** 접은 확인 권고. 규칙마다 개수와 줄 번호 한 줄. 뜻은 파이썬 textReport.py 의 noticeLines 가 소유한다. @param {import("../rules/finding.js").Finding[]} notices */
+/** 접은 경고. 규칙마다 개수와 줄 번호 한 줄. 뜻은 파이썬 textReport.py의 noticeLines가 소유한다. @param {import("../rules/finding.js").Finding[]} notices */
 function noticeLines(notices) {
   /** @type {Map<string, number[]>} */
   const byRule = new Map();
@@ -43,7 +43,7 @@ function noticeLines(notices) {
     if (!byRule.has(finding.rule)) byRule.set(finding.rule, []);
     /** @type {number[]} */ (byRule.get(finding.rule)).push(finding.line);
   }
-  const lines = [`확인 권고 ${notices.length}건 (접음. 다 보려면 --notices)`];
+  const lines = [`경고 ${notices.length}건 (접어 두었다. 다 보려면 --notices)`];
   for (const rule of [...byRule.keys()].sort()) {
     const numbers = [...new Set(/** @type {number[]} */ (byRule.get(rule)))].sort((a, b) => a - b);
     lines.push(`  ${rule} ${/** @type {number[]} */ (byRule.get(rule)).length}  ${numbers.join(", ")}줄`);
@@ -56,14 +56,14 @@ export function renderText(path, findings, register = null, preset = null, custo
   if (!findings.length) return `${path}  오류 없음`;
   const errors = findings.filter((f) => f.severity === "error").length;
   const notices = findings.length - errors;
-  const summary = `${path}  오류 ${errors}건` + (notices ? `, 확인 권고 ${notices}건` : "");
+  const summary = `${path}  오류 ${errors}건` + (notices ? `, 경고 ${notices}건` : "");
   const lines = [summary, ""];
   const folded = unfoldNotices ? [] : findings.filter((f) => f.severity === "notice");
   const shown = findings.filter((f) => unfoldNotices || f.severity === "error");
   for (const f of shown) {
-    const tag = `[${f.rule}]` + (f.severity === "notice" ? " 확인" : "");
+    const tag = `[${f.rule}]` + (f.severity === "notice" ? " 경고" : "");
     lines.push(`${path}:${f.line}  ${tag}`, `  ${f.quote}`, `  ${f.why}`);
-    if (f.fix) lines.push(`  ${f.severity === "notice" ? "검토할 대안" : "고친 뒤"}: ${f.fix}`);
+    if (f.fix) lines.push(`  ${f.severity === "notice" ? "제안" : "고친 뒤"}: ${f.fix}`);
     lines.push("");
   }
   if (folded.length) lines.push(...noticeLines(folded), "");

package/src/report/writingSpec.js

@@ -27,7 +27,7 @@ function percent(value) {
 function selectedProfile(config) {
   if (config.profile) return userProfile(config.profile);
   const kind = PROFILE_OF[config.preset];
-  if (kind === null) throw new Error(`${config.preset} 은 종류 프로파일이 없어 사양을 낼 수 없다`);
+  if (kind === null) throw new Error(`${config.preset} 프리셋은 비교할 프로파일이 없어 스펙을 낼 수 없다`);
   const profile = profileOf(kind);
   if (profile === null) throw new Error(`${kind} 프로파일을 찾지 못했다`);
   return profile;
@@ -40,8 +40,8 @@ function selectedProfile(config) {
  * @param {number | null} [targetChars]
  */
 export function writingSpec(config = defaultConfig(), register = HAPNIDA, targetChars = null) {
-  if (!REGISTERS.includes(register)) throw new Error(`register 는 ${REGISTERS.join(", ")} 가운데 하나다: ${register}`);
-  if (targetChars !== null && targetChars <= 0) throw new Error(`chars 는 1 이상이어야 한다: ${targetChars}`);
+  if (!REGISTERS.includes(register)) throw new Error(`register는 ${REGISTERS.join(", ")} 가운데 하나여야 한다. 받은 값: ${register}`);
+  if (targetChars !== null && targetChars <= 0) throw new Error(`chars는 1 이상이어야 한다. 받은 값: ${targetChars}`);
   const profile = selectedProfile(config);
   const sentence = profile.sentence;
   const paragraph = profile.paragraph.get("sentenceCount");
@@ -62,7 +62,7 @@ export function writingSpec(config = defaultConfig(), register = HAPNIDA, target
   }
   rows.push({ id: "amount", label: "분량", guidance: amount, basis: [`profile.${profile.kind}.paragraph.sentenceCount`] });
 
-  let length = `중앙 ${lengthP50}어절, 문장 90%가 ${percentile(lengthHistogram, 90)}어절 이하`;
+  let length = `중앙값 ${lengthP50}어절, 문장 90%가 ${percentile(lengthHistogram, 90)}어절 이하`;
   const lengthBasis = [`profile.${profile.kind}.sentence.length`];
   if (enabled(config, "longSentence")) {
     length += `. ${config.longSentenceMax}어절을 넘으면 longSentence가 지적`;
@@ -71,7 +71,7 @@ export function writingSpec(config = defaultConfig(), register = HAPNIDA, target
   rows.push({ id: "sentenceLength", label: "문장 길이", guidance: length, basis: lengthBasis });
 
   if (profile.endingRuns !== null) {
-    let endingText = `같은 끝맺음 연속 중앙 ${percentile(profile.endingRuns, 50)}개, 90%가 ${percentile(profile.endingRuns, 90)}개 이하`;
+    let endingText = `같은 끝맺음 연속 중앙값 ${percentile(profile.endingRuns, 50)}개, 90%가 ${percentile(profile.endingRuns, 90)}개 이하`;
     const endingBasis = [`profile.${profile.kind}.endingRuns`];
     if (enabled(config, "endingRepeat")) {
       endingText += `. 인과나 독자 호출 없이 ${config.endingRun}개부터 endingRepeat가 지적`;
@@ -85,13 +85,13 @@ export function writingSpec(config = defaultConfig(), register = HAPNIDA, target
   rows.push({
     id: "commas",
     label: "쉼표",
-    guidance: `문장 중앙 ${percentile(commas, 50)}개, 90%가 ${percentile(commas, 90)}개 이하, 99%가 ${percentile(commas, 99)}개 이하`,
+    guidance: `문장 중앙값 ${percentile(commas, 50)}개, 90%가 ${percentile(commas, 90)}개 이하, 99%가 ${percentile(commas, 99)}개 이하`,
     basis: [`profile.${profile.kind}.sentence.commas`],
   });
 
   const eui = sentence.get("euiCount");
   if (!eui) throw new Error("프로파일에 sentence.euiCount가 없다");
-  let euiText = `문장 중앙 ${percentile(eui, 50)}개, 90%가 ${percentile(eui, 90)}개 이하`;
+  let euiText = `문장 중앙값 ${percentile(eui, 50)}개, 90%가 ${percentile(eui, 90)}개 이하`;
   const euiBasis = [`profile.${profile.kind}.sentence.euiCount`];
   if (enabled(config, "euiChain")) {
     euiText += ". 3개부터, 붙은 2개부터 euiChain이 지적";
@@ -114,7 +114,7 @@ export function writingSpec(config = defaultConfig(), register = HAPNIDA, target
   rows.push({
     id: "newTopics",
     label: "새 화제",
-    guidance: `문장 중앙 ${percentile(newTopics, 50)}개, 90%가 ${percentile(newTopics, 90)}개 이하`,
+    guidance: `문장 중앙값 ${percentile(newTopics, 50)}개, 90%가 ${percentile(newTopics, 90)}개 이하`,
     basis: [`profile.${profile.kind}.sentence.newTopics`],
   });
 
@@ -122,7 +122,7 @@ export function writingSpec(config = defaultConfig(), register = HAPNIDA, target
   rows.push({
     id: "connector",
     label: "문두 접속",
-    guidance: `문서 중앙은 문장의 ${percent(connector.p50)}%, 문서 90%가 ${percent(connector.p90)}% 이하`,
+    guidance: `문서 중앙값은 문장의 ${percent(connector.p50)}%, 문서 90%가 ${percent(connector.p90)}% 이하`,
     basis: [`profile.${profile.kind}.rates.connector`],
   });
 
@@ -132,8 +132,8 @@ export function writingSpec(config = defaultConfig(), register = HAPNIDA, target
   const numberP90 = percentile(numbers, 90);
   const numberText =
     numberP50 === 0 && numberP90 === 0
-      ? "문장 중앙과 90%에서 숫자 없음"
-      : `문장 중앙 ${numberP50}개, 90%가 ${numberP90}개 이하`;
+      ? "문장 중앙값과 90%에서 숫자 없음"
+      : `문장 중앙값 ${numberP50}개, 90%가 ${numberP90}개 이하`;
   rows.push({ id: "numbers", label: "숫자", guidance: numberText, basis: [`profile.${profile.kind}.sentence.numbers`] });
 
   const question = profile.rates.question;
@@ -142,10 +142,10 @@ export function writingSpec(config = defaultConfig(), register = HAPNIDA, target
   if (enabled(config, "noQuestion")) {
     questionText = config.enforceStyle.includes("noQuestion")
       ? "선택한 정책: 절이 2개 이상이면 글 전체에 물음표 최소 1개"
-      : "물음표 부재는 notice다. 질문 없이 충분히 설명했다면 유지한다";
+      : "물음표가 없으면 경고다. 질문 없이 충분히 설명했다면 그대로 둔다";
     questionBasis = [`profile.${profile.kind}.rates.question`, "rule.noQuestion"];
   } else {
-    questionText = `규칙 요구 없음. 문서 중앙은 문장의 ${percent(question.p50)}%, 문서 90%가 ${percent(question.p90)}% 이하`;
+    questionText = `규칙 요구 없음. 문서 중앙값은 문장의 ${percent(question.p50)}%, 문서 90%가 ${percent(question.p90)}% 이하`;
     questionBasis = [`profile.${profile.kind}.rates.question`];
   }
   rows.push({ id: "question", label: "물음표", guidance: questionText, basis: questionBasis });
@@ -165,10 +165,10 @@ export function writingSpec(config = defaultConfig(), register = HAPNIDA, target
 export function renderWritingSpec(spec) {
   const target = spec.targetChars !== null ? `, ${spec.targetChars}자` : "";
   const lines = [
-    `hanlint spec  ${spec.preset} 종류, ${spec.register}체${target}. 같은 규칙 세트의 임계와 ${spec.profile} 프로파일을 쓰기 전 숫자로 편다`,
+    `hanlint spec  ${spec.preset} 종류, ${spec.register}체${target}. 같은 규칙의 기준값과 ${spec.profile} 글의 평소 수치를 쓰기 전에 보여 준다`,
   ];
   const width = Math.max(...spec.rows.map((row) => row.label.length));
   for (const row of spec.rows) lines.push(`  ${row.label.padEnd(width)}  ${row.guidance}`);
-  lines.push("", "이 사양은 품질 점수가 아니다. 쓴 뒤 같은 설정으로 hanlint <글.md>를 실행해 Finding을 확인한다");
+  lines.push("", "이 스펙은 품질 점수가 아니다. 다 쓴 뒤 같은 설정으로 hanlint <글.md>를 실행해 지적을 확인한다");
   return lines.join("\n");
 }

package/src/rules/code/inputFileSource.js

@@ -42,7 +42,7 @@ export function run(doc) {
         if (!isDataFile(path)) continue;
         const name2 = fileName(path);
         if (have.has(name2) || doc.reader.mentionedBefore(block.index, name2)) continue;
-        findings.push(finding(name, line, code.trim(), `\`${name2}\` 을 읽는데 글 어디에서도 만들지 않았다. 독자는 여기서 파일 없음 오류로 멈춘다`, null, "error", DOCUMENT, block.index));
+        findings.push(finding(name, line, code.trim(), `\`${name2}\` 파일을 읽는데 글 어디에서도 만들지 않았다. 독자는 여기서 파일 없음 오류로 멈춘다`, null, "error", DOCUMENT, block.index));
       }
       for (const path of [...writeTargets(code), ...reads]) {
         if (NOT_A_PATH.some((mark) => path.includes(mark))) continue;

package/src/rules/code/installImport.js

@@ -108,7 +108,7 @@ export function run(doc) {
           const acceptable = packageOf().get(top) ?? new Set([normalize(top)]);
           if (![...acceptable].some((pkg) => packages.has(pkg))) {
             const packageNames = [...acceptable].sort().join("`, `");
-            findings.push(finding(name, line, code.trim(), `\`${top}\` 를 import 하는데 설치 줄에 허용되는 이름 \`${packageNames}\` 가 없다. 독자는 ModuleNotFoundError 에서 멈춘다`, null, "error", DOCUMENT, block.index));
+            findings.push(finding(name, line, code.trim(), `\`${top}\` 모듈을 import하는데 설치 줄에 그 모듈이 든 패키지(\`${packageNames}\`)가 없다. 독자는 ModuleNotFoundError에서 멈춘다`, null, "error", DOCUMENT, block.index));
           }
         }
       }
@@ -120,7 +120,7 @@ export function run(doc) {
         const name2 = normalize(parsed[1]);
         const extra = parsed[2] ? normalize(parsed[2]) : null;
         if (packages.has(name2) && (extra === null || (packages.get(name2)?.has(extra) ?? false))) continue;
-        findings.push(finding(name, line, code.trim(), `이 줄은 \`${requirement}\` 가 있어야 돈다. ${why}. 설치 줄에 없다`, null, NOTICE, DOCUMENT, block.index));
+        findings.push(finding(name, line, code.trim(), `이 줄은 \`${requirement}\` 패키지가 있어야 실행되는데 설치 줄에 없다. ${why}`, null, NOTICE, DOCUMENT, block.index));
       }
     }
   }

package/src/rules/code/platformApi.js

@@ -27,7 +27,7 @@ export function run(doc) {
       for (const [pattern, source, platform, alternative] of platformApis()) {
         pattern.lastIndex = 0;
         if (pattern.test(code)) {
-          findings.push(finding(name, line, code.trim(), `\`${source}\` 은 ${platform} 전용이다. 다른 운영체제 독자는 여기서 멈춘다. ${alternative}`, null, NOTICE, DOCUMENT, block.index));
+          findings.push(finding(name, line, code.trim(), `\`${source}\` 부분은 ${platform} 전용이다. 다른 운영체제의 독자는 여기서 멈춘다. ${alternative}`, null, NOTICE, DOCUMENT, block.index));
           break;
         }
       }

package/src/rules/document/countMismatch.js

@@ -1,4 +1,5 @@
 // @ts-check
+import { fitJosa } from "../../analysis/grammar/josa.js";
 import { DOCUMENT, finding } from "../finding.js";
 
 export const name = "countMismatch";
@@ -50,7 +51,7 @@ export function run(doc, config) {
       const conflict = promises.slice(i + 1).find((p) => p[1] !== numberA && comparable(doc, lineA, p[0], config.countMismatchSpan));
       if (!conflict) continue;
       const [lineB, , textB] = conflict;
-      findings.push(finding(name, lineB, textB, `${lineA}번째 줄은 \`${textA}\` 인데 여기는 \`${textB}\` 다. 같은 단위로 다른 수를 약속하면 독자가 어느 쪽을 믿을지 모른다`, null, "error", DOCUMENT, -1));
+      findings.push(finding(name, lineB, textB, `${lineA}번째 줄은 \`${textA}\`${fitJosa(textA, "이라고")} 했는데 여기서는 \`${textB}\`${fitJosa(textB, "이라고")} 한다. 같은 단위로 다른 수를 약속하면 독자가 어느 쪽을 믿을지 모른다`, null, "error", DOCUMENT, -1));
       break;
     }
   }

package/src/rules/document/enoughOnce.js

@@ -1,4 +1,5 @@
 // @ts-check
+import { fitJosa } from "../../analysis/grammar/josa.js";
 import { matchedTexts } from "../../fingerprint/markers.js";
 import { SENTENCE, finding } from "../finding.js";
 
@@ -20,6 +21,6 @@ export function run(doc, config) {
   if (breaks.length < 2) return [];
   const first = breaks[0][0];
   return breaks.slice(1).map(([sentence, text]) =>
-    finding(name, sentence.line, sentence.text, `\`${text}\` 로 끊는 문장이 ${first.line}행에 이미 있다. 글 전체에 한 번만 쓴다. 계속 끝나는 척하다 이어지는 꼴이 된다`, null, "error", SENTENCE, sentence.index),
+    finding(name, sentence.line, sentence.text, `\`${text}\`${fitJosa(text, "로")} 끊는 문장이 ${first.line}번째 줄에 이미 있다. 글 전체에 한 번만 쓴다. 여러 번 쓰면 끝난다고 해 놓고 글이 계속 이어진다`, null, "error", SENTENCE, sentence.index),
   );
 }

package/src/rules/document/fieldEcho.js

@@ -5,22 +5,26 @@ import { DOCUMENT, NOTICE, finding } from "../finding.js";
 export const name = "fieldEcho";
 export const mechanism = "contrast";
 
+/** 글의 끝으로 보는 절의 수. 결말 뒤에 `더 해 볼 것` 목록이 붙는 경우가 흔하다. 파이썬과 같다. */
+const ENDING_SECTIONS = 2;
+
 /**
  * @param {import("../../fingerprint/build.js").DocumentPrint} doc
- * @param {import("../../fingerprint/build.js").SectionPrint} section
+ * @param {import("../../fingerprint/build.js").SectionPrint[]} sections
  * @param {string[]} fields
  * @param {string} where
  */
-function check(doc, section, fields, where) {
+function check(doc, sections, fields, where) {
   const findings = [];
+  const section = sections[0];
   for (const name_ of fields) {
     const value = doc.frontmatter[name_];
     if (!value) continue;
     const promised = topicsOf(value);
     if (!promised.size) continue;
-    if ([...promised].some((word) => section.topics.has(word))) continue;
+    if ([...promised].some((word) => sections.some((spoken) => spoken.topics.has(word)))) continue;
     findings.push(
-      finding(name, section.startLine, value, `frontmatter 의 \`${name_}\` 가 약속한 말이 ${where}에 하나도 없다. 약속한 것을 ${where}에서 그 말로 답한다`, null, NOTICE, DOCUMENT, section.index),
+      finding(name, section.startLine, value, `frontmatter의 \`${name_}\` 필드가 약속한 말이 ${where}에 하나도 없다. 약속한 것을 ${where}에서 그 말로 답한다`, null, NOTICE, DOCUMENT, section.index),
     );
   }
   return findings;
@@ -32,7 +36,7 @@ function check(doc, section, fields, where) {
  */
 export function run(doc, config) {
   if (!config.introFields.length && !config.endingFields.length) return [];
-  const findings = check(doc, doc.intro, config.introFields, "도입");
-  if (doc.sections.length > 1) findings.push(...check(doc, doc.sections[doc.sections.length - 1], config.endingFields, "마지막 절"));
+  const findings = check(doc, [doc.intro], config.introFields, "도입");
+  if (doc.sections.length > 1) findings.push(...check(doc, doc.sections.slice(-ENDING_SECTIONS), config.endingFields, "글의 끝"));
   return findings;
 }

package/src/rules/document/keywordHeading.js

@@ -27,6 +27,6 @@ export function run(doc, config) {
     .filter((word) => word.length >= MIN_WORD && promised.includes(word) && !joined.includes(word));
   if (!missing.length) return [];
   return [
-    finding(name, headings[0][2], joined, `글이 내건 \`${missing[0]}\` 가 절 제목 어디에도 없다. 목차를 훑는 독자가 이 글이 그것을 다루는지 못 본다`, null, NOTICE, DOCUMENT, -1),
+    finding(name, headings[0][2], joined, `글이 내건 말이 절 제목 어디에도 없다: \`${missing[0]}\`. 목차를 훑는 독자는 이 글이 그것을 다루는지 알 수 없다`, null, NOTICE, DOCUMENT, -1),
   ];
 }

package/src/rules/document/keywordMissing.js

@@ -17,6 +17,6 @@ export function run(doc, config) {
   const head = `${title}\n${first ? first.text : ""}`;
   if (head.includes(keyword)) return [];
   return [
-    finding(name, first ? first.startLine : 1, title || (first ? first.text : ""), `대표 검색어 \`${keyword}\` 가 제목에도 첫 문단에도 없다. 검색해 들어온 독자가 자기가 친 이름을 못 본다`, null, "error", DOCUMENT, -1),
+    finding(name, first ? first.startLine : 1, title || (first ? first.text : ""), `대표 검색어가 제목에도 첫 문단에도 없다: \`${keyword}\`. 검색해 들어온 독자는 자기가 친 이름을 보지 못한다`, null, "error", DOCUMENT, -1),
   ];
 }

package/src/rules/document/noQuestion.js

@@ -9,7 +9,7 @@ export function run(doc, config) {
   if (doc.bodySections.length < 2 || doc.questionCount > 0) return [];
   const first = doc.sentences.length ? doc.sentences[0] : null;
   const why = doc.readerCallCount === 0
-    ? "물음표가 한 번도 없고 독자를 부르는 말도 없다. 질문이나 독자 호출이 필요한 글인지 판단하고 충분하면 유지한다"
-    : "물음표가 한 번도 없다. 질문이 필요한 글인지 판단하고 설명만으로 충분하면 유지한다";
+    ? "물음표가 한 번도 없고 독자에게 말을 거는 문장도 없다. 질문이나 독자에게 말을 거는 문장이 필요한 글인지 판단하고, 설명만으로 충분하면 그대로 둔다"
+    : "물음표가 한 번도 없다. 질문이 필요한 글인지 판단하고, 설명만으로 충분하면 그대로 둔다";
   return [finding(name, first ? first.line : 1, first ? first.text : "", why, null, config.enforceStyle.includes(name) ? "error" : "notice", DOCUMENT, -1)];
 }

package/src/rules/document/promiseRecall.js

@@ -9,6 +9,6 @@ export function run(doc) {
   const reader = doc.reader.final;
   if (!reader.promises.length || reader.recalls.length) return [];
   return reader.promises.map(([line, text]) =>
-    finding(name, line, text, "뒤로 미룬 것을 앞에서 미룬 것으로 다시 부르는 자리가 글 어디에도 없다. 회수하거나 미루지 않는다", null, NOTICE, DOCUMENT, -1),
+    finding(name, line, text, "뒤로 미룬 이야기를 `앞에서 미룬 X`처럼 다시 언급하는 문장이 글 어디에도 없다. 뒤에서 다루거나 처음부터 미루지 않는다", null, NOTICE, DOCUMENT, -1),
   );
 }

package/src/rules/document/tableOddCell.js

@@ -53,7 +53,7 @@ export function run(doc, config) {
       const unit = [...kinds][0];
       const [offset, cell] = odd[0];
       findings.push(
-        finding(name, block.startLine + offset, cell, `이 열의 나머지 ${values.length - 1}칸은 \`${unit}\` 으로 잰 값 하나인데 이 칸만 다르다. 같은 잣대로 다시 재거나 그 줄을 본문 문장으로 옮긴다`, null, NOTICE, DOCUMENT, block.index),
+        finding(name, block.startLine + offset, cell, `이 열의 다른 ${values.length - 1}칸은 모두 \`${unit}\` 단위인데 이 칸만 다르다. 같은 단위로 다시 재거나 그 줄을 본문 문장으로 옮긴다`, null, NOTICE, DOCUMENT, block.index),
       );
     }
   }