Skip to content

Releases: ratelworks/agent-safety-oss

v1.6.1 — 문서 재정리 + 버전 표시 수정

10 Jun 00:47
@ratelworks ratelworks
v1.6.1
4e61f2d

Choose a tag to compare

View all tags
v1.6.1 — 문서 재정리 + 버전 표시 수정 Latest
Latest

문서를 처음 보는 분 기준으로 다시 정리하고, 도구가 표시하는 버전 오류를 바로잡은 안정화 릴리즈입니다.

무엇이 좋아졌나

  • README 전면 재정리 — 처음 방문해도 길을 잃지 않도록 목차를 추가하고, 여러 곳에 흩어져 있던 시작 방법·구성 요소 안내를 한 곳으로 모았습니다. 브라우저 입력 폼이 실제로 어떻게 생겼는지 화면 캡처로 바로 확인할 수 있습니다.
  • 버전 표시 수정 — 도구가 자신을 이전 버전(v1.5.0)으로 표시하던 문제를 바로잡았습니다. AI 비서 연결 화면과 명령어 실행 결과에 실제 버전이 표시됩니다. 같은 문제가 재발하지 않도록 릴리즈 전 자동 검사도 추가했습니다.
  • 데이터 출처 안내 정리 — 어떤 공공 데이터가 연결되어 있고 앞으로 무엇이 추가될 수 있는지 데이터 출처 문서 한 곳에서 볼 수 있습니다.
  • AI 코딩 도구 공통 안내 추가 — 기여자가 Claude Code·Codex CLI·Cursor 등 어떤 도구를 쓰든 같은 규칙(AGENTS.md)을 안내받습니다.

설치 / 업그레이드

처음 시작 (Node.js 20.19+ 만 있으면 됩니다):

npx -y agent-safety-oss viewer   # 브라우저 입력 폼이 바로 열립니다

Claude Desktop / Codex CLI 연결은 README의 "시작하기"를 따라 하면 됩니다. npx 로 쓰고 있다면 다음 실행 때 자동으로 최신 버전을 받습니다. 전역 설치 사용자는:

npm install -g agent-safety-oss@latest

호환성에 영향을 주는 변경(breaking change)은 없습니다.

  • 제공: 황룡건설(주) 안전보건기획부 · 개발: 주식회사 라텔웍스 (Ratelworks Inc.)
  • 전체 변경 내역: CHANGELOG.md
Assets 2
Loading

v1.6.0 — 브라우저 입력 폼을 명령어 한 줄로

01 Jun 01:03
@ratelworks ratelworks
v1.6.0
d67b945

Choose a tag to compare

View all tags
v1.6.0 — 브라우저 입력 폼을 명령어 한 줄로

[1.6.0] — 2026-05-30

브라우저 입력 폼을 명령어 한 줄로 띄울 수 있습니다 — 설치도 빌드도 필요 없습니다.

추가

  • 브라우저 입력 폼을 npx 한 줄로 — npx -y agent-safety-oss viewer 만 입력하면 안전문서 입력 폼이 브라우저에 바로 열립니다. 이전엔 소스를 내려받아 빌드해야 했지만, 이제 Node.js 만 있으면 됩니다. AI 비서(Claude·Codex)나 명령어가 익숙하지 않은 안전관리자·현장소장을 위한 가장 쉬운 경로입니다.
  • 자동 브라우저 열기가 Windows·Linux 에서도 동작 — 폼 화면이 운영체제에 맞게 자동으로 열립니다 (이전 macOS 전용 → 전 OS 지원).

개선

  • 포트가 이미 사용 중일 때 다른 포트로 실행하는 방법을 안내합니다.
  • Claude Desktop·Codex 설정 가이드의 옛 버전 표기를 정리했습니다.
Loading

v1.5.0 — 관련 KOSHA 가이드·법령 자동 연결

24 May 10:01
@ratelworks ratelworks
v1.5.0
d4fe0a4

Choose a tag to compare

View all tags
v1.5.0 — 관련 KOSHA 가이드·법령 자동 연결

안전 문서를 작성하면 관련 KOSHA 가이드와 법령 조항이 자동으로 따라붙습니다 — 일일이 찾을 필요가 없습니다.

추가

  • 가이드·법령 자동 연결 — 문서(TBM·위험성평가·산업재해보고 등)를 작성하면 관련 KOSHA 안전 가이드와 법령 근거를 자동으로 찾아 붙여줍니다.
  • 양식 자동 채움 — 문서 양식을 열면 관련 가이드·법령·위험요인·대책이 미리 채워진 상태로 시작합니다(빈 양식이 아니라).

개선

  • 근거 없는 인용 차단 강화 — 가이드·법령은 내장 지식에서 가져오므로, 존재하지 않는 가이드명·조문을 지어내지 않습니다.

설치·업그레이드: npm install agent-safety-oss@1.5.0
전체 변경 내역: CHANGELOG

Loading

v1.4.0 — 작성 중 실시간 보조 + 브라우저에서 바로 작성

22 May 01:01
@ratelworks ratelworks
v1.4.0
ff1d59e

Choose a tag to compare

View all tags
v1.4.0 — 작성 중 실시간 보조 + 브라우저에서 바로 작성

문서를 채워가는 동안 필요한 도움말·위험요인 대책·검토가 실시간으로 따라오고, MCP 프로그램 없이도 브라우저에서 바로 작성할 수 있습니다.

추가

  • 작성 중 실시간 보조 — 항목별 작성 도움말과 흔한 실수 안내, 위험요인을 넣으면 (제거·대체·공학적·관리적·보호구 순서로) 대책을 추천, 작업명·내용·조건을 넣으면 관련 위험·대책·법령·가이드를 한 번에 정리, 결재 전 문서를 미리 점검합니다.
  • 브라우저에서 바로 작성 — 별도 프로그램 없이도 브라우저에서 안전 문서를 작성하고, 완성 본문을 파일(.md)로 내려받을 수 있습니다.

수정

  • 새벽 시간대 날짜 오류 수정 — 자정~오전 9시 사이에 쓰면 "오늘"이 어제로 잡혀 작성일·기한이 하루 어긋나던 문제를 바로잡았습니다(한국 시각 기준).
  • 자연어로 입력 가능 — "사망/중상/경상", "건설/제조/서비스", "착공전/시공중/준공" 같은 한국어 표현을 그대로 입력해도 알아듣습니다.
  • 개인정보 보호 — 현장·인원·협력사 등록 결과 화면에 사업자등록번호·대표자명을 가려서 표시합니다(저장·재사용에는 원본 유지).
  • 잘못된 입력 처리 개선 — 위험요인을 비워 대책을 요청하면 안내하고, 건설 외 작업(서비스·화학공정 등)은 "적용 범위 밖"이라고 알려줍니다.

호환성 (Breaking)

  • 브라우저 작성 화면 실행 명령이 npm run mcp:viewer로 바뀌었습니다.
  • 정적 시연용 폴더는 제거되고, 그 기능은 브라우저 작성 화면으로 통합되었습니다.

설치·업그레이드: npm install agent-safety-oss@1.4.0

Loading

v1.3.1 — version drift fix + post-evaluation cleanup

20 May 07:34
@ratelworks ratelworks
v1.3.1
2447c7c

Choose a tag to compare

View all tags
v1.3.1 — version drift fix + post-evaluation cleanup

Patch release — npm v1.3.0 publish 직후 git tag/release 와 npm registry 시점이 어긋난 부분을 해소하고, 외부 평가 보고서 후속 정리를 단일 release 로 묶었습니다.

Update from v1.3.0

npm update -g agent-safety-oss        # 전역 설치 사용자
# 또는
npx -y agent-safety-oss@latest tools  # npx 사용자는 자동으로 latest

Claude Desktop · Codex CLI 의 npx -y agent-safety-oss serve 설정은 변경 없이 그대로 v1.3.1 을 받습니다.

Changes

  • External evaluator report (2026-05-20) — P0/P1 6 items resolved
    • tool-registry comment ("80 tools") → TOOLS.length SSoT
    • ensureGraphBuilt now invokes buildIndex + buildGraph (name/behavior alignment)
    • loadArchivedDocument path-traversal guard (.. / / / \\ / resolved-prefix check)
    • assemble_doc_context excerpt is now slice(0, 500) instead of full article body
    • Local storage path SSoT — src/config/paths.ts introduced + local-storage / trace-recorder integrated
    • link_company_key / get_company_info text content PII is masked by default; opt-in plaintext via reveal: true
  • Regression fix — trace-recorder now honors SAFETY_LOCAL_DIR via paths.ts
  • Cleanup — .env.example and code comments: residual agent-safety-oss-mcp legacy name removed

Backward compatibility

  • All 88 tools keep the same input schema and output structure
  • New reveal: false default on company-key tools is non-breaking for downstream programs (they receive masked values which are still strings)
  • No removed tools, no removed APIs

Verification

  • ontology:gate HIGH 0 / SHACL 22/22 / capability · edge-context · link-type all green
  • npm audit — 0 vulnerabilities
  • quality-regression — 96/96 excellent, mean 9.68/10, 0 hallucination flags
  • check:doc-sync HIGH 0 (all version markers aligned)

Links

Loading

v1.3.0 — First PUBLIC release

20 May 04:29
@ratelworks ratelworks
v1.3.0
a422c3d

Choose a tag to compare

View all tags
v1.3.0 — First PUBLIC release

OSS MCP server that assists Korean safety managers and site supervisors in drafting and reviewing the 19 statutory safety-management documents (TBM logs, work plans, risk assessments, MSDS registers, accident reports, …).

Korean OSH statutes, Safety Standards Rules, the Severe Accident Punishment Act, and KOSHA Guide bodies are bundled inside the tools, so the form template, blank-fill guide, statute body excerpt, and review are provided right at drafting time.

Install

npm install -g agent-safety-oss
# or use directly via npx
npx -y agent-safety-oss tools

npm: https://www.npmjs.com/package/agent-safety-oss

5-second setup

Targets two main hosts: Claude Desktop and OpenAI Codex CLI.

{
  "mcpServers": {
    "agent-safety-oss": {
      "command": "npx",
      "args": ["-y", "agent-safety-oss", "serve"]
    }
  }
}

What's bundled

  • 88 MCP tools — all wired directly to drafting workflows
  • 1,039 KOSHA Guide bodies (offline, keyless)
  • 8 statute bodies (OSH Act / Decree / Rule / Safety Standards Rules / SAPA / SAPA Decree / Risk Assessment Notice / CTPA §62 area)
  • 94-docId master + 132-form index
  • 3,365-node operational graph (Activity · Hazard · Control · LegalArticle · SafetyDocument · Evidence · CorrectiveAction)
  • 22 deterministic applicability rules — workplace scale + work conditions → triggered statutes + enforced controls auto-derived

API key — 2 paths

A2UI form preview in browser

git clone https://github.com/ratelworks/agent-safety-oss.git
cd agent-safety-oss && npm install && npm run build
npm run mcp:demo:viewer    # http://localhost:5174

Verification

  • ontology:gate HIGH 0 / SHACL 22/22 / capability · edge-context · link-type all green
  • npm audit — 0 vulnerabilities
  • quality-regression — 96/96 excellent, mean 9.68/10, 0 hallucination flags
  • fillrate top-20 — mean 76.8/100, statute-citation conformance 100%, approval-block presence 100%

Provider · Developer

  • Provider: 황룡건설(주) Safety & Health Planning Dept. — domain validation, on-site requirements, scenarios
  • Developer: Ratelworks Inc. — MCP server design / implementation / OSS maintenance
  • License: MIT (code) · KOGL (KOSHA / MOEL / Ministry of Government Legislation data)

Awards

  • 2025.07 — 2025 AI · Smart Industrial-Safety Technology Best-Practice Contest Grand Prize (Minister of Employment and Labor)
  • 2025.09 — 2025 Risk Assessment Best-Practice Showcase Excellence Prize (Daejeon Regional Labor Office Director)
  • 2026.01 — Side Impact 2025 AI Track Winner (Brian Impact Foundation)

For details: README.md · CHANGELOG.md.

Loading