@bifos/dooray-cli 0.5.3 → 0.6.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bifos/dooray-cli",
-  "version": "0.5.3",
+  "version": "0.6.0",
   "description": "CLI tool for Dooray project management — AI agent & terminal friendly",
   "keywords": [
     "dooray",
@@ -26,7 +26,7 @@
     "README.md"
   ],
   "engines": {
-    "node": ">=18"
+    "node": ">=20"
   },
   "scripts": {
     "build": "tsup",

package/skills/dooray-cli/SKILL.md

@@ -45,7 +45,7 @@ dooray doctor                                 # 설정 검증
 
 자연어 요청을 커맨드로 변환할 때 아래 표를 참고한다.
 
-> **공통 (post 하위 12개 명령)**: `post get`/`edit`/`done`/`workflow`, `post comment list`/`add`/`edit`/`delete`, `post file list`/`upload`/`download`/`download-all`/`delete`는 `<project> <number>` 외에도 `--id <postId>`, `--url <url>`, 또는 첫 인자에 Dooray URL(`https://*.dooray.com/task/to/<postId>`)을 직접 받는다. **사용자가 URL을 줬으면 그대로 첫 인자로 전달**하는 것이 가장 빠른 경로 (resolve 단계 단축, ADR-020).
+> **공통 (post 하위 16개 명령)**: `post get`/`edit`/`done`/`workflow`, `post comment list`/`add`/`edit`/`delete`, `post file list`/`upload`/`download`/`download-all`/`delete`, `post comment file list`/`upload`/`download`/`delete`는 `<project> <number>` 외에도 `--id <postId>`, `--url <url>`, 또는 첫 인자에 Dooray URL(`https://*.dooray.com/task/to/<postId>` 또는 브라우저 주소창 복사본 `https://*.dooray.com/task/<projectId>/<postId>`)을 직접 받는다. **사용자가 URL을 줬으면 그대로 첫 인자로 전달**하는 것이 가장 빠른 경로 (resolve 단계 단축, ADR-020).
 
 | 의도 | 커맨드 |
 |------|--------|
@@ -53,7 +53,10 @@ dooray doctor                                 # 설정 검증
 | 프로젝트 찾기 | `dooray project list --search <keyword>` |
 | 개인 프로젝트 목록 | `dooray project list --type private` |
 | 프로젝트 멤버 보기 | `dooray project members <project>` 또는 `dooray member list <project>` (이름·organizationMemberId) |
+| 프로젝트 멤버 그룹 목록 | `dooray project groups <project>` (ID / Code) |
+| 프로젝트 태그 목록 | `dooray project tags <project>` (ID / Color / Name / Group / Mandatory) |
 | 멤버 상세 (organizationMemberId) | `dooray member get <organizationMemberId>` (cache 우회, ADR-021) |
+| organization 전체 멤버 검색 | `dooray member search <keyword>` (이름 기본), `--email`(이메일 exact), `--user-code`(사번 like), `--user-code-exact`(사번 exact), `--page`/`--size` |
 | 업무 목록 조회 | `dooray post list <project>` |
 | 업무 검색 | `dooray post search <project> "<keyword>"` |
 | 업무 상세 보기 | `dooray post get <project> <number>` |
@@ -61,7 +64,8 @@ dooray doctor                                 # 설정 검증
 | 업무 제목/본문 수정 | `dooray post edit <project> <number> --title "..." --body "..."` 또는 `--body-file <path>` |
 | 업무 완료 처리 | `dooray post done <project> <number>` |
 | 업무 워크플로우 변경 | `dooray post workflow <project> <number> <workflow>` |
-| 댓글 조회 | `dooray post comment list <project> <number>` (table 출력은 Creator 이름 자동 채움, `--json`은 raw 유지 — ADR-021) |
+| 댓글 조회 | `dooray post comment list <project> <number>` — `--sort asc\|desc`, `--reverse`, `--latest <n>`, `--since <iso>`, `--from-author <name>` 필터 지원. table 출력은 Creator 이름 자동 채움, `--json`은 raw 유지 (ADR-021) |
+| 최신 댓글 조회 | `dooray post comment latest <project> <number>` — 최신 댓글 1개 빠른 조회. `-n <N>`으로 N개 지정 |
 | 댓글 추가 | `dooray post comment add <project> <number> --body "..."` 또는 `--body-file <path>` |
 | 댓글 수정 | `dooray post comment edit <project> <number> <comment-id> --body "..."` 또는 `--body-file <path>` |
 | 댓글 삭제 | `dooray post comment delete <project> <number> <comment-id>` |
@@ -83,6 +87,10 @@ dooray doctor                                 # 설정 검증
 | 전체 첨부파일 다운로드 | `dooray post file download-all <project> <number>` |
 | 첨부파일 업로드 | `dooray post file upload <project> <number> <file-path>` |
 | 첨부파일 삭제 | `dooray post file delete <project> <number> <file-id>` |
+| 댓글 첨부 목록 | `dooray post comment file list <project> <number> <comment-id>` |
+| 댓글 파일 업로드 | `dooray post comment file upload <project> <number> <comment-id> <path>` |
+| 댓글 파일 다운로드 | `dooray post comment file download <project> <number> <comment-id> <file-id>` |
+| 댓글 파일 삭제 | `dooray post comment file delete <project> <number> <comment-id> <file-id> --yes` |
 
 > **제목 옵션 네이밍**: `post` 와 `wiki page` 모두 `--title` 표준. `post`의 `--subject`는 deprecated alias로 당분간 동작하되, 새 코드에서는 `--title` 사용을 권장.
 
@@ -108,7 +116,8 @@ CLI로 처리 **불가능한** 작업. 아래 항목을 요청받으면 웹 UI
 3. **업무 번호를 모르면** → `dooray post search <project> "<keyword>"` 로 검색
 4. **워크플로우 이름을 모르면** → `dooray project workflows <project>` 로 확인
 5. **멤버 이름을 모르면** → `dooray member list <project>` (또는 `dooray project members <project>`) 로 확인
-6. **결과를 다음 액션에 사용하려면** → `--json` 플래그로 구조화된 데이터 획득
+6. **org 전체 멤버를 찾으려면** → `dooray member search <keyword>` (이름), `--email <addr>`, `--user-code <code>` 중 하나 사용
+7. **결과를 다음 액션에 사용하려면** → `--json` 플래그로 구조화된 데이터 획득
 
 ---
 
@@ -118,11 +127,11 @@ CLI로 처리 **불가능한** 작업. 아래 항목을 요청받으면 웹 UI
 
 ```bash
 # 1. 업무 검색으로 번호 확인
-dooray post search tc-ocr "graceful shutdown" --json
+dooray post search <project> "graceful shutdown" --json
 # → [{ "number": 42, "subject": "graceful shutdown 구현", ... }]
 
 # 2. 완료 처리
-dooray post done tc-ocr 42
+dooray post done <project> 42
 ```
 
 ### 프로젝트 찾아서 업무 생성
@@ -143,43 +152,55 @@ dooray post create ai-service-dev \
 
 ```bash
 # 1. 업무 조회
-dooray post get tc-ocr 42 --json
+dooray post get <project> 42 --json
 
 # 2. 댓글 추가
-dooray post comment add tc-ocr 42 --body "진행 상황 업데이트: 80% 완료"
+dooray post comment add <project> 42 --body "진행 상황 업데이트: 80% 완료"
+```
+
+### 시나리오 — 댓글에 스크린샷 자동 첨부
+
+스크립트가 스크린샷을 댓글에 삽입하거나, 에이전트가 결과 파일을 첨부 댓글로 보고할 때 사용. Dooray REST API 가 댓글 전용 attachment endpoint 를 미지원하므로 내부적으로 post-level files API + 댓글 본문 PUT 합성으로 동작 (ADR-024).
+
+```bash
+# 1. 댓글을 먼저 만든다 (텍스트만, --json 으로 commentId 획득)
+COMMENT_ID=$(dooray post comment add <project> <post-num> --body "스크린샷 보고:" --json | jq -r '.id')
+
+# 2. 그 댓글에 파일을 첨부 (post-level 업로드 + 댓글 본문 markdown 자동 추가)
+dooray post comment file upload <project> <post-num> "$COMMENT_ID" ./screenshot.png
 ```
 
 ### 위키 페이지 조회
 
 ```bash
 # 1. 위키 페이지 목록
-dooray wiki pages tc-ocr --json
-# → [{ "id": "3052841366755571094", "subject": "설계 문서", ... }]
+dooray wiki pages <project> --json
+# → [{ "id": "<pageId>", "subject": "설계 문서", ... }]
 
 # 2. 페이지 내용 조회
-dooray wiki page get tc-ocr 3052841366755571094 --json
+dooray wiki page get <project> <pageId> --json
 ```
 
 ---
 
 ## 커맨드 상세
 
-### 업무 식별 방식 (post 하위 12개 명령 공통, ADR-020)
+### 업무 식별 방식 (post 하위 16개 명령 공통, ADR-020)
 
-`post get`/`edit`/`done`/`workflow`, `post comment list`/`add`/`edit`/`delete`, `post file list`/`upload`/`download`/`download-all`/`delete`는 4가지 입력을 모두 받는다:
+`post get`/`edit`/`done`/`workflow`, `post comment list`/`add`/`edit`/`delete`, `post file list`/`upload`/`download`/`download-all`/`delete`, `post comment file list`/`upload`/`download`/`delete`는 4가지 입력을 모두 받는다:
 
 ```bash
 # (1) 기존 positional — 가장 익숙한 형태
-dooray post get tc-ocr 42
+dooray post get <project> 42
 
 # (2) Dooray URL을 첫 인자로 — 사용자 메시지에서 URL을 그대로 복사할 때 최적
-dooray post get https://x.dooray.com/task/to/4319587406666362045
+dooray post get https://x.dooray.com/task/to/<postId>
 
 # (3) --id <postId>
-dooray post get --id 4319587406666362045
+dooray post get --id <postId>
 
 # (4) --url <url>
-dooray post get --url https://x.dooray.com/task/to/4319587406666362045
+dooray post get --url https://x.dooray.com/task/to/<postId>
 ```
 
 **우선순위 / 충돌 규칙**: `--id`+`--url` 동시 지정 → 에러. `--id`/`--url`+positional 동시 지정 → 에러. URL/`--id`/`--url` 모드는 standalone API(`getPost(postId)`)로 resolve 단계를 단축.
@@ -211,7 +232,7 @@ dooray post create <project> \
   --priority normal \           # highest, high, normal, low, lowest
   --due-date "2026-04-30T18:00:00+09:00" \
   --tag "버그" --tag "긴급" \   # 반복 지정. mandatory 그룹은 클라이언트 사전 검증
-  --parent "tc-ocr/337" \       # "code/number" 또는 raw postId 두 형태만 허용
+  --parent "<project>/337" \       # "code/number" 또는 raw postId 두 형태만 허용
   --workflow "진행 중" \         # 이름 또는 class (registered/working/closed). 부분일치 모호 시 후보 + 에러
   --milestone "Sprint 12"
 ```
@@ -243,8 +264,90 @@ dooray post comment add <project> <number> --body "댓글 내용"
 dooray post comment add <project> <number> --body-file ./comment.md
 ```
 
+### 댓글 목록 필터 (non-interactive)
+
+```bash
+# 최신 5개
+dooray post comment list <project> <number> --latest 5
+# 특정 날짜 이후
+dooray post comment list <project> <number> --since 2026-04-27
+# 작성자 필터
+dooray post comment list <project> <number> --from-author 홍길동
+# 최신 댓글 1개 빠른 조회
+dooray post comment latest <project> <number>
+```
+
 ---
 
+## 멘션 자동 작성 (post comment add/edit)
+
+`--mention <name>` (반복) 또는 `--mention-group <code>` (반복)으로 본문 앞에 멘션 마크업을 자동 prepend한다. 아래 "Dooray 마크다운 링크 형식" 섹션의 URL 형식을 자동 출력한다.
+
+```bash
+dooray post comment add P 1 --mention 홍길동 --mention-group 개발 --body "..."
+# 결과 본문: [@홍길동](dooray://orgId/members/m1 "member") [@P/개발](dooray://orgId/member-groups/g1) ...
+```
+
+- 이름 부분일치 지원 (모호하면 에러 + 후보 목록 출력)
+- 멤버 먼저, 그룹 다음 순서 고정
+- comment edit에도 동일 옵션 사용 (`$EDITOR` 모드에서는 EDITOR 진입 전에 prepend)
+
+## Dooray 마크다운 링크 형식 (멤버·그룹·업무 멘션)
+
+댓글/본문 작성 시 다음 형식으로 마크업하면 Dooray 앱이 인식해 inline 멘션·navigation으로 렌더링한다. ID는 본인 환경 값으로 채워 사용 — `dooray member get` / `project groups` / `post get` 등으로 조회.
+
+### 멤버 멘션
+```markdown
+[@본인이름](dooray://{orgId}/members/{memberId} "me")
+[@타인이름](dooray://{orgId}/members/{memberId} "member")
+```
+- title 속성: 본인은 `"me"`, 타인은 `"member"`
+- URL: `dooray://{orgId}/members/{memberId}`
+
+### 그룹 멘션 (member-group)
+```markdown
+[@projectCode/그룹명](dooray://{orgId}/member-groups/{groupId})
+```
+- **`projects/{projectId}/` 경로 포함하지 않음** (직관과 반대 — 흔한 실수)
+- title 속성 **없음**
+- URL: `dooray://{orgId}/member-groups/{groupId}`
+
+### 업무(task) 링크
+```markdown
+[projectCode/{number} {subject}](dooray://{orgId}/tasks/{postId} "registered")
+```
+- 표시 텍스트: `{project}/{number} {subject}`
+- URL: `dooray://{orgId}/tasks/{postId}`
+- title: workflow class — `registered` / `working` / `closed` / `backlog`
+- 클릭 시 외부 브라우저 안 열고 Dooray 앱 내부 navigation + workflow 상태 표시
+
+### 필요 ID 조회 명령
+
+| ID | 조회 |
+|---|---|
+| `orgId` | Dooray 앱/웹 URL에서 추출 (`https://{org}.dooray.com/...`의 도메인 + 별도 확인 필요) |
+| `memberId` | `dooray member get <id>`, `dooray member search <name>`, `--email <addr>`, `--user-code <code>` 등으로 검색 |
+| `groupId` | `dooray project groups <project>` |
+| `postId` | `dooray post get <project> <number> --json` 의 `id` 필드 |
+
+---
+
+## 피드백 (GitHub Issue 등록)
+
+`dooray feedback` 명령으로 dooray-cli GitHub issue를 직접 등록한다 (`gh` CLI 위임).
+
+```bash
+# 논인터랙티브 (non-interactive — 에이전트 자동화용)
+dooray feedback --title "버그 제목" --body "재현 방법" --label "bug"
+
+# --last 모드 (직전 에러 자동 첨부 — track-last-run 활성화 필요)
+dooray config set track-last-run true
+dooray feedback --last --title "에러 제목" --body "추가 설명" --dry-run  # 미리보기
+dooray feedback --last --title "에러 제목" --body "추가 설명"            # 실제 등록
+```
+
+> **참고**: `--last` 모드는 `trackLastRun: true` (ADR-023 opt-in)가 설정된 경우에만 직전 실패 명령이 자동 기록됨. argv는 시크릿 패턴(`--api-key`/`--token`/`Authorization`) 마스킹 후 저장.
+
 ## 에러 핸들링
 
 CLI 에러 발생 시 복구 방법: