agi-schedule-daily-update

name: agi-schedule-daily-update description: 통합 파이프라인 2단계. AGI TR Schedule HTML(files 폴더)의 공지란·Weather & Marine Risk 블록 매일 갱신. 기본 파일 files/AGI TR SCHEDULE_20260128.html, 업데이트 시 가장 최근 날짜 파일 사용.

파이프라인 위치

통합 파이프라인(에이전트) 에서 항상 2번째로 적용되는 스킬이다.
순서: 1) agi-schedule-shift → 2) agi-schedule-daily-update → 3) agi-schedule-pipeline-check → 4) weather-go-nogo.
모든 요청에 대해 본 스킬(공지·날씨 갱신)이 항상 호출된다.

작업 범위

모든 작업은 AGI TR 1-6 Transportation Master Gantt Chart/files/ 폴더 안에서만 수행한다.

대상 파일

기본 파일: AGI TR 1-6 Transportation Master Gantt Chart/files/AGI TR SCHEDULE_20260128.html
대상 패턴: AGI TR 1-6 Transportation Master Gantt Chart/files/AGI TR SCHEDULE_*.html
업데이트 시 소스: files/ 안에서 파일명에 포함된 날짜(YYYYMMDD)가 가장 최근인 AGI TR SCHEDULE_*.html 을 읽어서 갱신한다. 예: AGI TR SCHEDULE_20260128.html, AGI TR SCHEDULE_20260129.html 이 있으면 → AGI TR SCHEDULE_20260129.html 를 소스로 사용.

언제 사용

AGI TR Schedule HTML의 **공지란(Operational Notice)**을 사용자 제공 내용으로 갱신할 때
Weather & Marine Risk Update 블록 갱신: (1) Mina Zayed 인근 = 인터넷 검색, (2) 해상 = 사용자 수동 다운로드한 PDF/JPG 파싱 후 삽입
"AGI schedule 공지", "날씨 블록 업데이트", "Mina Zayed weather 반영", "weather 폴더 PDF 파싱" 요청 시

입력

항목	제공자	형식	예시
공지 날짜	사용자	YYYY-MM-DD	2026-01-28
공지 텍스트	사용자	한 줄 또는 여러 줄	Action : Request Material entry pass
날씨/해상 정보	에이전트(웹 검색) 또는 사용자 다운로드(해상)	아래 "날씨 입력 2원화" 참조	-

날씨 입력 (2원화)

구분	입력 경로	동작
1. Mina Zayed Port 인근 날씨	에이전트(웹 검색)	인터넷 검색 후 요약 문단을 날씨란에 삽입(기존 방식).
2. 해상 날씨	사용자 수동 다운로드	날씨 확인 시에는 항상 `files/weather/` 폴더에서 날짜(YYYYMMDD)가 가장 최근인 폴더의 PDF·JPG를 파싱하여 적용. (예: `20260128`, `20260129` 가 있으면 → `20260129` 사용.)

해상용 파일 경로: AGI TR 1-6 Transportation Master Gantt Chart/files/weather/ 내 최신 날짜 폴더(YYYYMMDD). (예: 20260128, 20260129 가 있으면 20260129 사용.)
해상용 파일: PDF(예: ADNOC_DAILY_FORECAST_*.pdf, ADNOC-TR *.pdf, ENGLISH *.pdf), JPG(예: MR.JPG, SF.jpg, ST.jpg).
해상 파싱: PDF는 텍스트 추출(mrconvert 또는 PyMuPDF 등), JPG는 OCR 또는 이미지 분석 후 해상 예보·해상 상태 요약문 생성 → Weather & Marine Risk 블록에 해상(Marine) 문단으로 추가.

절차

1) 공지란 갱신

HTML에서  다음의 div.weather-alert 블록을 찾는다.
사용자가 해당일 공지 내용을 제공한 경우: 기존 날짜·본문을 제공한 날짜 + 텍스트로 교체. 마크업 유지: YYYY-MM-DD  + 공지 텍스트.
해당일에 내용이 없으면: 날짜만 해당일(갱신일)로 변경하고, 기준(기존)에 있던 내용은 전부 삭제한다. 공지란에는 날짜만 남기고 본문은 비운다.

2) Weather & Marine Risk Update 갱신

포맷: 기존 HTML과 동일하게 유지.
- 제목: Weather & Marine Risk Update (Mina Zayed Port)
- 서브: Last Updated: DD Mon YYYY | Update Frequency: Weekly (오늘 날짜로 갱신)
- 본문: (1) Mina Zayed 인근 요약 문단, (2) 해상(Marine) 요약 문단. 날짜별 DD Mon: … 유지.
예보 일수: 조회(갱신)하는 날짜 기준 당일 포함 4일치 예보를 항상 삽입한다.
- 예: 1월 28일 갱신 시 → 28 Jan, 29 Jan, 30 Jan, 31 Jan (4일).
- 일반: 갱신일 D, D+1, D+2, D+3 (총 4일). 날짜별 문단 DD Mon: … 유지.

2a) Mina Zayed Port 인근 날씨

웹 검색: "Mina Zayed Port Abu Dhabi weather", "Arabian Gulf sea state wind 7 days" 등으로 검색.
검색 결과를 요약해 위 4일치에 맞춰 날짜별 문단으로 삽입.

2b) 해상 날씨 (수동 다운로드)

경로: AGI TR 1-6 Transportation Master Gantt Chart/files/weather/ 내 날짜(YYYYMMDD)가 가장 최근인 폴더를 사용. (예: 20260128, 20260129 가 있으면 20260129 사용.) 사용자가 PDF·JPG를 수동 다운로드해 둠.
파싱: 최신 날짜 폴더 내 PDF는 텍스트 추출(mrconvert 또는 동일 도구), JPG는 OCR 후 해상 예보/해상 상태 요약 추출.
PDF 파서 불가 시 fallback (보안/DRM 등으로 PDF 직접 파싱이 실패할 때):
1. PDF 파일을 실행(열기) 한다. (뷰어로 화면에 표시.)
2. 화면에 표시된 PDF를 스크린 캡처한다. (전체 창 또는 해당 페이지만.)
3. 스크린 캡처한 이미지 파일을 파서한다. (이미지 OCR/이미지 분석으로 텍스트·표 추출 후 해상 예보 요약.)
- fallback 후에도 동일하게 추출 결과를 날씨란 "Marine / Offshore" 문단으로 삽입.
삽입: 추출한 해상 예보를 날씨란에 "Marine / Offshore" 또는 동일 4일치 날짜별 해상 문단으로 삽입. files/weather/ 폴더가 비어 있거나 최신 날짜 폴더에 파일이 없으면 2b는 생략.
JPG OCR 설정: JPG 파싱은 Tesseract OCR 사용. eng.traineddata가 없으면 프로젝트에 out/tessdata/eng.traineddata를 두고, scripts/weather_parse.py가 자동으로 TESSDATA_PREFIX=CONVERT/out/tessdata를 사용. 날씨 파서 확인: python scripts/weather_parse.py "AGI TR 1-6.../files/weather/YYYYMMDD" 로 PDF·JPG 파싱 가능 여부 확인.

2c) PDF 파서 → WEATHER_DASHBOARD → 이미지 임베드 파이프라인 (4일 히트맵용)

순서: (1) PDF/JPG 파싱 → (2) 파서 txt → WEATHER용 JSON 변환 → (3) WEATHER_DASHBOARD.py 실행 → (4) embed_heatmap_base64.py 또는 파일 참조.
1단계: files/weather/ 에서 최신 날짜 폴더(YYYYMMDD) 확인 후 → python scripts/weather_parse.py "AGI TR 1-6.../files/weather/YYYYMMDD" --out files/out/weather_parsed/YYYYMMDD
2단계: python scripts/parsed_to_weather_json.py files/out/weather_parsed/YYYYMMDD → files/out/weather_parsed/YYYYMMDD/weather_for_weather_py.json 생성 (ADNOC 텍스트에서 날짜·파고(ft)·풍속(kt) 추출).
3단계: files/ 폴더에서 python WEATHER_DASHBOARD.py 실행. 4일 모드일 때 위 JSON이 있으면 자동 사용 → files/out/weather_4day_heatmap.png 생성.
4단계(선택): files/out/weather_4day_heatmap.png 를 files/weather_4day_heatmap_dashboard.png 로 복사 후, files/ 에서 python embed_heatmap_base64.py 실행 → files/AGI TR SCHEDULE_*.html 내 이미지를 Base64 인라인으로 교체. (되돌리려면 python replace_img_ref.py.)
스케줄 HTML Weather 블록에 위 파이프라인 실행 후 생성된 PNG(파일 참조 또는 Base64)를 사용.
위 (2a+2b) 결과를 합쳐  다음 블록 전체를 교체한다.
class="weather-alert", 아이콘(⚠️), 인라인 스타일은 유지.

3) 저장

수정한 날짜(YYYYMMDD)를 파일명 뒤에 넣어 신규 파일로 files/ 안에 저장한다. 원본은 덮어쓰지 않는다.
예: 소스가 files/AGI TR SCHEDULE_20260128.html 이고 갱신일이 2026-01-29 이면 → files/AGI TR SCHEDULE_20260129.html 로 신규 생성.
파일명 형식: files/AGI TR SCHEDULE_YYYYMMDD.html (YYYYMMDD = 갱신을 수행한 날짜).

안전 규칙

files/ 폴더 밖의 HTML을 읽거나 쓰지 않는다.
공지란·날씨 블록 밖의 HTML(간트 데이터, 스크립트, KPI, Voyage Cards 등)은 수정하지 않는다. KPI Grid(Total Days 재계산, SPMT Set=1) 는 본 스킬 범위가 아니며, 3단계 agi-schedule-pipeline-check 점검 F에서만 수행한다. 갱신 시 KPI 규칙 적용 책임은 pipeline-check 스킬에 있다.
공지 미제공 시: 해당일로 날짜만 변경하고 기존 내용은 삭제(날짜만 남김). 날씨만 갱신할 때도 공지란에 이 규칙 적용.

통합

Subagent /agi-schedule-updater: 이 스킬을 사용해 공지·날씨 블록 갱신 수행. 모든 작업은 files/ 안에서만 수행.

대시보드 출력 형식 (필수)

결과값은 agentskillguide/DASHBOARD_OUTPUT_SCHEMA.md와 동일하게 대시보드에 출력되어야 함.

공지란: 날짜 YYYY-MM-DD, 본문(또는 비움)
Weather & Marine Risk: Last Updated DD Mon YYYY, 4일치(D~D+3) 예보, Mina Zayed·해상 문단
히트맵: files/out/weather_4day_heatmap.png → HTML src(파일 또는 Base64)