hanlint 0.0.9 → 0.0.12

package/README.md

@@ -1,50 +1,124 @@
 # hanlint
 
-한국어 글에서 반복되는 결함을 결정적으로 잡는 린터다. 번역투, 상투어, 이중 피동, 명사 나열, 조각난
-문단과 코드 튜토리얼의 계약 위반을 집는다. 맞춤법 전체를 추측하지 않고 앞뒤 낱말로 확정되는 일부 표기만
-본다. 런타임 의존성이 없고 Node 18 이상이면 된다.
+한국어 글에서 반복되는 결함을 찾는 린터다. 번역투, 상투어, 이중 피동과 문장 구조를 검사하고,
+지적마다 위치, 이유와 고칠 수 있는 표기를 돌려준다. Node.js 18 이상에서 런타임 의존성 없이 실행한다.
 
-```powershell
-npx hanlint
+**[설치 없이 써 보기](https://eddmpython.github.io/hanlint/)** ·
+[전체 소개](https://github.com/eddmpython/hanlint#readme) ·
+[명령과 설정](https://github.com/eddmpython/hanlint/blob/main/skills/specs/start/cli.md) ·
+[변경 이력](https://github.com/eddmpython/hanlint/blob/main/CHANGELOG.md)
+
+## 빠른 시작
+
+```sh
 npx hanlint 글.md
+npx hanlint docs/ --preset docs
+npx hanlint 글.md --format json
+```
+
+인자 없이 실행하면 현재 폴더의 파일을 바탕으로 시작 안내를 보여 준다.
+파일 대신 폴더를 주면 아래의 마크다운 파일을 찾는다. 표준 입력은 `npx hanlint - --path 글.md`로 받는다.
+
+```sh
 npx hanlint fix 글.md
-npx hanlint 글.md --format compact --errors-only
+npx hanlint 글.md
 ```
 
-인자 없이 치면 첫 화면이 나온다. 이 폴더의 마크다운 이름으로 만든 예시와 지금 칠 수 있는 명령이 거기 있다.
-파일 자리에 폴더를 주면 그 아래 마크다운을 전부 찾는다.
+`fix`는 고친 표기가 확정된 자리를 **파일에 직접 반영**한다. 변경을 확인하고 다시 검사한다.
+일반 검사는 error가 없으면 0, 있으면 1, 입력이나 설정이 잘못되면 2로 끝난다.
+notice만 있으면 0이며, `--errors-only`를 주면 notice 표시를 제외한다.
+명령마다 다른 판정은 [종료 코드 안내](https://github.com/eddmpython/hanlint/blob/main/skills/specs/start/cli.md#종료-코드)를 따른다.
+
+## JavaScript에서 검사하기
+
+```sh
+npm install hanlint
+```
+
+```js
+import { configFromMapping, lintText } from "hanlint";
+
+const text = "이 도구는 다양한 기능을 제공합니다.";
+const config = configFromMapping({ preset: "docs" });
+for (const finding of lintText(text, config)) {
+  console.log(finding.line, finding.rule, finding.why);
+}
+```
 
-지적마다 규칙 이름, 줄 번호, 인용 문장, 왜 문제인지가 붙고 마지막 줄이 다음에 무엇을 하면 되는지 말한다.
-고친 표기가 확정된 자리는 `fix` 가 원문에 적용한다. `--format json` 은 기계가 읽는 꼴이고 종료 코드는
-지적이 없으면 0, error 가 있으면 1 이라 발행 게이트에 그대로 물린다. stdin 은 `npx hanlint - --path 이름.md`
-로 받는다. 규칙 목록은 `npx hanlint rules`, 규칙의 기술서는 `npx hanlint explain <규칙>`, 지금 어느 설정으로
-도는지는 `npx hanlint doctor` 다.
+파일은 `lintFile("글.md", config)`로 검사한다. `loadConfig()`는 현재 위치에서 프로젝트 설정을 찾는다.
+파일과 설정 경로를 읽는 API는 Node 전용이다. 문자열 API에 설정을 생략하면 기본 설정을 쓴다.
 
-파이썬 판의 `hanlint learn 전.md 승인본.md --format toml`로 승인한 `[[patches]]`를 같은
-`hanlint.toml`에 두면 npm 판도 같은 패치를 읽는다. 정규화한 원문, 규칙, 프리셋, 국소 표지, 독자 상태가
-모두 같은 유일한 패치만 JSON 지적의 `patch`로 내고, 원문이 다르면 유사 문장이라도 기권한다.
+`blog`, `report`, `docs`, `guide`, `essay`, `fiction`, `encyclopedia`, `chat`, `screen`의 아홉 프리셋이 있다.
+`screen`은 화면의 글 (단추, 이름표, 상태, 빈 상태) 이다. 낱말 자리의 문장과 화면 해설, 접객 말투를 잡고 산문 규칙은 끈다.
+프로젝트 설정은 `npx hanlint init --preset docs`로 만들고 `npx hanlint doctor`로 확인한다.
+규칙 목록은 `npx hanlint rules`, 개별 규칙의 근거는 `npx hanlint explain translationese`에서 본다.
 
-같은 `learn` 출력에서 뜻과 적용 범위를 확인한 `[[operations]]`도 두 판이 함께 읽는다. 승인 조각이 현재
-문장의 단어 경계 한 자리에만 있고 숫자, URL, 식별자, 경로, 코드, 링크 목적지가 그대로일 때 파일 JSON의
-`operations[].operation.result`를 낸다. 한국어 고유명사와 프로젝트 용어는 `protectedTerms`에 적어 잠근다.
-지시어와 의미 고침, 여러 자리 일치는 기권하며 원문 완전 일치 패치와 확정 fix가 먼저다.
+## 수정하면서 원문 보호하기
 
-글의 종류가 블로그가 아니면 프리셋을 먼저 고른다. `npx hanlint init --preset docs` 가 참고 문서에 맞지 않는
-규칙을 끈 설정 파일을 만든다. `blog`, `report`, `docs`, `guide`, `essay`, `fiction`, `encyclopedia` 일곱이고
-`npx hanlint rules` 가 지금 도는 목록을 낸다.
+Reader Contract는 사람이 확인한 독자, 목적과 사실을 받아 숫자, URL, 인라인 코드와 링크 목적지를 보호한다.
 
 ```js
-import { lintFile } from "hanlint";
+import { Contract, Patch, check, renderCheck, verifyPatch } from "hanlint";
 
-for (const finding of lintFile("글.md")) console.log(finding.line, finding.rule, finding.why);
+const text = "예산은 400,000원이다.";
+const contract = new Contract(
+  "배포를 결정할 운영자",
+  "예산을 확인한다",
+  ["예산은 380,000원이다."],
+);
+console.log(renderCheck(check(text, contract)));
+
+const patch = new Patch("unexpectedNumbers", "400,000", "380,000");
+const result = verifyPatch(text, patch, contract);
+console.log(result);
 ```
 
-파이썬 패키지 (`pip install hanlint`) 와 같은 규칙, 같은 fixture, 같은 출력이다. 지문 지도 (`audit`, `map`),
-문체 프로파일, 초안 비교 (`diff`), 평가자 겹침 (`coverage`) 은 파이썬 쪽에만 있다. 무엇을 잡고 무엇을 잡지 않는지는
-[전체 사용 안내](https://github.com/eddmpython/hanlint#readme)와
-[제품 경계](https://github.com/eddmpython/hanlint/blob/main/skills/specs/start/product.md)에서 확인할 수 있다.
+`contractFromText(text, reader, goal)`은 원문에서 사실 후보를 모은다. 사람이 확인한 뒤 사용한다.
+`contractFromTextV2(text, reader, goal, 2)`는 H2 제목의 수와 순서도 보호할 계약을 만든다.
+패치는 원문 한 자리에 정확히 맞고 기존 위반을 줄이며 새 보호 위반이나 error를 만들지 않아야 검증된다.
+사실의 진실, 의미 보존과 자연스러움은 사람이 판단한다.
+
+JSON 형식과 전체 조건은
+[Reader Contract](https://github.com/eddmpython/hanlint/blob/main/skills/specs/start/readerContract.md)가 정본이다.
+
+## 브라우저와 수정 사례
+
+[한린트 편집기](https://eddmpython.github.io/hanlint/)는 같은 npm 코어로 검사, 고침,
+원문 비교와 개인 기록을 제공한다. 사용 방법은
+[편집기 안내](https://eddmpython.github.io/hanlint/guide.html)에서 확인한다.
+
+다음 API는 **main과 현재 웹 편집기에 먼저 반영되어 있으며, npm 0.0.10에는 없다.**
+배포 여부는 [변경 이력](https://github.com/eddmpython/hanlint/blob/main/CHANGELOG.md)에서 확인한다.
+
+| API | 결과 |
+|---|---|
+| `inspectText(text, config)` | 지적, 문체 본보기, 승인 고침 후보와 지문 |
+| `learnText(before, after, config)` | 사람이 확인하고 승인할 문장 고침과 표면 치환 후보 |
+| `compareRevision(before, after, config)` | 자유 원고의 숫자, 링크, 코드와 H2 제목 변화 |
+
+브라우저에서 코어를 실행하려면 사전과 모듈을 함께 조립한다.
+저장소의 [정적 사이트 빌드 절차](https://github.com/eddmpython/hanlint/blob/main/skills/specs/operation/webEditor.md)를 따른다.
+
+Python의 `hanlint learn 전.md 승인본.md --format toml`로 만든 후보는 사람이 검토한 뒤
+`hanlint.toml`의 `[[patches]]`와 `[[operations]]`로 승인할 수 있다. 두 판이 같은 설정을 읽는다.
+원문 일치와 문맥 조건을 통과한 고침만 제안하며, 모호한 곳에서는 기권한다.
+보호할 고유명사와 프로젝트 용어는 `protectedTerms`에 넣는다.
+후보 생성, 개인 승인과 공통 규칙 반영은 별도 단계다.
+
+## 자동화와 지원 범위
+
+GitHub Actions, pre-commit과 Claude Code 훅의 전체 설정은
+[자동화 연결 안내](https://github.com/eddmpython/hanlint/blob/main/skills/specs/start/integrations.md)에 있다.
+훅은 후속 작업에 지적을 전달하며, CI의 종료 코드 검사와는 목적이 다르다.
+
+Python 판과 공유하는 검사는 같은 사전과 적합성 자료로 검증한다.
+`audit`, `map`, `diff`, `learn`, `profile`, `coverage` 등 분석·실험 명령은 Python 쪽에 있다.
+전체 명령의 구분은 [명령과 설정](https://github.com/eddmpython/hanlint/blob/main/skills/specs/start/cli.md)을 참고한다.
+
+한린트는 모든 맞춤법이나 글의 품질을 판정하지 않는다. 지적이 없어도 좋은 글이라는 보증은 아니다.
+오탐과 수정 사례는 [GitHub Issues](https://github.com/eddmpython/hanlint/issues/new/choose)로 받는다.
 
 ## 라이선스
 
-코드와 나머지 데이터는 [MIT](LICENSE)다. `data/easyWords.json`은 국립국어원 자료의 파생물이며
-[공공누리 제1유형 고지](koglType1.LICENSE.md)가 적용된다.
+코드는 [MIT](https://github.com/eddmpython/hanlint/blob/main/LICENSE)다.
+쉬운 말 자료에는 [공공누리 제1유형 고지](https://github.com/eddmpython/hanlint/blob/main/npm/koglType1.LICENSE.md)가 적용된다.

package/data/checkResult.schema.json

@@ -0,0 +1,75 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://hanlint.dev/schemas/checkResult.schema.json",
+  "title": "hanlint Check Result",
+  "description": "A deterministic receipt for a Reader Contract and a prose draft.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "version",
+    "kind",
+    "violationCount",
+    "contractSha256",
+    "draftSha256",
+    "surface",
+    "lint",
+    "meaning"
+  ],
+  "properties": {
+    "version": { "const": 1 },
+    "kind": { "const": "hanlint.checkResult" },
+    "violationCount": { "type": "integer", "minimum": 0 },
+    "contractSha256": { "$ref": "#/$defs/sha256" },
+    "draftSha256": { "$ref": "#/$defs/sha256" },
+    "surface": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "missingNumbers",
+        "unexpectedNumbers",
+        "missingUrls",
+        "unexpectedUrls",
+        "missingCode",
+        "unexpectedCode",
+        "missingLinks",
+        "unexpectedLinks"
+      ],
+      "properties": {
+        "missingNumbers": { "$ref": "#/$defs/strings" },
+        "unexpectedNumbers": { "$ref": "#/$defs/strings" },
+        "missingUrls": { "$ref": "#/$defs/strings" },
+        "unexpectedUrls": { "$ref": "#/$defs/strings" },
+        "missingCode": { "$ref": "#/$defs/strings" },
+        "unexpectedCode": { "$ref": "#/$defs/strings" },
+        "missingLinks": { "$ref": "#/$defs/strings" },
+        "unexpectedLinks": { "$ref": "#/$defs/strings" }
+      }
+    },
+    "lint": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["errorCount", "noticeCount", "errorRules", "items"],
+      "properties": {
+        "errorCount": { "type": "integer", "minimum": 0 },
+        "noticeCount": { "type": "integer", "minimum": 0 },
+        "errorRules": {
+          "type": "object",
+          "additionalProperties": { "type": "integer", "minimum": 1 }
+        },
+        "items": {
+          "type": "array",
+          "items": { "$ref": "finding.schema.json" }
+        }
+      }
+    },
+    "meaning": { "type": "string", "minLength": 1 }
+  },
+  "$defs": {
+    "sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" },
+    "strings": {
+      "type": "array",
+      "uniqueItems": true,
+      "items": { "type": "string", "minLength": 1 }
+    }
+  }
+}

package/data/checkResultV2.schema.json

@@ -0,0 +1,98 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://hanlint.dev/schemas/checkResultV2.schema.json",
+  "title": "hanlint Check Result v2",
+  "description": "A deterministic receipt for protected surface atoms, an exact heading outline, document shape, and lint findings.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "version",
+    "kind",
+    "violationCount",
+    "contractSha256",
+    "draftSha256",
+    "surface",
+    "missingFacts",
+    "lint",
+    "meaning",
+    "outline",
+    "document"
+  ],
+  "properties": {
+    "version": { "const": 2 },
+    "kind": { "const": "hanlint.checkResult" },
+    "violationCount": { "type": "integer", "minimum": 0 },
+    "contractSha256": { "$ref": "#/$defs/sha256" },
+    "draftSha256": { "$ref": "#/$defs/sha256" },
+    "missingFacts": { "type": "array", "items": { "type": "string" } },
+    "surface": { "$ref": "checkResult.schema.json#/properties/surface" },
+    "lint": { "$ref": "checkResult.schema.json#/properties/lint" },
+    "meaning": { "type": "string", "minLength": 1 },
+    "outline": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["matches", "level", "expected", "actual", "mismatches"],
+      "properties": {
+        "matches": { "type": "boolean" },
+        "level": { "type": "integer", "minimum": 1, "maximum": 6 },
+        "expected": { "$ref": "#/$defs/strings" },
+        "actual": { "$ref": "#/$defs/strings" },
+        "mismatches": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["position", "expected", "actual"],
+            "properties": {
+              "position": { "type": "integer", "minimum": 1 },
+              "expected": { "type": ["string", "null"] },
+              "actual": { "type": ["string", "null"] }
+            }
+          }
+        }
+      }
+    },
+    "document": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "sentenceCount",
+        "paragraphCount",
+        "sectionCount",
+        "wordCount",
+        "questionCount",
+        "readerCallCount",
+        "sections"
+      ],
+      "properties": {
+        "sentenceCount": { "type": "integer", "minimum": 0 },
+        "paragraphCount": { "type": "integer", "minimum": 0 },
+        "sectionCount": { "type": "integer", "minimum": 0 },
+        "wordCount": { "type": "integer", "minimum": 0 },
+        "questionCount": { "type": "integer", "minimum": 0 },
+        "readerCallCount": { "type": "integer", "minimum": 0 },
+        "sections": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["heading", "line", "paragraphCount", "codeBlockCount"],
+            "properties": {
+              "heading": { "type": "string" },
+              "line": { "type": "integer", "minimum": 1 },
+              "paragraphCount": { "type": "integer", "minimum": 0 },
+              "codeBlockCount": { "type": "integer", "minimum": 0 }
+            }
+          }
+        }
+      }
+    }
+  },
+  "$defs": {
+    "sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" },
+    "strings": {
+      "type": "array",
+      "items": { "type": "string" }
+    }
+  }
+}

package/data/exemplars.json

@@ -318,6 +318,105 @@
       "before": "모든 분야에 있어서 기준이 필요합니다.",
       "after": "모든 분야에서 기준이 필요합니다.",
       "moved": "번역투를 우리말 어순으로 되돌렸다"
+    },
+    {
+      "rule": "screenSentence",
+      "before": "요청을 완료하지 못했습니다",
+      "after": "요청 실패",
+      "moved": "종결어미를 떼고 실패를 낱말로 적었다"
+    },
+    {
+      "rule": "screenNarration",
+      "before": "계약 신청이 도착하면 여기에 표시됩니다.",
+      "after": "계약 없음",
+      "moved": "예고 문장을 빈 상태의 낱말로 바꿨다"
+    },
+    {
+      "rule": "screenTone",
+      "before": "관리하실 수임처를 체크해 주시면 그 회사의 자료만 가져옵니다.",
+      "after": "관리할 수임처",
+      "moved": "접객 말투의 안내문을 칸의 이름으로 줄였다"
+    },
+    {
+      "rule": "dash",
+      "presets": [
+        "screen"
+      ],
+      "before": "설정 {em} 저장",
+      "after": "설정 저장",
+      "moved": "긴 줄표를 지우고 낱말만 남겼다"
+    },
+    {
+      "rule": "spelling",
+      "presets": [
+        "screen"
+      ],
+      "before": "몇일 남음",
+      "after": "며칠 남음",
+      "moved": "표기를 바로잡았다"
+    },
+    {
+      "rule": "spacing",
+      "presets": [
+        "screen"
+      ],
+      "before": "저장할수 없음",
+      "after": "저장할 수 없음",
+      "moved": "띄어쓰기를 바로잡았다"
+    },
+    {
+      "rule": "confusable",
+      "presets": [
+        "screen"
+      ],
+      "before": "회원으로써 신청",
+      "after": "회원으로서 신청",
+      "moved": "자격을 뜻하는 조사로 바로잡았다"
+    },
+    {
+      "rule": "hardWord",
+      "presets": [
+        "screen"
+      ],
+      "before": "금일 수집",
+      "after": "오늘 수집",
+      "moved": "어려운 한자어를 쉬운 말로 바꿨다"
+    },
+    {
+      "rule": "japaneseLoan",
+      "presets": [
+        "screen"
+      ],
+      "before": "잔고 조회",
+      "after": "잔액 조회",
+      "moved": "일본어투 낱말을 바꿨다"
+    },
+    {
+      "rule": "doublePassive",
+      "presets": [
+        "screen"
+      ],
+      "before": "보여지는 항목",
+      "after": "보이는 항목",
+      "moved": "피동을 하나로 줄였다"
+    },
+    {
+      "rule": "translationese",
+      "presets": [
+        "screen"
+      ],
+      "before": "승인에 있어서 필요한 값",
+      "after": "승인에 필요한 값",
+      "moved": "번역투를 지웠다"
+    },
+    {
+      "rule": "redundantPair",
+      "presets": [
+        "screen"
+      ],
+      "before": "매 시간마다 확인",
+      "after": "매시간 확인",
+      "moved": "겹말을 하나로 줄였다"
     }
   ]
 }

package/data/finding.schema.json

@@ -0,0 +1,38 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://hanlint.dev/schemas/finding.schema.json",
+  "title": "hanlint Finding",
+  "description": "A deterministic prose issue with its location, reason, and optional local repair data.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["rule", "line", "severity", "scope", "at", "quote", "why"],
+  "properties": {
+    "rule": { "type": "string", "minLength": 1 },
+    "line": { "type": "integer", "minimum": 1 },
+    "severity": { "enum": ["error", "notice"] },
+    "scope": { "enum": ["sentence", "paragraph", "section", "document"] },
+    "at": { "type": "integer", "minimum": -1 },
+    "quote": { "type": "string", "minLength": 1 },
+    "why": { "type": "string", "minLength": 1 },
+    "fix": { "type": "string", "minLength": 1 },
+    "fragment": { "type": ["string", "null"] },
+    "replacement": { "type": "string" },
+    "candidates": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["text", "why"],
+        "properties": {
+          "text": { "type": "string", "minLength": 1 },
+          "why": { "type": "string", "minLength": 1 }
+        }
+      }
+    }
+  },
+  "dependentRequired": {
+    "fragment": ["replacement"],
+    "replacement": ["fragment"]
+  }
+}

package/data/holeKinds.json

@@ -128,6 +128,18 @@
         "dash",
         "imperativePeriod"
       ]
+    },
+    {
+      "id": "screen",
+      "name": "화면",
+      "symbol": "U",
+      "ansi": 178,
+      "hex": "#E69F00",
+      "rules": [
+        "screenSentence",
+        "screenNarration",
+        "screenTone"
+      ]
     }
   ]
 }

package/data/patch.schema.json

@@ -0,0 +1,14 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://hanlint.dev/schemas/patch.schema.json",
+  "title": "hanlint Patch",
+  "description": "An exact local replacement connected to a named existing violation.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["reason", "before", "after"],
+  "properties": {
+    "reason": { "type": "string", "minLength": 1 },
+    "before": { "type": "string", "minLength": 1 },
+    "after": { "type": "string", "minLength": 1 }
+  }
+}

package/data/patchResult.schema.json

@@ -0,0 +1,86 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://hanlint.dev/schemas/patchResult.schema.json",
+  "title": "hanlint Patch Result",
+  "description": "A deterministic verification receipt for an exact prose Patch.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "version",
+    "kind",
+    "verified",
+    "violationCount",
+    "contractSha256",
+    "sourceSha256",
+    "patchSha256",
+    "resultSha256",
+    "matchCount",
+    "reason",
+    "newSurfaceIssues",
+    "newErrors",
+    "meaning"
+  ],
+  "properties": {
+    "version": { "const": 1 },
+    "kind": { "const": "hanlint.patchResult" },
+    "verified": { "type": "boolean" },
+    "violationCount": { "type": "integer", "minimum": 0 },
+    "contractSha256": { "$ref": "#/$defs/sha256" },
+    "sourceSha256": { "$ref": "#/$defs/sha256" },
+    "patchSha256": { "$ref": "#/$defs/sha256" },
+    "resultSha256": {
+      "oneOf": [
+        { "$ref": "#/$defs/sha256" },
+        { "type": "null" }
+      ]
+    },
+    "matchCount": { "type": "integer", "minimum": 0 },
+    "reason": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["name", "before", "after", "reduced"],
+      "properties": {
+        "name": { "type": "string", "minLength": 1 },
+        "before": { "type": "integer", "minimum": 0 },
+        "after": {
+          "oneOf": [
+            { "type": "integer", "minimum": 0 },
+            { "type": "null" }
+          ]
+        },
+        "reduced": { "type": "boolean" }
+      }
+    },
+    "newSurfaceIssues": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["kind", "value"],
+        "properties": {
+          "kind": {
+            "enum": [
+              "missingNumbers",
+              "unexpectedNumbers",
+              "missingUrls",
+              "unexpectedUrls",
+              "missingCode",
+              "unexpectedCode",
+              "missingLinks",
+              "unexpectedLinks"
+            ]
+          },
+          "value": { "type": "string", "minLength": 1 }
+        }
+      }
+    },
+    "newErrors": {
+      "type": "array",
+      "items": { "$ref": "finding.schema.json" }
+    },
+    "meaning": { "type": "string", "minLength": 1 }
+  },
+  "$defs": {
+    "sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }
+  }
+}