@y80163442/naver-thin-runner

Naver Blog Writer의 로컬 실행 클라이언트(thin runner)입니다.

설치

npx @y80163442/naver-thin-runner --help

또는 전역 설치:

npm i -g @y80163442/naver-thin-runner

핵심 명령

naver-thin-runner setup --setup-url "https://<control-plane>/v2/onboarding/setup-sessions/start?setup_token=..." --auto-service both
naver-thin-runner setup --proof-token "<proof_token>" --setup-issue-url "https://<control-plane>/v3/onboarding/setup-url/issue" --auto-service both
naver-thin-runner login
naver-thin-runner start
naver-thin-runner start --once
naver-thin-runner daemon start --port 19090
naver-thin-runner doctor --json

실행 모드

• start: 상주(worker) 모드입니다. 종료되지 않는 것이 정상이며 서비스/daemon 운영에 사용합니다.
• start --once: 요청당 1개 job만 처리하고 종료합니다. 에이전트의 요청당 실행(run-per-request)에 사용합니다.
• start --once 출력: 단일 JSON 한 줄(mode, result, job_id?, error_code?)
• start --once 종료코드: empty/published=0, failed=1.

Self-Onboarding 흐름

1. seller가 proof_token을 발급합니다.
2. buyer는 proof_token + setup-issue-url 또는 setup_url 하나로 아래를 자동 실행합니다.

• setup session 시작
• runner 등록(onboarding token 소비)
• optional service 설치(--auto-service)
• health check(doctor --json)

3. buyer가 네이버 로그인만 1회 수동으로 수행합니다.
4. 이후 agent는 dry_run preview 후 live publish를 호출할 수 있습니다.

주의사항

• Production support: macOS
• launchd service 설치는 macOS만 지원합니다.
• login/start는 npm 패키지에 포함된 standalone runtime으로 동작합니다(별도 repo clone 불필요).
• --repo-root는 코드 저장소 경로가 아니라 러너 작업 디렉터리(로그/DB/artifacts 기준 경로)로 사용됩니다.

자세한 릴리즈/호환성 정책은 /docs/THIN_RUNNER_RELEASE.md를 참고하세요.