@wport/cli 0.5.0 → 0.7.0

package/CHANGELOG.md

@@ -5,6 +5,45 @@
 
 ---
 
+## [0.7.0] — 2026-07-15
+
+### Removed
+
+- **`enterprise jobs close` 全面撤銷**（產品決議：職缺狀態只有上下架，無「關閉」態）。
+  「已關閉（status=10）」是 GUI 完全不存在的第三狀態——被 CLI 關閉的職缺會在企業後台
+  顯示成無法再上架、無法操作的殭屍列，卡住整個管理流程。命令改為隱藏 stub：
+  打到時印出遷移訊息（改用 `jobs unpublish` 下架、或 `jobs delete --confirm` 刪除）
+  並 exit 2、不發任何請求。
+- 後端 `PATCH /api/v1/enterprise/jobs/:enc_id/close` 端點同步移除（同一 backend PR）。
+  舊版 CLI（0.5.x–0.6.x）呼叫 `jobs close` 將收到 404——請升級至 0.7.0。
+
+### Notes
+
+- 已被關閉的存量職缺由後端資料復原 DML 統一改回「未刊登」（可重新上架），
+  詳見 backend repo `docs/ddl/V20260715*__tsh-pm_41-jobs-close-revoke-restore.sql`。
+
+---
+
+## [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/README.md

@@ -69,7 +69,6 @@ wport enterprise jobs view <enc_id>
 wport enterprise jobs create --file new-job.json
 wport enterprise jobs publish <enc_id>
 wport enterprise jobs copy <enc_id>
-wport enterprise jobs close <enc_id> --confirm
 
 # View / update your company profile
 wport enterprise company view

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.7.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.7.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) => {
@@ -1533,33 +1569,10 @@ function registerEnterpriseJobsCopy(parent) {
     await runJobsCopy(ctx, key, encId, flags.idempotencyKey ?? (0, import_node_crypto3.randomUUID)());
   });
 }
-async function runJobsClose(ctx, apiKey, encId, confirm, idempotencyKey) {
-  if (!confirm) {
-    throw new CliError(
-      "Refusing to close without --confirm (irreversible; a closed job cannot be reopened \u2014 copy it to relist)",
-      ExitCode.InvalidArgument
-    );
-  }
-  const trimmed = requireEncId(encId);
-  const { body } = await enterprisePatch(
-    { baseUrl: ctx.baseUrl, locale: ctx.locale, timeoutMs: ctx.timeoutMs, apiKey },
-    `/jobs/${encodeURIComponent(trimmed)}/close`,
-    {},
-    { idempotencyKey }
-  );
-  const result = unwrapDataResponse(body);
-  if (ctx.format === "json") {
-    printJson(result);
-    return;
-  }
-  process.stdout.write(`Closed job: ${result.enc_id ?? trimmed}
-`);
-}
+var JOBS_CLOSE_REMOVED_MESSAGE = '`jobs close` was removed in @wport/cli 0.7.0 \u2014 the "closed" job state has been revoked product-wide (jobs are only published/unpublished). Use `jobs unpublish <enc_id>` to take a job off the board, or `jobs delete <enc_id> --confirm` to remove it.';
 function registerEnterpriseJobsClose(parent) {
-  parent.command("close <enc_id>").description("Close (finalize) a job posting (destructive, irreversible; requires --confirm)").option("--confirm", "confirm this irreversible close (a closed job cannot be reopened)").option("--idempotency-key <key>", "reuse across retries (default: a fresh UUID)").action(async (encId, flags, command) => {
-    const ctx = resolveContext(command);
-    const { key } = resolveApiKey(command.optsWithGlobals().apiKey);
-    await runJobsClose(ctx, key, encId, flags.confirm === true, flags.idempotencyKey ?? (0, import_node_crypto3.randomUUID)());
+  parent.command("close [enc_id]", { hidden: true }).description("(removed in 0.7.0)").allowUnknownOption(true).action(async () => {
+    throw new CliError(JOBS_CLOSE_REMOVED_MESSAGE, ExitCode.InvalidArgument);
   });
 }
 function registerEnterpriseJobsPublish(parent) {
@@ -2243,10 +2256,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 +2274,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 +2284,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 +2495,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.7.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);