@rlarua/agentteams-cli 0.0.10 → 0.0.11

package/API-CLI-WORKFLOW.md

@@ -0,0 +1,418 @@
+---
+trigger: 
+description: 
+agentInstruction: |
+  본 문서는 한국어로 작성해주세요.
+---
+# API ↔ CLI 워크플로우
+
+이 문서는 AgentTeams CLI(`agentteams`)가 API 서버와 어떻게 통신하는지, 그리고 그 결과로 로컬 워크스페이스에 어떤 파일이 생성/업데이트되는지를 설명합니다.
+
+## 범위(Scope)
+
+- CLI 인증/설정(config) 로딩 규칙
+- 요청/응답 컨벤션(엔벨로프, 페이지네이션)
+- 엔드투엔드 흐름(Plan → Comments/Status → Completion Report → Postmortem)
+- CLI가 생성하는 로컬 파일 위치 및 역할
+- (추가) 공통 출력 UX(`--output-file`, `--verbose`)와 단축 워크플로우(`plan start/finish`)
+
+> 최종 소스 오브 트루스는 코드입니다. 이 문서는 운영/사용 가이드입니다.
+
+---
+
+## 구성 요소와 책임
+
+- CLI(`/cli`)
+  - 커맨드 파싱: `commander`
+  - HTTP 호출: `axios`
+  - 설정 로딩: `.agentteams/config.json`, `~/.agentteams/config.json`, `AGENTTEAMS_*`
+  - 로컬 아티팩트 생성: 플랜 스냅샷(runbook), 컨벤션/가이드 다운로드 파일
+  - (추가) 공통 출력 UX: `--output-file`, `--verbose`
+  - (추가) 단축 워크플로우: `agentteams plan start|finish`
+- API(`/api`)
+  - REST API: Fastify
+  - 인증/권한: 주로 `X-API-Key` 기반
+  - DB 접근: Prisma
+  - Swagger UI: `/docs`
+
+---
+
+## 인증(Authentication)과 설정(Config) 로딩
+
+### `agentteams init` (최초 설정)
+
+개요 흐름:
+
+1. 로컬 OAuth 콜백 서버를 실행합니다.
+2. 브라우저에서 authorize 페이지를 엽니다(SSH 환경에서는 URL을 출력).
+3. `apiUrl`, `apiKey`, `teamId`, `projectId`, `agentName`을 수신하고 로컬에 저장합니다.
+4. 컨벤션 템플릿을 `.agentteams/convention.md`로 저장합니다.
+5. 컨벤션/플랫폼 가이드를 `.agentteams/*`로 다운로드합니다.
+
+```mermaid
+sequenceDiagram
+  participant U as "User"
+  participant CLI as "CLI (agentteams)"
+  participant WEB as "Web (Authorize)"
+  participant API as "API"
+  participant FS as "Local FS"
+
+  U->>CLI: agentteams init
+  CLI->>CLI: Start local OAuth callback server
+  CLI->>WEB: Open/print authorize URL
+  WEB->>CLI: OAuth callback (auth result)
+  CLI->>FS: Write .agentteams/config.json
+  CLI->>API: Fetch convention template
+  API-->>CLI: template(content)
+  CLI->>FS: Write .agentteams/convention.md
+  CLI->>API: Download conventions
+  API-->>CLI: conventions (+ platform guides)
+  CLI->>FS: Write .agentteams/<category>/*.md and manifest
+```
+
+### 설정 우선순위(높음 → 낮음)
+
+1. CLI option overrides (some commands only)
+2. Env vars `AGENTTEAMS_*`
+3. Project config: nearest `.agentteams/config.json` found by walking up from `cwd`
+4. Global config: `~/.agentteams/config.json`
+
+지원 환경변수:
+
+- `AGENTTEAMS_API_KEY`
+- `AGENTTEAMS_API_URL`
+- `AGENTTEAMS_TEAM_ID`
+- `AGENTTEAMS_PROJECT_ID`
+- `AGENTTEAMS_AGENT_NAME`
+
+### 기본 요청 헤더
+
+- `X-API-Key: key_...`
+- `Content-Type: application/json`
+
+예외:
+
+- `DELETE` 요청은 서버의 빈 JSON body 검증 충돌을 피하기 위해 `Content-Type`을 포함하지 않습니다.
+
+API는 다음 중 하나를 허용합니다:
+
+- `Authorization: Bearer <token>`
+- `X-API-Key: key_...` (API keys must have the `key_` prefix)
+
+---
+
+## 공통 API 컨벤션
+
+### Base URL
+
+The CLI calls `{apiUrl}/api/...`.
+
+Example: `GET {apiUrl}/api/projects/{projectId}/plans`
+
+### Response envelopes
+
+- Single: `{ data: {...} }`
+- List: `{ data: [...], meta: {...} }`
+- Error: `{ statusCode, error, message, errorCode? }`
+
+에러 응답의 `errorCode`는 선택 필드이며, CLI는 `errorCode`가 있을 때 이를 우선 사용해 에러를 분기합니다.
+`errorCode`가 없는 구버전/부분 적용 응답에서는 기존 `statusCode + message` 기반 동작으로 fallback합니다.
+
+### Pagination
+
+Many list endpoints accept `page` and `pageSize`.
+
+---
+
+## 공통 출력 UX(추가)
+
+### `--output-file <path>` / `--verbose`
+
+대상(주요 커맨드 전반): `init`, `sync`, `status`, `plan`, `comment`, `report`, `postmortem`, `dependency`, `agent-config`, `config`, `convention`
+
+- `--output-file <path>`
+  - “원래 stdout에 출력될 전체 결과”를 지정한 파일에 그대로 저장합니다.
+  - stdout에는 기본적으로 **요약 1~3줄**만 출력합니다.
+  - 상대 경로는 `cwd` 기준이며 내부에서 `path.resolve`로 절대경로로 변환합니다.
+  - 부모 디렉토리가 없으면 생성합니다.
+- `--verbose`
+  - `--output-file`과 함께 사용하면 stdout에도 전체 결과를 출력합니다(파일 저장은 유지).
+
+요약 출력은 기본 영어 메시지로 출력됩니다(자동화/로그 파싱 관점에서 고정된 문구를 선호).
+
+text 출력에서 객체 필드는 핵심 식별 필드(`id/title/status/priority/updatedAt/createdAt`)를 우선 표시한 뒤 나머지를 정렬해 출력합니다.
+
+---
+
+## 커맨드별 워크플로우
+
+### Plan
+
+- Create: `POST /api/projects/:projectId/plans`
+  - Plans are always created as `DRAFT` (server-enforced). Even if a client sends `status`, it will be ignored on creation.
+  - Use `--content` or `--file` for the body.
+  - `--template refactor-minimal`로 최소 리팩터링 체크리스트 본문을 자동 채울 수 있습니다(내용이 비어 있을 때).
+  - 멀티라인을 `--content`로 전달해야 하는 경우, `--interpret-escapes`를 사용하면 `\\n` 시퀀스를 실제 줄바꿈으로 변환합니다(기본 OFF).
+- Get alias: `plan show --id <id>`는 `plan get --id <id>`와 동일 동작입니다.
+- Include dependencies: `plan get|show --id <id> --include-deps`
+  - 내부적으로 `GET /plans/:id` + `GET /plans/:id/dependencies`를 호출해 응답을 합성합니다.
+  - `--format json`: `data.dependencies = { blocking: [...], dependents: [...] }`
+  - `--format text`: Plan 필드 출력 뒤 `## Dependencies` 섹션을 추가합니다.
+- Download snapshot: `GET /api/projects/:projectId/plans/:id`
+  - Saved to `.agentteams/active-plan/{safe-title}.md` with frontmatter.
+- (추가) 단축 커맨드
+  - `agentteams plan start --id <planId>`
+    - 내부적으로 `GET /plans/:id` → `PUT /plans/:id(status=IN_PROGRESS)` → `POST /agent-statuses(status=IN_PROGRESS)`를 순서대로 호출합니다.
+    - 플랜이 `DRAFT`인 경우, UX 개선을 위해 `DRAFT → PENDING → IN_PROGRESS`로 자동 승격합니다.
+  - `agentteams plan finish --id <planId>`
+    - 내부적으로 `GET /plans/:id` → `PUT /plans/:id(status=DONE)` → `POST /agent-statuses(status=DONE)`를 순서대로 호출합니다.
+
+### Comment (plan-scoped)
+
+- List: `GET /api/projects/:projectId/plans/:planId/comments`
+- Create: `POST /api/projects/:projectId/plans/:planId/comments`
+- Get/Update/Delete by ID: `GET/PUT/DELETE /api/projects/:projectId/comments/:id`
+
+Types: `RISK`, `MODIFICATION`, `GENERAL`
+
+### Status
+
+- Report: `POST /api/projects/:projectId/agent-statuses`
+- List/Get/Update/Delete: `GET/PUT/DELETE /api/projects/:projectId/agent-statuses...`
+
+### Convention
+
+Convention commands are tightly coupled to `.agentteams/`.
+
+- Sync download: `agentteams sync` (internally runs `convention download`)
+  - Writes conventions and platform guides under `.agentteams/`
+  - Updates `.agentteams/conventions.manifest.json`
+- Create/Update/Delete: `agentteams convention create|update|delete`
+  - Files are expected under `.agentteams/<category>/...`
+  - `update/delete` default to a non-destructive preview; use `--apply` to execute.
+
+### Completion report / Postmortem
+
+- Completion reports: `.../completion-reports`
+- Postmortems: `.../post-mortems`
+
+CLI supports `--api-url`, `--api-key`, `--team-id`, `--project-id`, `--agent-name` overrides for environments without local config.
+
+#### (추가) `report create`의 템플릿/Deprecated 옵션
+
+- `--template minimal`
+  - `--content`가 없을 때 최소 템플릿을 자동으로 채워서 생성할 수 있습니다.
+- Deprecated(호환 유지, 경고 출력)
+  - `--summary`: `--title`의 별칭(Deprecated)
+  - `--details`: `--content`가 없을 때 Details 섹션으로 삽입(Deprecated)
+
+---
+
+## CLI가 생성/관리하는 로컬 파일
+
+- Project config: `.agentteams/config.json`
+- Global config: `~/.agentteams/config.json`
+- Convention template: `.agentteams/convention.md`
+- Download manifest: `.agentteams/conventions.manifest.json`
+- Plan snapshots: `.agentteams/active-plan/*.md`
+- Output capture: `--output-file <path>`로 지정한 임의 경로(사용자 지정)
+
+---
+
+## 엔드투엔드: plan 생성 → 완료 보고서
+
+```mermaid
+sequenceDiagram
+  participant U as "User/Agent"
+  participant CLI as "CLI (agentteams)"
+  participant API as "API"
+  participant FS as "Local FS"
+
+  U->>CLI: plan create (title, content, priority)
+  CLI->>API: POST /api/projects/:projectId/plans
+  API-->>CLI: { data: plan(status=DRAFT) }
+
+  U->>CLI: plan update --status IN_PROGRESS
+  CLI->>API: PUT /api/projects/:projectId/plans/:id
+  API-->>CLI: { data: plan }
+
+  U->>CLI: plan download --id {planId}
+  CLI->>API: GET /api/projects/:projectId/plans/:id
+  API-->>CLI: { data: plan(contentMarkdown) }
+  CLI->>FS: Write .agentteams/active-plan/{safe-title}.md
+
+  U->>CLI: comment create --type RISK|MODIFICATION|GENERAL
+  CLI->>API: POST /api/projects/:projectId/plans/:planId/comments
+  API-->>CLI: { data: comment }
+
+  U->>CLI: status report --status IN_PROGRESS|DONE|BLOCKED
+  CLI->>API: POST /api/projects/:projectId/agent-statuses
+  API-->>CLI: { data: status }
+
+  U->>CLI: plan update --status DONE
+  CLI->>API: PUT /api/projects/:projectId/plans/:id
+  API-->>CLI: { data: plan }
+
+  U->>CLI: report create --plan-id {planId}
+  CLI->>API: POST /api/projects/:projectId/completion-reports
+  API-->>CLI: { data: report }
+```
+
+## 엔드투엔드(추가): plan start / plan finish
+
+```mermaid
+sequenceDiagram
+  participant U as "User/Agent"
+  participant CLI as "CLI (agentteams)"
+  participant API as "API"
+
+  U->>CLI: plan start --id {planId}
+  CLI->>API: GET /api/projects/:projectId/plans/:id
+  API-->>CLI: { data: plan(title, ...) }
+  CLI->>API: PUT /api/projects/:projectId/plans/:id (status=PENDING)  %% only when current status is DRAFT
+  API-->>CLI: { data: plan }
+  CLI->>API: PUT /api/projects/:projectId/plans/:id (status=IN_PROGRESS)
+  API-->>CLI: { data: plan }
+  CLI->>API: POST /api/projects/:projectId/agent-statuses (IN_PROGRESS)
+  API-->>CLI: { data: status }
+
+  U->>CLI: plan finish --id {planId}
+  CLI->>API: GET /api/projects/:projectId/plans/:id
+  API-->>CLI: { data: plan(title, ...) }
+  CLI->>API: PUT /api/projects/:projectId/plans/:id (status=DONE)
+  API-->>CLI: { data: plan }
+  CLI->>API: POST /api/projects/:projectId/agent-statuses (DONE)
+  API-->>CLI: { data: status }
+```
+
+---
+
+## Plan status model and constraints
+
+### Status values
+
+- `DRAFT`
+- `PENDING`
+- `ASSIGNED`
+- `IN_PROGRESS`
+- `BLOCKED`
+- `DONE` (terminal)
+- `CANCELLED` (terminal)
+
+### Allowed status transitions (server-validated)
+
+```mermaid
+stateDiagram-v2
+  [*] --> DRAFT
+
+  DRAFT --> PENDING
+
+  PENDING --> ASSIGNED
+  PENDING --> IN_PROGRESS
+  PENDING --> DONE
+  PENDING --> CANCELLED
+
+  ASSIGNED --> PENDING
+  ASSIGNED --> IN_PROGRESS
+  ASSIGNED --> DONE
+  ASSIGNED --> CANCELLED
+
+  IN_PROGRESS --> DONE
+  IN_PROGRESS --> BLOCKED
+  IN_PROGRESS --> CANCELLED
+
+  BLOCKED --> IN_PROGRESS
+  BLOCKED --> CANCELLED
+
+  DONE --> [*]
+  CANCELLED --> [*]
+```
+
+If you attempt a disallowed transition, the API returns `400` with `허용되지 않은 상태 전이입니다`.
+
+### `plan assign` behavior
+
+`agentteams plan assign` sets the plan to `ASSIGNED` as long as the plan is not terminal.
+
+- Not allowed when current status is `DONE` or `CANCELLED`
+- Otherwise allowed and results in `ASSIGNED`
+
+### Content edit/delete constraints (status-based)
+
+```mermaid
+flowchart TD
+  A["plan update (title/content/priority change)"] --> B{Current status is<br/>DRAFT or PENDING?}
+  B -- "No" --> E["400: Content edits allowed only in DRAFT or PENDING"]
+  B -- "Yes" --> F["Allowed"]
+
+  C["plan delete"] --> D{Current status is<br/>PENDING, DRAFT, or CANCELLED?}
+  D -- "No" --> G["400: Delete allowed only in PENDING, DRAFT, or CANCELLED"]
+  D -- "Yes" --> H["204 No Content"]
+```
+
+---
+
+## Completion report writing rules (practical)
+
+- Prefer the platform template if available: `.agentteams/platform/guides/completion-report-guide.md`
+- Include reproducible verification evidence (commands + outcomes).
+- Keep outcomes short: write `pass/fail + 1–3 lines of summary`; do not paste long raw logs into the report body.
+
+---
+
+## Troubleshooting
+
+- `401 Unauthorized`
+  - Check `AGENTTEAMS_API_KEY` / `.agentteams/config.json` `apiKey`.
+  - API keys must have the `key_` prefix.
+- `403 Forbidden`
+  - You likely lack project/role permissions (especially for convention writes).
+- `400 Bad Request`
+  - 플랜 상태 전이처럼 서버가 검증하는 제약을 위반했을 수 있습니다.
+  - 예: 허용되지 않은 상태 전이 시 `400` + `허용되지 않은 상태 전이입니다`
+- Connection issues (`ECONNREFUSED`, `ENOTFOUND`)
+  - Check `AGENTTEAMS_API_URL` / config `apiUrl`, and ensure the server is reachable.
+
+---
+
+## 최소 사용 예시
+
+```bash
+# First-time setup
+agentteams init
+
+# Create plan (always DRAFT)
+agentteams plan create --title "My plan" --content "# TODO\n- ..." --priority MEDIUM
+
+# Download local snapshot/runbook
+agentteams plan download --id <planId>
+
+# Add a risk comment
+agentteams comment create --plan-id <planId> --type RISK --content "Potential failure mode..."
+
+# Report agent status
+agentteams status report --status IN_PROGRESS --task "Working on plan" --issues "" --remaining ""
+
+# Move plan forward (manual)
+agentteams plan update --id <planId> --status IN_PROGRESS
+agentteams plan update --id <planId> --status DONE
+
+# Start/finish shortcuts (auto status report)
+agentteams plan start --id <planId>
+agentteams plan finish --id <planId>
+
+# Create completion report (recommended flags)
+agentteams report create --plan-id <planId> --title "Done" --template minimal
+```
+
+Environment-only mode (no config file):
+
+```bash
+export AGENTTEAMS_API_URL="https://..."
+export AGENTTEAMS_API_KEY="key_..."
+export AGENTTEAMS_TEAM_ID="..."
+export AGENTTEAMS_PROJECT_ID="..."
+export AGENTTEAMS_AGENT_NAME="..."
+
+agentteams plan list --page 1 --page-size 20
+```

package/README.md

@@ -75,6 +75,11 @@ export AGENTTEAMS_API_URL="https://your-agentteams-api.example.com"
 agentteams convention list
 agentteams convention show
 agentteams convention download
+agentteams convention create --file .agentteams/rules/new-rule.md
+agentteams convention update --file .agentteams/rules/context.md
+agentteams convention update --file .agentteams/rules/context.md --apply
+agentteams convention delete --file .agentteams/rules/context.md
+agentteams convention delete --file .agentteams/rules/context.md --apply
 ```
 
 ## Core Commands
@@ -89,17 +94,64 @@ agentteams init
 
 ### `convention`
 
-View and download project conventions.
+Manage project conventions.
 
 ```bash
 agentteams convention list
 agentteams convention show
 agentteams convention download
+agentteams convention create --file .agentteams/rules/new-rule.md
+agentteams convention update --file .agentteams/rules/context.md
+agentteams convention update --file .agentteams/rules/context.md --apply
+agentteams convention delete --file .agentteams/rules/context.md
+agentteams convention delete --file .agentteams/rules/context.md --apply
 ```
 
 `convention download` saves files by category in `.agentteams/<category>/`.
 If file names collide within the same category, suffixes like `-2`, `-3` are added.
 
+#### `convention create`
+
+Create a new convention.
+
+- The input file must be under `.agentteams/<category>/*.md`, and `<category>` is inferred from the path.
+- Frontmatter is optional. Supported fields: `trigger`, `description`, `agentInstruction`, `title` (optional).
+- After creation, the CLI immediately updates `.agentteams/conventions.manifest.json`, so you can `update/delete` the same file right away.
+- Run `agentteams convention download` if you want to refresh `convention.md` and the server-normalized (downloadable) markdown.
+
+Examples:
+
+```bash
+agentteams convention create --file .agentteams/rules/new-rule.md
+```
+
+#### `convention update` / `convention delete`
+
+- By default, `update` and `delete` run in **dry-run** mode. They print a diff/plan and do not modify the server.
+- Use `--apply` to actually update/delete the server resource.
+- Only files produced by `agentteams convention download` are allowed. The CLI uses `.agentteams/conventions.manifest.json` to map local files to server conventions.
+
+Examples:
+
+```bash
+# Preview changes (dry-run)
+agentteams convention update --file .agentteams/rules/context.md
+
+# Apply update to server
+agentteams convention update --file .agentteams/rules/context.md --apply
+
+# Preview deletion (dry-run)
+agentteams convention delete --file .agentteams/rules/context.md
+
+# Apply deletion to server
+agentteams convention delete --file .agentteams/rules/context.md --apply
+```
+
+Common errors:
+
+- `403 Forbidden`: the server rejected the operation due to missing write permissions.
+- `409 Conflict`: optimistic-lock conflict (someone else updated the convention). Download again and retry.
+
 ### `sync`
 
 Resync convention files.
@@ -134,16 +186,25 @@ Status values: `IN_PROGRESS`, `DONE`, `BLOCKED`
 
 Manage plans.
 
+Note: Plans are always created as `DRAFT`. Even if you pass `--status` to `plan create`, the server will ignore it. Use `plan update` to change status after creation.
+
 ```bash
 agentteams plan list
 agentteams plan get --id <plan-id>
+agentteams plan get --id <plan-id> --include-deps --format text
+agentteams plan show --id <plan-id>  # alias of get
 
 agentteams plan create \
   --title "Implement feature" \
   --content "Detailed content" \
-  --status "PENDING" \
   --priority "HIGH"
 
+# optional checklist template for create
+agentteams plan create \
+  --title "Refactor module" \
+  --template "refactor-minimal"
+
+agentteams plan update --id <plan-id> --status "PENDING"
 agentteams plan update --id <plan-id> --status "IN_PROGRESS"
 agentteams plan assign --id <plan-id> --agent "agent-name"
 agentteams plan download --id <plan-id>
@@ -155,6 +216,10 @@ Status values: `DRAFT`, `PENDING`, `ASSIGNED`, `IN_PROGRESS`, `BLOCKED`, `DONE`,
 
 Priorities: `LOW`, `MEDIUM`, `HIGH`
 
+Plan template values (create): `refactor-minimal`
+
+`--include-deps` (get/show): also fetches dependency data and appends a `Dependencies` section in text output; in json output it adds `data.dependencies` with `blocking` and `dependents` arrays.
+
 ### `comment`
 
 Manage plan comments.
@@ -197,6 +262,8 @@ agentteams agent-config delete --id <config-id>
 
 Manage completion reports.
 
+Tip: Include reproducible verification evidence (commands + outcomes), but keep outcomes short: `pass/fail + 1–3 lines of summary`. Do not paste long raw logs into the report body.
+
 ```bash
 agentteams report list
 
@@ -205,16 +272,39 @@ agentteams report create \
   --content "## TL;DR\n- done" \
   --report-type IMPL_PLAN \
   --status COMPLETED
+
+# with metrics (auto + manual)
+agentteams report create \
+  --title "CLI metrics report" \
+  --content "## Summary\n- done" \
+  --files-modified 5 \
+  --lines-added 120 \
+  --lines-deleted 30 \
+  --quality-score 95
+
+# disable git auto collection
+agentteams report create \
+  --title "Manual metrics report" \
+  --content "## Summary\n- done" \
+  --no-git
 ```
 
 Report types: `IMPL_PLAN`, `COMMIT_RANGE`, `TASK_COMPLETION`
 
 Status values: `COMPLETED`, `FAILED`, `PARTIAL`
 
+Metrics behavior:
+
+- Auto-collected on `report create` (unless `--no-git`): `commitHash`, `branchName`, `filesModified`, `linesAdded`, `linesDeleted`
+- Manual only: `durationSeconds`, `commitStart`, `commitEnd`, `pullRequestId`
+- Manual options always override auto-collected values
+
 ### `postmortem`
 
 Manage post mortems.
 
+Tip: If you have platform guides downloaded under `.agentteams/platform/guides/`, prefer the template in `post-mortem-guide.md`.
+
 ```bash
 agentteams postmortem list
 
@@ -271,15 +361,40 @@ export AGENTTEAMS_AGENT_NAME="my-agent"
 
 Most resource commands support `--format json|text`.
 
+Output behavior by default:
+
+- `plan create|update|start|finish`: prints short summary lines on stdout by default.
+- `plan list|get` and other read-oriented commands: keep full output by default.
+- `--verbose`: always prints full output to stdout.
+- `--output-file <path>`: always writes full output to file and keeps stdout short.
+
+Compatibility note:
+
+- If you need full JSON on stdout for automation, pass `--format json` explicitly.
+
 ```bash
 agentteams plan list --format json
 agentteams plan list --format text
+agentteams plan update --id <plan-id> --status IN_PROGRESS --format json
 ```
 
 Note: `convention` does not support `--format`.
 
 ## Error Guide
 
+The API may include an optional machine-readable `errorCode` in error responses:
+
+```json
+{
+  "statusCode": 403,
+  "error": "Forbidden",
+  "message": "Cross-project access denied",
+  "errorCode": "CROSS_PROJECT_ACCESS_DENIED"
+}
+```
+
+The CLI prioritizes `errorCode` when present and falls back to message/status-based handling for older API responses.
+
 | Error | Meaning | Resolution |
 |---|---|---|
 | `401 Unauthorized` | Invalid API key | Check `apiKey` or `AGENTTEAMS_API_KEY` |

package/dist/api/comment.d.ts

@@ -0,0 +1,11 @@
+export declare function listComments(apiUrl: string, projectId: string, headers: any, planId: string, params?: Record<string, string | number>): Promise<any>;
+export declare function getComment(apiUrl: string, projectId: string, headers: any, commentId: string): Promise<any>;
+export declare function createComment(apiUrl: string, projectId: string, headers: any, planId: string, body: {
+    type: string;
+    content: string;
+}): Promise<any>;
+export declare function updateComment(apiUrl: string, projectId: string, headers: any, commentId: string, body: {
+    content: string;
+}): Promise<any>;
+export declare function deleteComment(apiUrl: string, projectId: string, headers: any, commentId: string): Promise<any>;
+//# sourceMappingURL=comment.d.ts.map

package/dist/api/comment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"comment.d.ts","sourceRoot":"","sources":["../../src/api/comment.ts"],"names":[],"mappings":"AAGA,wBAAsB,YAAY,CAChC,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,GAAG,EACZ,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,GACvC,OAAO,CAAC,GAAG,CAAC,CAQd;AAED,wBAAsB,UAAU,CAC9B,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,GAAG,EACZ,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,GAAG,CAAC,CAId;AAED,wBAAsB,aAAa,CACjC,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,GAAG,EACZ,MAAM,EAAE,MAAM,EACd,IAAI,EAAE;IACJ,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB,GACA,OAAO,CAAC,GAAG,CAAC,CAId;AAED,wBAAsB,aAAa,CACjC,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,GAAG,EACZ,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE;IACJ,OAAO,EAAE,MAAM,CAAC;CACjB,GACA,OAAO,CAAC,GAAG,CAAC,CAId;AAED,wBAAsB,aAAa,CACjC,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,GAAG,EACZ,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,GAAG,CAAC,CAMd"}

package/dist/api/comment.js

@@ -0,0 +1,33 @@
+import axios from 'axios';
+import { withoutJsonContentType } from '../utils/httpHeaders.js';
+export async function listComments(apiUrl, projectId, headers, planId, params) {
+    const baseUrl = `${apiUrl}/api/projects/${projectId}/plans/${planId}/comments`;
+    const requestConfig = params && Object.keys(params).length > 0
+        ? { headers, params }
+        : { headers };
+    const response = await axios.get(baseUrl, requestConfig);
+    return response.data;
+}
+export async function getComment(apiUrl, projectId, headers, commentId) {
+    const baseUrl = `${apiUrl}/api/projects/${projectId}/comments/${commentId}`;
+    const response = await axios.get(baseUrl, { headers });
+    return response.data;
+}
+export async function createComment(apiUrl, projectId, headers, planId, body) {
+    const baseUrl = `${apiUrl}/api/projects/${projectId}/plans/${planId}/comments`;
+    const response = await axios.post(baseUrl, body, { headers });
+    return response.data;
+}
+export async function updateComment(apiUrl, projectId, headers, commentId, body) {
+    const baseUrl = `${apiUrl}/api/projects/${projectId}/comments/${commentId}`;
+    const response = await axios.put(baseUrl, body, { headers });
+    return response.data;
+}
+export async function deleteComment(apiUrl, projectId, headers, commentId) {
+    const baseUrl = `${apiUrl}/api/projects/${projectId}/comments/${commentId}`;
+    const response = await axios.delete(baseUrl, {
+        headers: withoutJsonContentType(headers),
+    });
+    return response.data;
+}
+//# sourceMappingURL=comment.js.map

package/dist/api/comment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"comment.js","sourceRoot":"","sources":["../../src/api/comment.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAEjE,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,MAAc,EACd,SAAiB,EACjB,OAAY,EACZ,MAAc,EACd,MAAwC;IAExC,MAAM,OAAO,GAAG,GAAG,MAAM,iBAAiB,SAAS,UAAU,MAAM,WAAW,CAAC;IAC/E,MAAM,aAAa,GAAG,MAAM,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,GAAG,CAAC;QAC5D,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE;QACrB,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC;IAEhB,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;IACzD,OAAO,QAAQ,CAAC,IAAI,CAAC;AACvB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,MAAc,EACd,SAAiB,EACjB,OAAY,EACZ,SAAiB;IAEjB,MAAM,OAAO,GAAG,GAAG,MAAM,iBAAiB,SAAS,aAAa,SAAS,EAAE,CAAC;IAC5E,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;IACvD,OAAO,QAAQ,CAAC,IAAI,CAAC;AACvB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,MAAc,EACd,SAAiB,EACjB,OAAY,EACZ,MAAc,EACd,IAGC;IAED,MAAM,OAAO,GAAG,GAAG,MAAM,iBAAiB,SAAS,UAAU,MAAM,WAAW,CAAC;IAC/E,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;IAC9D,OAAO,QAAQ,CAAC,IAAI,CAAC;AACvB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,MAAc,EACd,SAAiB,EACjB,OAAY,EACZ,SAAiB,EACjB,IAEC;IAED,MAAM,OAAO,GAAG,GAAG,MAAM,iBAAiB,SAAS,aAAa,SAAS,EAAE,CAAC;IAC5E,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;IAC7D,OAAO,QAAQ,CAAC,IAAI,CAAC;AACvB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,MAAc,EACd,SAAiB,EACjB,OAAY,EACZ,SAAiB;IAEjB,MAAM,OAAO,GAAG,GAAG,MAAM,iBAAiB,SAAS,aAAa,SAAS,EAAE,CAAC;IAC5E,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE;QAC3C,OAAO,EAAE,sBAAsB,CAAC,OAAO,CAAC;KACzC,CAAC,CAAC;IACH,OAAO,QAAQ,CAAC,IAAI,CAAC;AACvB,CAAC"}

package/dist/api/plan.d.ts

@@ -0,0 +1,13 @@
+export declare function listPlans(apiUrl: string, projectId: string, headers: any, params?: Record<string, string | number>): Promise<any>;
+export declare function getPlan(apiUrl: string, projectId: string, headers: any, id: string): Promise<any>;
+export declare function getPlanDependencies(apiUrl: string, projectId: string, headers: any, id: string): Promise<any>;
+export declare function createPlan(apiUrl: string, projectId: string, headers: any, body: {
+    title: string;
+    content: string;
+    priority: string;
+    status: 'DRAFT';
+}): Promise<any>;
+export declare function updatePlan(apiUrl: string, projectId: string, headers: any, id: string, body: Record<string, unknown>): Promise<any>;
+export declare function assignPlan(apiUrl: string, projectId: string, headers: any, id: string, assignedTo: string): Promise<any>;
+export declare function deletePlan(apiUrl: string, projectId: string, headers: any, id: string): Promise<any>;
+//# sourceMappingURL=plan.d.ts.map