hanlint 0.0.7 → 0.0.8

package/data/nonNouns.txt

@@ -0,0 +1,153 @@
+# 명사 연속을 끊는 어절. 조사도 어미도 안 붙어서 표층 판정이 명사로 오인하지만 명사 쌓기의 재료가 아닌 것들.
+# 의존명사, 관형사, 부사, 그리고 굳은 꼴이다. nounPile 만 이 목록을 읽는다.
+# 실측: 005-python-history 에서 nounPile 세 건이 전부 이 부류 때문이었다 (토론 4번).
+#   `아니라 1970년대 BBC 코미디 Monty` (아니라), `도는지 직접 눌러 볼 수` (직접, 수),
+#   `최근 몇 년 동안 파이썬` (몇, 년, 동안).
+# 이 목록은 연속을 끊기만 하므로 잘못 넣으면 놓치는 쪽으로 틀린다. 잡는 쪽으로는 틀리지 않는다.
+
+# 의존명사
+수
+것
+때
+곳
+중
+뿐
+등
+바
+데
+편
+셈
+터
+채
+김
+분
+쪽
+줄
+지경
+
+# 시간과 단위의 의존명사
+년
+월
+일
+시
+초
+동안
+무렵
+즈음
+가량
+남짓
+
+# 관형사
+몇
+여러
+각
+어느
+무슨
+온갖
+아무
+딴
+
+# 부사
+직접
+크게
+다시
+매우
+아주
+잘
+더
+덜
+함께
+각각
+먼저
+바로
+특히
+이미
+아직
+늘
+항상
+자주
+가끔
+서로
+모두
+전부
+거의
+조금
+훨씬
+그냥
+오히려
+결국
+실제로
+곧
+잠깐
+따로
+그대로
+반드시
+너
+왜
+얼마
+아니
+문득
+또
+어찌
+
+# 접속부사와 계사 꼴. 실측: 형태소 분석기와 말뭉치 390편을 견주자 표층만 잡은 nounPile 129건의 대부분이
+#   `A 및 B` 의 및 과 `사용 중인 X` 의 중인 을 명사로 센 것이었다 (2026-08-29).
+및
+중인
+# 부사와 관형사 둘째 묶음. 후, 이후, 직후 같은 시간 의존명사는 넣지 않는다. 원사례 `가상환경 생성 후 패키지 설치 확인 절차` 가
+#   후 를 건너 하나의 나열이다. 실측: 형태소 분석기와 말뭉치 390편을 견주자 표층만 명사 다섯으로 본 63문장에서
+#   `못 들어`, `가장 추운`, `지난 30일`, `다른 방법`, `오늘 새벽`, `총 약 1억`, `브랜치 간`, `7분 경` 이 명사로 세어졌다 (2026-08-29).
+못
+안
+좀
+너무
+몹시
+꽤
+역시
+가장
+총
+약
+현
+첫
+한
+올
+지난
+새
+옛
+다른
+어떤
+이런
+그런
+저런
+오늘
+어제
+내일
+지금
+현재
+당시
+내
+간
+경
+별로
+아마
+물론
+이
+그
+저
+우리
+아무리
+딱
+점점
+만일
+처음
+소위
+과거
+# 굳은 꼴
+아니라
+대신
+위해
+통해
+비해
+관해
+대해
+의해

package/data/panelAssignmentReview.schema.json

@@ -0,0 +1,117 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://hanlint.dev/schemas/panelAssignmentReview.schema.json",
+  "title": "hanlint writing arena assigned human review",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["version", "kind", "assignmentSha256", "evaluator", "reviews"],
+  "properties": {
+    "version": { "const": 1 },
+    "kind": { "const": "hanlint.panelAssignmentReview" },
+    "assignmentSha256": { "$ref": "#/$defs/sha256" },
+    "evaluator": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "group", "protocolRevision"],
+      "properties": {
+        "id": {
+          "type": "string",
+          "minLength": 1,
+          "pattern": "^\\S(?:.*\\S)?$",
+          "not": { "const": "<required>" }
+        },
+        "group": {
+          "enum": ["targetReader", "professionalEditor", "koreanExpert", "generalReader"]
+        },
+        "protocolRevision": { "const": "hanlint.writingArena.panel.v1" }
+      }
+    },
+    "reviews": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["caseId", "assignmentCaseSha256", "contentChecks", "preferences", "reasons"],
+        "properties": {
+          "caseId": { "type": "string", "minLength": 1 },
+          "assignmentCaseSha256": { "$ref": "#/$defs/sha256" },
+          "contentChecks": { "$ref": "#/$defs/contentChecks" },
+          "preferences": { "$ref": "#/$defs/preferences" },
+          "reasons": { "$ref": "#/$defs/reasons" }
+        },
+        "allOf": [
+          {
+            "if": {
+              "not": {
+                "properties": {
+                  "contentChecks": {
+                    "properties": {
+                      "left": { "const": "pass" },
+                      "right": { "const": "pass" }
+                    }
+                  }
+                }
+              }
+            },
+            "then": {
+              "properties": {
+                "preferences": {
+                  "properties": {
+                    "naturalness": { "const": "cannotJudge" },
+                    "clarity": { "const": "cannotJudge" },
+                    "taskUtility": { "const": "cannotJudge" },
+                    "voice": { "const": "cannotJudge" }
+                  }
+                }
+              }
+            }
+          }
+        ]
+      }
+    }
+  },
+  "$defs": {
+    "sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" },
+    "contentChoice": { "enum": ["pass", "fail", "cannotJudge"] },
+    "preferenceChoice": { "enum": ["left", "right", "tie", "cannotJudge"] },
+    "contentChecks": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["left", "right"],
+      "properties": {
+        "left": { "$ref": "#/$defs/contentChoice" },
+        "right": { "$ref": "#/$defs/contentChoice" }
+      }
+    },
+    "preferences": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["naturalness", "clarity", "taskUtility", "voice"],
+      "properties": {
+        "naturalness": { "$ref": "#/$defs/preferenceChoice" },
+        "clarity": { "$ref": "#/$defs/preferenceChoice" },
+        "taskUtility": { "$ref": "#/$defs/preferenceChoice" },
+        "voice": { "$ref": "#/$defs/preferenceChoice" }
+      }
+    },
+    "reason": {
+      "type": "string",
+      "minLength": 1,
+      "pattern": "\\S",
+      "not": { "const": "<required>" }
+    },
+    "reasons": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["content", "naturalness", "clarity", "taskUtility", "voice"],
+      "properties": {
+        "content": { "$ref": "#/$defs/reason" },
+        "naturalness": { "$ref": "#/$defs/reason" },
+        "clarity": { "$ref": "#/$defs/reason" },
+        "taskUtility": { "$ref": "#/$defs/reason" },
+        "voice": { "$ref": "#/$defs/reason" }
+      }
+    }
+  }
+}

package/data/panelJudgePredictions.schema.json

@@ -0,0 +1,78 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://hanlint.dev/schemas/panelJudgePredictions.schema.json",
+  "title": "hanlint writing arena automatic judge predictions",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "version",
+    "kind",
+    "judgeCasesSha256",
+    "evaluatorId",
+    "evaluatorRevision",
+    "promptSha256",
+    "predictions"
+  ],
+  "properties": {
+    "version": { "const": 1 },
+    "kind": { "const": "hanlint.panelJudgePredictions" },
+    "judgeCasesSha256": { "$ref": "#/$defs/sha256" },
+    "evaluatorId": { "type": "string", "minLength": 1 },
+    "evaluatorRevision": { "$ref": "#/$defs/sha256" },
+    "promptSha256": { "$ref": "#/$defs/sha256" },
+    "predictions": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["presentationId", "presentationSha256", "contentChecks", "preferences"],
+        "properties": {
+          "presentationId": { "type": "string", "minLength": 1 },
+          "presentationSha256": { "$ref": "#/$defs/sha256" },
+          "contentChecks": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["left", "right"],
+            "properties": {
+              "left": { "$ref": "#/$defs/contentDecision" },
+              "right": { "$ref": "#/$defs/contentDecision" }
+            }
+          },
+          "preferences": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["naturalness", "clarity", "taskUtility", "voice"],
+            "properties": {
+              "naturalness": { "$ref": "#/$defs/preferenceDecision" },
+              "clarity": { "$ref": "#/$defs/preferenceDecision" },
+              "taskUtility": { "$ref": "#/$defs/preferenceDecision" },
+              "voice": { "$ref": "#/$defs/preferenceDecision" }
+            }
+          }
+        }
+      }
+    }
+  },
+  "$defs": {
+    "sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" },
+    "confidence": { "type": "number", "minimum": 0, "maximum": 1 },
+    "contentDecision": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["choice", "confidence"],
+      "properties": {
+        "choice": { "enum": ["pass", "fail", "abstain"] },
+        "confidence": { "$ref": "#/$defs/confidence" }
+      }
+    },
+    "preferenceDecision": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["choice", "confidence"],
+      "properties": {
+        "choice": { "enum": ["left", "right", "tie", "abstain"] },
+        "confidence": { "$ref": "#/$defs/confidence" }
+      }
+    }
+  }
+}

package/data/panelReviewBatch.schema.json

@@ -0,0 +1,79 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://hanlint.dev/schemas/panelReviewBatch.schema.json",
+  "title": "hanlint writing arena human review batch",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["version", "kind", "suiteSha256", "rubricSha256", "evaluator", "reviews"],
+  "properties": {
+    "version": { "const": 1 },
+    "kind": { "const": "hanlint.panelReviewBatch" },
+    "suiteSha256": { "$ref": "#/$defs/sha256" },
+    "rubricSha256": { "$ref": "#/$defs/sha256" },
+    "evaluator": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "group", "protocolRevision"],
+      "properties": {
+        "id": { "type": "string", "minLength": 1 },
+        "group": {
+          "enum": ["targetReader", "professionalEditor", "koreanExpert", "generalReader"]
+        },
+        "protocolRevision": { "const": "hanlint.writingArena.panel.v1" }
+      }
+    },
+    "reviews": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["caseId", "caseSha256", "contentChecks", "preferences", "reasons"],
+        "properties": {
+          "caseId": { "type": "string", "minLength": 1 },
+          "caseSha256": { "$ref": "#/$defs/sha256" },
+          "contentChecks": { "$ref": "#/$defs/contentChecks" },
+          "preferences": { "$ref": "#/$defs/preferences" },
+          "reasons": { "$ref": "#/$defs/reasons" }
+        }
+      }
+    }
+  },
+  "$defs": {
+    "sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" },
+    "contentChoice": { "enum": ["pass", "fail", "cannotJudge"] },
+    "preferenceChoice": { "enum": ["left", "right", "tie", "cannotJudge"] },
+    "contentChecks": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["left", "right"],
+      "properties": {
+        "left": { "$ref": "#/$defs/contentChoice" },
+        "right": { "$ref": "#/$defs/contentChoice" }
+      }
+    },
+    "preferences": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["naturalness", "clarity", "taskUtility", "voice"],
+      "properties": {
+        "naturalness": { "$ref": "#/$defs/preferenceChoice" },
+        "clarity": { "$ref": "#/$defs/preferenceChoice" },
+        "taskUtility": { "$ref": "#/$defs/preferenceChoice" },
+        "voice": { "$ref": "#/$defs/preferenceChoice" }
+      }
+    },
+    "reasons": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["content", "naturalness", "clarity", "taskUtility", "voice"],
+      "properties": {
+        "content": { "type": "string", "minLength": 1 },
+        "naturalness": { "type": "string", "minLength": 1 },
+        "clarity": { "type": "string", "minLength": 1 },
+        "taskUtility": { "type": "string", "minLength": 1 },
+        "voice": { "type": "string", "minLength": 1 }
+      }
+    }
+  }
+}

package/data/panelTrialSet.schema.json

@@ -0,0 +1,44 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://hanlint.dev/schemas/panelTrialSet.schema.json",
+  "title": "hanlint writing arena panel trial set",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "version",
+    "kind",
+    "studyId",
+    "candidateStrategyId",
+    "provenance",
+    "trials",
+    "claimBoundary",
+    "trialSetSha256"
+  ],
+  "properties": {
+    "version": { "const": 1 },
+    "kind": { "const": "hanlint.panelTrialSet" },
+    "studyId": { "type": "string", "minLength": 1 },
+    "candidateStrategyId": { "type": "string", "minLength": 1 },
+    "provenance": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["origin", "license", "containsExternalReferenceText", "qualityLabels"],
+      "properties": {
+        "origin": { "type": "string", "minLength": 1 },
+        "license": { "type": "string", "minLength": 1 },
+        "containsExternalReferenceText": { "type": "boolean" },
+        "qualityLabels": { "const": false }
+      }
+    },
+    "trials": {
+      "type": "array",
+      "minItems": 1,
+      "items": { "$ref": "writingTrial.schema.json" }
+    },
+    "claimBoundary": { "type": "string", "minLength": 1 },
+    "trialSetSha256": { "$ref": "#/$defs/sha256" }
+  },
+  "$defs": {
+    "sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }
+  }
+}

package/data/patterns.json

@@ -0,0 +1,114 @@
+{
+  "entry": [
+    {
+      "name": "행동과 결과",
+      "form": "{대상}을 {행동}하면 {결과}가 {어디}에 {생깁니다}",
+      "when": "독자에게 무엇을 시킬 때. 가능성만 말하지 않고 손이 할 일과 눈에 보일 것을 한 문장에 담는다",
+      "example": "`저장` 버튼을 누르면 `report.csv` 가 그 폴더에 만들어집니다.",
+      "instead": "이 기능을 통해 파일 생성이 가능합니다.",
+      "avoids": [
+        "translationese"
+      ],
+      "source": "글쓰기 스킬의 쉬운 말로 바로 쓰기. 배상복 문장기술의 주어와 서술어를 붙여 쓰기"
+    },
+    {
+      "name": "확인",
+      "form": "{무엇}이 {어떤지} 확인합니다. {그 값}이 보이면 된 것입니다",
+      "when": "절을 닫을 때. 독자가 자기 화면에서 결과를 확인할 자리를 만든다",
+      "example": "폴더에 `link.png` 가 생겼는지 확인합니다. 파일이 보이면 된 것입니다.",
+      "instead": "결과가 저장되어집니다.",
+      "avoids": [
+        "doublePassive"
+      ],
+      "source": "글쓰기 스킬의 한 절을 다 읽으면 결과 하나가 남는다"
+    },
+    {
+      "name": "인과 잇기",
+      "form": "{앞 사실}입니다. 그래서 {뒤 사실}입니다",
+      "when": "사실이 둘 이상 나란히 놓일 때. 관계를 독자가 세우게 두지 않는다",
+      "example": "병합 셀은 첫 칸에만 값이 들어 있습니다. 그래서 그대로 정렬하면 빈 칸이 값과 떨어져 순서가 깨집니다.",
+      "instead": "값이 있습니다. 칸은 빕니다. 순서가 깨집니다.",
+      "avoids": [
+        "factListParagraph"
+      ],
+      "source": "글쓰기 스킬의 설명을 풀어 쓰기. 이수열의 문장은 이어져야 한다"
+    },
+    {
+      "name": "이름으로 이어받기",
+      "form": "{앞에서 만든 것}은 {상태}입니다. {아직 못 하는 일}입니다",
+      "when": "새 문단이나 새 절을 열 때. 지시어 대신 앞에서 만든 것의 이름을 부른다",
+      "example": "`link.png` 는 33픽셀입니다. 명함에 넣기에는 너무 작습니다.",
+      "instead": "터미널을 엽니다. 이것을 실행합니다.",
+      "avoids": [
+        "danglingDeixis"
+      ],
+      "source": "글쓰기 스킬의 절은 앞 절이 못 한 일에서 시작한다. 김정선의 것을 이름으로"
+    },
+    {
+      "name": "독자에게 묻기",
+      "form": "그럼 {무엇}은 {어디}에 {있을까요}? {답}",
+      "when": "독자가 품을 의문이 생기는 자리. 대신 묻고 다음 문장에서 답한다",
+      "example": "## 절\n\n파일을 만듭니다.\n\n## 다음 절\n\n그럼 파일은 어디에 생겼을까요? 방금 명령을 실행한 그 폴더에 있습니다.\n",
+      "instead": "## 절\n\n파일을 만듭니다.\n\n## 다음 절\n\n파일이 만들어집니다.\n",
+      "avoids": [
+        "noQuestion"
+      ],
+      "source": "글쓰기 스킬의 사실과 목소리"
+    },
+    {
+      "name": "값 소개",
+      "form": "{값}은 {무엇}입니다. {왜 그 값인지}. {지금 무엇을 하면 되는지}",
+      "when": "새 숫자나 옵션이 처음 나올 때. 셋 중 하나라도 못 적으면 그 값을 아직 넣을 때가 아니다",
+      "example": "`border` 는 그림 바깥에 남기는 빈 칸의 수입니다. 빈 자리가 없으면 카메라가 그림의 끝을 못 찾습니다. 그래서 기본값 4 를 그대로 둡니다.",
+      "instead": "메모리 최대치는 453MB에서 700MB로 올라갔습니다.",
+      "avoids": [
+        "numberOrphan"
+      ],
+      "source": "글쓰기 스킬의 새로 나온 값과 옵션은 세 가지를 그 자리에서 준다"
+    },
+    {
+      "name": "동사로 되돌리기",
+      "form": "{무엇}을 {한 뒤} {무엇}이 {어떤지} {확인합니다}",
+      "when": "명사가 셋 이상 이어질 때. 조사를 되살려 무엇이 무엇의 목적어인지 보인다",
+      "example": "가상환경을 만든 뒤 패키지가 깔렸는지 확인합니다.",
+      "instead": "가상환경 생성 후 패키지 설치 확인 절차를 따릅니다.",
+      "avoids": [
+        "nounPile"
+      ],
+      "source": "이오덕 우리글 바로쓰기의 명사문을 동사문으로. 글쓰기 스킬의 명사를 쌓지 말고 동사로 되돌린다"
+    },
+    {
+      "name": "결핍 도입",
+      "form": "{독자가 지금 하려는 일}입니다. {왜 지금 방법으로는 안 되는지}. 끝까지 읽으면 {손에 남는 것}이 남습니다",
+      "when": "글의 첫 문단. 정의로 시작하지 않고 독자가 막힌 자리로 시작한다",
+      "example": "거래 기록을 CSV로 내려받았더니 5백만 줄입니다. 엑셀로 열면 1,048,576줄에서 잘립니다. 끝까지 읽으면 그 표를 여는 코드가 손에 남습니다.",
+      "instead": "핵심은 속도입니다.",
+      "avoids": [
+        "cliche"
+      ],
+      "source": "글쓰기 스킬의 도입은 결핍부터. 이태준 문장강화의 첫머리"
+    },
+    {
+      "name": "수치 비교",
+      "form": "{A}는 {수치}, {B}는 {수치}입니다",
+      "when": "둘을 견줄 때. 형용사로 말하지 않고 잰 값을 나란히 놓는다",
+      "example": "같은 질문에 pandas 는 3.7초, Polars 는 0.18초가 걸립니다.",
+      "instead": "속도는 조금 느려집니다...",
+      "avoids": [
+        "ellipsis"
+      ],
+      "source": "글쓰기 스킬의 수치와 인용은 직접 확인한 값만 쓴다"
+    },
+    {
+      "name": "미룬 것 회수",
+      "form": "앞에서 미룬 {이름}을 이제 봅니다",
+      "when": "뒤에서 다루겠다고 해 둔 것을 실제로 다루는 자리. 미뤘다는 사실을 밝히고 그 이름을 다시 부른다",
+      "example": "앞에서 미룬 `usecols` 를 이제 봅니다.",
+      "instead": "다음으로 크기를 바꿉니다.",
+      "avoids": [
+        "fillerOpener"
+      ],
+      "source": "글쓰기 스킬의 미룬 것은 같은 글 안에서 회수한다"
+    }
+  ]
+}