feat: 주요 CLI, 인증, 서비스 로직 및 문서 개선

docs/technical/auth-and-token-lifecycle.md

@@ -64,6 +64,26 @@
 3. 요청 처리 시 해시 비교와 만료/폐기 상태 검증
 4. `DELETE /auth/tokens/{token_id}` 또는 봇 비활성화로 토큰 폐기
 
+CLI 봇 토큰 라이프사이클:
+
+1. `bot token issue <bot_id>` 실행 시 `--ttl-days`/`--no-expiry` 정책을 먼저 검증한다.
+2. 정책 검증 후 서비스 계층에서 권한과 만기 정책을 재검증한다.
+3. 발급 성공 시 응답은 마스킹된 토큰만 재출력 가능하며, 원문 토큰은 1회 출력 경로로 제한한다.
+4. `bot token revoke <bot_id> <token_id>` 실행 시 확인 프롬프트(`--force`로 생략 가능)를 거쳐 폐기한다.
+
+만기 정책:
+
+- 기본 TTL은 365일이다.
+- `--ttl-days`와 `--no-expiry` 동시 사용은 거부한다.
+- 비관리자 컨텍스트에서는 `--no-expiry`를 거부한다.
+
+감사 로그 정책:
+
+- `issue/revoke`는 `auth.bot_token` 이벤트를 감사 로그로 남긴다.
+- 감사 로그에는 마스킹된 `token_id/token_ref`만 기록한다.
+- issue 경로에서 감사 로그 기록이 실패하면 발급 토큰을 즉시 폐기하고 실패 처리한다.
+- revoke 경로에서 감사 로그 기록이 실패해도 폐기는 유지하고 명령은 실패로 반환한다.
+
 ## 실패 응답 기준
 
 - bearer 헤더 누락 또는 형식 오류: `401`