@wport/cli 0.9.3 → 0.10.1

package/CHANGELOG.md

@@ -5,6 +5,74 @@
 
 ---
 
+## [0.10.1] — 2026-09-10
+
+### Changed
+
+- **`enterprise usage` 輸出標明計量語意**：月配額行改為 `X / Y calls used`，並加一行說明
+  「所有認證通過的 API 呼叫計數；`whoami`/`usage` 與 key rotate 豁免」——對齊後端 2026-09-10
+  上線的 quota PRD 對齊（talent#233：guard 層 per-request 計數，原先只計職缺建立）。
+  純顯示變更，wire 契約與 exit code 不變。（0.10.0 已以 `next` tag 發布、不可覆寫，故以
+  patch 版收納本變更。）
+
+## [0.10.0] — 2026-09-09
+
+### Added
+
+- **`wport enterprise company replace <section>`（新指令）**：整段取代四個公司內容區塊
+  （`pain-points` / `awards` / `milestones` / `qa-items`）。輸入為 `{ "items": [...] }`，
+  走 `--file <path>` 或 `-`（stdin）。
+
+  **這是整段取代，不是 add/update：未列於輸入中的既有項目會被刪除。** 因此指令會在每次寫入前
+  先 `GET /company`、比對 `enc_id`，只要有任何項目將被移除（包含「非空但漏掉一筆」，
+  不只 `items: []`），就列出即將刪除的 `enc_id` 與摘要並要求 `--confirm`，否則 exit 2。
+
+  寫入使用同一次 preflight 取得的 `block_revisions.<block>` 作為 `If-Match` 樂觀鎖；
+  遇 409（stale revision）**不自動重送**，改為重新 `GET` 顯示差異後 exit 2。
+  預設帶 `Idempotency-Key`（`randomUUID()`），可用 `--idempotency-key` 覆寫。
+
+- **`company update` 的 `basic` 節新增六個可寫欄位**：`representative_name`、
+  `establishment_date`、`directors`（`string[]`），以及三個公開頁顯示開關
+  `is_representative_visible` / `is_establishment_date_visible` / `is_directors_visible`
+  （皆 `0|1`，**未設時預設 0 = 隱藏**）。
+
+  `is_uniform_number_visible` **刻意不開放**（保留在 `FORBIDDEN_FIELDS`），
+  `uniform_number` 維持唯讀。
+
+- **`company update` 的 `descriptions` 節新增 `video_links`**（≤3，YouTube / Vimeo）。
+  與同節其他三個欄位不同：帶 `video_links` 時會自動附上 `If-Match`（樂觀鎖），
+  且與 `description` 在後端是**同一筆原子寫入**。移除既有影片（含漏一部與 `video_links: []`
+  清空）套用與 `replace` **相同的** `--confirm` 規則；428／409 不自動重送。
+
+  只送 `video_links` 而不送 `description` 時，CLI 會以 preflight 讀到的現值回填，
+  不會清空既有的公司介紹。
+
+- **`company view` 表格模式新增區塊摘要**（五個區塊各自的筆數）。
+  `block_revisions` **只在 `--output json` 顯示**——它是 opaque token，不是人類可讀的版本號。
+
+- **可程式判讀的錯誤碼**：新增五個 `error_code` 的專屬訊息裝飾
+  （`profile_revision_required` / `profile_revision_conflict` / `block_max_exceeded` /
+  `block_item_forbidden` / `unsupported_video_provider`）。分流一律依 `error_code`
+  優先於 HTTP status，**不解析多語系 `message`**。
+
+- **enterprise 線導入 OpenAPI codegen**：契約凍結自 talent repo commit
+  `4cf6ca74b4f50dc256b2536b5101c2b9fed3c422`，產物與 source manifest 進版控，
+  CI 新增 `enterprise schema drift gate`（驗 sha256 → 驗 prefix → 跑 codegen →
+  `git diff --exit-code`）。新指令的型別取自 `components['schemas']`。
+
+### Changed
+
+- 依賴 bump：`@wport/core` `^0.2.0` → `^0.3.0`（0.x 的 caret 不跨 minor，需顯式升）。
+  core 0.3.0 為純 additive（新增 `enterprisePut` 與 enterprise schema 型別匯出），
+  無移除任何既有匯出，CLI 既有行為不受影響。
+
+### ⚠️ 後端相依
+
+本版新增的指令與欄位需要 talent 後端 **2026-09-09 或之後的版本**
+（PR hotfire-digital/W101-TalentSearchHub#232，已於該日上正式站）。
+對更舊的後端使用新欄位會因 `forbidNonWhitelisted` 被回 400。
+既有指令不受影響。
+
 ## [0.9.3] — 2026-08-26
 
 ### Changed

package/README.md

@@ -85,6 +85,26 @@ wport enterprise company view
 wport enterprise company update --file company-patch.json
 wport enterprise company logo upload ./logo.png
 
+# `basic` section (via company update) also accepts: representative_name, establishment_date,
+# directors (string[]), and their three display toggles is_representative_visible /
+# is_establishment_date_visible / is_directors_visible (all default to 0 = hidden when unset).
+# is_uniform_number_visible is intentionally NOT supported.
+
+# `descriptions` section (via company update) also accepts video_links (<=3, YouTube/Vimeo URLs).
+# Unlike the other three description fields, video_links is optimistic-locked: it is written
+# atomically with `description` using an If-Match derived from your latest `company view`
+# (handled automatically — no flag needed). Removing any existing video (a non-empty submission
+# that drops one, or `video_links: []` to clear all) requires --confirm; a stale revision (409)
+# is never auto-retried — re-run `company view` and retry.
+wport enterprise company update --file company-video-links.json --confirm
+
+# Replace an entire profile block (full replacement — items not listed are deleted;
+# any deletion needs --confirm, whether from a non-empty submission or an empty one)
+wport enterprise company replace pain-points --file pain-points.json --confirm
+wport enterprise company replace awards --file awards.json
+wport enterprise company replace milestones --file milestones.json
+wport enterprise company replace qa-items --file qa-items.json
+
 # Talent pool: browse applicants and reply (no bulk export by design)
 wport enterprise talents list --tab applied
 wport enterprise talents view <enc_resume_id>
@@ -99,7 +119,7 @@ wport enterprise campaigns publish <enc_id>
 wport enterprise keys list
 wport enterprise keys rotate <enc_id> --reveal
 
-# Monthly quota + rate-limit headroom
+# Monthly quota (all authenticated API calls) + rate-limit ceiling
 wport enterprise usage
 
 # Agent / CI friendly: no key on disk