교육 패키지에 포함된 합성 비정형 회의 메모 목록을 조회합니다.

회의록 작업의 출발점입니다. 여기서 얻은 note_id를 다른 모든 도구에 넘깁니다.

Returns: NoteListResponse: notes[]에 note_id, 제목, 난이도(초급/중급/고급), 줄 수, 글자 수가 담깁니다.

Examples: - 사용: "어떤 더미 메모가 있나요?" - 사용하지 않음: 이미 note_id를 알고 있고 원문이 필요할 때 → read_meeting_note

note_id에 해당하는 합성 회의 메모 원문을 읽습니다.

긴 메모를 통째로 읽어 컨텍스트를 낭비하지 않도록 줄 범위를 지정할 수 있고, 근거 검사에서 경고가 난 줄만 다시 확인할 때도 이 범위 인자를 씁니다.

Args: note_id: 메모 id. start_line: 시작 줄(1부터). 기본 1. end_line: 끝 줄. 생략하면 끝까지. with_line_numbers: 줄 번호 접두사 부착 여부. 기본 True.

Returns: NoteContentResponse: content에 본문, total_lines에 전체 줄 수, truncated에 일부만 읽었는지 여부.

Raises: ToolFailure: NOTE_NOT_FOUND / INVALID_NOTE_ID. 오류 메시지에 사용 가능한 note_id 목록이 함께 담깁니다.

초안을 쓰기 전에 원문에서 '인용 가능한 사실'을 줄 번호와 함께 뽑습니다.

할루시네이션을 막는 가장 효과적인 방법은 사후 검사가 아니라 사전 앵커링 입니다. 이 도구는 참석자, 발화 줄, 날짜 표현, 결정 후보, 실행 항목 후보, 그리고 특히 ambiguity_flags(확정되지 않은 표현이 있는 줄)를 돌려줍니다. ambiguity_flags에 걸린 내용은 회의록에서 '미정'으로 남겨야 합니다.

Args: note_id: 메모 id. max_items_per_category: 분류별 최대 항목 수 (기본 15).

Returns: NoteFactsResponse: 각 항목이 line(원문 줄 번호)과 text를 가집니다. truncated_categories에 잘린 분류 이름이 들어갑니다.

Examples: - 사용: 초안 작성 직전, 근거 칸에 적을 앵커를 확보할 때 - 사용: 근거 검사에서 '담당자를 원문에서 찾지 못했습니다' 경고가 났을 때 - 사용하지 않음: 이미 완성된 초안을 검증할 때 → check_minutes_grounding

회의 메모와 표준 템플릿을 결합한 회의록 작성 프롬프트를 반환합니다.

이 MCP는 LLM API를 호출하지 않습니다. 요약은 호스트(Claude/Codex)가 하고, 이 도구는 '무엇을 어떤 형식으로 쓸지'에 대한 지시문만 조립합니다.

Args: note_id: 메모 id. with_line_numbers: 원문 줄 번호 부착 및 인용 규칙 추가 여부 (기본 True).

Returns: PromptResponse: prompt에 규칙 + 템플릿 + 원문이 담긴 지시문.

회의록 초안의 구조를 검사합니다. 저장 게이트입니다.

error가 하나라도 있으면 preview_save_minutes에서 승인 토큰이 발급되지 않습니다. 각 항목은 rule_id, severity, line, fix를 가지므로 다시 물어보지 않고 스스로 고칠 수 있습니다.

검사 항목: - error: H1 제목, 필수 섹션 7개, 실행 항목 표 헤더, 실행 항목 행의 칸 수 - warning: 섹션 순서, 기한 형식(YYYY-MM-DD 또는 '미정'), 자리표시자 잔존, '미정' 표기 누락, 리스크 표 헤더, 머리말의 '- 원문:' 항목

Args: minutes_markdown: 회의록 초안 전문.

Returns: ValidationResponse: valid, error_count, warning_count, issues[](rule_id/severity/message/fix/line).

Examples: - 사용: 초안을 쓴 직후, 저장 미리보기 전 - 사용하지 않음: 내용이 원문에 근거하는지 볼 때 → check_minutes_grounding

회의록에 적힌 사람·날짜·수치가 원문에서 확인되는지 역으로 대조합니다.

"원문에 없는 결정·담당자·기한을 추정하지 않는다"는 규칙을 사람 눈 대신 기계가 확인합니다. 날짜는 '9월 15일', '8/27', '20일' 같은 원문 표현을 ISO로 정규화한 뒤 비교하므로, 정상적인 회의록이 오탐으로 잡히지 않습니다.

검사 항목: - person_unsupported: 담당자·결정자 이름이 원문에 없음 - date_unsupported / year_unsupported: 날짜·연도의 근거가 원문에 없음 - number_unsupported: 원문에 없는 수치가 새로 생김 - evidence_missing: 실행 항목·리스크의 근거 칸이 비어 있음(참고) - ambiguity_dropped: 원문의 애매한 부분이 회의록에서 전부 확정되어 버림

중요: 이 검사는 자문(advisory) 입니다. 휴리스틱이므로 오탐이 있을 수 있고, 저장을 막지 않습니다. 저장 게이트는 validate_minutes_draft(구조)와 사용자 승인입니다. 경고가 났다면 해당 줄의 원문을 read_meeting_note로 다시 확인하고, 근거가 없으면 '미정'으로 바꾸세요.

Args: note_id: 원본 메모 id. minutes_markdown: 회의록 초안 전문. max_findings: 최대 지적 건수 (기본 30).

Returns: GroundingResponse: status(GROUNDED / MOSTLY_GROUNDED / NEEDS_EVIDENCE_REVIEW), score(0-100), findings[].

이미 저장된 회의록과 초안의 차이를 보여 줍니다.

같은 note_id로 두 번째 저장을 하면 기존 파일을 덮어씁니다. 무엇이 사라지는지 먼저 확인해 사고를 막는 용도입니다.

Args: note_id: 메모 id. minutes_markdown: 초안 전문. diff_preview_lines: unified diff 미리보기 줄 수 (기본 40).

Returns: DiffResponse: diff.write_mode가 CREATE / OVERWRITE / NO_CHANGE 중 하나.

저장 대상·변경 내용·검증·근거 결과를 한 번에 보여 주고 승인 토큰을 발급합니다.

저장 직전의 단일 관문입니다. 구조 검증을 통과했을 때만 approval_token이 발급되며, 토큰은 (note_id, 본문) 해시라서 승인받은 내용과 저장되는 내용이 달라질 수 없습니다.

토큰은 사용자 승인을 대신하지 않습니다. 응답의 approval_request를 사용자에게 그대로 보여 주고, 사용자가 명시적으로 승인한 뒤에만 save_approved_minutes를 호출하세요.

Args: note_id: 메모 id. minutes_markdown: 저장할 회의록 전문. include_preview: 전문을 응답에 다시 담을지 여부 (기본 False). max_preview_chars: preview 최대 길이 (기본 4000).

Returns: PreviewResponse: status(AWAITING_APPROVAL / NEEDS_REVISION), approval_token, validation, grounding, diff, approval_request.

미리보기에서 발급된 승인 토큰이 일치할 때만 회의록을 파일로 저장합니다.

이 서버에서 유일한 쓰기 도구입니다. 호출 전 반드시 두 조건을 만족해야 합니다.

1. preview_save_minutes가 AWAITING_APPROVAL을 돌려주고 토큰을 발급했다.

2. 사용자가 그 내용을 보고 명시적으로 저장을 승인했다.

토큰은 기술적 무결성(승인한 내용 == 저장되는 내용)만 보장합니다. 사용자 승인을 대신하지 않습니다. 사용자가 "저장해"라고 말하지 않았다면 호출하지 마세요.

Args: note_id: 메모 id. minutes_markdown: 저장할 회의록 전문. approval_token: 미리보기가 발급한 토큰. expected_write_mode: 선택. 지정하면 실제 write_mode와 다를 때 거부합니다.

Returns: SaveResponse: path(저장 경로), audit(감사 로그 경로), write_mode(CREATE / OVERWRITE / NO_CHANGE).

Raises: ToolFailure: TOKEN_MISMATCH, VALIDATION_FAILED, WRITE_MODE_CHANGED, INVALID_NOTE_ID. 모두 복구 방법이 메시지에 포함됩니다.

이미 저장된 회의록 목록을 조회합니다.

같은 note_id로 저장하면 덮어쓰기가 되므로, 저장 전에 무엇이 있는지 확인하는 용도입니다.

Returns: SavedListResponse: saved[]에 note_id, 경로, 줄 수, 수정 시각(UTC), 내용 해시 앞 16자.

회의록 저장 감사 로그를 최신순으로 조회합니다.

AWAITING_APPROVAL → SAVED 흐름의 실행 증거를 제출할 때 사용합니다. 각 이벤트에는 시각, note_id, write_mode, 변경 줄 수, 내용 해시가 담깁니다.

Args: limit: 최대 건수 (기본 20). note_id: 특정 메모로 필터링 (선택).

Returns: AuditResponse: events[] 최신순.