오늘 작업은 개발일지 자동 생성과 티스토리 자동 발행 파이프라인의 연동 결함을 바로잡고, 프로젝트 단위 분리 발행 체계를 구축하는 데 집중했다. 총 11건의 커밋으로 1,086줄의 코드를 추가하고 115줄을 정리했다. 발행 성공을 실패로 오진하거나 에디터에 본문이 제대로 입력되지 않던 티스토리 연동 결함을 수정을 거쳐 정상화했다. 필자와 검토자가 서로 다른 데이터를 바라보며 자동 일지가 매일 반송되던 파이프라인 불일치 문제도 원인을 찾아 해결했다. 프로젝트별 2단계 분류 로직 연동과 자본시장법 금지 표현 검증 확대, 다이어그램 자동 이미지 변환 기능까지 통합을 마쳤다.
성공한 발행을 실패로 리포트하던 티스토리 연동 교정
티스토리 발행 과정에서는 외부 응답이 정상적으로 수신되어 발행이 완료되었음에도 파이프라인 내부에서 이를 실패 상태로 잘못 판정하는 오진 문제가 존재했다. 추가로 웹 에디터 연동 과정에서 일반적인 DOM 셀렉터 지정 방식으로 입력할 경우 본문 영역에 글이 채워지지 않고 빈 상태로 발행되는 현상이 함께 발견되었다. 웹 에디터 내부의 CodeMirror API를 직접 호출하여 텍스트를 주입하도록 방식을 교정했다. 단순한 외부 조작 대신 에디터 인스턴스 내부 API에 직접 접근함으로써 입력 누락 현상을 원천 방지하고 발행 결과도 올바르게 반환받도록 바꿨다.
외부 알림이 실제 전달되지 않았음에도 발송 성공으로 표시되던 메시지 리포트 오류도 함께 바로잡았다. 알림 실패 상황을 성공으로 잘못 알리면 운영자가 자동화 파이프라인의 이상 유무를 즉시 인지하지 못하고 적절한 조치 타이밍을 놓치게 된다. 외부 서비스와의 실제 연동 결과와 알림 메시지 상태를 정확히 일치시켜 거짓 성공 리포트를 완전히 없앴다. 예외 상황 발생 시 실패 기록을 명확하게 보여주도록 바꿔 운영 파이프라인의 투명성과 신뢰도를 동시에 확보했다.
검토자와 필자의 시각 차이로 발생하던 일지 반송 해소
자동 작성된 개발일지가 검토선에서 매일 F항목으로 반송되던 문제를 추적한 결과, 검토 스크립트와 작성 스크립트가 서로 다른 재료 데이터를 들여다보고 있었다. 검토 모듈이 최종 렌더링을 거치기 전의 원본 본문 데이터를 기준으로 평가를 수행했기 때문에 필자가 다듬은 본문과 검토 기준 사이에 불일치가 발생한 것이다. 검증 보고서가 최종 렌더링된 본문을 기준으로 작동하도록 검증선 구조를 통일했다. 작성자와 검토자가 동일한 산출물을 공유하도록 만들어 불필요한 반송 재작업을 차단했다.
단순히 커밋 내역이 존재한다는 이유만으로 무조건 일지 작성을 시작하던 기존 제어 조건도 개선했다. 최소한의 작업 재료 수량과 필수 캡처 이미지, 설정된 문턱 조건을 통과했을 때만 작성 단계로 진입하도록 조건을 강화했다. 이와 함께 품질 검사 모듈의 글자 수 임계값을 기존 2,000자에서 300자로 조정했다. 분량 기준을 채우기 위해 억지로 내용을 부풀리기보다는, 작업량이 적더라도 변경의 구체적인 이유와 판단 근거를 담은 실질적인 기록을 남기는 것이 파이프라인 운영 목적에 부합한다고 판단한 결과다.
프로젝트별 2단계 분류 체계 도입과 출력 검증 강화
하나의 글에 모든 작업 내역을 한데 묶어 출간하던 방식을 벗어나, 프로젝트별로 일지를 분할하고 요약형 제목을 적용하는 구조 개편을 단행했다. 단일 글에 여러 개 맥락이 무작위로 섞이면 읽는 입장에서 원하는 기술 정보를 찾아내기 어렵다는 단점이 컸다. 새롭게 도입한 2단계 분류 체계를 일지 생성기와 티스토리 발행 모듈에 연결하여, 각 프로젝트 맥락에 맞춰 독립된 글이 발행되도록 시스템을 정비했다.
자본시장법상 금지 표현을 검증하는 검사 로직의 적용 범위를 확장했다. 기존에는 기본 본문 텍스트만 검사했으나 이번 개편으로 통계 템플릿 출력 경로까지 검사 대상에 포함시켰다. 혹시라도 일지 생성 과정 중 예외적인 경로에서 부적합한 표현이 포함되어 배포되는 상황을 철저히 차단하기 위한 결정이다. 더불어 문맥을 시각적으로 전달하기 위해 mermaid 다이어그램 구문이 포함되면 발행 전 자동으로 PNG 이미지로 구워내는 변환 처리도 붙였다. 텍스트 위주의 설명에 시각적 도표 요소를 보완하여 전달력을 끌어올렸다.
남은 과제
프로젝트별 분리 발행과 에디터 연동 오류 수정은 완료했으나, 새로 추가한 mermaid PNG 이미지 렌더링 과정에서 처리 시간이 늘어날 경우 전체 파이프라인의 타임아웃으로 이어지지 않는지 모니터링이 더 필요하다. 품질 검사 임계값을 300자로 낮춘 설정이 향후 다양한 작업량 변화 속에서 의도대로 작동하는지도 실제 발행 데이터를 쌓으며 계속 관찰할 계획이다.
2026-08-08 · 개발일지 파이프라인 · 커밋 12건 (+1175/-141)
이 글은 그날의 커밋 기록을 바탕으로 자동 생성·발행되었다.