@twentyoz/alexx-cli 0.3.0 → 0.3.1

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.
Files changed (2) hide show
  1. package/README.md +7 -5
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -31,13 +31,15 @@ cd web/cli && ALEXX_ENV=dev npm run dev -- --help
31
31
  ### npm 발행
32
32
 
33
33
  ```bash
34
- make release-cli # 현재 version 으로 발행 (운영 endpoint)
35
- make release-cli version=patch # version bump 후 발행
34
+ make release-cli version=patch # version bump + 태그 + GitHub Actions 발행
35
+ make release-cli # 현재 version 그대로 발행
36
+ make release-cli dry=1 # 태그 없이 빌드·테스트·패키징만 (발행 안 함)
36
37
  ```
37
38
 
38
- - 발행본은 항상 **운영 endpoint baked** — `npm publish` 는 `ALEXX_ENV=prod` 일 때만 허용(`prepublishOnly` 가드)
39
- - 발행 머신의 `.env` 에 `ALEXX_API_BASE_PROD` 필요 (또는 `ALEXX_API_BASE_URL` 주입). 사전 `npm login` (스코프 `@twentyoz`)
40
- - 레지스트리는 public npmjs 기본(`publishConfig.access=public`). private/GitHub Packages 로 바꾸려면 `publishConfig.registry` 추가
39
+ - 발행은 GitHub Actions 가 함. 이 디렉토리를 `git subtree push` 로 `alexx-app/alexx-cli` 에 미러링하고, `cli/v*` 태그 ref 에서 [`publish.yml`](.github/workflows/publish.yml) 을 실행함
40
+ - npm 인증은 Trusted Publishing(OIDC). 로컬·저장소 어디에도 npm 토큰이 없고, 패키지 설정은 토큰 발행을 막아 둠
41
+ - 발행본은 항상 **운영 endpoint baked** — 워크플로가 `ALEXX_ENV=prod`·`ALEXX_API_BASE_URL=https://alexx.app/api` 로 빌드함. `npm publish` 는 `ALEXX_ENV=prod` 일 때만 허용(`prepublishOnly` 가드)
42
+ - 태그를 먼저 찍고 발행하므로 워크플로가 실패하면 태그가 남음. 고친 뒤 `gh workflow run publish.yml --repo alexx-app/alexx-cli --ref cli/vX.Y.Z` 로 재실행
41
43
 
42
44
  | 환경 | 기본 URL (`.env.template`) |
43
45
  |------|----------------------------|
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@twentyoz/alexx-cli",
3
- "version": "0.3.0",
3
+ "version": "0.3.1",
4
4
  "description": "Alexx CLI (alexx) — AI 에이전트를 위한 음성 분석 앱 조작 도구. npm 발행본은 운영 endpoint baked.",
5
5
  "type": "module",
6
6
  "bin": {