@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,
|
|
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"}
|
package/dist/commands/report.js
CHANGED
|
@@ -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
package/API-CLI-WORKFLOW.md
DELETED
|
@@ -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
|
-
```
|