@ait-co/console-cli 0.1.38 → 0.1.40

package/README.en.md

@@ -182,46 +182,38 @@ Every command accepts `--json`. When set:
 
 `agent-plugin` skills shell out with `--json` exclusively and parse stdout.
 
-## Telemetry
-
-`aitcc` collects anonymous usage statistics split into two tiers. See the [privacy page](https://docs.aitc.dev/privacy) for details.
-
-### Tier 0 — anonymous daily ping (on by default, opt-out)
+## Status
 
-Once per day per machine, a minimal anonymous ping is sent on every invocation. Collected: `{source, version, platform}`. No PII, no `anon_id` — the server derives a daily hash from IP + User-Agent using a rotating salt, and stores nothing else. This is the minimum signal needed to know "is anyone actually using this version?"
+The following command groups are implemented end-to-end:
 
-Three ways to opt out:
+- Auth & session: `login` / `logout` / `whoami` / `auth` (export/import)
+- Workspace: `workspace` / `members` / `me` / `notices`
+- Mini-app: `app` — `init` / `ls` / `show` / `status` / `deploy` / `register` / `ratings` / `reports` / `metrics` / `events` / `messages` / `share-rewards`, `app bundles` (`ls`/`deployed`/`upload`/`review`/`release`/`test-push`/`test-links`), `app certs` (`ls`/`show`/`issue`/`revoke`)
+- Misc: Deploy Key issuance (`keys`), `upgrade` (self-update), `completion` (shell completion)
 
-- `AITCC_TELEMETRY=off` environment variable — disables all telemetry for this shell session
-- `--no-telemetry` flag — disables for this single invocation only (not permanent)
-- `aitcc telemetry tier0-off` — permanently opts out (persisted to the state file)
+`app logs` is deferred until the backend endpoint is available. See the [organization landing page](https://aitc.dev/) for the full roadmap.
 
-### Tier 1 — detailed events (off by default, opt-in)
+## Issuing a Deploy Key
 
-On first run in a TTY, the CLI prompts for consent. In CI or pipe environments it silently defaults to deny. Collected: command name, version, platform, random persistent anonymous ID (`anon_id`). No personally identifiable information (email, session, user ID, etc.) is ever sent.
+Issue a workspace-scoped credential (Deploy Key) for deploy automation:
 
 ```sh
-aitcc telemetry status          # show both tier status + anon ID
-aitcc telemetry status --json   # machine-readable output
-aitcc telemetry enable          # enable Tier 1 events
-aitcc telemetry disable         # disable Tier 1 events
-aitcc telemetry delete          # request deletion of Tier 1 server data + rotate local anon ID
-aitcc telemetry tier0-off       # permanently opt out of Tier 0 daily ping
-aitcc telemetry tier0-on        # re-enable Tier 0 after a previous tier0-off
+aitcc keys create --name ci-deploy
 ```
 
-State file: `$XDG_CONFIG_HOME/aitcc/telemetry.json` (fallback `~/.config/aitcc/telemetry.json`, mode `0600`).
+The key is automatically saved to `~/.ait/credentials` under the `ci-deploy` profile as soon as it is issued — no separate `ait token add` step required:
 
-## Status
+```sh
+ait deploy --profile ci-deploy ./bundle.ait
+```
 
-The following command groups are implemented end-to-end:
+Only the plaintext key is written to stdout (pipe-friendly). stderr confirms which profile was saved. If you are piping the key into an external secret manager and do not need a local profile, pass `--no-save-profile`:
 
-- Auth & session: `login` / `logout` / `whoami` / `auth` (export/import)
-- Workspace: `workspace` / `members` / `me` / `notices`
-- Mini-app: `app` — `init` / `ls` / `show` / `status` / `deploy` / `register` / `ratings` / `reports` / `metrics` / `events` / `messages` / `share-rewards`, `app bundles` (`ls`/`deployed`/`upload`/`review`/`release`/`test-push`/`test-links`), `app certs` (`ls`/`show`/`issue`/`revoke`)
-- Misc: Deploy Key issuance (`keys`), `telemetry`, `upgrade` (self-update), `completion` (shell completion)
+```sh
+aitcc keys create --name ci-deploy --no-save-profile | secret-tool store --label=… key password
+```
 
-`app logs` is deferred until the backend endpoint is available. See the [organization landing page](https://aitc.dev/) for the full roadmap.
+To save the profile under a different name than `--name`, pass `--save-profile <other-name>`. The plaintext key is exposed once at issuance and cannot be retrieved later — if you lose it, revoke it with `aitcc keys revoke <id>` and issue a new one.
 
 ## Pre-commit hook
 

package/README.md

@@ -182,46 +182,38 @@ aitcc app deploy ./aitc-sdk-example.ait --json
 
 `agent-plugin` skill은 항상 `--json`으로 shell out하고 stdout을 파싱합니다.
 
-## 텔레메트리
-
-`aitcc`는 두 단계로 분리된 익명 사용 통계를 수집합니다. 자세한 내용은 [privacy 페이지](https://docs.aitc.dev/privacy) 참조.
-
-### Tier 0 — 일별 익명 핑 (기본 ON, opt-out)
+## 진행 상황
 
-매 실행 시 하루 한 번 익명 핑을 보냅니다. 수집 항목: `{source, version, platform}`. 개인 식별 정보 없음. `anon_id`도 없음 — 서버가 일별 salt로 IP+UA 해시를 계산해 저장하며, 그 외 정보는 저장하지 않습니다. "이 버전을 실제로 쓰는 사람이 있는가"를 파악하기 위한 최소 신호입니다.
+다음 명령군이 end-to-end로 동작합니다:
 
-opt-out 방법 (세 가지):
+- 인증·세션: `login` / `logout` / `whoami` / `auth` (export/import)
+- 워크스페이스: `workspace` / `members` / `me` / `notices`
+- 미니앱: `app` — `init` / `ls` / `show` / `status` / `deploy` / `register` / `ratings` / `reports` / `metrics` / `events` / `messages` / `share-rewards`, `app bundles` (`ls`/`deployed`/`upload`/`review`/`release`/`test-push`/`test-links`), `app certs` (`ls`/`show`/`issue`/`revoke`)
+- 그 외: Deploy Key 발급(`keys`), `upgrade`(self-update), `completion`(셸 자동완성)
 
-- `AITCC_TELEMETRY=off` 환경 변수 — 이 쉘 세션 전체 비활성
-- `--no-telemetry` 플래그 — 이 invocation만 비활성 (영구 X)
-- `aitcc telemetry tier0-off` — 영구 opt-out (state file에 저장)
+`app logs`는 백엔드 endpoint 확보 후 구현 예정입니다. 전체 로드맵은 [organization landing page](https://aitc.dev/) 참조.
 
-### Tier 1 — 세부 이벤트 (기본 OFF, opt-in)
+## Deploy Key 발급
 
-처음 실행 시 TTY 환경에서만 동의를 묻습니다. CI/파이프 환경에선 자동으로 비활성화됩니다. 수집 항목: 실행된 명령 이름, 버전, 플랫폼, 임의 익명 ID (`anon_id`). 개인 식별 정보(이메일, 세션, 사용자 ID 등)는 절대 전송하지 않습니다.
+배포 자동화를 위한 워크스페이스-scope 자격증명(Deploy Key)을 발급합니다.
 
 ```sh
-aitcc telemetry status          # 두 tier 상태 + 익명 ID 확인
-aitcc telemetry status --json   # machine-readable 출력
-aitcc telemetry enable          # Tier 1 활성화
-aitcc telemetry disable         # Tier 1 비활성화
-aitcc telemetry delete          # 서버에 저장된 Tier 1 데이터 삭제 요청 + 로컬 익명 ID 교체
-aitcc telemetry tier0-off       # Tier 0 익명 핑 영구 비활성화
-aitcc telemetry tier0-on        # Tier 0 다시 활성화
+aitcc keys create --name ci-deploy
 ```
 
-상태 파일: `$XDG_CONFIG_HOME/aitcc/telemetry.json` (fallback `~/.config/aitcc/telemetry.json`, mode `0600`).
+키 발급 즉시 `~/.ait/credentials`에 `ci-deploy` 프로파일로 저장되므로, 별도 `ait token add` 단계 없이 바로 사용할 수 있습니다:
 
-## 진행 상황
+```sh
+ait deploy --profile ci-deploy ./bundle.ait
+```
 
-다음 명령군이 end-to-end로 동작합니다:
+stdout에는 plaintext 키 한 줄만 나옵니다 (파이프 친화적). stderr는 저장된 프로파일 이름을 확인해줍니다. CI 파이프에서 키를 외부 secret manager에 직접 주입할 때처럼 로컬 저장이 필요 없다면 `--no-save-profile`로 저장을 건너뜁니다:
 
-- 인증·세션: `login` / `logout` / `whoami` / `auth` (export/import)
-- 워크스페이스: `workspace` / `members` / `me` / `notices`
-- 미니앱: `app` — `init` / `ls` / `show` / `status` / `deploy` / `register` / `ratings` / `reports` / `metrics` / `events` / `messages` / `share-rewards`, `app bundles` (`ls`/`deployed`/`upload`/`review`/`release`/`test-push`/`test-links`), `app certs` (`ls`/`show`/`issue`/`revoke`)
-- 그 외: Deploy Key 발급(`keys`), `telemetry`, `upgrade`(self-update), `completion`(셸 자동완성)
+```sh
+aitcc keys create --name ci-deploy --no-save-profile | secret-tool store --label=… key password
+```
 
-`app logs`는 백엔드 endpoint 확보 후 구현 예정입니다. 전체 로드맵은 [organization landing page](https://aitc.dev/) 참조.
+프로파일 이름을 `--name`과 다르게 지정하려면 `--save-profile <other-name>`을 사용합니다. plaintext 키는 발급 시 한 번만 노출되며 목록 endpoint에서 다시 확인할 수 없습니다 — 분실 시 `aitcc keys revoke <id>`로 무효화하고 재발급합니다.
 
 ## Pre-commit hook