hanlint 0.0.17 → 0.0.19

package/src/cli/walk.js

@@ -1,7 +1,7 @@
 // @ts-check
 /**
  * 폴더에서 검사할 마크다운을 찾는 규칙. 첫 화면과 검사가 **같은 함수**를 쓴다.
- * 무엇을 건너뛰고 왜 그러는지는 파이썬 `cli/commands/shared.py` 의 SKIPPED_FOLDERS 가 소유한다.
+ * 무엇을 건너뛰고 왜 그러는지는 파이썬 `cli/commands/shared.py`의 SKIPPED_FOLDERS가 소유한다.
  */
 import { readdirSync, statSync } from "node:fs";
 import { join } from "node:path";
@@ -16,7 +16,7 @@ export function isSkipped(name) {
   return name.startsWith(".") || SKIPPED_FOLDERS.includes(name);
 }
 
-/** 폴더 아래 마크다운. 건너뛸 폴더에는 안 들어간다. 경로 문자열 순이라 두 판이 같은 차례를 낸다. @param {string} folder */
+/** 폴더 아래 마크다운. 건너뛸 폴더에는 안 들어간다. 경로 문자열 순이라 두 구현이 같은 차례를 낸다. @param {string} folder */
 export function markdownUnder(folder) {
   /** @type {string[]} */
   const found = [];

package/src/cli/welcome.js

@@ -1,7 +1,7 @@
 // @ts-check
 /**
- * `hanlint` 를 인자 없이 쳤을 때의 첫 화면. 파이썬 cli/welcome.py 와 같은 글자다.
- * 같은 폴더에서 두 판을 돌리면 결과가 같다. 파일을 찾는 것은 검사와 같은 함수 (walk.markdownUnder) 다.
+ * `hanlint`를 인자 없이 쳤을 때의 첫 화면. 파이썬 cli/welcome.py와 같은 글자다.
+ * 같은 폴더에서 두 구현을 돌리면 결과가 같다. 파일을 찾는 것은 검사와 같은 함수 (walk.markdownUnder)다.
  */
 import { relative, sep } from "node:path";
 
@@ -27,24 +27,24 @@ export function welcome(version, folder) {
   const nearby = nearbyMarkdown(where);
   const example = nearby.length ? nearby[0] : "글.md";
   const shown = [
-    [`hanlint ${example}`, "검사한다. 자리와 이유와 고칠 말이 나온다"],
-    [`hanlint fix ${example}`, "기계가 확실히 고칠 수 있는 자리를 원문에 적용한다"],
+    [`hanlint ${example}`, "검사한다. 걸린 곳과 까닭과 고칠 말이 나온다"],
+    [`hanlint fix ${example}`, "기계가 확실히 고칠 수 있는 곳을 원문에 고친다"],
     [`hanlint audit ${example}`, "글의 모양을 지도와 분포로 본다"],
   ];
   const width = Math.max(...shown.map(([command]) => command.length));
   const lines = [
-    `hanlint ${version}  한국어 글에서 세면 확정되는 결함을 집는다. 좋은 글인지는 판정하지 않는다`,
+    `hanlint ${version}  한국어 글에서 규칙으로 잡을 수 있는 잘못을 찾는다. 좋은 글인지는 판정하지 않는다`,
     "",
     ...shown.map(([command, why]) => `  ${command.padEnd(width)}  ${why}`),
   ];
   if (nearby.length) {
-    lines.push("", `이 폴더의 마크다운: ${nearby.join(", ")}. 폴더를 통째로 줘도 된다 (hanlint .)`);
+    lines.push("", `이 폴더의 마크다운: ${nearby.join(", ")}. 폴더를 통째로 줘도 된다(hanlint .)`);
   } else {
-    lines.push("", "이 폴더에는 검사할 마크다운이 없다. 파일 하나나 폴더 하나를 인자로 준다");
+    lines.push("", "이 폴더에는 검사할 마크다운이 없다. 파일이나 폴더 하나를 인자로 준다");
   }
   lines.push(
     "",
-    "처음이면 hanlint init 으로 설정을 만든다. 글의 종류가 블로그가 아니면 --preset report 나 --preset docs",
+    "처음이면 hanlint init으로 설정 파일을 만든다. 블로그 글이 아니면 --preset report나 --preset docs를 붙인다",
     "규칙 목록은 hanlint rules, 규칙 하나가 왜 있는지는 hanlint explain <규칙>, 지금 상태는 hanlint doctor",
     "전체 사용법은 hanlint --help",
   );

package/src/config/loadConfig.js

@@ -1,5 +1,5 @@
 // @ts-check
-/** 설정 파일을 찾아 읽는다. `hanlint.toml` 이거나 `pyproject.toml` 의 `[tool.hanlint]` 다. 파이썬과 같은 탐색이다. */
+/** 설정 파일을 찾아 읽는다. `hanlint.toml` 이거나 `pyproject.toml`의 `[tool.hanlint]`다. 파이썬과 같은 탐색이다. */
 import { existsSync, readFileSync } from "node:fs";
 import { basename, dirname, join, resolve } from "node:path";
 
@@ -21,7 +21,7 @@ export function readConfigFile(path) {
   return config;
 }
 
-/** start 에서 위로 올라가며 hanlint.toml 이나 [tool.hanlint] 를 가진 pyproject.toml 을 찾는다. @param {string} start */
+/** start에서 위로 올라가며 hanlint.toml이나 [tool.hanlint]를 가진 pyproject.toml을 찾는다. @param {string} start */
 export function findConfigFile(start) {
   let folder = resolve(start);
   while (true) {
@@ -40,7 +40,7 @@ export function findConfigFile(start) {
 }
 
 /**
- * `path` 를 주면 그 파일만 읽는다. 안 주면 `start` (기본 현재 폴더) 에서 찾고, 없으면 기본값이다.
+ * `path`를 주면 그 파일만 읽는다. 안 주면 `start` (기본 현재 폴더)에서 찾고, 없으면 기본값이다.
  * @param {string | null} [path]
  * @param {string | null} [start]
  */

package/src/config/patch.js

@@ -5,9 +5,9 @@ import { sha256 } from "../digest.js";
 /** @param {unknown} value @param {string} where */
 function checkedString(value, where) {
   if (typeof value !== "string" || !value || value !== value.trim()) {
-    throw new Error(`${where} 는 양끝 공백 없는 문자열이다`);
+    throw new Error(`${where}: 양끝 공백 없는 문자열이어야 한다`);
   }
-  if (value !== value.normalize("NFC")) throw new Error(`${where} 는 NFC 문자열이어야 한다`);
+  if (value !== value.normalize("NFC")) throw new Error(`${where}: NFC 문자열이어야 한다`);
   return value;
 }
 
@@ -17,19 +17,19 @@ export class Patch {
     this.reason = checkedString(reason, "reason");
     this.before = checkedString(before, "before");
     this.after = checkedString(after, "after");
-    if (this.before === this.after) throw new Error("patch before 와 after 는 달라야 한다");
+    if (this.before === this.after) throw new Error("patch before와 after는 달라야 한다");
     Object.freeze(this);
   }
 
   /** @param {unknown} raw */
   static fromMapping(raw) {
-    if (!raw || typeof raw !== "object" || Array.isArray(raw)) throw new Error("patch 는 JSON 객체다");
+    if (!raw || typeof raw !== "object" || Array.isArray(raw)) throw new Error("patch는 JSON 객체여야 한다");
     const data = /** @type {Record<string, unknown>} */ (raw);
     const expected = ["reason", "before", "after"];
     const unknown = Object.keys(data).filter((key) => !expected.includes(key)).sort();
     const missing = expected.filter((key) => !(key in data)).sort();
-    if (unknown.length) throw new Error(`patch 의 모르는 키: ${unknown.join(", ")}`);
-    if (missing.length) throw new Error(`patch 의 빠진 키: ${missing.join(", ")}`);
+    if (unknown.length) throw new Error(`patch의 모르는 키: ${unknown.join(", ")}`);
+    if (missing.length) throw new Error(`patch의 빠진 키: ${missing.join(", ")}`);
     return new Patch(
       /** @type {string} */ (data.reason),
       /** @type {string} */ (data.before),

package/src/config/readerContract.js

@@ -9,19 +9,19 @@ export const CONTRACT_VERSIONS = Object.freeze([CONTRACT_VERSION, LATEST_CONTRAC
 /** @param {unknown} value @param {string} where */
 function checkedString(value, where) {
   if (typeof value !== "string" || !value || value !== value.trim()) {
-    throw new Error(`${where} 는 양끝 공백 없는 문자열이다`);
+    throw new Error(`${where}: 양끝 공백 없는 문자열이어야 한다`);
   }
-  if (value !== value.normalize("NFC")) throw new Error(`${where} 는 NFC 문자열이어야 한다`);
+  if (value !== value.normalize("NFC")) throw new Error(`${where}: NFC 문자열이어야 한다`);
   return value;
 }
 
 /** @param {unknown} value @param {string} where @param {boolean} [allowEmpty] */
 function checkedStrings(value, where, allowEmpty = false) {
   if (!Array.isArray(value) || (!allowEmpty && !value.length)) {
-    throw new Error(`${where} 는 ${allowEmpty ? "문자열 배열" : "비지 않은 문자열 배열"}이다`);
+    throw new Error(`${where}: ${allowEmpty ? "문자열 배열" : "비지 않은 문자열 배열"}이어야 한다`);
   }
   const found = value.map((item, index) => checkedString(item, `${where} ${index + 1}번째`));
-  if (new Set(found).size !== found.length) throw new Error(`${where} 에 같은 값이 두 번 있다`);
+  if (new Set(found).size !== found.length) throw new Error(`${where}에 같은 값이 두 번 있다`);
   return found;
 }
 
@@ -45,7 +45,7 @@ export class Contract {
   /** @param {string} reader @param {string} goal @param {string[]} facts @param {number} [version] */
   constructor(reader, goal, facts, version = CONTRACT_VERSION) {
     if (!Number.isInteger(version) || version !== CONTRACT_VERSION) {
-      throw new Error(`reader contract version 은 ${CONTRACT_VERSION}이다: ${version}`);
+      throw new Error(`reader contract version이 맞지 않다: ${version} (맞는 값: ${CONTRACT_VERSION})`);
     }
     this.reader = checkedString(reader, "reader");
     this.goal = checkedString(goal, "goal");
@@ -56,13 +56,13 @@ export class Contract {
 
   /** @param {unknown} raw */
   static fromMapping(raw) {
-    if (!raw || typeof raw !== "object" || Array.isArray(raw)) throw new Error("reader contract 는 JSON 객체다");
+    if (!raw || typeof raw !== "object" || Array.isArray(raw)) throw new Error("reader contract는 JSON 객체여야 한다");
     const data = /** @type {Record<string, unknown>} */ (raw);
     const expected = ["version", "reader", "goal", "facts"];
     const unknown = Object.keys(data).filter((key) => !expected.includes(key)).sort();
     const missing = expected.filter((key) => !(key in data)).sort();
-    if (unknown.length) throw new Error(`reader contract 의 모르는 키: ${unknown.join(", ")}`);
-    if (missing.length) throw new Error(`reader contract 의 빠진 키: ${missing.join(", ")}`);
+    if (unknown.length) throw new Error(`reader contract의 모르는 키: ${unknown.join(", ")}`);
+    if (missing.length) throw new Error(`reader contract의 빠진 키: ${missing.join(", ")}`);
     return new Contract(
       /** @type {string} */ (data.reader),
       /** @type {string} */ (data.goal),
@@ -96,13 +96,13 @@ export class ProtectedSurface {
 
   /** @param {unknown} raw */
   static fromMapping(raw) {
-    if (!raw || typeof raw !== "object" || Array.isArray(raw)) throw new Error("surface 는 JSON 객체다");
+    if (!raw || typeof raw !== "object" || Array.isArray(raw)) throw new Error("surface는 JSON 객체여야 한다");
     const data = /** @type {Record<string, unknown>} */ (raw);
     const expected = ["numbers", "urls", "code", "links"];
     const unknown = Object.keys(data).filter((key) => !expected.includes(key)).sort();
     const missing = expected.filter((key) => !(key in data)).sort();
-    if (unknown.length) throw new Error(`surface 의 모르는 키: ${unknown.join(", ")}`);
-    if (missing.length) throw new Error(`surface 의 빠진 키: ${missing.join(", ")}`);
+    if (unknown.length) throw new Error(`surface의 모르는 키: ${unknown.join(", ")}`);
+    if (missing.length) throw new Error(`surface의 빠진 키: ${missing.join(", ")}`);
     return new ProtectedSurface(
       /** @type {string[]} */ (data.numbers),
       /** @type {string[]} */ (data.urls),
@@ -128,7 +128,7 @@ export class ProtectedSurface {
 export class Outline {
   /** @param {number} level @param {string[]} headings */
   constructor(level, headings) {
-    if (!Number.isInteger(level) || level < 1 || level > 6) throw new Error(`outline.level 은 1~6 정수다: ${level}`);
+    if (!Number.isInteger(level) || level < 1 || level > 6) throw new Error(`outline.level은 1~6 정수여야 한다. 받은 값: ${level}`);
     this.level = level;
     this.headings = Object.freeze(checkedStrings(headings, "outline.headings"));
     Object.freeze(this);
@@ -136,13 +136,13 @@ export class Outline {
 
   /** @param {unknown} raw */
   static fromMapping(raw) {
-    if (!raw || typeof raw !== "object" || Array.isArray(raw)) throw new Error("outline 은 JSON 객체다");
+    if (!raw || typeof raw !== "object" || Array.isArray(raw)) throw new Error("outline은 JSON 객체여야 한다");
     const data = /** @type {Record<string, unknown>} */ (raw);
     const expected = ["level", "headings"];
     const unknown = Object.keys(data).filter((key) => !expected.includes(key)).sort();
     const missing = expected.filter((key) => !(key in data)).sort();
-    if (unknown.length) throw new Error(`outline 의 모르는 키: ${unknown.join(", ")}`);
-    if (missing.length) throw new Error(`outline 의 빠진 키: ${missing.join(", ")}`);
+    if (unknown.length) throw new Error(`outline의 모르는 키: ${unknown.join(", ")}`);
+    if (missing.length) throw new Error(`outline의 빠진 키: ${missing.join(", ")}`);
     return new Outline(/** @type {number} */ (data.level), /** @type {string[]} */ (data.headings));
   }
 
@@ -155,7 +155,7 @@ export class ContractV2 {
   /** @param {string} reader @param {string} goal @param {string[]} facts @param {ProtectedSurface | Record<string, unknown>} surface @param {Outline | Record<string, unknown>} outline @param {number} [version] */
   constructor(reader, goal, facts, surface, outline, version = LATEST_CONTRACT_VERSION, lockedFacts = [], editPolicy = {}) {
     if (!Number.isInteger(version) || version !== LATEST_CONTRACT_VERSION) {
-      throw new Error(`reader contract version 은 ${LATEST_CONTRACT_VERSION}다: ${version}`);
+      throw new Error(`reader contract version이 맞지 않다: ${version} (맞는 값: ${LATEST_CONTRACT_VERSION})`);
     }
     this.reader = checkedString(reader, "reader");
     this.goal = checkedString(goal, "goal");
@@ -163,14 +163,14 @@ export class ContractV2 {
     this.surface = surface instanceof ProtectedSurface ? surface : ProtectedSurface.fromMapping(surface);
     this.outline = outline instanceof Outline ? outline : Outline.fromMapping(outline);
     this.lockedFacts = Object.freeze(checkedStrings(lockedFacts, "lockedFacts", true));
-    if (this.lockedFacts.some((fact) => !this.facts.includes(fact))) throw new Error("lockedFacts must select approved facts");
-    if (!editPolicy || typeof editPolicy !== "object" || Array.isArray(editPolicy)) throw new Error("editPolicy must be an object");
+    if (this.lockedFacts.some((fact) => !this.facts.includes(fact))) throw new Error("lockedFacts는 승인한 facts 가운데서 골라야 한다");
+    if (!editPolicy || typeof editPolicy !== "object" || Array.isArray(editPolicy)) throw new Error("editPolicy는 객체여야 한다");
     this.editPolicy = Object.freeze(Object.fromEntries(Object.entries(editPolicy).sort(([a], [b]) => compareText(a, b)).map(([rule, limits]) => {
-      if (!rule || rule !== rule.trim()) throw new Error("editPolicy requires rule names");
+      if (!rule || rule !== rule.trim()) throw new Error("editPolicy에는 규칙 이름이 있어야 한다");
       if (!limits || typeof limits !== "object" || Array.isArray(limits) || Object.keys(limits).sort().join(",") !== "maxChars,maxLines") {
-        throw new Error("editPolicy requires maxChars and maxLines");
+        throw new Error("editPolicy의 규칙마다 maxChars와 maxLines가 있어야 한다");
       }
-      if (Object.values(limits).some((n) => !Number.isInteger(n) || n < 1)) throw new Error("editPolicy limits must be positive integers");
+      if (Object.values(limits).some((n) => !Number.isInteger(n) || n < 1)) throw new Error("editPolicy의 한도는 양의 정수여야 한다");
       return [rule, Object.freeze({maxChars: limits.maxChars, maxLines: limits.maxLines})];
     })));
     this.version = version;
@@ -179,13 +179,13 @@ export class ContractV2 {
 
   /** @param {unknown} raw */
   static fromMapping(raw) {
-    if (!raw || typeof raw !== "object" || Array.isArray(raw)) throw new Error("reader contract 는 JSON 객체다");
+    if (!raw || typeof raw !== "object" || Array.isArray(raw)) throw new Error("reader contract는 JSON 객체여야 한다");
     const data = /** @type {Record<string, unknown>} */ (raw);
     const expected = ["version", "reader", "goal", "facts", "surface", "outline"];
     const unknown = Object.keys(data).filter((key) => !expected.includes(key) && !["lockedFacts", "editPolicy"].includes(key)).sort();
     const missing = expected.filter((key) => !(key in data)).sort();
-    if (unknown.length) throw new Error(`reader contract 의 모르는 키: ${unknown.join(", ")}`);
-    if (missing.length) throw new Error(`reader contract 의 빠진 키: ${missing.join(", ")}`);
+    if (unknown.length) throw new Error(`reader contract의 모르는 키: ${unknown.join(", ")}`);
+    if (missing.length) throw new Error(`reader contract의 빠진 키: ${missing.join(", ")}`);
     return new ContractV2(
       /** @type {string} */ (data.reader),
       /** @type {string} */ (data.goal),
@@ -237,9 +237,9 @@ export class ContractV2 {
 
 /** @param {unknown} raw */
 export function parseContract(raw) {
-  if (!raw || typeof raw !== "object" || Array.isArray(raw)) throw new Error("reader contract 는 JSON 객체다");
+  if (!raw || typeof raw !== "object" || Array.isArray(raw)) throw new Error("reader contract는 JSON 객체여야 한다");
   const version = /** @type {Record<string, unknown>} */ (raw).version;
   if (version === CONTRACT_VERSION) return Contract.fromMapping(raw);
   if (version === LATEST_CONTRACT_VERSION) return ContractV2.fromMapping(raw);
-  throw new Error(`reader contract version 은 ${CONTRACT_VERSIONS.join(",")} 가운데 하나다: ${version}`);
+  throw new Error(`reader contract version이 맞지 않다: ${version} (맞는 값: ${CONTRACT_VERSIONS.join(",")} 가운데 하나)`);
 }

package/src/config/settings.js

@@ -1,7 +1,7 @@
 // @ts-check
 /**
- * 설정과 임계 기본값. 정본은 파이썬 config/settings.py 이고 여기는 같은 값을 든다. 필드 이름이 곧 설정 파일의 키다.
- * 기본값을 바꾸면 양쪽을 같은 작업에서 바꾼다. tests/parity 가 두 구현의 결과를 견준다.
+ * 설정과 임계 기본값. 정본은 파이썬 config/settings.py이고 여기는 같은 값을 든다. 필드 이름이 곧 설정 파일의 키다.
+ * 기본값을 바꾸면 양쪽을 같은 작업에서 바꾼다. tests/parity가 두 구현의 결과를 견준다.
  */
 
 import { projectExemplars } from "../data/exemplars.js";
@@ -9,15 +9,16 @@ import { projectOperations } from "../data/operations.js";
 import { projectPatches } from "../data/patches.js";
 
 /**
- * 글의 종류마다 처음부터 끄고 시작할 규칙. 정본은 파이썬 config/settings.py 의 PRESETS 다.
+ * 글의 종류마다 처음부터 끄고 시작할 규칙. 정본은 파이썬 config/settings.py의 PRESETS다.
  * @type {Record<string, string[]>}
  */
-// 화면의 글에서만 켜는 것. 산문의 모든 종류가 처음부터 끈다. 파이썬 settings.py 의 SCREEN 과 같다.
+// 화면의 글에서만 켜는 것. 산문의 모든 종류가 처음부터 끈다. 파이썬 settings.py의 SCREEN과 같다.
 const SCREEN = ["screenNarration", "screenSentence", "screenTone", "screenWord"];
 export const PRESETS = {
   blog: [...SCREEN],
-  report: ["noQuestion", "firstResultDistance", "introImage", "moreLater", "numberOrphan", ...SCREEN],
+  report: ["noQuestion", "firstResultDistance", "introImage", "moreLater", "numberOrphan", "imperativePeriod", ...SCREEN],
   docs: [
+    "imperativePeriod",
     "noQuestion",
     "firstResultDistance",
     "introImage",
@@ -30,18 +31,18 @@ export const PRESETS = {
     ...SCREEN,
   ],
 };
-// 서사 글에서만 끄는 것. 설명글의 전제 (독자가 문장 사이 이유를 따라간다, 말끝을 맺는다) 가 장면과
-// 대사에는 성립하지 않는다. 파이썬 settings.py 의 NARRATIVE 와 같다.
-// 참고 문서와 자습서는 명령 전후 상태와 완결된 예제를 보이려 같은 블록을 다시 둔다. 파이썬의 REFERENCE 와 같다.
+// 서사 글에서만 끄는 것. 설명글의 전제 (독자가 문장 사이 이유를 따라간다, 말끝을 맺는다)가 장면과
+// 대사에는 성립하지 않는다. 파이썬 settings.py의 NARRATIVE와 같다.
+// 참고 문서와 자습서는 명령 전후 상태와 완결된 예제를 보이려 같은 블록을 다시 둔다. 파이썬의 REFERENCE와 같다.
 const REFERENCE = ["duplicateBlock", "headingUniform"];
-// 백과 표제어는 첫 절 앞의 머리말이 길게 정의와 요약을 담는 것이 관례다. 파이썬의 ENCYCLOPEDIC 과 같다.
+// 백과 표제어는 첫 절 앞의 머리말이 길게 정의와 요약을 담는 것이 관례다. 파이썬의 ENCYCLOPEDIC과 같다.
 const ENCYCLOPEDIC = ["introLong"];
 const NARRATIVE = ["factListParagraph"];
 PRESETS.guide = [...PRESETS.blog, ...REFERENCE];
 PRESETS.essay = [...PRESETS.report, ...NARRATIVE];
 PRESETS.fiction = [...PRESETS.report, ...NARRATIVE];
 PRESETS.encyclopedia = [...PRESETS.docs, ...ENCYCLOPEDIC];
-// 대화 답변에서 끄는 것. 글의 짜임을 재는 규칙은 글 한 편을 전제한다. 파이썬 settings.py 의 CONVERSATION 과 같다.
+// 대화 답변에서 끄는 것. 글의 짜임을 재는 규칙은 글 한 편을 전제한다. 파이썬 settings.py의 CONVERSATION과 같다.
 const CONVERSATION = [
   "countMismatch",
   "duplicateBlock",
@@ -50,6 +51,7 @@ const CONVERSATION = [
   "headingSentence",
   "headingSkip",
   "headingUniform",
+  "imperativePeriod",
   "inputFileSource",
   "installImport",
   "introLong",
@@ -62,10 +64,11 @@ const CONVERSATION = [
   "sectionNoProse",
 ];
 PRESETS.chat = [...CONVERSATION, ...SCREEN];
-// 화면의 글에서 끄는 것. 문장과 문단과 글의 짜임을 재는 규칙은 화면의 글 한 마디에 전제가 없다. 파이썬 settings.py 의 SCREEN_OFF 와 같다.
+// 화면의 글에서 끄는 것. 문장과 문단과 글의 짜임을 재는 규칙은 화면의 글 한 마디에 전제가 없다. 파이썬 settings.py의 SCREEN_OFF와 같다.
 const SCREEN_OFF = [
   "cliche",
   "connectorRepeat",
+  "phraseRepeat",
   "danglingDeixis",
   "deixis",
   "doubleNegative",
@@ -107,10 +110,10 @@ const SCREEN_OFF = [
   "platformApi",
 ];
 PRESETS.screen = SCREEN_OFF;
-/** enforceStyle 에 넣을 수 있는 규칙. 파이썬 settings.py 의 ENFORCEABLE 과 같다. */
-export const ENFORCEABLE = ["noQuestion", "nounPile", "screenNarration", "screenTone", "screenWord"];
+/** enforceStyle에 넣을 수 있는 규칙. 파이썬 settings.py의 ENFORCEABLE과 같다. */
+export const ENFORCEABLE = ["imperativePeriod", "noQuestion", "nounPile", "screenNarration", "screenTone", "screenWord"];
 
-/** 프리셋 → 견줄 프로파일의 종류. 정본은 파이썬 config/settings.py 의 PROFILE_OF 다. @type {Record<string, string>} */
+/** 프리셋 → 견줄 프로파일의 종류. 정본은 파이썬 config/settings.py의 PROFILE_OF다. @type {Record<string, string>} */
 export const PROFILE_OF = {
   blog: "blog",
   report: "report",
@@ -123,35 +126,43 @@ export const PROFILE_OF = {
   screen: null,
 };
 
+/** 프리셋 → 용례 빈도표의 종류. 정본은 파이썬 config/settings.py의 USAGE_OF다. @type {Record<string, string>} */
+export const USAGE_OF = { report: "report" };
+/** 실린 빈도표의 종류. */
+export const USAGE_KINDS = [...new Set(Object.values(USAGE_OF))].sort();
+
 export const PRESET_NAMES = Object.keys(PRESETS);
 /** 설정도 옵션도 없을 때의 종류. 이 이름일 때는 출력에 프리셋을 적지 않는다. */
 export const DEFAULT_PRESET = PRESET_NAMES[0];
 
 /**
  * @typedef {object} Config
- * @property {string} preset 글의 종류. PRESETS 가 정한 규칙을 처음부터 끈다
+ * @property {string} preset 글의 종류. PRESETS가 정한 규칙을 처음부터 끈다
  * @property {string[]} enforceStyle
  * @property {Set<string>} disable 끌 규칙 이름
  * @property {string | null} keywordField
  * @property {string[]} introFields
  * @property {string[]} endingFields
  * @property {string | null} profile 사용자 프로파일 파일 경로
- * @property {number} profilePercentile outsideProfile 이 짚는 백분위
+ * @property {number} profilePercentile outsideProfile이 짚는 백분위
  * @property {number} countMismatchSpan 절이 없는 글이 이 줄 수 안일 때만 글 전체를 견준다
  * @property {string | null} baseline
  * @property {Record<string, unknown[]>} dictionary
- * @property {import("../data/exemplars.js").Exemplar[]} exemplars 사람이 승인한 프로젝트 본보기
+ * @property {import("../data/exemplars.js").Exemplar[]} exemplars 사람이 승인한 프로젝트 예시
  * @property {import("../data/patches.js").Patch[]} patches 사람이 승인한 국소 고침
  * @property {import("../data/operations.js").SurfaceOperation[]} operations 사람이 승인한 표면 치환
  * @property {string[]} protectedTerms 표면 치환이 바꾸면 안 되는 한국어 고유명사와 프로젝트 용어
  * @property {string[]} ignoreFences 지문에서 뺄 펜스의 언어 표기. 장면 계약과 도표 원문은 코드 블록이 아니다
- * @property {string | null} source 설정을 읽은 파일. 기본값이면 null. loadConfig 가 채운다
+ * @property {string | null} source 설정을 읽은 파일. 기본값이면 null. loadConfig가 채운다
  * @property {number} fragmentRun
  * @property {number} introMaxParagraphs
  * @property {number} headingUniformRatio
  * @property {number} headingSentenceMaxLevel
  * @property {number} bridgeRepeatMin
  * @property {number} nounPileMin
+ * @property {string | null} usageKind 용례 빈도표의 종류. null이면 프리셋이 정하고 ""면 보지 않는다
+ * @property {number} usageMin 명사 연쇄가 몇 편의 문서에 나와야 용례로 보는가
+ * @property {number} usageShare 사전 항목이 그 종류의 문서 몇 할에 나오면 관용으로 보는가
  * @property {number} endingRun
  * @property {number} factListMinSentences
  * @property {number} factListMaxMeanLength
@@ -191,6 +202,9 @@ export function defaultConfig() {
     headingSentenceMaxLevel: 6,
     bridgeRepeatMin: 3,
     nounPileMin: 5,
+    usageKind: null,
+    usageMin: 3,
+    usageShare: 0.9,
     endingRun: 4,
     factListMinSentences: 3,
     factListMaxMeanLength: 8.0,
@@ -211,7 +225,7 @@ export function enabled(config, ruleName) {
   return !config.disable.has(ruleName) && (!PRESETS[config.preset].includes(ruleName) || config.enforceStyle.includes(ruleName));
 }
 
-/** 지금 꺼져 있는 규칙 이름. 프리셋이 끈 것과 disable 이 끈 것을 합친다. @param {Config} config */
+/** 지금 꺼져 있는 규칙 이름. 프리셋이 끈 것과 disable이 끈 것을 합친다. @param {Config} config */
 export function offRules(config) {
   return [...new Set([...PRESETS[config.preset].filter((name) => !config.enforceStyle.includes(name)), ...config.disable])].sort();
 }
@@ -223,18 +237,23 @@ export function configFromMapping(data) {
     if (key === "disable") {
       config.disable = new Set(/** @type {string[]} */ (value));
     } else if (key === "analyzer") {
-      // 0.0.7 까지의 키. hanlint init 이 surface 를 써 넣었으므로 그 값은 조용히 넘기고 다른 값은 빠졌다고 알린다.
-      if (value !== "surface") throw new Error(`analyzer 설정은 빠졌다. 분석기는 표층 하나라 키를 지운다: ${JSON.stringify(value)}`);
+      // 0.0.7 까지의 키. hanlint init이 surface를 써 넣었으므로 그 값은 조용히 넘기고 다른 값은 빠졌다고 알린다.
+      if (value !== "surface") throw new Error(`analyzer 설정은 이제 쓰지 않는다. 설정 파일에서 이 키를 지운다. 받은 값: ${JSON.stringify(value)}`);
     } else if (key === "preset") {
       if (!(/** @type {string} */ (value) in PRESETS)) {
-        throw new Error(`preset 은 ${PRESET_NAMES.join(", ")} 가운데 하나다: ${JSON.stringify(value)}`);
+        throw new Error(`preset은 ${PRESET_NAMES.join(", ")} 가운데 하나여야 한다. 받은 값: ${JSON.stringify(value)}`);
       }
       config.preset = /** @type {string} */ (value);
     } else if (key === "enforceStyle") {
       if (!Array.isArray(value) || value.some((name) => !ENFORCEABLE.includes(name))) {
-        throw new Error(`enforceStyle 은 ${ENFORCEABLE.join(", ")}의 배열이다`);
+        throw new Error(`enforceStyle은 다음 규칙 이름의 배열이어야 한다: ${ENFORCEABLE.join(", ")}`);
       }
       config.enforceStyle = [...value];
+    } else if (key === "usageKind") {
+      if (value !== null && value !== "" && !USAGE_KINDS.includes(/** @type {string} */ (value))) {
+        throw new Error(`usageKind는 ${USAGE_KINDS.join(", ")} 가운데 하나이거나 빈 문자열이어야 한다. 받은 값: ${JSON.stringify(value)}`);
+      }
+      config.usageKind = /** @type {string | null} */ (value);
     } else if (key === "dictionary") {
       config.dictionary = { .../** @type {Record<string, unknown[]>} */ (value) };
     } else if (key === "exemplars") {
@@ -245,14 +264,14 @@ export function configFromMapping(data) {
       config.operations = projectOperations(value, PRESET_NAMES);
     } else if (key === "ignoreFences" || key === "introFields" || key === "endingFields" || key === "protectedTerms") {
       if (!Array.isArray(value) || !value.every((item) => typeof item === "string" && item.trim())) {
-        throw new Error(`${key} 는 문자열 배열이다: ${JSON.stringify(value)}`);
+        throw new Error(`${key}: 문자열 배열이어야 한다. 받은 값: ${JSON.stringify(value)}`);
       }
       const names = value.map((item) => item.trim());
       config[key] = key === "ignoreFences" ? names.map((name) => name.toLowerCase()) : names;
     } else if (key !== "source" && key in config) {
       config[key] = value;
     } else {
-      throw new Error(`모르는 설정 키: ${key}. hanlint init 이 만드는 파일의 키만 쓴다`);
+      throw new Error(`모르는 설정 키: ${key}. hanlint init이 만드는 파일의 키만 쓴다`);
     }
   }
   return config;

package/src/config/toml.js

@@ -1,8 +1,8 @@
 // @ts-check
 /**
- * hanlint 설정에 쓰이는 TOML 부분집합을 읽는다. 의존성 0 을 지키려고 직접 쓴다.
+ * hanlint 설정에 쓰이는 TOML 부분집합을 읽는다. 의존성 0을 지키려고 직접 쓴다.
  *
- * 되는 것: 주석, `key = 값`, 점 키, `[table]`, `[[array]]`, 문자열 ("..." 와 '...'), 정수, 실수, 불리언,
+ * 되는 것: 주석, `key = 값`, 점 키, `[table]`, `[[array]]`, 문자열 ("..."와 '...'), 정수, 실수, 불리언,
  * 여러 줄 배열, 인라인 테이블. 안 되는 것: 여러 줄 문자열, 날짜. 만나면 어디서 막혔는지 말하고 던진다.
  */
 
@@ -28,7 +28,7 @@ class Parser {
   /** @param {string} message */
   error(message) {
     const line = this.text.slice(0, this.pos).split("\n").length;
-    return new Error(`TOML ${line}번째 줄: ${message}. hanlint 가 읽는 TOML 부분집합이 아니다`);
+    return new Error(`TOML ${line}번째 줄: ${message}. hanlint가 읽는 TOML 부분집합이 아니다`);
   }
 
   document() {
@@ -102,7 +102,7 @@ class Parser {
       const next = node[part];
       if (Array.isArray(next)) node = /** @type {Record<string, unknown>} */ (next[next.length - 1]);
       else if (typeof next === "object" && next !== null) node = /** @type {Record<string, unknown>} */ (next);
-      else throw this.error(`${part} 는 테이블이 아니다`);
+      else throw this.error(`테이블이 아니다: ${part}`);
     }
     return node;
   }
@@ -110,7 +110,7 @@ class Parser {
   table() {
     this.pos++;
     const parts = this.keyPath();
-    if (this.text[this.pos] !== "]") throw this.error("] 가 없다");
+    if (this.text[this.pos] !== "]") throw this.error("]가 없다");
     this.pos++;
     this.current = this.descend(this.root, parts);
   }
@@ -118,13 +118,13 @@ class Parser {
   arrayTable() {
     this.pos += 2;
     const parts = this.keyPath();
-    if (!this.text.startsWith("]]", this.pos)) throw this.error("]] 가 없다");
+    if (!this.text.startsWith("]]", this.pos)) throw this.error("]]가 없다");
     this.pos += 2;
     const parent = this.descend(this.root, parts.slice(0, -1));
     const name = parts[parts.length - 1];
     if (!(name in parent)) parent[name] = [];
     const list = parent[name];
-    if (!Array.isArray(list)) throw this.error(`${name} 은 배열이 아니다`);
+    if (!Array.isArray(list)) throw this.error(`배열이 아니다: ${name}`);
     /** @type {Record<string, unknown>} */
     const entry = {};
     list.push(entry);
@@ -209,7 +209,7 @@ class Parser {
       items.push(this.value());
       this.skipBlank();
       if (this.text[this.pos] === ",") this.pos++;
-      else if (this.text[this.pos] !== "]") throw this.error("배열에 , 나 ] 가 없다");
+      else if (this.text[this.pos] !== "]") throw this.error("배열에 쉼표나 ]가 없다");
     }
   }
 
@@ -233,7 +233,7 @@ class Parser {
         this.pos++;
         return table;
       }
-      throw this.error("인라인 테이블에 , 나 } 가 없다");
+      throw this.error("인라인 테이블에 쉼표나 }가 없다");
     }
   }
 }