@bifos/dooray-cli 0.5.2 → 0.5.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bifos/dooray-cli",
-  "version": "0.5.2",
+  "version": "0.5.4",
   "description": "CLI tool for Dooray project management — AI agent & terminal friendly",
   "keywords": [
     "dooray",
@@ -30,7 +30,9 @@
   },
   "scripts": {
     "build": "tsup",
-    "dev": "tsup --watch"
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "test:watch": "vitest"
   },
   "license": "MIT",
   "dependencies": {
@@ -53,6 +55,7 @@
     "@types/nodemailer": "^7.0.11",
     "@types/tmp": "^0.2.6",
     "tsup": "^8.5.1",
-    "typescript": "^6.0.2"
+    "typescript": "^6.0.2",
+    "vitest": "^4.1.5"
   }
 }

package/skills/dooray-cli/SKILL.md

@@ -45,20 +45,26 @@ 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).
+
 | 의도 | 커맨드 |
 |------|--------|
 | 초기 설정 (대화형) | `dooray setup` |
 | 프로젝트 찾기 | `dooray project list --search <keyword>` |
 | 개인 프로젝트 목록 | `dooray project list --type private` |
-| 프로젝트 멤버 보기 | `dooray project members <project>` |
+| 프로젝트 멤버 보기 | `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) |
 | 업무 목록 조회 | `dooray post list <project>` |
 | 업무 검색 | `dooray post search <project> "<keyword>"` |
 | 업무 상세 보기 | `dooray post get <project> <number>` |
-| 업무 생성 | `dooray post create <project> --title "..." --body "..."` 또는 `--body-file <path>` (`--body`와 `--body-file`은 동시 사용 불가) |
+| 업무 생성 | `dooray post create <project> --title "..." --body "..."` 또는 `--body-file <path>` (`--body`와 `--body-file`은 동시 사용 불가, `--tag`/`--parent`/`--workflow`/`--milestone` 지원) |
 | 업무 제목/본문 수정 | `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>` |
+| 댓글 조회 | `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>` |
@@ -104,7 +110,7 @@ CLI로 처리 **불가능한** 작업. 아래 항목을 요청받으면 웹 UI
 2. **프로젝트 코드를 모르면** → `dooray project list --search <keyword>` 로 먼저 찾기
 3. **업무 번호를 모르면** → `dooray post search <project> "<keyword>"` 로 검색
 4. **워크플로우 이름을 모르면** → `dooray project workflows <project>` 로 확인
-5. **멤버 이름을 모르면** → `dooray project members <project>` 로 확인
+5. **멤버 이름을 모르면** → `dooray member list <project>` (또는 `dooray project members <project>`) 로 확인
 6. **결과를 다음 액션에 사용하려면** → `--json` 플래그로 구조화된 데이터 획득
 
 ---
@@ -161,6 +167,42 @@ dooray wiki page get tc-ocr 3052841366755571094 --json
 
 ## 커맨드 상세
 
+### 업무 식별 방식 (post 하위 12개 명령 공통, ADR-020)
+
+`post get`/`edit`/`done`/`workflow`, `post comment list`/`add`/`edit`/`delete`, `post file list`/`upload`/`download`/`download-all`/`delete`는 4가지 입력을 모두 받는다:
+
+```bash
+# (1) 기존 positional — 가장 익숙한 형태
+dooray post get tc-ocr 42
+
+# (2) Dooray URL을 첫 인자로 — 사용자 메시지에서 URL을 그대로 복사할 때 최적
+dooray post get https://x.dooray.com/task/to/4319587406666362045
+
+# (3) --id <postId>
+dooray post get --id 4319587406666362045
+
+# (4) --url <url>
+dooray post get --url https://x.dooray.com/task/to/4319587406666362045
+```
+
+**우선순위 / 충돌 규칙**: `--id`+`--url` 동시 지정 → 에러. `--id`/`--url`+positional 동시 지정 → 에러. URL/`--id`/`--url` 모드는 standalone API(`getPost(postId)`)로 resolve 단계를 단축.
+
+**sub-id 옵션화** (URL/`--id`/`--url` 모드에서 필수):
+```bash
+# comment edit/delete: --comment-id
+dooray post comment edit  --url <url> --comment-id <commentId> --body "..."
+dooray post comment delete --url <url> --comment-id <commentId>
+
+# file download/delete: --file-id
+dooray post file download --url <url> --file-id <fileId> -o ./downloads
+dooray post file delete   --url <url> --file-id <fileId>
+
+# file upload: --file (로컬 경로)
+dooray post file upload   --url <url> --file ./report.pdf
+```
+
+기존 positional 3-arg(`comment edit <project> <number> <comment-id>`, `file upload <project> <number> <path>`)는 그대로 유지.
+
 ### 업무 생성 (non-interactive)
 
 ```bash
@@ -170,7 +212,11 @@ dooray post create <project> \
   --to "담당자이름" \           # 여러 명: --to "김철수" --to "이영희"
   --cc "참조자이름" \
   --priority normal \           # highest, high, normal, low, lowest
-  --due-date "2026-04-30T18:00:00+09:00"
+  --due-date "2026-04-30T18:00:00+09:00" \
+  --tag "버그" --tag "긴급" \   # 반복 지정. mandatory 그룹은 클라이언트 사전 검증
+  --parent "tc-ocr/337" \       # "code/number" 또는 raw postId 두 형태만 허용
+  --workflow "진행 중" \         # 이름 또는 class (registered/working/closed). 부분일치 모호 시 후보 + 에러
+  --milestone "Sprint 12"
 ```
 
 본문이 길면 파일로 (`--body`와 `--body-file`은 함께 사용 불가):
@@ -178,6 +224,8 @@ dooray post create <project> \
 dooray post create <project> --title "제목" --body-file ./content.md
 ```
 
+> **`--workflow` 동작 주의**: 워크플로우 설정은 post 생성 *후속* 호출이므로, 워크플로우 resolve/설정에 실패해도 stderr 경고만 출력되고 **exit code는 0** (post는 이미 생성됨). 자동화 스크립트에서 워크플로우 적용 여부를 보장해야 하면 stderr를 별도 점검할 것.
+
 ### 업무 수정 (non-interactive)
 
 ```bash
@@ -198,6 +246,59 @@ 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>
+```
+
+---
+
+## 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 project members <project>` |
+| `groupId` | `dooray project groups <project>` |
+| `postId` | `dooray post get <project> <number> --json` 의 `id` 필드 |
+
 ---
 
 ## 에러 핸들링