@wport/cli 0.5.0 → 0.6.0

package/CHANGELOG.md

@@ -5,6 +5,26 @@
 
 ---
 
+## [0.6.0] — 2026-07-08
+
+issue #106 實測回饋：讓 agent 更容易讀懂錯誤與能力邊界，不必踩裸 40x 才知道。
+
+### Added
+
+- **`enterprise jobs publish` 失敗明列缺欄**：BR-008 publish gate 回 400（`data.missing_fields`）時，錯誤訊息直接列出缺哪些欄位（如 `Missing required fields: work_hours, headcount`），並提示以 `jobs update` 補齊；不再只有翻譯後的中文一句話。
+- **`enterprise jobs copy` 顯示 `incomplete_fields`**：複製 legacy 職缺（來源子表為空）時，人類模式印出 `⚠ Incomplete for publish — fill before \`jobs publish\`: …`；json 模式回應含 `incomplete_fields`。
+- **`wport doctor` 新增「Enterprise talent scope」區塊**：明示 Enterprise API Key 僅存取「已投遞」人才庫（`talents list --tab visit` 尚未開放、回 400），且**無主動搜尋**——`/api/search-talent` 需互動式 JWT（企業模式）session，API Key → 401（設計如此，非設定錯誤）。
+
+### Changed
+
+- `enterprise talents` 群組說明對齊現況：applied pool only、無主動搜尋（詳見 `wport doctor`）。
+
+### Notes
+
+- 上述錯誤/邊界提示與後端無耦合，對任何後端版本皆生效；`incomplete_fields` 顯示需後端已含 issue #106 copy 回應擴充（已於 backend `main`）。
+
+---
+
 ## [0.5.0] — 2026-07-07
 
 pm_41 企業 CLI 補完：人才庫、召募活動、公司資料、用量查詢，以及職缺複製/關閉。命令樹至此完整覆蓋 PRD §6.1 企業模式全部命令。

package/dist/index.js

@@ -179,7 +179,7 @@ function isTimeoutAbort(err) {
   return false;
 }
 function buildUserAgent() {
-  return `wport-cli/${"0.5.0"} (node ${process.version}; ${process.platform})`;
+  return `wport-cli/${"0.6.0"} (node ${process.version}; ${process.platform})`;
 }
 function unwrapDataResponse(body) {
   if (body && typeof body === "object" && "success" in body && "data" in body) {
@@ -972,13 +972,20 @@ function registerConfigCommand(program2) {
 // src/commands/doctor.ts
 var import_node_fs5 = require("fs");
 var SILENT_IGNORED_PARAMS = ["orderBy", "order"];
+var ENTERPRISE_TALENT_BOUNDARY_NOTES = [
+  "`enterprise talents` covers your APPLIED pool only (list / view / respond).",
+  "The visit tab is not available yet: `talents list --tab visit` returns 400.",
+  "There is NO active candidate search over an API Key. `/api/search-talent` needs an",
+  "interactive JWT (company-mode) session and returns 401 for an API Key \u2014 by design,",
+  "not a setup error. Do not script talent-sourcing against an Enterprise API Key."
+];
 function registerDoctorCommand(program2) {
   program2.command("doctor").description(
     "Diagnose CLI setup: resolved config, server reachability, schema fingerprint, and known server quirks."
   ).action(async (_opts, command) => {
     const ctx = resolveContext(command);
     const line = (s = "") => process.stdout.write(s + "\n");
-    line(`wport-cli ${"0.5.0"}`);
+    line(`wport-cli ${"0.6.0"}`);
     line(`  bundled schema fingerprint: ${"839e8a891dfb"}`);
     line("");
     line("Resolved configuration:");
@@ -998,6 +1005,9 @@ function registerDoctorCommand(program2) {
     line("  \u2022 jobs search sorts by publish date, or by relevance when --keyword is set.");
     line("  \u2022 jobs view --batch caps parallelism (default 5, max 20) to stay friendly to the API.");
     line("");
+    line("Enterprise talent scope (Enterprise API Key):");
+    for (const note of ENTERPRISE_TALENT_BOUNDARY_NOTES) line(`  \u2022 ${note}`);
+    line("");
     line("Schema drift:");
     line("  The fingerprint above identifies the OpenAPI contract this CLI was built against.");
     line("  Automated drift detection needs a server-side schema-version endpoint, which is");
@@ -1087,8 +1097,25 @@ function throwEnterpriseHttpError(status, body) {
       ExitCode.ServerClientError
     );
   }
+  if (status === 400) {
+    const missingFields = extractMissingFields(body);
+    if (missingFields.length > 0) {
+      throw new CliError(
+        `${base} \u2014 Missing required fields: ${missingFields.join(", ")}. Fill them via \`wport enterprise jobs update <enc_id> ...\` (or the web console), then publish.`,
+        ExitCode.ServerClientError
+      );
+    }
+  }
   throwForHttpStatus(status, body);
 }
+function extractMissingFields(body) {
+  if (!body || typeof body !== "object") return [];
+  const data = body.data;
+  if (!data || typeof data !== "object") return [];
+  const fields = data.missing_fields;
+  if (!Array.isArray(fields)) return [];
+  return fields.filter((f) => typeof f === "string");
+}
 function warnIfRateLimitLow(headers) {
   const remaining = Number(headers.get("x-ratelimit-remaining"));
   const limit = Number(headers.get("x-ratelimit-limit"));
@@ -1525,6 +1552,15 @@ async function runJobsCopy(ctx, apiKey, encId, idempotencyKey) {
   }
   process.stdout.write(`Copied job ${trimmed} \u2192 new draft: ${result.enc_id ?? "(unknown)"}
 `);
+  const incomplete = extractStringArray(result.incomplete_fields);
+  if (incomplete.length > 0) {
+    process.stdout.write(`  \u26A0 Incomplete for publish \u2014 fill before \`jobs publish\`: ${incomplete.join(", ")}
+`);
+  }
+}
+function extractStringArray(value) {
+  if (!Array.isArray(value)) return [];
+  return value.filter((v) => typeof v === "string");
 }
 function registerEnterpriseJobsCopy(parent) {
   parent.command("copy <enc_id>").description("Copy a job posting into a new unpublished draft").option("--idempotency-key <key>", "reuse across retries (default: a fresh UUID)").action(async (encId, flags, command) => {
@@ -2243,10 +2279,13 @@ async function runEnterpriseTalentsRespond(ctx, apiKey, encResumeId, flags, idem
     throw new CliError("--subject is required and must not be empty", ExitCode.InvalidArgument);
   }
   const body = resolveRespondBody(flags, { timeoutMs: ctx.timeoutMs });
+  const encJobId = flags.encJobId?.trim();
+  const payload = { subject, body };
+  if (encJobId) payload.enc_job_id = encJobId;
   const { body: respBody } = await enterprisePost(
     { baseUrl: ctx.baseUrl, locale: ctx.locale, timeoutMs: ctx.timeoutMs, apiKey },
     `/talents/${encodeURIComponent(trimmedId)}/respond`,
-    { subject, body },
+    payload,
     { idempotencyKey }
   );
   const result = unwrapDataResponse(respBody);
@@ -2258,7 +2297,7 @@ async function runEnterpriseTalentsRespond(ctx, apiKey, encResumeId, flags, idem
 `);
 }
 function registerEnterpriseTalentsRespond(parent) {
-  parent.command("respond <enc_resume_id>").description("Reply to an applicant (in-app message; inherits the company daily reply quota)").requiredOption("--subject <subject>", "message subject (max 200)").option("--body <text>", "message body text (max 5000)").option("--body-file <path>", 'read message body from a file, or "-" for stdin').option("--idempotency-key <key>", "reuse across retries to avoid duplicate sends (default: a fresh UUID)").action(async (encResumeId, flags, command) => {
+  parent.command("respond <enc_resume_id>").description("Reply to an applicant (in-app message; inherits the company daily reply quota)").requiredOption("--subject <subject>", "message subject (max 200)").option("--body <text>", "message body text (max 5000)").option("--body-file <path>", 'read message body from a file, or "-" for stdin').option("--enc-job-id <enc_id>", "reply to a specific job posting; omit to reply to the most recent application").option("--idempotency-key <key>", "reuse across retries to avoid duplicate sends (default: a fresh UUID)").action(async (encResumeId, flags, command) => {
     const ctx = resolveContext(command);
     const globals = command.optsWithGlobals();
     const { key } = resolveApiKey(globals.apiKey);
@@ -2268,7 +2307,9 @@ function registerEnterpriseTalentsRespond(parent) {
 
 // src/commands/enterprise/talents/index.ts
 function registerEnterpriseTalentsCommand(parent) {
-  const talents = parent.command("talents").description("Browse and respond to applicants in your talent pool");
+  const talents = parent.command("talents").description(
+    "Browse & respond to your applied talent pool (visit tab n/a, no active candidate search \u2014 see `wport doctor`)"
+  );
   registerEnterpriseTalentsList(talents);
   registerEnterpriseTalentsView(talents);
   registerEnterpriseTalentsRespond(talents);
@@ -2477,7 +2518,7 @@ function registerEnterpriseCommand(program2) {
 
 // src/index.ts
 var program = new import_commander.Command();
-program.name("wport").description("wport CLI \u2014 terminal interface to the W101 Talent Search Hub public API").version("0.5.0", "-v, --version", "output the CLI version").option("--lang <locale>", "Accept-Language locale: zh-TW | en-US | vi-VN | th-TH | id-ID").option("--api <url>", "override API base URL").option("--output <fmt>", "output format: table | json").option("--no-color", "disable color output").option("--timeout <ms>", "HTTP timeout in milliseconds", (v) => Number(v));
+program.name("wport").description("wport CLI \u2014 terminal interface to the W101 Talent Search Hub public API").version("0.6.0", "-v, --version", "output the CLI version").option("--lang <locale>", "Accept-Language locale: zh-TW | en-US | vi-VN | th-TH | id-ID").option("--api <url>", "override API base URL").option("--output <fmt>", "output format: table | json").option("--no-color", "disable color output").option("--timeout <ms>", "HTTP timeout in milliseconds", (v) => Number(v));
 registerJobsCommand(program);
 registerConfigCommand(program);
 registerDoctorCommand(program);