크라우니 배포기 — 코어 + 티옴타 어댑터 (1차 구축)

개요

콘텐츠(영상/이미지+캡션)를 여러 플랫폼에 발행하는 어댑터형 CLI 도구. 순수 한선씨(.한선)로 작성, 큐 기반(배포큐.psv) + append-only 로그(배포로그.psv) + 4상 판정(티/옴/타/음)으로 발행 상태를 관리한다.

1차 범위: 코어 CLI + 티옴타 어댑터(tiomta-tube, 실제 동작 확인) + 외부 플랫폼은 계약만 문서화(키 미수급).

무엇을 했는지

1. 배포큐.psv 9필드 스키마 확정, 파이프 이스케이프(|) 규칙 구현.
2. 배포기.한선 CLI: 추가/실행/현황 서브커맨드(hanseonc_high엔 argv가 없어 환경변수 CMD/A1..A4로 전달).
3. 어댑터 계약: 발행(콘텐츠경로,제목,캡션) → "OK|참조"/"ERR|사유", 플랫폼 추가=파일 1개.
4. 티옴타 정찰: tube.tiomta.com(127.0.0.1:9890) /api/upload(POST, title/url JSON) 확인·실동작 어댑터 작성.

tok.tiomta.com(127.0.0.1:9979)은 업로드/게시 라우트 미발견(리뷰/톡 중심) → 이번엔 미사용.

1. 로컬 콘텐츠 경로 → 공개 URL 매핑: ays 정적 서빙(/images/generated/) 재사용, 별도 업로드 API 없어

사전 호스팅 필요함을 확인 후 이 경로로 구현(타 서비스 수정 없음).

1. 실측 검증: 추가→실행→tube에 vid_17 실등록(curl 확인)→현황 통계 일치→재실행 멱등(중복 미생성)→

실패경로(없는 파일, 3회 재시도 후 타=실패)→미지원 플랫폼(음=SKIP, 재시도 카운트 미증가).

관련 파일

• /Users/ef/crowny-publisher/배포기.한선 — 코어 CLI
• /Users/ef/crowny-publisher/문자열도구.한선 — 파이프/JSON 이스케이프, 현재시각
• /Users/ef/crowny-publisher/어댑터_티옴타.한선 — 티옴타 어댑터
• /Users/ef/crowny-publisher/README.md — 사용법, 어댑터 계약, 외부 플랫폼 필요 키 표
• /Users/ef/crowny-publisher/data/배포큐.psv · 배포로그.psv · 카운터.txt — 큐/로그(검증 흔적 id 1~3 포함)
• 정찰 대상: /Users/ef/crowny-tiomta/티옴타튜브.한선(9890, 사용), /Users/ef/crowny-tiomta/tok/*.한선(9979, 미사용)

잔여 이슈

• tok(숏폼, 9979) 게시 API 부재 — 파일 기반 배치 방식 후속 검토 필요(스펙.md 확인 요).
• 외부 플랫폼(유튜브/스레드·인스타/틱톡/X/네이버TV) 어댑터는 키 수급 후 구축(계약은 README에 명시).
• 어댑터 함수명이 전부 발행으로 겹침 — 실동작 어댑터가 2개 이상 되면 파일간 함수명 충돌(하드에러) 함정

회피를 위해 발행_<플랫폼> 모듈접두 리네임 필요(README에 경고 기록, 현재는 1개뿐이라 미적용).

• 예약시각(스케줄 지연 발행)은 필드만 있고 실행이 시각 비교 없이 즉시 처리 — 예약 발행이 필요하면

실행에 현재시각 < 예약시각 스킵 로직 추가 필요.