agent-safety-oss 1.8.4 → 1.9.0

package/CHANGELOG.md

@@ -5,6 +5,27 @@ All notable changes to `agent-safety-oss` are documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.9.0] — 2026-11-04
+
+산업안전보건법·관리비 고시·산업재해조사표를 현행으로 맞추고 취약점이 보고된 의존성을 올렸습니다.
+
+### 변경
+
+- **산업재해조사표를 현행 서식(2025. 10. 1. 개정)으로 바꿨습니다.** 주민등록번호는 앞 7자리만 적고, 다친 근로자의 주소·휴대전화와 산재보험급여 안내를 위한 개인정보 활용 동의 칸이 새로 생겼으며, 성별 칸은 없어졌습니다. 예전 형식으로 입력해도 오류 없이 처리합니다 — 성별 값은 무시하고, 13자리 주민등록번호는 앞 7자리만 남깁니다.
+- **건설업 산업안전보건관리비 계상 및 사용기준을 현행 고시(제2025-11호)로 바꿨습니다.** 공사 종류가 5종에서 4종(건축·토목·중건설·특수건설)으로 바뀌었고, 계상 요율·기초액과 사용 항목·항목별 상한도 현행을 따릅니다. 사업장 정보로 관리비를 자동으로 채울 때도 현행 요율표로 계산하며, 공사 종류를 판별하지 못하면 요율과 총액을 비워 둡니다.
+- Node.js 24·26 에서도 시험합니다. 지원 범위(Node.js 20.19 이상)는 그대로입니다.
+
+### 수정
+
+- **산업안전보건법을 현행 판(법률 제22122호, 2026-10-27 시행)으로 맞췄습니다.** 이미 시행 중인 제70조(폭염·한파)·제84조 개정 문구를 반영했고, 아직 시행되지 않은 개정은 본문에 섞지 않고 시행예정 일정으로만 표시합니다.
+- **조문 데이터를 법제처 현행 원문과 다시 대조했습니다.** 산업안전보건법·시행령·시행규칙·산업안전보건기준에 관한 규칙 조문 1,248건 중 문구가 달랐던 18건(예: 산업안전보건기준에 관한 규칙 제623조·제641조의 2025년 12월 개정 문구)을 현행 원문으로 고쳤습니다.
+- **열리지 않던 양식 원본 링크를 고쳤습니다.** 위험성평가·TBM 자료 링크는 산업안전포털의 KRAS 메뉴로, KOSHA 전자책 양식 2종과 기술지침 목록 링크는 현행 주소로 바꿨습니다. 작업환경측정 결과 제출처 안내도 시행규칙 제188조 문구로 바로잡았습니다.
+- KOSHA 가이드 D-1-2021 제목을 현행 목록 제목(「미압 배관에서의 폭연 방산구 설치에 관한 기술지침」)으로 고쳤습니다.
+
+### 보안
+
+- 취약점이 보고된 의존성(MCP SDK·zod 등)을 수정판으로 올렸습니다. 도구 목록과 입력 방식은 그대로입니다(위 산업재해조사표 변경 제외).
+
 ## [1.8.4] — 2026-09-28
 
 1.8.3 에서 법령 본문을 다시 맞춘 뒤, 조문 안에서 빠져 있던 항·호와 조문 첫 문장을 찾아 채웠습니다.

package/README.md

@@ -5,7 +5,7 @@
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](./LICENSE)
 [![Node](https://img.shields.io/badge/node-%3E%3D20.19-brightgreen)](https://nodejs.org)
 [![MCP](https://img.shields.io/badge/MCP-1.x-purple)](https://modelcontextprotocol.io)
-[![Release](https://img.shields.io/badge/release-v1.8.4-blue.svg)](./CHANGELOG.md)
+[![Release](https://img.shields.io/badge/release-v1.9.0-blue.svg)](./CHANGELOG.md)
 [![Tools](https://img.shields.io/badge/MCP%20tools-92-orange.svg)](./docs/IDENTITY.md)
 
 **건설현장의 법정 안전문서 작성을 더 빠르고 정확하게.** 산안법·기준규칙·중처법·KOSHA 기술지원규정(가이드)을 기반으로 안전관리자와 현장소장의 문서 작성과 검토를 돕는 오픈소스 도구입니다.
@@ -62,13 +62,13 @@ LLM은 이 그래프를 보고 문서를 작성하거나 설명할 수 있지만
 | 영역 | 내용 |
 |---|---|
 | **<!-- INV:DOCUMENTS_TOTAL -->19<!-- /INV:DOCUMENTS_TOTAL -->종 법정 안전관리 문서** | TBM · 작업계획서 · 위험성평가 · MSDS · 산재조사표 등 매일·매주·매월 작성하는 양식. docId 마스터 <!-- INV:DOCID_MASTER -->94<!-- /INV:DOCID_MASTER -->개 (19종 + 사이클·범위·발주처별 변형) |
-| **법령 <!-- INV:LAW_BUNDLE_COUNT -->10<!-- /INV:LAW_BUNDLE_COUNT -->건 핵심 조문** | 산안법 · 시행령 · 시행규칙 · 기준규칙 · 중처법 · 중처법 시행령 · 위험성평가 고시 · 건진법 등 합계 <!-- INV:LAW_ARTICLES -->79<!-- /INV:LAW_ARTICLES -->조 (전체 1,310조 중 건설안전 실무 핵심만 발췌. 전체 법령은 [법제처](https://www.law.go.kr) 직접 참조). 마지막 동기화: <!-- INV:LAW_LAST_SYNC -->2026-09-28<!-- /INV:LAW_LAST_SYNC --> |
+| **법령 <!-- INV:LAW_BUNDLE_COUNT -->10<!-- /INV:LAW_BUNDLE_COUNT -->건 핵심 조문** | 산안법 · 시행령 · 시행규칙 · 기준규칙 · 중처법 · 중처법 시행령 · 위험성평가 고시 · 건진법 등 합계 <!-- INV:LAW_ARTICLES -->79<!-- /INV:LAW_ARTICLES -->조 (전체 1,310조 중 건설안전 실무 핵심만 발췌. 전체 법령은 [법제처](https://www.law.go.kr) 직접 참조). 마지막 동기화: <!-- INV:LAW_LAST_SYNC -->2026-11-03<!-- /INV:LAW_LAST_SYNC --> |
 | **KOSHA 기술지원규정 (가이드) <!-- INV:KOSHA_BODY -->1,039<!-- /INV:KOSHA_BODY -->건** | 한국산업안전보건공단 발행 기술지침 전체 본문 (인터넷 없이 즉시 검색·인용) |
 | **양식 <!-- INV:FORMS_TOTAL -->132<!-- /INV:FORMS_TOTAL -->개** | 고용노동부·KOSHA 공식 HWP <!-- INV:FORMS_HWP -->14<!-- /INV:FORMS_HWP --> / PDF <!-- INV:FORMS_PDF -->23<!-- /INV:FORMS_PDF --> / XLSX <!-- INV:FORMS_XLSX -->1<!-- /INV:FORMS_XLSX --> 원본 + 자동 생성 Markdown 양식 <!-- INV:FORMS_MD -->94<!-- /INV:FORMS_MD -->개 (일부는 라이선스상 공식 다운로드 URL 안내로 대체) |
 | **MCP 도구 <!-- INV:TOOLS_TOTAL -->92<!-- /INV:TOOLS_TOTAL -->개** | 키 없이 바로 쓰는 <!-- INV:TOOLS_KEYLESS -->85<!-- /INV:TOOLS_KEYLESS -->개 + 공공 API 키 필요 <!-- INV:TOOLS_KEYREQ -->7<!-- /INV:TOOLS_KEYREQ -->개 (그중 <!-- INV:TOOLS_PLACEHOLDER -->2<!-- /INV:TOOLS_PLACEHOLDER -->개는 공공누리 라이선스 사유로 다운로드 URL 안내만 하는 placeholder) |
 | **위험·통제 정보망** | 작업 → 위험요인 → 통제대책 → 법령 근거 → 문서 자동 연결. 그래프 노드 <!-- INV:GRAPH_TOTAL -->3,375<!-- /INV:GRAPH_TOTAL -->개 (카테고리 1단계 <!-- INV:GRAPH_TOPLEVEL -->2,218<!-- /INV:GRAPH_TOPLEVEL --> + KOSHA Guide 1,039) · 엣지 약 <!-- INV:GRAPH_EDGES -->33,034<!-- /INV:GRAPH_EDGES --> · WorkActivity <!-- INV:GRAPH_ACTIVITIES -->41<!-- /INV:GRAPH_ACTIVITIES --> / Hazard <!-- INV:GRAPH_HAZARDS -->38<!-- /INV:GRAPH_HAZARDS --> / Control <!-- INV:GRAPH_CONTROLS -->50<!-- /INV:GRAPH_CONTROLS --> |
 
-→ 위 자료들이 **서로 연결**되어 있어, "굴착 작업"이라는 한 단어만 알면 적용 법령·KOSHA 가이드·위험·통제·양식이 자동으로 따라옵니다. (패키지 버전: <!-- INV:VERSION -->1.8.4<!-- /INV:VERSION -->)
+→ 위 자료들이 **서로 연결**되어 있어, "굴착 작업"이라는 한 단어만 알면 적용 법령·KOSHA 가이드·위험·통제·양식이 자동으로 따라옵니다. (패키지 버전: <!-- INV:VERSION -->1.9.0<!-- /INV:VERSION -->)
 
 ## 시작하기
 

package/build/evidence/evidence.schema.d.ts

@@ -2,32 +2,32 @@ import { z } from "zod";
 import { BASIS_TYPES, LEGAL_WEIGHTS, EVIDENCE_SOURCES } from "../config/constants.js";
 export { BASIS_TYPES, LEGAL_WEIGHTS, EVIDENCE_SOURCES };
 export declare const EvidenceItemSchema: z.ZodObject<{
-    basisType: z.ZodEnum<["law", "regulation", "kosha_guide", "accident_case", "safety_material", "msds", "statistics", "ppe_certification"]>;
-    legalWeight: z.ZodEnum<["mandatory", "recommended", "reference"]>;
+    basisType: z.ZodEnum<{
+        law: "law";
+        regulation: "regulation";
+        kosha_guide: "kosha_guide";
+        accident_case: "accident_case";
+        safety_material: "safety_material";
+        msds: "msds";
+        statistics: "statistics";
+        ppe_certification: "ppe_certification";
+    }>;
+    legalWeight: z.ZodEnum<{
+        mandatory: "mandatory";
+        recommended: "recommended";
+        reference: "reference";
+    }>;
     title: z.ZodString;
-    source: z.ZodEnum<["KOSHA", "DATA_GO_KR", "LAW_MCP", "INTERNAL"]>;
+    source: z.ZodEnum<{
+        KOSHA: "KOSHA";
+        DATA_GO_KR: "DATA_GO_KR";
+        LAW_MCP: "LAW_MCP";
+        INTERNAL: "INTERNAL";
+    }>;
     url: z.ZodOptional<z.ZodString>;
     reference: z.ZodOptional<z.ZodString>;
     snippet: z.ZodOptional<z.ZodString>;
     retrievedAt: z.ZodOptional<z.ZodString>;
-}, "strip", z.ZodTypeAny, {
-    title: string;
-    source: "KOSHA" | "DATA_GO_KR" | "LAW_MCP" | "INTERNAL";
-    basisType: "law" | "regulation" | "kosha_guide" | "accident_case" | "safety_material" | "msds" | "statistics" | "ppe_certification";
-    legalWeight: "mandatory" | "recommended" | "reference";
-    reference?: string | undefined;
-    url?: string | undefined;
-    snippet?: string | undefined;
-    retrievedAt?: string | undefined;
-}, {
-    title: string;
-    source: "KOSHA" | "DATA_GO_KR" | "LAW_MCP" | "INTERNAL";
-    basisType: "law" | "regulation" | "kosha_guide" | "accident_case" | "safety_material" | "msds" | "statistics" | "ppe_certification";
-    legalWeight: "mandatory" | "recommended" | "reference";
-    reference?: string | undefined;
-    url?: string | undefined;
-    snippet?: string | undefined;
-    retrievedAt?: string | undefined;
-}>;
+}, z.core.$strip>;
 export type EvidenceItemT = z.infer<typeof EvidenceItemSchema>;
 //# sourceMappingURL=evidence.schema.d.ts.map

package/build/evidence/evidence.schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"evidence.schema.d.ts","sourceRoot":"","sources":["../../src/evidence/evidence.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,WAAW,EACX,aAAa,EACb,gBAAgB,EACjB,MAAM,wBAAwB,CAAC;AAIhC,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,gBAAgB,EAAE,CAAC;AAIxD,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;EAS7B,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC"}
+{"version":3,"file":"evidence.schema.d.ts","sourceRoot":"","sources":["../../src/evidence/evidence.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,WAAW,EACX,aAAa,EACb,gBAAgB,EACjB,MAAM,wBAAwB,CAAC;AAIhC,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,gBAAgB,EAAE,CAAC;AAIxD,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAS7B,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC"}

package/build/lib/input-migrations.d.ts

@@ -0,0 +1,32 @@
+/**
+ * input-migrations.ts — 양식 개정으로 없어지거나 형식이 바뀐 입력 칸 처리
+ *
+ * 문서 노드 _meta.inputMigrations 에 선언된 규칙을 draft 에 적용한다 (규칙은 노드가, 적용은 코드가).
+ * 옛 입력 키를 넘긴 호출이 오류로 끝나지 않게 하는 것이 목적이다.
+ *
+ *   - drop              : 그 칸이 서식에서 사라졌다 — 값을 지우고 무시한 사실을 기록한다
+ *   - keepLeadingDigits : 숫자 앞 N 자리만 받는다 — 더 긴 값이 오면 앞 N 자리만 남기고 나머지는 *로 가린다
+ *                         (예: 주민등록번호 13자리 → "830101-1******")
+ */
+export type InputMigrationRule = {
+    key: string;
+    action: "drop";
+    reason?: string;
+} | {
+    key: string;
+    action: "keepLeadingDigits";
+    digits: number;
+    reason?: string;
+};
+export interface InputMigrationNote {
+    key: string;
+    action: InputMigrationRule["action"];
+    detail: string;
+}
+/** 노드에서 규칙을 꺼낸다 — 형식이 맞지 않는 규칙은 버린다 */
+export declare function readInputMigrations(doc: unknown): InputMigrationRule[];
+/** 숫자 앞 N 자리만 남긴 표기 — 6자리 뒤에 하이픈, 남은 자리는 * (13자리 기준) */
+export declare function keepLeadingDigits(value: string, digits: number): string | null;
+/** draft(와 draft.raw)에 규칙을 적용하고, 바꾼 내용을 돌려준다 */
+export declare function applyInputMigrations(draft: Record<string, unknown> | undefined, rules: InputMigrationRule[]): InputMigrationNote[];
+//# sourceMappingURL=input-migrations.d.ts.map

package/build/lib/input-migrations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"input-migrations.d.ts","sourceRoot":"","sources":["../../src/lib/input-migrations.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAOH,MAAM,MAAM,kBAAkB,GAC1B;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAChD;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,mBAAmB,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAElF,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,kBAAkB,CAAC,QAAQ,CAAC,CAAC;IACrC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,uCAAuC;AACvC,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,OAAO,GAAG,kBAAkB,EAAE,CAStE;AAED,wDAAwD;AACxD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAS9E;AAED,gDAAgD;AAChD,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAC1C,KAAK,EAAE,kBAAkB,EAAE,GAC1B,kBAAkB,EAAE,CAwBtB"}

package/build/lib/input-migrations.js

@@ -0,0 +1,70 @@
+/**
+ * input-migrations.ts — 양식 개정으로 없어지거나 형식이 바뀐 입력 칸 처리
+ *
+ * 문서 노드 _meta.inputMigrations 에 선언된 규칙을 draft 에 적용한다 (규칙은 노드가, 적용은 코드가).
+ * 옛 입력 키를 넘긴 호출이 오류로 끝나지 않게 하는 것이 목적이다.
+ *
+ *   - drop              : 그 칸이 서식에서 사라졌다 — 값을 지우고 무시한 사실을 기록한다
+ *   - keepLeadingDigits : 숫자 앞 N 자리만 받는다 — 더 긴 값이 오면 앞 N 자리만 남기고 나머지는 *로 가린다
+ *                         (예: 주민등록번호 13자리 → "830101-1******")
+ */
+// ── 상수 ────────────────────────────────────────────────────────────
+const MASK_CHAR = "*";
+/** 주민등록번호·외국인등록번호 형태(생년월일 6자리 + 뒷자리)일 때 하이픈을 넣는 위치 */
+const BIRTHDATE_DIGITS = 6;
+/** 노드에서 규칙을 꺼낸다 — 형식이 맞지 않는 규칙은 버린다 */
+export function readInputMigrations(doc) {
+    const rules = doc?._meta?.inputMigrations;
+    if (!Array.isArray(rules))
+        return [];
+    return rules.filter((r) => {
+        if (!r || typeof r !== "object" || typeof r.key !== "string")
+            return false;
+        const a = r.action;
+        if (a === "drop")
+            return true;
+        return a === "keepLeadingDigits" && Number.isInteger(r.digits);
+    });
+}
+/** 숫자 앞 N 자리만 남긴 표기 — 6자리 뒤에 하이픈, 남은 자리는 * (13자리 기준) */
+export function keepLeadingDigits(value, digits) {
+    const only = value.replace(/\D/g, "");
+    if (only.length <= digits)
+        return null; // 이미 N 자리 이하 — 바꾸지 않는다
+    const kept = only.slice(0, digits);
+    const masked = MASK_CHAR.repeat(only.length - digits);
+    if (digits > BIRTHDATE_DIGITS) {
+        return `${kept.slice(0, BIRTHDATE_DIGITS)}-${kept.slice(BIRTHDATE_DIGITS)}${masked}`;
+    }
+    return `${kept}${masked}`;
+}
+/** draft(와 draft.raw)에 규칙을 적용하고, 바꾼 내용을 돌려준다 */
+export function applyInputMigrations(draft, rules) {
+    const notes = [];
+    if (!draft || rules.length === 0)
+        return notes;
+    const containers = [draft];
+    if (draft.raw && typeof draft.raw === "object")
+        containers.push(draft.raw);
+    for (const rule of rules) {
+        for (const box of containers) {
+            if (!(rule.key in box))
+                continue;
+            if (rule.action === "drop") {
+                delete box[rule.key];
+                notes.push({ key: rule.key, action: rule.action, detail: rule.reason ?? "현행 서식에 없는 칸 — 무시" });
+                continue;
+            }
+            const v = box[rule.key];
+            if (typeof v !== "string" && typeof v !== "number")
+                continue;
+            const next = keepLeadingDigits(String(v), rule.digits);
+            if (next !== null) {
+                box[rule.key] = next;
+                notes.push({ key: rule.key, action: rule.action, detail: rule.reason ?? `앞 ${rule.digits}자리만 남김` });
+            }
+        }
+    }
+    return notes;
+}
+//# sourceMappingURL=input-migrations.js.map

package/build/lib/input-migrations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"input-migrations.js","sourceRoot":"","sources":["../../src/lib/input-migrations.ts"],"names":[],"mappings":"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"}

package/build/lib/osh-cost.d.ts

@@ -0,0 +1,43 @@
+/**
+ * osh-cost.ts — 건설업 산업안전보건관리비 계상 계산
+ *
+ * 요율·기초액은 코드에 두지 않는다 — 관리비 사용계획서 문서 노드(safety_health_mgmt_cost_plan)의
+ * calculationBasis.rateTable(고시 별표 1)에서 읽어 계산만 한다 (그래프가 법적 사실의 SSoT).
+ *
+ * 근거: 건설업 산업안전보건관리비 계상 및 사용기준(고용노동부 고시) 제4조제1항
+ *   1. 대상액 5억 원 미만 또는 50억 원 이상: 대상액 × 별표 1 비율
+ *   2. 대상액 5억 원 이상 50억 원 미만: 대상액 × 별표 1 비율 + 기초액
+ *   3. 대상액이 명확하지 않은 경우: 총공사금액의 10분의 7 을 대상액으로 한다
+ * 금액은 원 단위 정수로 다룬다(비율은 만분율 정수로 곱해 부동소수 오차를 피한다).
+ */
+/** 고시 별표 1 한 줄 — 비율은 % 값(예: 2.28) */
+export interface OshCostRateRow {
+    type: string;
+    keywords: string[];
+    matchOrder?: number;
+    under500M: number;
+    from500MTo5B: number;
+    baseAmount: number;
+    over5B: number;
+    healthManagerSite: number;
+}
+export interface OshCostResult {
+    type: string;
+    baseAmount: number;
+    baseEstimated: boolean;
+    ratePercent: number;
+    fixedAmount: number;
+    total: number;
+    bracket: "5억 원 미만" | "5억 원 이상 50억 원 미만" | "50억 원 이상";
+}
+/** 공사 종류 문자열에서 별표 1 공사종류를 찾는다 — 못 찾으면 undefined (추측해 채우지 않는다) */
+export declare function matchRateRow(constructionType: string | undefined, table: OshCostRateRow[]): OshCostRateRow | undefined;
+/** 총공사금액 → 대상액 추정 (대상액이 명확하지 않은 경우, 10분의 7) */
+export declare function estimateBaseFromContract(contractAmount: number): number;
+export declare function computeOshCost(row: OshCostRateRow, baseAmount: number, options?: {
+    healthManagerSite?: boolean;
+    baseEstimated?: boolean;
+}): OshCostResult;
+/** 문서 노드의 calculationBasis 에서 요율표를 꺼낸다 (형식이 맞지 않으면 빈 배열) */
+export declare function readRateTable(node: unknown): OshCostRateRow[];
+//# sourceMappingURL=osh-cost.d.ts.map

package/build/lib/osh-cost.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"osh-cost.d.ts","sourceRoot":"","sources":["../../src/lib/osh-cost.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AASH,qCAAqC;AACrC,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,OAAO,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,SAAS,GAAG,kBAAkB,GAAG,UAAU,CAAC;CACtD;AAOD,iEAAiE;AACjE,wBAAgB,YAAY,CAAC,gBAAgB,EAAE,MAAM,GAAG,SAAS,EAAE,KAAK,EAAE,cAAc,EAAE,GAAG,cAAc,GAAG,SAAS,CAMtH;AAED,+CAA+C;AAC/C,wBAAgB,wBAAwB,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,CAEvE;AAED,wBAAgB,cAAc,CAC5B,GAAG,EAAE,cAAc,EACnB,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE;IAAE,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAAC,aAAa,CAAC,EAAE,OAAO,CAAA;CAAO,GACrE,aAAa,CA0Bf;AAED,4DAA4D;AAC5D,wBAAgB,aAAa,CAAC,IAAI,EAAE,OAAO,GAAG,cAAc,EAAE,CAS7D"}

package/build/lib/osh-cost.js

@@ -0,0 +1,74 @@
+/**
+ * osh-cost.ts — 건설업 산업안전보건관리비 계상 계산
+ *
+ * 요율·기초액은 코드에 두지 않는다 — 관리비 사용계획서 문서 노드(safety_health_mgmt_cost_plan)의
+ * calculationBasis.rateTable(고시 별표 1)에서 읽어 계산만 한다 (그래프가 법적 사실의 SSoT).
+ *
+ * 근거: 건설업 산업안전보건관리비 계상 및 사용기준(고용노동부 고시) 제4조제1항
+ *   1. 대상액 5억 원 미만 또는 50억 원 이상: 대상액 × 별표 1 비율
+ *   2. 대상액 5억 원 이상 50억 원 미만: 대상액 × 별표 1 비율 + 기초액
+ *   3. 대상액이 명확하지 않은 경우: 총공사금액의 10분의 7 을 대상액으로 한다
+ * 금액은 원 단위 정수로 다룬다(비율은 만분율 정수로 곱해 부동소수 오차를 피한다).
+ */
+// ── 상수 ────────────────────────────────────────────────────────────
+const FIVE_HUNDRED_MILLION = 500_000_000;
+const FIVE_BILLION = 5_000_000_000;
+/** 대상액이 명확하지 않을 때 총공사금액에 곱하는 비율 (고시 제4조제1항제3호: 10분의 7) */
+const UNCLEAR_BASE_NUMERATOR = 7;
+const UNCLEAR_BASE_DENOMINATOR = 10;
+/** % 값을 만분율 정수로 (2.28 → 228) */
+function toBasisPoints(percent) {
+    return Math.round(percent * 100);
+}
+/** 공사 종류 문자열에서 별표 1 공사종류를 찾는다 — 못 찾으면 undefined (추측해 채우지 않는다) */
+export function matchRateRow(constructionType, table) {
+    if (!constructionType)
+        return undefined;
+    const t = constructionType.replace(/\s+/g, "");
+    // 판별 순서는 노드의 matchOrder(작을수록 먼저) — 별표 5 상 더 구체적인 공사종류(중건설·특수건설)를 먼저 본다
+    const ordered = [...table].sort((a, b) => (a.matchOrder ?? 99) - (b.matchOrder ?? 99));
+    return ordered.find((row) => row.keywords.some((k) => t.includes(k.replace(/\s+/g, ""))));
+}
+/** 총공사금액 → 대상액 추정 (대상액이 명확하지 않은 경우, 10분의 7) */
+export function estimateBaseFromContract(contractAmount) {
+    return Math.floor((contractAmount * UNCLEAR_BASE_NUMERATOR) / UNCLEAR_BASE_DENOMINATOR);
+}
+export function computeOshCost(row, baseAmount, options = {}) {
+    const base = Math.max(0, Math.floor(baseAmount));
+    let ratePercent;
+    let fixedAmount = 0;
+    let bracket;
+    if (base < FIVE_HUNDRED_MILLION) {
+        ratePercent = row.under500M;
+        bracket = "5억 원 미만";
+    }
+    else if (base < FIVE_BILLION) {
+        ratePercent = row.from500MTo5B;
+        fixedAmount = row.baseAmount;
+        bracket = "5억 원 이상 50억 원 미만";
+    }
+    else {
+        ratePercent = options.healthManagerSite ? row.healthManagerSite : row.over5B;
+        bracket = "50억 원 이상";
+    }
+    const total = Math.floor((base * toBasisPoints(ratePercent)) / 10_000) + fixedAmount;
+    return {
+        type: row.type,
+        baseAmount: base,
+        baseEstimated: options.baseEstimated ?? false,
+        ratePercent,
+        fixedAmount,
+        total,
+        bracket,
+    };
+}
+/** 문서 노드의 calculationBasis 에서 요율표를 꺼낸다 (형식이 맞지 않으면 빈 배열) */
+export function readRateTable(node) {
+    const basis = node?.calculationBasis;
+    if (!basis || !Array.isArray(basis.rateTable))
+        return [];
+    return basis.rateTable.filter((r) => typeof r?.type === "string" &&
+        Array.isArray(r.keywords) &&
+        [r.under500M, r.from500MTo5B, r.baseAmount, r.over5B, r.healthManagerSite].every((v) => typeof v === "number"));
+}
+//# sourceMappingURL=osh-cost.js.map

package/build/lib/osh-cost.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"osh-cost.js","sourceRoot":"","sources":["../../src/lib/osh-cost.ts"],"names":[],"mappings":"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"}

package/build/lib/schema-introspection.d.ts

@@ -2,20 +2,27 @@
  * schema-introspection.ts
  *
  * Issue #3 / #4 (2026-05-21) — CLI 가 도구 inputSchema 의 expected type 을 알 수 있도록
- * Zod schema 를 단순 JSON 메타로 변환. 의존성 0 원칙 — `zod-to-json-schema` 미사용.
+ * Zod schema 를 단순 JSON 메타로 변환. 의존성 0 원칙 — 별도 JSON Schema 변환기 미사용.
  *
  * 두 가지 사용처:
  *   1. Issue #3 — parseKeyValueArgs 에서 각 키의 expected type 확인 후 coerce 결정.
  *      예: industryCode: ZodString 이면 "41" 을 string 으로 보존 (Number 변환 X).
  *   2. Issue #4 — tools --json / describe 출력에 properties · required 노출.
+ *
+ * zod 4 기준: 스키마 종류는 `_zod.def.type`, 설명은 `schema.description`(전역 메타 레지스트리).
+ *   - .preprocess() 와 .transform() 은 모두 pipe(in → out) 로 표현된다.
+ *     preprocess = pipe(transform → 실제 스키마), transform = pipe(실제 스키마 → transform).
+ *     본질 타입은 transform 이 아닌 쪽이다.
+ *   - .refine() 은 래퍼를 만들지 않고 같은 스키마에 검사로 붙는다.
  */
 import type { z } from "zod";
-export declare function unwrapZodType(schema: z.ZodTypeAny): z.ZodTypeAny;
-export declare function isOptional(schema: z.ZodTypeAny): boolean;
+type AnySchema = z.ZodType;
+export declare function unwrapZodType(schema: AnySchema): AnySchema;
+export declare function isOptional(schema: AnySchema): boolean;
 export type FieldKind = "string" | "number" | "boolean" | "array" | "object" | "enum" | "unknown";
-export declare function getFieldKind(schema: z.ZodTypeAny): FieldKind;
-export declare function getDescription(schema: z.ZodTypeAny): string | undefined;
-export declare function getObjectShape(schema: z.ZodTypeAny): Record<string, z.ZodTypeAny> | null;
+export declare function getFieldKind(schema: AnySchema): FieldKind;
+export declare function getDescription(schema: AnySchema): string | undefined;
+export declare function getObjectShape(schema: AnySchema): Record<string, AnySchema> | null;
 export interface FieldMeta {
     type: FieldKind;
     optional: boolean;
@@ -24,11 +31,12 @@ export interface FieldMeta {
     default?: unknown;
     itemsType?: FieldKind;
 }
-export declare function fieldToMeta(schema: z.ZodTypeAny): FieldMeta;
+export declare function fieldToMeta(schema: AnySchema): FieldMeta;
 export interface ToolInputMeta {
     type: "object";
     properties: Record<string, FieldMeta>;
     required: string[];
 }
-export declare function toolInputToMeta(schema: z.ZodTypeAny): ToolInputMeta;
+export declare function toolInputToMeta(schema: AnySchema): ToolInputMeta;
+export {};
 //# sourceMappingURL=schema-introspection.d.ts.map

package/build/lib/schema-introspection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema-introspection.d.ts","sourceRoot":"","sources":["../../src/lib/schema-introspection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAwC7B,wBAAgB,aAAa,CAAC,MAAM,EAAE,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,UAAU,CAqBhE;AAGD,wBAAgB,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC,UAAU,GAAG,OAAO,CAIxD;AAGD,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,GAAG,SAAS,CAAC;AAElG,wBAAgB,YAAY,CAAC,MAAM,EAAE,CAAC,CAAC,UAAU,GAAG,SAAS,CA0B5D;AAGD,wBAAgB,cAAc,CAAC,MAAM,EAAE,CAAC,CAAC,UAAU,GAAG,MAAM,GAAG,SAAS,CAiBvE;AAGD,wBAAgB,cAAc,CAAC,MAAM,EAAE,CAAC,CAAC,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,UAAU,CAAC,GAAG,IAAI,CAMxF;AAGD,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,SAAS,CAAC;IAChB,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,CAAC,CAAC,UAAU,GAAG,SAAS,CAiC3D;AAGD,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,QAAQ,CAAC;IACf,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACtC,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,CAAC,CAAC,UAAU,GAAG,aAAa,CAWnE"}
+{"version":3,"file":"schema-introspection.d.ts","sourceRoot":"","sources":["../../src/lib/schema-introspection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAO7B,KAAK,SAAS,GAAG,CAAC,CAAC,OAAO,CAAC;AAiC3B,wBAAgB,aAAa,CAAC,MAAM,EAAE,SAAS,GAAG,SAAS,CAmB1D;AAGD,wBAAgB,UAAU,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAIrD;AAGD,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,GAAG,SAAS,CAAC;AAElG,wBAAgB,YAAY,CAAC,MAAM,EAAE,SAAS,GAAG,SAAS,CA0BzD;AAGD,wBAAgB,cAAc,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,GAAG,SAAS,CAqBpE;AAGD,wBAAgB,cAAc,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,IAAI,CAKlF;AAGD,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,SAAS,CAAC;IAChB,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,SAAS,GAAG,SAAS,CAoCxD;AAGD,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,QAAQ,CAAC;IACf,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACtC,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,GAAG,aAAa,CAWhE"}

package/build/lib/schema-introspection.js

@@ -1,60 +1,75 @@
+// 파일 최상단 상수 — 래퍼 해제 최대 깊이
+const MAX_UNWRAP_DEPTH = 8;
+const MAX_DEFAULT_DEPTH = 4;
+const OPTIONAL_WRAPPERS = new Set(["optional", "default", "nullable"]);
 function getDef(schema) {
     if (!schema || typeof schema !== "object")
         return undefined;
-    return schema._def;
+    return schema._zod?.def;
 }
-// Optional/Default/Nullable/Effects/Pipeline wrapping 을 모두 풀어 본질 타입을 반환.
+function getOwnDescription(schema) {
+    if (!schema)
+        return undefined;
+    const d = schema.description;
+    return typeof d === "string" ? d : undefined;
+}
+// pipe 의 본질 쪽 — transform 이 아닌 쪽 (preprocess 는 out, transform 은 in)
+function pipeEssence(def) {
+    const outType = getDef(def.out)?.type;
+    if (outType === "transform")
+        return def.in;
+    return def.out;
+}
+// Optional/Default/Nullable/pipe(preprocess·transform) 래핑을 모두 풀어 본질 타입을 반환.
 export function unwrapZodType(schema) {
     let cur = schema;
-    for (let i = 0; i < 8 && cur; i += 1) {
+    for (let i = 0; i < MAX_UNWRAP_DEPTH && cur; i += 1) {
         const def = getDef(cur);
         if (!def)
             break;
-        const t = def.typeName;
-        if (t === "ZodOptional" || t === "ZodDefault" || t === "ZodNullable") {
+        if (def.type && OPTIONAL_WRAPPERS.has(def.type) && def.innerType) {
             cur = def.innerType;
             continue;
         }
-        if (t === "ZodEffects" && def.schema) {
-            cur = def.schema;
-            continue;
-        }
-        if (t === "ZodPipeline" && def.out) {
-            cur = def.out;
-            continue;
+        if (def.type === "pipe") {
+            const next = pipeEssence(def);
+            if (next) {
+                cur = next;
+                continue;
+            }
         }
         break;
     }
     return cur ?? schema;
 }
-// 필드가 optional 인지 (Optional 또는 Default 래퍼)
+// 필드가 optional 인지 (Optional 또는 Default 또는 Nullable 래퍼)
 export function isOptional(schema) {
     const def = getDef(schema);
-    if (!def)
+    if (!def || !def.type)
         return false;
-    return def.typeName === "ZodOptional" || def.typeName === "ZodDefault" || def.typeName === "ZodNullable";
+    return OPTIONAL_WRAPPERS.has(def.type);
 }
 export function getFieldKind(schema) {
     const unwrapped = unwrapZodType(schema);
     const def = getDef(unwrapped);
     if (!def)
         return "unknown";
-    switch (def.typeName) {
-        case "ZodString":
+    switch (def.type) {
+        case "string":
             return "string";
-        case "ZodNumber":
+        case "number":
             return "number";
-        case "ZodBoolean":
+        case "boolean":
             return "boolean";
-        case "ZodArray":
+        case "array":
             return "array";
-        case "ZodObject":
-        case "ZodRecord":
+        case "object":
+        case "record":
             return "object";
-        case "ZodEnum":
-        case "ZodLiteral":
+        case "enum":
+        case "literal":
             return "enum";
-        case "ZodUnion":
+        case "union":
             // union 의 첫 옵션을 따라감 (CLI 단순화)
             if (def.options && def.options.length > 0)
                 return getFieldKind(def.options[0]);
@@ -63,35 +78,38 @@ export function getFieldKind(schema) {
             return "unknown";
     }
 }
-// description 추출 (Optional/Default 래퍼 통과)
+// description 추출 (Optional/Default/Nullable·pipe 래퍼 통과 — 바깥 설명 우선)
 export function getDescription(schema) {
     let cur = schema;
-    for (let i = 0; i < 8 && cur; i += 1) {
+    for (let i = 0; i < MAX_UNWRAP_DEPTH && cur; i += 1) {
+        const own = getOwnDescription(cur);
+        if (own)
+            return own;
         const def = getDef(cur);
         if (!def)
             break;
-        if (def.description)
-            return def.description;
-        if (def.typeName === "ZodOptional" || def.typeName === "ZodDefault" || def.typeName === "ZodNullable") {
+        if (def.type && OPTIONAL_WRAPPERS.has(def.type) && def.innerType) {
             cur = def.innerType;
             continue;
         }
-        if (def.typeName === "ZodEffects" && def.schema) {
-            cur = def.schema;
-            continue;
+        if (def.type === "pipe") {
+            const next = pipeEssence(def);
+            if (next) {
+                cur = next;
+                continue;
+            }
         }
         break;
     }
     return undefined;
 }
-// ZodObject shape 추출 (Effects/Pipeline wrap 포함)
+// ZodObject shape 추출 (pipe·optional 래핑 포함)
 export function getObjectShape(schema) {
     const unwrapped = unwrapZodType(schema);
     const def = getDef(unwrapped);
-    if (!def || def.typeName !== "ZodObject" || !def.shape)
+    if (!def || def.type !== "object" || !def.shape)
         return null;
-    const raw = typeof def.shape === "function" ? def.shape() : def.shape;
-    return raw;
+    return def.shape;
 }
 export function fieldToMeta(schema) {
     const optional = isOptional(schema);
@@ -99,21 +117,21 @@ export function fieldToMeta(schema) {
     const def = getDef(unwrapped);
     const kind = getFieldKind(unwrapped);
     const description = getDescription(schema);
-    // Default 값 추출
+    // Default 값 추출 (바깥 Optional/Nullable 은 통과)
     let defaultValue;
     let cur = schema;
-    for (let i = 0; i < 4 && cur; i += 1) {
+    for (let i = 0; i < MAX_DEFAULT_DEPTH && cur; i += 1) {
         const d = getDef(cur);
         if (!d)
             break;
-        if (d.typeName === "ZodDefault" && d.defaultValue) {
+        if (d.type === "default") {
             try {
-                defaultValue = d.defaultValue();
+                defaultValue = cur._zod.def.defaultValue;
             }
             catch { }
             break;
         }
-        if (d.typeName === "ZodOptional" || d.typeName === "ZodNullable") {
+        if (d.type === "optional" || d.type === "nullable") {
             cur = d.innerType;
             continue;
         }
@@ -122,10 +140,12 @@ export function fieldToMeta(schema) {
     const meta = { type: kind, optional, description };
     if (defaultValue !== undefined)
         meta.default = defaultValue;
-    if (kind === "enum" && def?.values)
-        meta.enumValues = def.values;
-    if (kind === "array" && def?.type)
-        meta.itemsType = getFieldKind(def.type);
+    // 열거값은 z.enum 만 노출 (literal 은 단일값이라 노출하지 않음 — 기존 동작 유지)
+    if (kind === "enum" && def?.type === "enum" && def.entries) {
+        meta.enumValues = Object.values(def.entries).map((v) => String(v));
+    }
+    if (kind === "array" && def?.element)
+        meta.itemsType = getFieldKind(def.element);
     return meta;
 }
 export function toolInputToMeta(schema) {