pilot npm 정식 배포 (@followingseas/pilot) #10

배경

pilot v1이 안정화됐지만 아직 npm에 배포되지 않았다 (npm view @followingseas/pilot → 404). 현재는 소스에서 npm link 또는 npx tsx src/cli/index.ts로만 실행 가능해, 팀·외부 사용자가 설치하기 어렵다. 정식 배포로 npm i -g @followingseas/pilot 한 줄이면 쓰게 만든다.

주의: 여기서 정하는 건 pilot npm 패키지 버전이다. 그동안 얘기한 "v1"은 rutter 매니페스트 포맷 버전이지 패키지 버전이 아니다 (현재 package.json은 0.1.0). 혼동 금지.

할 일

1. package.json 배포 준비

• publishConfig: { "access": "public" } 추가 — 스코프(@followingseas) 패키지는 기본 private이라 공개 OSS는 public 명시 필요
• prepublishOnly(또는 prepack) 스크립트로 배포 전 npm run build 보장
• keywords 채우기 (현재 빈 배열 — 예: rutter, ai-agents, mcp, cli, conventions, policy)
• files: ["dist"] — src/tests 제외, README·LICENSE 자동 포함 (이미 OK)
• 초기 공개 버전 결정 — 현재 0.1.0 유지 vs 상향

2. 빌드 산출물 검증

• dist/cli/index.js shebang(#!/usr/bin/env node) 유지 — tsup가 보존함(확인됨)
• npm pack tarball 내용 점검 + npm publish --dry-run
• 설치 스모크: npm pack → 다른 디렉터리에서 tgz 전역 설치 → pilot --help

3. npm 조직·인증

• npm followingseas 조직 생성(또는 개인 계정 스코프)
• CI 배포용 NPM_TOKEN(automation token) 시크릿 등록

4. 배포 자동화 (CI)

• GitHub Actions 릴리스 워크플로 — 태그/릴리스 시 npm publish
• npm provenance (npm publish --provenance + GH Actions OIDC) — 공급망 보안, 조직 보안 지향과 부합
• 이미 conventional commits를 강제(rebase+linear+commitlint)하므로 release-please 또는 semantic-release로 버전·CHANGELOG·배포 자동화 검토

열린 질문

• 수동 배포(태그 시 npm publish) vs 자동(release-please/semantic-release)?
• CLI 외에 라이브러리 API도 export할지 — 지금은 bin 중심이라 필요 시 exports 추가

🤖 Generated with Claude Code