@rlarua/agentteams-cli 0.0.9 → 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/LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.