hanlint 0.0.17 → 0.0.19

package/src/guard/contract.js

@@ -1,5 +1,5 @@
 // @ts-check
-/** Reader Contract 검사와 이유가 붙은 국소 Patch 검증. */
+/** Reader Contract 검사와, 이유를 붙여 한 곳만 바꾸는 Patch의 검증. */
 import { sha256 } from "../digest.js";
 
 import { Patch } from "../config/patch.js";
@@ -19,7 +19,7 @@ function digest(text) {
   return sha256(text);
 }
 
-/** 원문의 보호 표면을 모두 덮는 version 1 Contract 초안을 만든다. @param {string} text @param {string} reader @param {string} goal */
+/** 원문의 지켜야 할 숫자·링크·코드를 모두 담는 version 1 Contract 초안을 만든다. @param {string} text @param {string} reader @param {string} goal */
 export function contractFromText(text, reader, goal) {
   const contract = new Contract(reader, goal, factLines(text));
   const result = surfaceDiff(contract.text, text);
@@ -27,15 +27,15 @@ export function contractFromText(text, reader, goal) {
   for (const kind of ["missingNumbers", "missingUrls", "missingCode", "missingLinks"]) {
     for (const value of result[/** @type {keyof typeof result} */ (kind)]) missing.push(`${kind}=${value}`);
   }
-  if (missing.length) throw new Error(`reader 또는 goal이 원문에 없는 보호 원자를 넣었다: ${missing.join(", ")}`);
+  if (missing.length) throw new Error(`reader나 goal에 원문에 없는 숫자·링크·코드가 들었다: ${missing.join(", ")}`);
   if (surfaceViolationCount(result)) {
     const issues = Object.entries(result).flatMap(([kind, values]) => values.map((value) => `${kind}=${value}`));
-    throw new Error(`계약 초안이 원문의 보호 표면을 모두 담지 못했다: ${issues.join(", ")}`);
+    throw new Error(`계약 초안이 원문의 지켜야 할 숫자·링크·코드를 모두 담지 못했다: ${issues.join(", ")}`);
   }
   return contract;
 }
 
-/** 원문의 자동 표면과 한 수준의 제목을 분리한 version 2 Contract 초안을 만든다. @param {string} text @param {string} reader @param {string} goal @param {number} [outlineLevel] @param {string[]} [facts] */
+/** 원문에서 자동으로 찾은 숫자·링크·코드와 한 수준의 제목을 따로 담은 version 2 Contract 초안을 만든다. @param {string} text @param {string} reader @param {string} goal @param {number} [outlineLevel] @param {string[]} [facts] */
 export function contractFromTextV2(text, reader, goal, outlineLevel = 2, facts = []) {
   const doc = parseMarkdown(text);
   const headings = headingsOf(doc, outlineLevel).map((heading) => heading.text);
@@ -50,7 +50,7 @@ export function contractFromTextV2(text, reader, goal, outlineLevel = 2, facts =
   const result = surfaceDiff(contract.text, text);
   if (surfaceViolationCount(result)) {
     const issues = Object.entries(result).flatMap(([kind, values]) => values.map((value) => `${kind}=${value}`));
-    throw new Error(`reader, goal 또는 facts가 원문에 없는 보호 원자를 넣었다: ${issues.join(", ")}`);
+    throw new Error(`reader, goal, facts에 원문에 없는 숫자·링크·코드가 들었다: ${issues.join(", ")}`);
   }
   return contract;
 }

package/src/guard/editLocality.js

@@ -1,5 +1,5 @@
 // @ts-check
-/** 선택한 규칙의 Finding 줄과 원문 변경 창을 대조한다. */
+/** 고른 규칙의 지적이 있는 줄과 원문에서 바뀐 범위를 대조한다. */
 export function editIssues(text, patch, findings, policy) {
   if (!Object.keys(policy).length) return [];
   const limits = policy[patch.reason];

package/src/guard/outline.js

@@ -1,5 +1,5 @@
 // @ts-check
-/** Reader Contract가 잠근 제목 순서와 글 지문의 구조 요약. */
+/** Reader Contract가 고정한 제목 순서와, 글 분석 결과에서 뽑은 구조 요약. */
 
 /** @typedef {{position: number, expected: string | null, actual: string | null}} OutlineMismatch */
 /** @typedef {{matches: boolean, level: number, expected: string[], actual: string[], mismatches: OutlineMismatch[]}} OutlineDiff */

package/src/guard/receipt.js

@@ -1,14 +1,14 @@
 // @ts-check
-/** Reader Contract 검사와 Patch 검증의 결정적 영수증. */
+/** Reader Contract 검사와 Patch 검증의 결과 기록. 같은 입력이면 늘 같은 결과다. */
 
 import { findingAsDict } from "../rules/finding.js";
 import { readerDebts } from "../rules/readerDebt.js";
 import { compareText, surfaceViolationCount } from "./surface.js";
 
 export const CHECK_MEANING = "violationCount는 선언한 보호 원자와 hanlint error의 수다. facts의 관계와 진실, 빠진 의미, 독자 효용과 자연스러움은 검증하지 않는다";
-export const CHECK_MEANING_V2 = "violationCount는 선언한 보호 원자, 제목 구조, 잠금 문구 누락과 hanlint error의 수다. facts의 관계와 진실, 빠진 의미, 독자 효용과 자연스러움은 검증하지 않는다";
+export const CHECK_MEANING_V2 = "violationCount는 계약에 적은 숫자·링크·코드의 어긋남, 제목 구조의 어긋남, 빠진 고정 문구, hanlint 오류를 더한 수다. facts 사이의 관계와 사실 여부, 빠진 뜻, 독자에게 쓸모 있는지와 자연스러운지는 검사하지 않는다";
 export const PATCH_MEANING = "verified는 정확히 한 자리를 바꾸고 명시한 기존 위반을 줄이며 새 보호 원자 위반과 새 error를 만들지 않았다는 뜻뿐이다. 수정문의 의미와 진실, 자연스러움은 승인하지 않는다";
-export const PATCH_MEANING_V2 = "verified는 정확히 한 자리를 바꾸고 명시한 기존 위반을 줄이며 새 계약 위반과 새 error를 만들지 않고 선택한 수정 예산을 지켰다는 뜻뿐이다. 수정문의 의미와 진실, 자연스러움은 승인하지 않는다";
+export const PATCH_MEANING_V2 = "verified는 정확히 한 곳을 바꾸고, 적어 둔 기존 위반을 줄이고, 새 계약 위반과 새 오류를 만들지 않고, 고른 수정 예산을 지켰다는 뜻뿐이다. 고친 문장의 뜻이 맞는지, 사실인지, 자연스러운지는 보증하지 않는다";
 
 /** @param {import("../rules/finding.js").Finding[]} findings */
 function errorRules(findings) {
@@ -32,7 +32,7 @@ export class CheckResult {
     this.document = document;
     this.missingFacts = missingFacts;
     if (![1, 2].includes(contractVersion)) {
-      throw new Error(`check result contractVersion 은 1 또는 2다: ${contractVersion}`);
+      throw new Error(`check result의 contractVersion은 1이나 2여야 한다. 받은 값: ${contractVersion}`);
     }
     const hasStructure = outline !== null && document !== null;
     if (hasStructure !== (contractVersion === 2)) {
@@ -89,7 +89,7 @@ export class PatchResult {
     this.resultText = values.resultText;
     this.contractVersion = values.contractVersion;
     if (![1, 2].includes(values.contractVersion)) {
-      throw new Error(`patch result contractVersion 은 1 또는 2다: ${values.contractVersion}`);
+      throw new Error(`patch result의 contractVersion은 1이나 2여야 한다. 받은 값: ${values.contractVersion}`);
     }
   }
 
@@ -137,7 +137,7 @@ export class PatchResult {
   }
 }
 
-/** 사람이 결론, 근거, 다음 행동 순서로 읽는 검사 영수증. @param {CheckResult} result */
+/** 사람이 결론, 근거, 다음 할 일의 순서로 읽는 검사 결과. @param {CheckResult} result */
 export function renderCheck(result) {
   const lines = [result.violationCount === 0 ? "계약 위반 없음" : `계약 위반 ${result.violationCount}건`];
   const labels = [
@@ -162,19 +162,19 @@ export function renderCheck(result) {
   if (result.document) {
     lines.push(`- 글: 문장 ${result.document.sentenceCount}, 문단 ${result.document.paragraphCount}, 절 ${result.document.sectionCount}`);
     result.document.sections.forEach((section, index) => {
-      lines.push(`  ${index + 1}. ${section.heading} (${section.line}행, 문단 ${section.paragraphCount}, 코드 ${section.codeBlockCount})`);
+      lines.push(`  ${index + 1}. ${section.heading} (${section.line}줄, 문단 ${section.paragraphCount}, 코드 ${section.codeBlockCount})`);
     });
   }
-  lines.push(`- lint: error ${result.errorCount}, notice ${result.noticeCount}`);
+  lines.push(`- lint: 오류 ${result.errorCount}건, 경고 ${result.noticeCount}건`);
   if (result.errorCount) {
     lines.push(`  ${Object.entries(errorRules(result.findings)).map(([rule, count]) => `${rule} ${count}`).join(", ")}`);
   }
   const debts = readerDebts(result.findings);
-  lines.push(debts.length ? `- 독자 부채: ${debts.length}건` : "- 독자 부채: 없음");
-  for (const debt of debts) lines.push(`  ${debt.line}행 [${debt.rule}] ${debt.why}`);
-  if (result.violationCount) lines.push("\n다음: 계약과 글 가운데 틀린 쪽을 바로잡고 같은 check를 다시 실행한다");
-  else if (result.noticeCount) lines.push("\n다음: notice를 읽고 고칠지 유지할지 판단한 뒤 사람과 LLM 평가로 넘어간다");
-  else lines.push("\n다음: 세어서 잡히는 계약 위반이 없다. 사람과 LLM 평가로 넘어간다");
+  lines.push(debts.length ? `- 독자가 막힐 곳: ${debts.length}건` : "- 독자가 막힐 곳: 없음");
+  for (const debt of debts) lines.push(`  ${debt.line}줄 [${debt.rule}] ${debt.why}`);
+  if (result.violationCount) lines.push("\n다음: 계약과 글 가운데 틀린 쪽을 고치고 같은 check를 다시 돌린다");
+  else if (result.noticeCount) lines.push("\n다음: 경고를 읽고 고칠지 그대로 둘지 정한다");
+  else lines.push("\n다음: 규칙으로 셀 수 있는 계약 위반은 없다. 뜻과 자연스러움은 사람이 읽고 판단한다");
   lines.push("", result.contractVersion === 1 ? CHECK_MEANING : CHECK_MEANING_V2);
   return lines.join("\n");
 }

package/src/guard/surface.js

@@ -1,5 +1,5 @@
 // @ts-check
-/** 계약 본문과 결과 글 사이의 보호 원자 차이. */
+/** 계약 본문과 결과 글 사이에서 지켜야 할 숫자·링크·코드의 차이. */
 
 /**
  * @typedef {object} SurfaceDiff
@@ -107,7 +107,7 @@ export function surfaceViolationCount(diff) {
   return Object.values(diff).reduce((total, values) => total + values.length, 0);
 }
 
-/** 원문의 보호 원자를 뜻 없는 정렬 집합으로 분리한다. @param {string} text */
+/** 원문의 지켜야 할 숫자·링크·코드를 뜻과 상관없이 정렬한 집합으로 나눈다. @param {string} text */
 export function protectedSurface(text) {
   const surfaceText = text.normalize("NFC");
   return {
@@ -118,7 +118,7 @@ export function protectedSurface(text) {
   };
 }
 
-/** 원문의 보호 표면을 모두 덮는 Contract 사실 후보 줄. @param {string} text */
+/** 원문의 지켜야 할 숫자·링크·코드를 모두 담는 Contract 사실 후보 줄. @param {string} text */
 export function factLines(text) {
   const surfaceText = text.normalize("NFC");
   const seen = new Set();
@@ -144,7 +144,7 @@ export function factLines(text) {
     ),
   );
   if (!uncovered.size) {
-    throw new Error("원문에 자동으로 보호할 숫자, URL, 인라인 코드, 링크 목적지가 없다. facts를 직접 작성한다");
+    throw new Error("원문에 자동으로 지킬 숫자, URL, 인라인 코드, 링크 목적지가 없다. facts를 직접 작성한다");
   }
 
   const selected = new Set();

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";
@@ -26,7 +26,7 @@ import { configFromMapping, defaultConfig } from "./config/settings.js";
 import { loadVersion } from "./data/load.js";
 import { parseMarkdown } from "./document/parseMarkdown.js";
 import { SOURCE_SUFFIXES, replaceLiteral, sourceLiterals } from "./document/sourceText.js";
-import { parseSheet, renderSheet, renderSheetJson } from "./report/sheet.js";
+import { applyRows, parseSheet, renderSheet, renderSheetJson, sheetRows } from "./report/sheet.js";
 import { headingsOf } from "./document/model.js";
 import { applyFixes } from "./edit/applyFixes.js";
 import { buildFingerprint } from "./fingerprint/build.js";
@@ -54,6 +54,8 @@ export {
   parseSheet,
   renderSheet,
   renderSheetJson,
+  sheetRows,
+  applyRows,
   replaceLiteral,
   sourceLiterals,
   CONTRACT_VERSION,
@@ -82,7 +84,7 @@ export {
 export const version = loadVersion();
 
 /**
- * 글을 한 번 읽어 지문을 만든다.
+ * 글을 한 번 읽어 분석 결과를 만든다.
  * @param {string} text
  * @param {import("./config/settings.js").Config} [config]
  * @param {string | null} [path]
@@ -102,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]
  */
@@ -110,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);
@@ -130,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,7 +1,7 @@
 // @ts-check
-/** 한 줄에 지적 하나. AI 와 스크립트가 읽는 꼴이다. 파이썬 report/compactReport.py 와 같은 글자다. */
+/** 한 줄에 지적 하나. AI와 스크립트가 읽는 형식이다. 파이썬 report/compactReport.py와 같은 글자다. */
 
-/** 줄바꿈과 이어진 공백을 하나로 눕힌다. 한 줄은 이 꼴의 계약이다. @param {string} text */
+/** 줄바꿈과 이어진 공백을 하나로 눕힌다. 한 줄은 이 형식의 계약이다. @param {string} text */
 function flat(text) {
   return text.split(/\s+/).filter(Boolean).join(" ");
 }
@@ -9,6 +9,10 @@ function flat(text) {
 /** @param {string} path @param {import("../rules/finding.js").Finding[]} findings */
 export function renderCompact(path, findings) {
   return findings
-    .map((f) => `${path}:${f.line} [${f.rule}] ${f.severity === "notice" ? "notice: " : ""}${flat(f.why)}` + (f.fix ? `  고친 뒤: ${flat(f.fix)}` : ""))
+    .map((f) => {
+      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,8 +1,8 @@
 // @ts-check
 /**
- * 기계가 읽는 꼴. 평가 루프의 0층 입력이다. 파이썬 json.dumps(indent=2, ensure_ascii=False) 와 같은 글자다.
- * 지적마다 `exemplar` 를 붙인다. 승인 원문 완전 일치 `patch`는 맞는 지적에만 별도로 붙인다.
- * 실제 수정 차이는 파이썬의 exemplarLift와 patchMemory 탐침에서 따로 잰다.
+ * 기계가 읽는 형식. 평가 루프의 0층 입력이다. 파이썬 json.dumps(indent=2, ensure_ascii=False)와 같은 글자다.
+ * 지적마다 `exemplar`를 붙인다. 승인 원문 완전 일치 `patch`는 맞는 지적에만 별도로 붙인다.
+ * 실제 수정 차이는 파이썬의 exemplarLift와 patchMemory 실험 스크립트에서 따로 잰다.
  */
 import { exemplarFor } from "../data/exemplars.js";
 import { findingAsDict } from "../rules/finding.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/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,21 +35,40 @@ function candidateLines(findings) {
   return lines;
 }
 
-/** @param {string} path @param {import("../rules/finding.js").Finding[]} findings @param {string | null | undefined} [register] @param {string | null | undefined} [preset] @param {import("../data/exemplars.js").Exemplar[]} [customExemplars] */
-export function renderText(path, findings, register = null, preset = null, customExemplars = []) {
-  if (!findings.length) return `${path}  집은 자리 없음`;
+/** 접은 경고. 규칙마다 개수와 줄 번호 한 줄. 뜻은 파이썬 textReport.py의 noticeLines가 소유한다. @param {import("../rules/finding.js").Finding[]} notices */
+function noticeLines(notices) {
+  /** @type {Map<string, number[]>} */
+  const byRule = new Map();
+  for (const finding of notices) {
+    if (!byRule.has(finding.rule)) byRule.set(finding.rule, []);
+    /** @type {number[]} */ (byRule.get(finding.rule)).push(finding.line);
+  }
+  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(", ")}줄`);
+  }
+  return lines;
+}
+
+/** @param {string} path @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 {boolean} [unfoldNotices] */
+export function renderText(path, findings, register = null, preset = null, customExemplars = [], unfoldNotices = false) {
+  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, ""];
-  for (const f of findings) {
-    const tag = `[${f.rule}]` + (f.severity === "notice" ? " 확인" : "");
+  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" ? " 경고" : "");
     lines.push(`${path}:${f.line}  ${tag}`, `  ${f.quote}`, `  ${f.why}`);
-    if (f.fix) lines.push(`  고친 뒤: ${f.fix}`);
+    if (f.fix) lines.push(`  ${f.severity === "notice" ? "제안" : "고친 뒤"}: ${f.fix}`);
     lines.push("");
   }
-  lines.push(...exemplarLines(findings, register, preset, customExemplars));
-  const candidates = candidateLines(findings);
+  if (folded.length) lines.push(...noticeLines(folded), "");
+  lines.push(...exemplarLines(shown, register, preset, customExemplars));
+  const candidates = candidateLines(shown);
   if (candidates.length) lines.push("", ...candidates);
   return lines.join("\n").replace(/\n+$/, "");
 }

package/src/report/writingSpec.js

@@ -27,21 +27,21 @@ 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;
 }
 
 /**
- * 현재 규칙판을 쓰기 전 숫자 사양으로 편다. 품질 점수나 새 임계는 만들지 않는다.
+ * 현재 규칙 세트를 쓰기 전 숫자 사양으로 편다. 품질 점수나 새 임계는 만들지 않는다.
  * @param {import("./settings.js").Config} [config]
  * @param {string} [register]
  * @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 });
@@ -161,14 +161,14 @@ export function writingSpec(config = defaultConfig(), register = HAPNIDA, target
   };
 }
 
-/** 사람이 읽는 꼴. basis는 JSON에서 확인한다. @param {ReturnType<typeof writingSpec>} spec */
+/** 사람이 읽는 형식. basis는 JSON에서 확인한다. @param {ReturnType<typeof writingSpec>} spec */
 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;
     }
   }