@wport/cli 0.9.0 → 0.9.1

package/CHANGELOG.md

@@ -5,6 +5,17 @@
 
 ---
 
+## [0.9.1] — 2026-08-17
+
+### Changed
+
+- **內部重構(pm_48 交付 B):轉 npm workspaces monorepo**——共用引擎抽出為 `@wport/core`
+  (typed REST client、typed errors、enterprise transport、concurrency、resume-schema),
+  CLI 改為其消費者。**對外行為零變更**:指令、exit code 契約(0/2/3/4/5)、
+  schema fingerprint(`839e8a891dfb`)均與 0.9.0 一致(669 tests + whole-branch review 驗證)。
+- 新姊妹套件:`@wport/sdk`(程式化存取,同能力邊界)與 `@wport/core`(內部引擎)自本版起發布。
+- npm 發布素材補齊:package 內 README/CHANGELOG/LICENSE(先前 `files` 指向 repo root 造成漏檔)。
+
 ## [0.9.0] — 2026-08-10
 
 ### Added

package/README.md

@@ -16,6 +16,16 @@ npm install -g @wport/cli
 
 Requires Node.js >= 18.17.
 
+### dev channel(內部測試用)
+
+`@wport/cli@dev` 是預設連 dev 後端(`https://developers.wport.me/v2`)的建置,供內部測試未上 prod 的後端改動:
+
+    npm i -g @wport/cli@dev     # wport → dev 後端
+    wport login                 # 直接對 dev 後端做 device flow
+    npm i -g @wport/cli@latest  # 換回 prod 版
+
+dev 版憑證獨立存於 `credentials-dev.json`,與 prod 版的 `credentials.json` 互不干擾;`wport doctor` 會印出目前 channel。base URL 仍可用 `--api` / `WPORT_API_BASE` 覆寫。
+
 ## Quick start
 
 ```bash
@@ -295,24 +305,37 @@ The public job search endpoint is throttled to 1200 requests / minute / client I
 ## Development
 
 ```bash
-cd apps/cli
+# from the repo root (npm workspaces monorepo)
 npm install
-npm run gen:openapi:prod  # fetch + filter swagger from prod, produces src/generated/schema.d.ts
-npm run build
-npm link                  # so the wport command resolves to this build
+npm run gen:openapi:prod -w @wport/core  # fetch + filter swagger from prod, produces packages/core/src/generated/schema.d.ts
+npm run build -w @wport/cli
+npm link -w @wport/cli    # so the wport command resolves to this build
 
 wport jobs search --keyword backend
 ```
 
-Three codegen variants — pick whichever matches your setup:
+Three codegen scripts live in `packages/core/package.json` — run each with `-w @wport/core`, pick whichever matches your setup:
+
+| Script | Source | Output | When to use |
+|---|---|---|---|
+| `npm run gen:openapi:prod -w @wport/core` | `https://api.wport.me/api/api-doc-json` | `packages/core/src/generated/schema.d.ts` (jobs line) | Default; works from a fresh checkout, no local backend needed |
+| `npm run gen:openapi -w @wport/core` | `http://localhost:3000/api/api-doc-json` | `packages/core/src/generated/schema.d.ts` (jobs line) | When you're hacking on the backend locally |
+| `npm run gen:openapi:personal -w @wport/core` | repo's frozen `docs/handoff/swagger-wport-personal-api-v1.json` | `packages/core/src/generated/personal-schema.d.ts` (personal line) | Regenerating personal-line types after the frozen spec changes; deterministic, no network needed, and CI enforces this one stays in sync |
+
+All three go through `packages/core/scripts/gen-from-remote.cjs`, which filters the upstream spec down to the endpoints this CLI uses (it ignores unrelated `$ref` breakage elsewhere in the spec). When the CLI starts using a new endpoint, add it to `KEEP_PATHS` (jobs line) or `--keep-prefix` (personal line) in that script.
+
+#### 發 dev channel 到 npm
+
+    npm version prerelease --preid=dev --no-git-tag-version   # 0.9.0 → 0.9.1-dev.0(prerelease 會先進 patch)
+    npm run build:dev                                         # 選用:發布前先在本地確認 dev build 行為正常
+    # 發布必須帶 WPORT_BUILD_CHANNEL=dev:否則 npm publish 的 prepublishOnly hook 會跑 `npm run build`(prod),
+    # 把 dist 覆寫回 prod 產物,結果 @wport/cli@dev 底下發成 prod build(靜默、不報錯)。
+    WPORT_BUILD_CHANNEL=dev npm publish --tag dev --otp <code> # 必須顯式帶 --tag dev
+    npm view @wport/cli dist-tags                             # 斷言 latest 未被動到
 
-| Script | Source | When to use |
-|---|---|---|
-| `npm run gen:openapi:prod` | `https://api.wport.me/api/api-doc-json` | Default; works from a fresh checkout, no local backend needed |
-| `npm run gen:openapi:remote` | `http://localhost:3000/api/api-doc-json` | When you're hacking on the backend locally |
-| `npm run gen:openapi` | `../../docs/swagger/swagger-dev.json` | When you've already exported the spec via root's `npm run export:swagger:json` |
+⚠️ npm 預設 tag 是 `latest`,即使版號是 prerelease;漏掉 `--tag dev` 會把 `latest` 指到 dev 版,污染所有 `npm i @wport/cli`。發布後務必用 `npm view dist-tags` 確認 `latest` 沒變。
 
-The `:prod` / `:remote` variants go through `scripts/gen-from-remote.cjs`, which filters the upstream spec down to the endpoints this CLI uses (it ignores unrelated `$ref` breakage elsewhere in the spec). When the CLI starts using a new endpoint, add it to `KEEP_PATHS` in that script.
+⚠️ `package.json` 的 `prepublishOnly` 會在 `npm publish` 時自動重跑 `npm run build`(prod build,無 dev channel),覆寫掉上一步 `build:dev` 產出的 dist。真正決定 channel 的是 publish 指令本身的 `WPORT_BUILD_CHANNEL=dev` 前綴 —— 該 env 會被 npm 傳進 prepublishOnly 的子行程,讓重跑的 `npm run build` 也讀到 dev channel。漏掉這個前綴,`@wport/cli@dev` 就會靜默發成連 `api.wport.me` 的 prod build。
 
 ## Support