@bifos/dooray-cli 0.8.0 → 0.10.0

package/README.md

@@ -23,7 +23,11 @@ npm install -g @bifos/dooray-cli
 dooray setup
 ```
 
-API Endpoint 선택 → API Key 입력 → 연결 테스트 → 메일 설정(선택)을 순서대로 진행합니다.
+아래 순서로 진행합니다:
+1. API Endpoint 선택
+2. API Key 입력
+3. 연결 테스트
+4. 메일 설정 (선택)
 API 토큰은 `https://{tenant}.dooray.com/setting/api/token`에서 발급할 수 있습니다.
 
 수동 설정도 가능합니다:
@@ -46,6 +50,7 @@ dooray project members <project>              # 멤버 목록
 dooray project workflows <project>            # 워크플로우 목록
 dooray project groups <project>              # 멤버 그룹 목록 (ID / Code)
 dooray project tags <project>                # 태그 목록 (ID / Color / Name / Group / Mandatory)
+dooray project templates <project>          # 템플릿 목록 (ID / Template Name, ADR-027)
 ```
 
 > **태그 캐시 갱신**: 이전 버전에서 캐시한 태그가 색상 없이 표시되면 `dooray cache clear` 실행 후 다시 조회하세요.
@@ -83,7 +88,8 @@ dooray post get <project> 42 --json           # JSON 출력
 | `--id <postId>` | `dooray post get --id <postId>` |
 | `--url <url>` | `dooray post get --url https://x.dooray.com/task/to/...` |
 
-대상: `post get`/`edit`/`done`/`workflow`, `post comment list`/`add`/`edit`/`delete`, `post file list`/`upload`/`download`/`download-all`/`delete`. AI 에이전트는 사용자 메시지의 Dooray URL을 그대로 첫 인자로 전달하면 가장 빠르다 (ADR-020).
+대상: `post get`/`edit`/`done`/`workflow`, `post comment list`/`add`/`edit`/`delete`, `post file list`/`upload`/`download`/`download-all`/`delete`.
+AI 에이전트는 사용자 메시지의 Dooray URL을 그대로 첫 인자로 전달하면 가장 빠르다 (ADR-020).
 
 ### 업무 생성
 
@@ -106,7 +112,27 @@ dooray post create <project> \
   --milestone "Sprint 12"
 ```
 
-> mandatory-tag 정책 프로젝트(예: `<project>`)에서는 mandatory 그룹마다 1개 이상 `--tag`로 지정해야 한다. 누락 시 클라이언트가 사전 검증으로 후보 목록과 함께 에러 출력.
+> mandatory-tag 정책 프로젝트(예: `<project>`)에서는 mandatory 그룹마다 1개 이상 `--tag`로 지정해야 한다.
+> 누락 시 클라이언트가 사전 검증으로 후보 목록과 함께 에러 출력.
+
+#### 템플릿 기반 정형 task (ADR-027)
+
+```bash
+# 프로젝트의 템플릿 목록
+dooray project templates <project>
+
+# 템플릿으로 업무 생성 (body/users/tags 자동 채움)
+dooray post create <project> --template "릴리스 플랜"
+
+# 사용자 옵션 override — 일부 필드만 다르게
+dooray post create <project> --template "릴리스 플랜" --title "v0.9 릴리스 계획" --tag "p0"
+
+# 19자리 templateId 직접 입력
+dooray post create <project> --template 1234567890123456789 --title "by id"
+```
+
+`interpolation=true` 가 기본 — Dooray 가 `${year}`, `${month}` 같은 시스템 매크로를 응답에서 자동 치환.
+사용자 정의 변수 (`--field key=value`) 는 본 release scope 외.
 
 ### 업무 수정
 
@@ -123,7 +149,8 @@ dooray post edit <project> 42 --body-file ./updated.md
 
 #### 본문 변경 시 attachment 보호
 
-`post edit` 와 `post comment edit` 는 본문을 통째로 replace 합니다. 새 본문에 기존 inline attachment markdown(`![](/files/<id>)`)이 빠져 있으면 stderr 에 경고를 띄우고 (y/N) 로 물어봅니다.
+`post edit` 와 `post comment edit` 는 본문을 통째로 replace 합니다.
+새 본문에 기존 inline attachment markdown(`![](/files/<id>)`)이 빠져 있으면 stderr 에 경고를 띄우고 (y/N) 로 물어봅니다.
 
 자동화 환경 (pipe / non-TTY) 에서는 그대로 abort 됩니다. 의도한 변경이면 `--no-confirm` 으로 다시 실행하세요.
 
@@ -179,13 +206,73 @@ dooray post create <project> --title "주간 audit" --cc-group dev-team
 ```
 
 interactive ($EDITOR) 모드에서는 위 6개 옵션이 무시되고 stderr 경고가 출력됩니다.
-`post edit --dry-run --json` 사용 시 출력에 `users: { to, cc }` 가 포함되어 API 호출 없이 변경 결과 미리보기 가능. (`post create --dry-run` 은 본문만 출력하며 `users` 는 포함하지 않음.)
+`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": [] } }, ...]
 ```
 
+#### 생성 후 태그 변경 (Issue #66)
+
+```bash
+# 기존 태그 유지 + 신규 추가 (dedupe)
+dooray post edit --id <postId> --tag "<group>: <name>"
+
+# 기존 태그 전부 제거 + 신규만 적용
+dooray post edit --id <postId> --tag-clear --tag "<group>: <name>"
+
+# 특정 태그만 제거 (기존 유지)
+dooray post edit --id <postId> --tag-remove "<group>: <name>"
+```
+
+`--title` / `--body` 없이 단독 호출 가능 — 기존 본문은 자동 재전송.
+mandatory tag 그룹은 `post create` 와 동일하게 사전 검증 (ADR-019).
+
+#### 상위 업무 변경 (`--parent`)
+
+```bash
+# 자식 업무에 부모 지정
+dooray post edit <project> <child-number> --title "<원제목>" --parent <project>/<parent-number>
+
+# 다른 부모로 변경
+dooray post edit --id <postId> --title "<원제목>" --parent <other-parent-postId>
+```
+
+내부적으로 `client.updatePost` 호출 후 별도 `POST .../set-parent-post` endpoint 추가 호출.
+**parent 해제 (top-level 화)** 는 Dooray API 가 미지원이라 웹 UI 에서 수동 처리.
+
+interactive ($EDITOR) 모드에서 `--parent` 사용 시 무시 + stderr 경고.
+**parent 만 단독 변경하려면 `--title "<원제목>"` 동반 필요** — `post edit` 는 본문 변경(`--title`/`--body`) 동반 시에만 non-interactive 분기로 들어감.
+parent 변경은 그 분기 안에서만 수행됨. (Issue #60)
+
+`--dry-run --json` 출력의 `parentChange` 필드는 **사용자 입력 원문 그대로** (`<project>/<number>` 또는 raw postId).
+resolver 처리 전 미리보기 값이며 실제 호출 대상 `postId` 가 아님.
+dry-run 은 API 미호출 원칙을 유지해 `resolvePostRef` 도 건너뜀.
+
+#### `--to` / `--cc` / `--mention` 입력 형식 (자동 분기)
+
+이름 외에도 이메일 / organizationMemberId 직접 입력 가능 — **동명이인 우회 + ID 직접 입력** (Issue #58):
+
+```bash
+# 이름 (이전부터 지원, 부분일치)
+dooray post create <project> --title "..." --cc 홍길동
+
+# 이메일 (동명이인 우회)
+dooray post create <project> --title "..." --cc user@example.com
+
+# organizationMemberId 직접
+dooray post create <project> --title "..." --cc 1234567890123456789
+```
+
+분기 규칙 (`resolveMember` 자동 판단):
+- `^\d{15,}$` — memberId 직접 사용
+- `^[^\s@]+@[^\s@]+\.[^\s@]+$` — 이메일, `searchMembers` exact 조회
+- 그 외 — 이름 부분일치
+
+`member search --email` 의 인프라 재사용.
+
 #### comment list 필터 옵션
 
 ```bash
@@ -250,6 +337,79 @@ dooray wiki page edit <project> <page-id> --body "..." | --body-file <path>  #
 dooray wiki page edit <project> <page-id>                                     # $EDITOR (플래그 없을 때)
 ```
 
+#### 위키 페이지 첨부파일 (Issue #70)
+
+post 의 `post file` 명령군과 동일 패턴 — `<project> <page-id>` 외에도 `--id`/`--url`/positional URL 지원.
+
+```bash
+# 목록 (general 첨부 + inline image 둘 다 표시, type 컬럼)
+dooray wiki page file list <project> <page-id>
+
+# 업로드 (기본 general — 페이지 하단 첨부 영역)
+dooray wiki page file upload <project> <page-id> --file ./SKILL.md
+# stdout: attachFileId + 파일 메타 출력
+
+# 인라인 이미지 업로드 (본문 markdown 은 사용자가 직접 박음)
+dooray wiki page file upload <project> <page-id> --file ./diagram.png --type inline_image
+# stdout 에 본문 삽입용 markdown snippet 안내
+
+# 다운로드
+dooray wiki page file download <project> <page-id> --file-id <id> -o ./
+
+# 페이지 모든 첨부 (files + images) 일괄 다운로드
+dooray wiki page file download-all <project> <page-id> -o ./attachments/
+
+# 삭제 (confirm 없이 즉시)
+dooray wiki page file delete <project> <page-id> --file-id <id>
+
+# URL 모드 (--id 모드는 --project 동반 필요)
+dooray wiki page file list "https://<tenant>.dooray.com/wiki/<wikiId>/<pageId>"
+dooray wiki page file upload --id <pageId> --project <project> --file ./README.md
+```
+
+**주의**:
+- `upload` 시 multipart 필드 순서 (`type` → `file`) 가 중요.
+  클라이언트가 자동으로 강제 (ADR-029 참조)
+- `inline_image` 로 올린 파일은 본문에 markdown 으로 박혀야 위키에서 보임.
+  upload stdout 의 snippet 을 복사해서 `dooray wiki page edit` 으로 본문에 직접 추가
+- `delete` 는 confirm 없이 즉시 삭제 (실수 방지 책임은 호출자)
+
+#### 위키 페이지 댓글
+
+post 의 `post comment` 명령군과 동일 패턴 — `<project> <page-id>` 외에도 `--id`/`--url`/positional URL 지원.
+
+```bash
+# 목록 (최신순)
+dooray wiki page comment list <project> <page-id>
+dooray wiki page comment list <project> <page-id> --latest 5
+
+# 최신 1건 shortcut
+dooray wiki page comment latest <project> <page-id>
+
+# 단일 조회
+dooray wiki page comment get <project> <page-id> <comment-id>
+
+# 추가 — interactive ($EDITOR) 또는 옵션
+dooray wiki page comment add <project> <page-id>                          # $EDITOR
+dooray wiki page comment add <project> <page-id> --body "회의 결정 사항"
+dooray wiki page comment add <project> <page-id> --body-file ./note.md
+echo "댓글" | dooray wiki page comment add <project> <page-id> --body -
+
+# 수정 — interactive ($EDITOR, 기존 본문 prefill) 또는 옵션
+dooray wiki page comment edit <project> <page-id> <comment-id> --body "..."
+
+# 삭제 (confirm 없이 즉시)
+dooray wiki page comment delete <project> <page-id> <comment-id>
+
+# URL 모드
+dooray wiki page comment list "https://<tenant>.dooray.com/wiki/<wikiId>/<pageId>"
+```
+
+**post comment 와의 차이**:
+- mention / cc / 받는 사람 미지원 — wiki API 부재
+- 첨부 파일 미지원 — wiki comment 전용 endpoint 부재 (페이지 본문 파일은 `wiki page file` 사용)
+- 본문은 markdown 그대로 전송 (mimeType 자동)
+
 ### 메일
 
 IMAP을 통해 Dooray 메일을 조회할 수 있습니다. 메일 설정은 `dooray setup`에서 한 번에 진행하거나, 수동으로 설정할 수 있습니다.
@@ -309,7 +469,8 @@ dooray post comment delete --url <url> --comment-id <commentId>
 
 ### 댓글 첨부 파일 (`post comment file *`)
 
-자동화로 댓글에 인라인 이미지 / 파일을 삽입할 때 사용. 4 명령 (list/upload/download/delete) 모두 `<project> <post-number> <comment-id>` 또는 `--id <postId> --comment-id <logId>` / `--url <url> --comment-id <logId>` 패턴 지원 (ADR-020).
+자동화로 댓글에 인라인 이미지 / 파일을 삽입할 때 사용.
+4 명령 (list/upload/download/delete) 모두 `<project> <post-number> <comment-id>` 또는 `--id <postId> --comment-id <logId>` / `--url <url> --comment-id <logId>` 패턴 지원 (ADR-020).
 
 ```bash
 # 첨부 목록
@@ -345,7 +506,8 @@ dooray post list <project> --quiet | xargs -I{} dooray post done <project> {}
 
 ## AI 에이전트 연동
 
-`skills/dooray-cli/SKILL.md`에 AI 에이전트를 위한 스킬 파일이 포함되어 있습니다. Claude Code 등의 AI 에이전트에서 dooray-cli를 자동으로 활용할 수 있도록 의도→커맨드 매핑, 체이닝 예시, 에러 핸들링 가이드가 포함되어 있습니다.
+`skills/dooray-cli/SKILL.md`에 AI 에이전트를 위한 스킬 파일이 포함되어 있습니다.
+Claude Code 등의 AI 에이전트에서 dooray-cli를 자동으로 활용할 수 있도록 의도→커맨드 매핑, 체이닝 예시, 에러 핸들링 가이드가 포함되어 있습니다.
 
 ```bash
 # 스킬 파일 복사 (Claude Code 예시)
@@ -409,7 +571,7 @@ dooray --help
 
 ### CI (`.github/workflows/ci.yml`)
 - 트리거: `main` 으로 push, `main` 대상 PR
-- 동작: `pnpm install --frozen-lockfile` → `pnpm test` → `pnpm build` (Node 18, ubuntu-latest)
+- 동작: `pnpm install --frozen-lockfile`, `pnpm test`, `pnpm build` (Node 18, ubuntu-latest)
 - 별도 secret 불필요
 
 ### Claude code review (`.github/workflows/claude-code-review.yml`)
@@ -425,11 +587,13 @@ dooray --help
 
 #### 비용 / 토큰
 
-각 PR 당 4 specialist 가 모두 `haiku` 모델로 동작 — 평균 PR 1건 당 수십 센트 수준. PR 자동 트리거 비활성화하려면 `claude-code-review.yml` 의 `if:` 조건에서 `github.event_name == 'pull_request'` 분기를 제거하고 `/review` 댓글 트리거만 남길 수 있음.
+각 PR 당 4 specialist 가 모두 `haiku` 모델로 동작 — 평균 PR 1건 당 수십 센트 수준.
+PR 자동 트리거 비활성화하려면 `claude-code-review.yml` 의 `if:` 조건에서 `github.event_name == 'pull_request'` 분기를 제거하고 `/review` 댓글 트리거만 남길 수 있음.
 
 #### Fork PR 제한
 
-GitHub Actions 정책상 fork 에서 열린 PR 은 `secrets.CLAUDE_CODE_OAUTH_TOKEN` 에 접근 못 해 **자동 리뷰가 silent 하게 skip** 된다. fork 기여자가 리뷰를 받으려면 maintainer 가 PR 댓글에 `/review` 를 작성하여 base repo 컨텍스트로 워크플로를 트리거해야 한다.
+GitHub Actions 정책상 fork 에서 열린 PR 은 `secrets.CLAUDE_CODE_OAUTH_TOKEN` 에 접근 못 해 **자동 리뷰가 silent 하게 skip** 된다.
+fork 기여자가 리뷰를 받으려면 maintainer 가 PR 댓글에 `/review` 를 작성하여 base repo 컨텍스트로 워크플로를 트리거해야 한다.
 
 ## 라이센스