@rlarua/agentteams-cli 0.0.9 → 0.0.10

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.

package/README.md

@@ -1,6 +1,7 @@
 # @rlarua/agentteams-cli
 
-Command-line interface for managing AI agent teams. Configure agents, sync conventions, track tasks, and report status from your terminal.
+A CLI for working with the AgentTeams API from your terminal.
+It supports convention sync, status reporting, and plan/comment/report management.
 
 ## Installation
 
@@ -8,7 +9,7 @@ Command-line interface for managing AI agent teams. Configure agents, sync conve
 npm install -g @rlarua/agentteams-cli
 ```
 
-Or use with npx:
+Or run with `npx`:
 
 ```bash
 npx @rlarua/agentteams-cli init
@@ -22,247 +23,229 @@ npx @rlarua/agentteams-cli init
 agentteams init
 ```
 
-This command:
-- Opens your browser for OAuth authentication
-- Creates `.agentteams/config.json` with credentials
-- Downloads convention index to `.agentteams/convention.md`
-- Runs sync to download category conventions into `.agentteams/<category>/*.md`
-- Detects your AI environment (Claude Code, opencode, codex)
+The `init` command:
 
-You can run `agentteams sync` later to refresh them again.
+- Opens a browser for OAuth authentication
+- Creates `.agentteams/config.json`
+- Saves the convention template to `.agentteams/convention.md`
+- Syncs convention files into `.agentteams/<category>/*.md`
 
-**What gets created:**
+In SSH/remote environments, open the URL printed in the terminal manually.
 
+### Service URLs (Defaults and Overrides)
+
+The CLI talks to two services:
+
+- Web app (OAuth flow): defaults to `https://agent-web.justin-mk.me`
+- API: no hardcoded default; it is read from `.agentteams/config.json` (created by `init`) or overridden via `AGENTTEAMS_API_URL` (commonly `https://agent-api.justin-mk.me`)
+
+Typical usage:
+
+- Production: run `agentteams init` and do not set any URL overrides.
+- If you need to point the CLI to a different environment, override URLs with environment variables.
+
+Override examples (production):
+
+```bash
+export AGENTTEAMS_API_URL="https://agent-api.justin-mk.me"
 ```
-your-project/
-├── .agentteams/
-│   ├── config.json        # API credentials
-│   └── convention.md      # Convention index template
+
+Override examples (advanced):
+
+```bash
+# Override the web app used by `agentteams init` (OAuth authorize page)
+export AGENTTEAMS_WEB_URL="https://your-agentteams-web.example.com"
+
+# Override the API base URL used by all API calls
+export AGENTTEAMS_API_URL="https://your-agentteams-api.example.com"
 ```
 
-### 2. Add to .gitignore
+### 2. Protect Sensitive Data
 
-Protect your API keys by adding this to `.gitignore`:
+`.agentteams` may contain API keys, so do not commit it to git.
 
 ```gitignore
 # AgentTeams CLI config (contains API keys)
 .agentteams
 ```
 
-### 3. Use conventions
-
-After initialization, conventions are available to your AI agent. The CLI provides setup instructions based on your environment.
+### 3. Use Conventions
 
 ```bash
-# List conventions
 agentteams convention list
-
-# Show full conventions
 agentteams convention show
-
-# Download all conventions from server
 agentteams convention download
 ```
 
-## Commands
+## Core Commands
 
 ### `init`
 
-Initialize with OAuth authentication.
+Initialize the CLI via OAuth and download conventions.
 
 ```bash
 agentteams init
 ```
 
-Opens browser for authentication, saves config, and downloads conventions. For SSH/remote environments, manually copy the displayed URL if the browser doesn't open automatically.
-
 ### `convention`
 
-Manage project conventions.
+View and download project conventions.
 
 ```bash
-# List conventions
 agentteams convention list
-
-# Show all convention markdown in terminal
 agentteams convention show
-
-# Download all conventions and save dev files
 agentteams convention download
 ```
 
-`convention download` saves files by category directory (for example: `.agentteams/rules/<name>.md`).
-If duplicate names exist in the same category, numeric suffixes are added (for example: `rules.md`, `rules-2.md`).
-Before saving, the CLI cleans up existing files in each target category directory.
+`convention download` saves files by category in `.agentteams/<category>/`.
+If file names collide within the same category, suffixes like `-2`, `-3` are added.
 
 ### `sync`
 
-Sync local convention files from API.
+Resync convention files.
 
 ```bash
-# Download conventions by category into .agentteams/<category>/*.md
 agentteams sync
 ```
 
-`sync` also refreshes `.agentteams/convention.md` template.
-
-### `agent-config`
-
-Manage agent configurations.
-
-```bash
-# List all configs
-agentteams agent-config list
-agentteams agent-config list --format text
-
-# Get specific config
-agentteams agent-config get --id <config-id>
-
-# Delete config
-agentteams agent-config delete --id <config-id>
-```
-
 ### `status`
 
-Manage agent status reports.
+Manage agent statuses.
 
 ```bash
-# Report status
 agentteams status report \
   --agent "my-agent" \
   --status "IN_PROGRESS" \
-  --task "작업 중" \
+  --task "Working on task" \
   --issues "" \
   --remaining "next step"
 
-# List statuses
 agentteams status list
-
-# Get specific status
 agentteams status get --id <status-id>
-
-# Update status
 agentteams status update --id <status-id> --status "DONE"
-
-# Delete status
 agentteams status delete --id <status-id>
 ```
 
-**Status values:** `IN_PROGRESS`, `DONE`, `BLOCKED`
+Note: `--agent` is optional, but your server may require it depending on your setup.
 
-`--issues`, `--remaining` are comma-separated strings.
-Examples:
-- `--issues "api timeout,auth failure"`
-- `--remaining "add tests,write docs"`
-- empty list: `--issues ""`
+Status values: `IN_PROGRESS`, `DONE`, `BLOCKED`
 
 ### `plan`
 
 Manage plans.
 
 ```bash
-# List plans
 agentteams plan list
-
-# Get plan
-agentteams plan get --id 1
-
-	# Create plan
-	agentteams plan create \
-	  --title "Implement feature X" \
-	  --content "Details here" \
-	  --status "PENDING" \
-	  --priority "HIGH"
-
-# Update plan
-agentteams plan update --id 1 --status "IN_PROGRESS"
-
-# Assign plan
-agentteams plan assign --id 1 --agent "agent-name"
-
-# Delete plan
-agentteams plan delete --id 1
+agentteams plan get --id <plan-id>
+
+agentteams plan create \
+  --title "Implement feature" \
+  --content "Detailed content" \
+  --status "PENDING" \
+  --priority "HIGH"
+
+agentteams plan update --id <plan-id> --status "IN_PROGRESS"
+agentteams plan assign --id <plan-id> --agent "agent-name"
+agentteams plan download --id <plan-id>
+agentteams plan cleanup --id <plan-id>
+agentteams plan delete --id <plan-id>
 ```
 
-**Plan statuses:** `DRAFT`, `PENDING`, `IN_PROGRESS`, `DONE`, `CANCELLED`  
-**Priorities:** `LOW`, `MEDIUM`, `HIGH`
+Status values: `DRAFT`, `PENDING`, `ASSIGNED`, `IN_PROGRESS`, `BLOCKED`, `DONE`, `CANCELLED`
+
+Priorities: `LOW`, `MEDIUM`, `HIGH`
 
 ### `comment`
 
 Manage plan comments.
 
 ```bash
+agentteams comment list --plan-id <plan-id>
+
 agentteams comment create \
   --plan-id <plan-id> \
   --type GENERAL \
-  --content "Great work!"
+  --content "Work completed"
 
-# Types: RISK, MODIFICATION, GENERAL
+agentteams comment update --id <comment-id> --content "Updated content"
+agentteams comment delete --id <comment-id>
 ```
 
+Types: `RISK`, `MODIFICATION`, `GENERAL`
+
 ### `dependency`
 
 Manage plan dependencies.
 
 ```bash
-# List dependencies for a plan
 agentteams dependency list --plan-id <plan-id>
-
-# Add dependency
 agentteams dependency create --plan-id <plan-id> --blocking-plan-id <blocking-plan-id>
-
-# Delete dependency
 agentteams dependency delete --plan-id <plan-id> --dep-id <dependency-id>
 ```
 
+### `agent-config`
+
+View or delete agent configurations.
+
+```bash
+agentteams agent-config list
+agentteams agent-config get --id <config-id>
+agentteams agent-config delete --id <config-id>
+```
+
 ### `report`
 
-Create completion reports (stored as Markdown).
+Manage completion reports.
 
 ```bash
-# Create from inline markdown
+agentteams report list
+
 agentteams report create \
-  --title "AgentBoard MVP 구현" \
+  --title "AgentTeams completion report" \
   --content "## TL;DR\n- done" \
   --report-type IMPL_PLAN \
   --status COMPLETED
 ```
 
+Report types: `IMPL_PLAN`, `COMMIT_RANGE`, `TASK_COMPLETION`
+
+Status values: `COMPLETED`, `FAILED`, `PARTIAL`
+
 ### `postmortem`
 
-Create post mortems (content supports Markdown).
+Manage post mortems.
 
 ```bash
+agentteams postmortem list
+
 agentteams postmortem create \
-  --title "배포 장애 사후분석" \
-  --content "## 원인\n- 설정 누락" \
-  --action-items "롤백 자동화,사전 점검 체크리스트" \
+  --title "Deployment incident analysis" \
+  --content "## Root cause\n- Missing configuration" \
+  --action-items "Automate rollback,Pre-release checklist" \
   --status RESOLVED
 ```
 
-### `config`
+Status values: `OPEN`, `IN_PROGRESS`, `RESOLVED`
 
-View current configuration.
+### `config`
 
 ```bash
 agentteams config whoami
 agentteams config whoami --format text
 ```
 
-## Configuration
+`config whoami` prints current environment variable values for `AGENTTEAMS_API_KEY` and `AGENTTEAMS_API_URL`.
 
-### Priority Order
+## Configuration
 
-Configuration is merged from multiple sources (highest to lowest priority):
+Configuration is merged in this priority order (highest first):
 
-1. CLI options (command-line arguments)
+1. CLI options
 2. Environment variables (`AGENTTEAMS_*`)
 3. Project config (`.agentteams/config.json`)
 4. Global config (`~/.agentteams/config.json`)
 
-### Config File
-
-`.agentteams/config.json`:
+### Config File Example
 
 ```json
 {
@@ -274,7 +257,7 @@ Configuration is merged from multiple sources (highest to lowest priority):
 }
 ```
 
-### Environment Variables
+### Environment Variable Example
 
 ```bash
 export AGENTTEAMS_API_KEY="key_your_api_key_here"
@@ -284,36 +267,30 @@ export AGENTTEAMS_PROJECT_ID="proj_xxx"
 export AGENTTEAMS_AGENT_NAME="my-agent"
 ```
 
-Useful for CI/CD pipelines and temporary overrides.
-
-## Output Formats
+## Output Format
 
-All commands support `--format` option:
+Most resource commands support `--format json|text`.
 
 ```bash
-# JSON (default, machine-readable)
 agentteams plan list --format json
-
-# Text (human-friendly tables)
 agentteams plan list --format text
 ```
 
-## Error Handling
-
-| Error | Meaning | Solution |
-|-------|---------|----------|
-| **401 Unauthorized** | Invalid API key | Check `apiKey` in config or `AGENTTEAMS_API_KEY` |
-| **403 Forbidden** | Cross-project access denied | Verify `projectId` matches resource |
-| **404 Not Found** | Resource doesn't exist | Check ID or create resource first |
-| **Network errors** | Can't connect to server | Verify `apiUrl` and server status |
-| **Config not found** | No config file or env vars | Run `agentteams init` first |
+Note: `convention` does not support `--format`.
 
-## Development
+## Error Guide
 
-For contributors and developers who want to work on the CLI:
-
-**See [DEVELOPMENT.md](https://github.com/rlarua/AgentTeams/blob/main/cli/DEVELOPMENT.md)** for detailed development setup, testing, and contribution guidelines.
+| Error | Meaning | Resolution |
+|---|---|---|
+| `401 Unauthorized` | Invalid API key | Check `apiKey` or `AGENTTEAMS_API_KEY` |
+| `403 Forbidden` | No access to project | Verify `projectId` |
+| `404 Not Found` | Resource does not exist | Verify ID or create the resource |
+| Network error | Cannot reach server | Check `apiUrl` and server status |
+| Missing config | Config file/env vars not found | Run `agentteams init` |
 
 ## License
 
-MIT
+Apache-2.0
+
+This license applies to the CLI code distributed in this package.
+Use of the AgentTeams service/API may require credentials and is governed by separate service terms/policies.

package/dist/commands/convention.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"convention.d.ts","sourceRoot":"","sources":["../../src/commands/convention.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAMhD,KAAK,wBAAwB,GAAG;IAC9B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAsCF,wBAAsB,cAAc,IAAI,OAAO,CAAC,GAAG,CAAC,CA2BnD;AAED,wBAAsB,cAAc,IAAI,OAAO,CAAC,GAAG,CAAC,CAwBnD;AAsID,wBAAsB,kBAAkB,CAAC,OAAO,CAAC,EAAE,wBAAwB,GAAG,OAAO,CAAC,MAAM,CAAC,CAqF5F"}
+{"version":3,"file":"convention.d.ts","sourceRoot":"","sources":["../../src/commands/convention.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAMhD,KAAK,wBAAwB,GAAG;IAC9B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAsCF,wBAAsB,cAAc,IAAI,OAAO,CAAC,GAAG,CAAC,CA2BnD;AAED,wBAAsB,cAAc,IAAI,OAAO,CAAC,GAAG,CAAC,CAwBnD;AAsID,wBAAsB,kBAAkB,CAAC,OAAO,CAAC,EAAE,wBAAwB,GAAG,OAAO,CAAC,MAAM,CAAC,CAsG5F"}