@bifos/dooray-cli - npm Package Compare versions

Comparing version 0.10.0 to 0.10.1

package.json

 {
   "name": "@bifos/dooray-cli",
-  "version": "0.10.0",
+  "version": "0.10.1",
   "description": "CLI tool for Dooray project management — AI agent & terminal friendly",
@@ -5,0 +5,0 @@ "keywords": [

README.md

@@ -212,3 +212,19 @@ # dooray-cli
 
+**그룹 cc / mention 사용 예 (Issue #76 fix)**:
+
 ```bash
+# code 부분일치
+dooray post create <project> ... --cc-group "개발"
+
+# code 정확 일치
+dooray post create <project> ... --mention-group "all"
+
+# 19자리 id 직접 입력 (response shape robustness 또는 code 누락 그룹 회피)
+dooray post create <project> ... --cc-group "<19자리 group id>"
+
+# 후보 탐색
+dooray project groups <project>
+```
+
+```bash
 dooray post edit <project> <post-number> --cc-group dev-team --dry-run --json | jq '.users.cc'
@@ -215,0 +231,0 @@ # 출력 예: [{ "type": "group", "group": { "projectMemberGroupId": "...", "members": [] } }, ...]

skills/dooray-cli/SKILL.md

@@ -114,2 +114,3 @@ ---
 | 신규 업무 + 그룹 cc | `dooray post create <project> --title "..." --cc-group <code>` — 생성 시 그룹 참조자 포함 |
+| `--cc-group <code\|id>` / `--mention-group <code\|id>` | 그룹 매칭 — 15+자리 numeric → id 직접 / 그 외 → code matchByName (부분일치, ADR-028) |
 | 상위 업무 설정/변경 | `dooray post edit <project> <number> --title "<원제목>" --parent <ref>` (`<ref>`: `<project>/<number>` 또는 raw postId. `--title` 필수, unset 미지원) |
@@ -455,2 +456,31 @@ | `dooray post edit --id <postId> --tag <name>` | 태그 추가 (반복, dedupe) |
 
+## 그룹 멘션 / cc 시 AI agent 동선 (Issue #76, ADR-028)
+
+자연어 그룹명을 사용자가 지칭했을 때 AI agent 의 의사결정 순서:
+
+1. **사용자가 명확한 code 를 줬으면 바로 시도**
+   ```bash
+   dooray post create <project> --mention-group "<code>"
+   ```
+   부분일치 가능 (예: "AI-Data" → "AI-Data파트" 매칭).
+
+2. **부분일치 모호 / 매칭 실패 시 후보 탐색**
+   ```bash
+   dooray project groups <project>
+   ```
+   ID + Code 표 출력.
+   AI agent 가 자연어 의도와 가장 가까운 code 선택 후 재시도.
+
+3. **모든 컬럼이 빈값일 때 (response shape 이상) 회피**
+   - ADR-028 fix 이후 거의 발생 안 함 (`fetchAllMemberGroups` 가 nested array 정규화)
+   - 만약 발생 시: 사용자에게 그룹 id (UI 의 그룹 URL 에서 19자리 numeric) 확인 요청
+   - `--cc-group <id>` / `--mention-group <id>` 직접 입력
+   - 또는 그룹 멤버를 개별 `--cc <member>` / `--mention <member>` 로 지정
+
+4. **모호한 자연어 매핑은 사용자에게 확인**
+   - 후보가 여러 개일 때 임의 선택 금지 — 사용자에게 선택지 제시
+   - 예: "AI-Data파트 / AI-Data실험팀 — 어느 그룹인가요?"
+
+순서 고정 — 멤버 먼저, 그룹 다음 (기존 정책 유지).
+
 ## 멘션·링크 자동 삽입 (first-class)
@@ -457,0 +487,0 @@

No alert changes

Improved metrics

Total package byte prevSize

299486

0.91%

Lines of code

5635

0.27%

Number of lines in readme file

617

2.66%

No dependency changes