@rlarua/agentteams-cli 0.0.11 → 0.0.12

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1 +1 @@
1
- {"version":3,"file":"report.d.ts","sourceRoot":"","sources":["../../src/commands/report.ts"],"names":[],"mappings":"AAiDA,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,GAAG,EACZ,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,GAAG,GACX,OAAO,CAAC,GAAG,CAAC,CA+Jd"}
1
+ {"version":3,"file":"report.d.ts","sourceRoot":"","sources":["../../src/commands/report.ts"],"names":[],"mappings":"AAiDA,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,GAAG,EACZ,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,GAAG,GACX,OAAO,CAAC,GAAG,CAAC,CAmKd"}
@@ -137,6 +137,9 @@ export async function executeReportCommand(apiUrl, headers, action, options) {
137
137
  body.pullRequestId = pullRequestId;
138
138
  if (qualityScore !== undefined)
139
139
  body.qualityScore = qualityScore;
140
+ if (body.planId && durationSeconds === undefined) {
141
+ console.info('[info] durationSeconds is omitted; server will auto-calculate from linked plan timing when available.');
142
+ }
140
143
  return withSpinner('Creating report...', async () => {
141
144
  try {
142
145
  return await createReport(apiUrl, options.projectId, headers, body);
@@ -1 +1 @@
1
- {"version":3,"file":"report.js","sourceRoot":"","sources":["../../src/commands/report.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"report.js","sourceRoot":"","sources":["../../src/commands/report.ts"],"names":[],"mappings":"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"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@rlarua/agentteams-cli",
3
- "version": "0.0.11",
3
+ "version": "0.0.12",
4
4
  "description": "CLI tool for AgentTeams API",
5
5
  "type": "module",
6
6
  "main": "dist/index.js",
@@ -1,418 +0,0 @@
1
- ---
2
- trigger:
3
- description:
4
- agentInstruction: |
5
- 본 문서는 한국어로 작성해주세요.
6
- ---
7
- # API ↔ CLI 워크플로우
8
-
9
- 이 문서는 AgentTeams CLI(`agentteams`)가 API 서버와 어떻게 통신하는지, 그리고 그 결과로 로컬 워크스페이스에 어떤 파일이 생성/업데이트되는지를 설명합니다.
10
-
11
- ## 범위(Scope)
12
-
13
- - CLI 인증/설정(config) 로딩 규칙
14
- - 요청/응답 컨벤션(엔벨로프, 페이지네이션)
15
- - 엔드투엔드 흐름(Plan → Comments/Status → Completion Report → Postmortem)
16
- - CLI가 생성하는 로컬 파일 위치 및 역할
17
- - (추가) 공통 출력 UX(`--output-file`, `--verbose`)와 단축 워크플로우(`plan start/finish`)
18
-
19
- > 최종 소스 오브 트루스는 코드입니다. 이 문서는 운영/사용 가이드입니다.
20
-
21
- ---
22
-
23
- ## 구성 요소와 책임
24
-
25
- - CLI(`/cli`)
26
- - 커맨드 파싱: `commander`
27
- - HTTP 호출: `axios`
28
- - 설정 로딩: `.agentteams/config.json`, `~/.agentteams/config.json`, `AGENTTEAMS_*`
29
- - 로컬 아티팩트 생성: 플랜 스냅샷(runbook), 컨벤션/가이드 다운로드 파일
30
- - (추가) 공통 출력 UX: `--output-file`, `--verbose`
31
- - (추가) 단축 워크플로우: `agentteams plan start|finish`
32
- - API(`/api`)
33
- - REST API: Fastify
34
- - 인증/권한: 주로 `X-API-Key` 기반
35
- - DB 접근: Prisma
36
- - Swagger UI: `/docs`
37
-
38
- ---
39
-
40
- ## 인증(Authentication)과 설정(Config) 로딩
41
-
42
- ### `agentteams init` (최초 설정)
43
-
44
- 개요 흐름:
45
-
46
- 1. 로컬 OAuth 콜백 서버를 실행합니다.
47
- 2. 브라우저에서 authorize 페이지를 엽니다(SSH 환경에서는 URL을 출력).
48
- 3. `apiUrl`, `apiKey`, `teamId`, `projectId`, `agentName`을 수신하고 로컬에 저장합니다.
49
- 4. 컨벤션 템플릿을 `.agentteams/convention.md`로 저장합니다.
50
- 5. 컨벤션/플랫폼 가이드를 `.agentteams/*`로 다운로드합니다.
51
-
52
- ```mermaid
53
- sequenceDiagram
54
- participant U as "User"
55
- participant CLI as "CLI (agentteams)"
56
- participant WEB as "Web (Authorize)"
57
- participant API as "API"
58
- participant FS as "Local FS"
59
-
60
- U->>CLI: agentteams init
61
- CLI->>CLI: Start local OAuth callback server
62
- CLI->>WEB: Open/print authorize URL
63
- WEB->>CLI: OAuth callback (auth result)
64
- CLI->>FS: Write .agentteams/config.json
65
- CLI->>API: Fetch convention template
66
- API-->>CLI: template(content)
67
- CLI->>FS: Write .agentteams/convention.md
68
- CLI->>API: Download conventions
69
- API-->>CLI: conventions (+ platform guides)
70
- CLI->>FS: Write .agentteams/<category>/*.md and manifest
71
- ```
72
-
73
- ### 설정 우선순위(높음 → 낮음)
74
-
75
- 1. CLI option overrides (some commands only)
76
- 2. Env vars `AGENTTEAMS_*`
77
- 3. Project config: nearest `.agentteams/config.json` found by walking up from `cwd`
78
- 4. Global config: `~/.agentteams/config.json`
79
-
80
- 지원 환경변수:
81
-
82
- - `AGENTTEAMS_API_KEY`
83
- - `AGENTTEAMS_API_URL`
84
- - `AGENTTEAMS_TEAM_ID`
85
- - `AGENTTEAMS_PROJECT_ID`
86
- - `AGENTTEAMS_AGENT_NAME`
87
-
88
- ### 기본 요청 헤더
89
-
90
- - `X-API-Key: key_...`
91
- - `Content-Type: application/json`
92
-
93
- 예외:
94
-
95
- - `DELETE` 요청은 서버의 빈 JSON body 검증 충돌을 피하기 위해 `Content-Type`을 포함하지 않습니다.
96
-
97
- API는 다음 중 하나를 허용합니다:
98
-
99
- - `Authorization: Bearer <token>`
100
- - `X-API-Key: key_...` (API keys must have the `key_` prefix)
101
-
102
- ---
103
-
104
- ## 공통 API 컨벤션
105
-
106
- ### Base URL
107
-
108
- The CLI calls `{apiUrl}/api/...`.
109
-
110
- Example: `GET {apiUrl}/api/projects/{projectId}/plans`
111
-
112
- ### Response envelopes
113
-
114
- - Single: `{ data: {...} }`
115
- - List: `{ data: [...], meta: {...} }`
116
- - Error: `{ statusCode, error, message, errorCode? }`
117
-
118
- 에러 응답의 `errorCode`는 선택 필드이며, CLI는 `errorCode`가 있을 때 이를 우선 사용해 에러를 분기합니다.
119
- `errorCode`가 없는 구버전/부분 적용 응답에서는 기존 `statusCode + message` 기반 동작으로 fallback합니다.
120
-
121
- ### Pagination
122
-
123
- Many list endpoints accept `page` and `pageSize`.
124
-
125
- ---
126
-
127
- ## 공통 출력 UX(추가)
128
-
129
- ### `--output-file <path>` / `--verbose`
130
-
131
- 대상(주요 커맨드 전반): `init`, `sync`, `status`, `plan`, `comment`, `report`, `postmortem`, `dependency`, `agent-config`, `config`, `convention`
132
-
133
- - `--output-file <path>`
134
- - “원래 stdout에 출력될 전체 결과”를 지정한 파일에 그대로 저장합니다.
135
- - stdout에는 기본적으로 **요약 1~3줄**만 출력합니다.
136
- - 상대 경로는 `cwd` 기준이며 내부에서 `path.resolve`로 절대경로로 변환합니다.
137
- - 부모 디렉토리가 없으면 생성합니다.
138
- - `--verbose`
139
- - `--output-file`과 함께 사용하면 stdout에도 전체 결과를 출력합니다(파일 저장은 유지).
140
-
141
- 요약 출력은 기본 영어 메시지로 출력됩니다(자동화/로그 파싱 관점에서 고정된 문구를 선호).
142
-
143
- text 출력에서 객체 필드는 핵심 식별 필드(`id/title/status/priority/updatedAt/createdAt`)를 우선 표시한 뒤 나머지를 정렬해 출력합니다.
144
-
145
- ---
146
-
147
- ## 커맨드별 워크플로우
148
-
149
- ### Plan
150
-
151
- - Create: `POST /api/projects/:projectId/plans`
152
- - Plans are always created as `DRAFT` (server-enforced). Even if a client sends `status`, it will be ignored on creation.
153
- - Use `--content` or `--file` for the body.
154
- - `--template refactor-minimal`로 최소 리팩터링 체크리스트 본문을 자동 채울 수 있습니다(내용이 비어 있을 때).
155
- - 멀티라인을 `--content`로 전달해야 하는 경우, `--interpret-escapes`를 사용하면 `\\n` 시퀀스를 실제 줄바꿈으로 변환합니다(기본 OFF).
156
- - Get alias: `plan show --id <id>`는 `plan get --id <id>`와 동일 동작입니다.
157
- - Include dependencies: `plan get|show --id <id> --include-deps`
158
- - 내부적으로 `GET /plans/:id` + `GET /plans/:id/dependencies`를 호출해 응답을 합성합니다.
159
- - `--format json`: `data.dependencies = { blocking: [...], dependents: [...] }`
160
- - `--format text`: Plan 필드 출력 뒤 `## Dependencies` 섹션을 추가합니다.
161
- - Download snapshot: `GET /api/projects/:projectId/plans/:id`
162
- - Saved to `.agentteams/active-plan/{safe-title}.md` with frontmatter.
163
- - (추가) 단축 커맨드
164
- - `agentteams plan start --id <planId>`
165
- - 내부적으로 `GET /plans/:id` → `PUT /plans/:id(status=IN_PROGRESS)` → `POST /agent-statuses(status=IN_PROGRESS)`를 순서대로 호출합니다.
166
- - 플랜이 `DRAFT`인 경우, UX 개선을 위해 `DRAFT → PENDING → IN_PROGRESS`로 자동 승격합니다.
167
- - `agentteams plan finish --id <planId>`
168
- - 내부적으로 `GET /plans/:id` → `PUT /plans/:id(status=DONE)` → `POST /agent-statuses(status=DONE)`를 순서대로 호출합니다.
169
-
170
- ### Comment (plan-scoped)
171
-
172
- - List: `GET /api/projects/:projectId/plans/:planId/comments`
173
- - Create: `POST /api/projects/:projectId/plans/:planId/comments`
174
- - Get/Update/Delete by ID: `GET/PUT/DELETE /api/projects/:projectId/comments/:id`
175
-
176
- Types: `RISK`, `MODIFICATION`, `GENERAL`
177
-
178
- ### Status
179
-
180
- - Report: `POST /api/projects/:projectId/agent-statuses`
181
- - List/Get/Update/Delete: `GET/PUT/DELETE /api/projects/:projectId/agent-statuses...`
182
-
183
- ### Convention
184
-
185
- Convention commands are tightly coupled to `.agentteams/`.
186
-
187
- - Sync download: `agentteams sync` (internally runs `convention download`)
188
- - Writes conventions and platform guides under `.agentteams/`
189
- - Updates `.agentteams/conventions.manifest.json`
190
- - Create/Update/Delete: `agentteams convention create|update|delete`
191
- - Files are expected under `.agentteams/<category>/...`
192
- - `update/delete` default to a non-destructive preview; use `--apply` to execute.
193
-
194
- ### Completion report / Postmortem
195
-
196
- - Completion reports: `.../completion-reports`
197
- - Postmortems: `.../post-mortems`
198
-
199
- CLI supports `--api-url`, `--api-key`, `--team-id`, `--project-id`, `--agent-name` overrides for environments without local config.
200
-
201
- #### (추가) `report create`의 템플릿/Deprecated 옵션
202
-
203
- - `--template minimal`
204
- - `--content`가 없을 때 최소 템플릿을 자동으로 채워서 생성할 수 있습니다.
205
- - Deprecated(호환 유지, 경고 출력)
206
- - `--summary`: `--title`의 별칭(Deprecated)
207
- - `--details`: `--content`가 없을 때 Details 섹션으로 삽입(Deprecated)
208
-
209
- ---
210
-
211
- ## CLI가 생성/관리하는 로컬 파일
212
-
213
- - Project config: `.agentteams/config.json`
214
- - Global config: `~/.agentteams/config.json`
215
- - Convention template: `.agentteams/convention.md`
216
- - Download manifest: `.agentteams/conventions.manifest.json`
217
- - Plan snapshots: `.agentteams/active-plan/*.md`
218
- - Output capture: `--output-file <path>`로 지정한 임의 경로(사용자 지정)
219
-
220
- ---
221
-
222
- ## 엔드투엔드: plan 생성 → 완료 보고서
223
-
224
- ```mermaid
225
- sequenceDiagram
226
- participant U as "User/Agent"
227
- participant CLI as "CLI (agentteams)"
228
- participant API as "API"
229
- participant FS as "Local FS"
230
-
231
- U->>CLI: plan create (title, content, priority)
232
- CLI->>API: POST /api/projects/:projectId/plans
233
- API-->>CLI: { data: plan(status=DRAFT) }
234
-
235
- U->>CLI: plan update --status IN_PROGRESS
236
- CLI->>API: PUT /api/projects/:projectId/plans/:id
237
- API-->>CLI: { data: plan }
238
-
239
- U->>CLI: plan download --id {planId}
240
- CLI->>API: GET /api/projects/:projectId/plans/:id
241
- API-->>CLI: { data: plan(contentMarkdown) }
242
- CLI->>FS: Write .agentteams/active-plan/{safe-title}.md
243
-
244
- U->>CLI: comment create --type RISK|MODIFICATION|GENERAL
245
- CLI->>API: POST /api/projects/:projectId/plans/:planId/comments
246
- API-->>CLI: { data: comment }
247
-
248
- U->>CLI: status report --status IN_PROGRESS|DONE|BLOCKED
249
- CLI->>API: POST /api/projects/:projectId/agent-statuses
250
- API-->>CLI: { data: status }
251
-
252
- U->>CLI: plan update --status DONE
253
- CLI->>API: PUT /api/projects/:projectId/plans/:id
254
- API-->>CLI: { data: plan }
255
-
256
- U->>CLI: report create --plan-id {planId}
257
- CLI->>API: POST /api/projects/:projectId/completion-reports
258
- API-->>CLI: { data: report }
259
- ```
260
-
261
- ## 엔드투엔드(추가): plan start / plan finish
262
-
263
- ```mermaid
264
- sequenceDiagram
265
- participant U as "User/Agent"
266
- participant CLI as "CLI (agentteams)"
267
- participant API as "API"
268
-
269
- U->>CLI: plan start --id {planId}
270
- CLI->>API: GET /api/projects/:projectId/plans/:id
271
- API-->>CLI: { data: plan(title, ...) }
272
- CLI->>API: PUT /api/projects/:projectId/plans/:id (status=PENDING) %% only when current status is DRAFT
273
- API-->>CLI: { data: plan }
274
- CLI->>API: PUT /api/projects/:projectId/plans/:id (status=IN_PROGRESS)
275
- API-->>CLI: { data: plan }
276
- CLI->>API: POST /api/projects/:projectId/agent-statuses (IN_PROGRESS)
277
- API-->>CLI: { data: status }
278
-
279
- U->>CLI: plan finish --id {planId}
280
- CLI->>API: GET /api/projects/:projectId/plans/:id
281
- API-->>CLI: { data: plan(title, ...) }
282
- CLI->>API: PUT /api/projects/:projectId/plans/:id (status=DONE)
283
- API-->>CLI: { data: plan }
284
- CLI->>API: POST /api/projects/:projectId/agent-statuses (DONE)
285
- API-->>CLI: { data: status }
286
- ```
287
-
288
- ---
289
-
290
- ## Plan status model and constraints
291
-
292
- ### Status values
293
-
294
- - `DRAFT`
295
- - `PENDING`
296
- - `ASSIGNED`
297
- - `IN_PROGRESS`
298
- - `BLOCKED`
299
- - `DONE` (terminal)
300
- - `CANCELLED` (terminal)
301
-
302
- ### Allowed status transitions (server-validated)
303
-
304
- ```mermaid
305
- stateDiagram-v2
306
- [*] --> DRAFT
307
-
308
- DRAFT --> PENDING
309
-
310
- PENDING --> ASSIGNED
311
- PENDING --> IN_PROGRESS
312
- PENDING --> DONE
313
- PENDING --> CANCELLED
314
-
315
- ASSIGNED --> PENDING
316
- ASSIGNED --> IN_PROGRESS
317
- ASSIGNED --> DONE
318
- ASSIGNED --> CANCELLED
319
-
320
- IN_PROGRESS --> DONE
321
- IN_PROGRESS --> BLOCKED
322
- IN_PROGRESS --> CANCELLED
323
-
324
- BLOCKED --> IN_PROGRESS
325
- BLOCKED --> CANCELLED
326
-
327
- DONE --> [*]
328
- CANCELLED --> [*]
329
- ```
330
-
331
- If you attempt a disallowed transition, the API returns `400` with `허용되지 않은 상태 전이입니다`.
332
-
333
- ### `plan assign` behavior
334
-
335
- `agentteams plan assign` sets the plan to `ASSIGNED` as long as the plan is not terminal.
336
-
337
- - Not allowed when current status is `DONE` or `CANCELLED`
338
- - Otherwise allowed and results in `ASSIGNED`
339
-
340
- ### Content edit/delete constraints (status-based)
341
-
342
- ```mermaid
343
- flowchart TD
344
- A["plan update (title/content/priority change)"] --> B{Current status is<br/>DRAFT or PENDING?}
345
- B -- "No" --> E["400: Content edits allowed only in DRAFT or PENDING"]
346
- B -- "Yes" --> F["Allowed"]
347
-
348
- C["plan delete"] --> D{Current status is<br/>PENDING, DRAFT, or CANCELLED?}
349
- D -- "No" --> G["400: Delete allowed only in PENDING, DRAFT, or CANCELLED"]
350
- D -- "Yes" --> H["204 No Content"]
351
- ```
352
-
353
- ---
354
-
355
- ## Completion report writing rules (practical)
356
-
357
- - Prefer the platform template if available: `.agentteams/platform/guides/completion-report-guide.md`
358
- - Include reproducible verification evidence (commands + outcomes).
359
- - Keep outcomes short: write `pass/fail + 1–3 lines of summary`; do not paste long raw logs into the report body.
360
-
361
- ---
362
-
363
- ## Troubleshooting
364
-
365
- - `401 Unauthorized`
366
- - Check `AGENTTEAMS_API_KEY` / `.agentteams/config.json` `apiKey`.
367
- - API keys must have the `key_` prefix.
368
- - `403 Forbidden`
369
- - You likely lack project/role permissions (especially for convention writes).
370
- - `400 Bad Request`
371
- - 플랜 상태 전이처럼 서버가 검증하는 제약을 위반했을 수 있습니다.
372
- - 예: 허용되지 않은 상태 전이 시 `400` + `허용되지 않은 상태 전이입니다`
373
- - Connection issues (`ECONNREFUSED`, `ENOTFOUND`)
374
- - Check `AGENTTEAMS_API_URL` / config `apiUrl`, and ensure the server is reachable.
375
-
376
- ---
377
-
378
- ## 최소 사용 예시
379
-
380
- ```bash
381
- # First-time setup
382
- agentteams init
383
-
384
- # Create plan (always DRAFT)
385
- agentteams plan create --title "My plan" --content "# TODO\n- ..." --priority MEDIUM
386
-
387
- # Download local snapshot/runbook
388
- agentteams plan download --id <planId>
389
-
390
- # Add a risk comment
391
- agentteams comment create --plan-id <planId> --type RISK --content "Potential failure mode..."
392
-
393
- # Report agent status
394
- agentteams status report --status IN_PROGRESS --task "Working on plan" --issues "" --remaining ""
395
-
396
- # Move plan forward (manual)
397
- agentteams plan update --id <planId> --status IN_PROGRESS
398
- agentteams plan update --id <planId> --status DONE
399
-
400
- # Start/finish shortcuts (auto status report)
401
- agentteams plan start --id <planId>
402
- agentteams plan finish --id <planId>
403
-
404
- # Create completion report (recommended flags)
405
- agentteams report create --plan-id <planId> --title "Done" --template minimal
406
- ```
407
-
408
- Environment-only mode (no config file):
409
-
410
- ```bash
411
- export AGENTTEAMS_API_URL="https://..."
412
- export AGENTTEAMS_API_KEY="key_..."
413
- export AGENTTEAMS_TEAM_ID="..."
414
- export AGENTTEAMS_PROJECT_ID="..."
415
- export AGENTTEAMS_AGENT_NAME="..."
416
-
417
- agentteams plan list --page 1 --page-size 20
418
- ```