@bifos/dooray-cli 0.6.0 → 0.8.0

package/README.md

@@ -1,6 +1,9 @@
 # dooray-cli
 
+[![npm version](https://img.shields.io/npm/v/@bifos/dooray-cli.svg)](https://www.npmjs.com/package/@bifos/dooray-cli)
+[![npm downloads](https://img.shields.io/npm/dm/@bifos/dooray-cli.svg)](https://www.npmjs.com/package/@bifos/dooray-cli)
 [![CI](https://github.com/jon890/dooray-cli/actions/workflows/ci.yml/badge.svg)](https://github.com/jon890/dooray-cli/actions/workflows/ci.yml)
+[![license](https://img.shields.io/npm/l/@bifos/dooray-cli.svg)](https://github.com/jon890/dooray-cli/blob/main/LICENSE)
 
 NHN Dooray REST API를 래핑한 CLI 도구입니다. 터미널과 AI 에이전트 환경에서 Dooray 업무를 관리할 수 있습니다.
 
@@ -118,6 +121,16 @@ dooray post edit <project> 42 --title "새 제목" --body "새 본문"
 dooray post edit <project> 42 --body-file ./updated.md
 ```
 
+#### 본문 변경 시 attachment 보호
+
+`post edit` 와 `post comment edit` 는 본문을 통째로 replace 합니다. 새 본문에 기존 inline attachment markdown(`![](/files/<id>)`)이 빠져 있으면 stderr 에 경고를 띄우고 (y/N) 로 물어봅니다.
+
+자동화 환경 (pipe / non-TTY) 에서는 그대로 abort 됩니다. 의도한 변경이면 `--no-confirm` 으로 다시 실행하세요.
+
+```bash
+echo "new body" | dooray post comment edit <project> <post-number> <comment-id> --body - --no-confirm
+```
+
 ### 댓글
 
 ```bash
@@ -128,31 +141,50 @@ dooray post comment add <project> 42 --body-file ./comment.md
 
 > table 출력의 Creator 컬럼은 프로젝트 멤버 캐시로 자동 enrich되며, `--json`은 raw 응답을 유지한다 (ADR-021).
 
-#### 멘션 (comment add / comment edit)
-
-`--mention <name>` (반복), `--mention-group <code>` (반복)으로 본문 앞에 멘션 마크업을 자동 prepend한다.
+#### 멘션·내부 링크 자동 삽입
 
 ```bash
-# 멤버 멘션 1명
-dooray post comment add P 1 --mention 홍길동 --body "확인 부탁드립니다"
+# 댓글에 멤버·그룹 멘션
+dooray post comment add <project> <post-number> \
+  --body "주간 리포트 첨부" \
+  --mention "홍길동" \
+  --mention-group <project>/dev
+
+# 본문에 다른 업무 링크 append
+dooray post create <project> \
+  --title "이번 주 작업" \
+  --body "관련 이슈" \
+  --link-task <project>/470
+
+# 송신 전 합성 결과 미리보기
+dooray post comment add <project> <post-number> --body "..." --link-task <project>/470 --dry-run
+```
+
+> `--mention` / `--mention-group` / `--link-task` / `--dry-run` 은 `post create`, `post edit`, `post comment add`, `post comment edit` 4 명령 모두 지원.
+> 이전 버전 캐시는 orgId가 없으므로 첫 호출 시 자동 갱신됩니다 (또는 `dooray cache clear`).
 
-# 여러 명
-dooray post comment add P 1 --mention 홍길동 --mention 김철수 --body "..."
+#### 참조자(cc) / 담당자(to) 변경 (ADR-025)
 
-# 그룹 멘션
-dooray post comment add P 1 --mention-group 개발 --body "검토 요청"
+```bash
+# 멤버/그룹 추가 (기존 참조자 유지 + dedupe)
+dooray post edit <project> <post-number> \
+  --cc 홍길동 --cc-group dev-team \
+  --to 김철수
 
-# 멤버 + 그룹 혼합
-dooray post comment add P 1 \
-  --mention 홍길동 \
-  --mention-group 개발 \
-  --body "검토 부탁드립니다"
+# 기존 참조자 전부 비우고 신규만
+dooray post edit <project> <post-number> --cc-clear --cc 홍길동
 
-# comment edit에도 동일 옵션 사용 가능
-dooray post comment edit P 1 <commentId> --mention 홍길동 --body "수정 내용"
+# 신규 업무 생성 시 그룹 cc 동봉
+dooray post create <project> --title "주간 audit" --cc-group dev-team
 ```
 
-> 이전 버전 캐시는 orgId가 없으므로 첫 호출 시 자동 갱신됩니다 (또는 `dooray cache clear`).
+interactive ($EDITOR) 모드에서는 위 6개 옵션이 무시되고 stderr 경고가 출력됩니다.
+`post edit --dry-run --json` 사용 시 출력에 `users: { to, cc }` 가 포함되어 API 호출 없이 변경 결과 미리보기 가능. (`post create --dry-run` 은 본문만 출력하며 `users` 는 포함하지 않음.)
+
+```bash
+dooray post edit <project> <post-number> --cc-group dev-team --dry-run --json | jq '.users.cc'
+# 출력 예: [{ "type": "group", "group": { "projectMemberGroupId": "...", "members": [] } }, ...]
+```
 
 #### comment list 필터 옵션
 
@@ -187,6 +219,18 @@ dooray post comment latest <project> 42 -n 3
 dooray post comment latest --url <dooray-url>
 ```
 
+#### comment get
+
+단일 댓글 ID 로 본문·메타·attachments 를 직접 fetch. `comment list` 후 jq 필터링 없이 바로 사용할 수 있어 자동화 파이프라인에 적합하다.
+
+```bash
+# 단일 댓글 조회 (자동화 친화)
+dooray post comment get <project> <post-number> <comment-id> --json | jq -r '.body.content'
+
+# ID / URL 모드
+dooray post comment get --id <postId> --comment-id <commentId> --json
+```
+
 ### 상태 변경
 
 ```bash