Affinity 전용 CLI 구현·보관 및 전역 지침 연동
개발 기록 · 블로그 공개
원본 기록 상태 구현·자동검증 완료 / 실제 연동 대기
CLI·테스트·예제를 설정 저장소에 보관하고 전역 지침 연동 및 원격 푸시 완료
작업 결과
- tools/affinity-cli/에 Node.js 22+ 기반 전용 CLI를 구현했습니다. 외부 npm 의존성은 없습니다.
- PowerShell 래퍼가 PATH의 Node 또는 Codex 번들 Node를 찾아 실행합니다. 전역 PATH 변경 없이 저장소 내 경로로 사용할 수 있습니다.
- doctor·status·tools·docs·fonts·presets·inspect·job·run·call·render·verify 명령을 제공합니다.
- JSON 작업으로 문서 생성·열기, 도형·텍스트·이미지 추가, 레이어 이름·텍스트·채움·변환, 저장·내보내기·검사를 구현했습니다. 이 네이티브 작업들의 실제 앱 실행은 아직 검증하지 않았습니다.
- 기존 문서의 세션 ID 고정, 실제 글꼴·프리셋 확인, 기본 덮어쓰기 거부, 요청 시간 제한, 수정 자동 재시도 금지, 사용자 단위 CLI 직렬화, 부분 실패 결과 기록을 포함했습니다.
- 출력 이미지 저장과 SHA-256·파일 크기·PNG/JPEG 픽셀 크기 검사를 구현했습니다. 이것은 시각 품질 검증을 대신하지 않습니다.
- 기본 CLI와 JSON 작업에는 화면 클릭·키 입력·창 활성화·앱 실행·재시작 기능이 없습니다. 임의 SDK 스크립트는 별도 샌드박스가 아니므로 UI 함수를 호출하지 않도록 검토해야 합니다.
- README, VALIDATION.md, 읽기 전용 스크립트와 포스터 JSON 예제를 포함했습니다. 포스터 예제는 실제 제작 완료 결과물이 아니며 아직 Affinity에서 렌더링하지 않았습니다.
- 전역 AGENTS.md에 CLI 우선 사용 경로·진단·작업·검증·실패 처리 절차를 추가했습니다.