@wport/cli 0.8.0 → 0.9.0

package/CHANGELOG.md

@@ -5,6 +5,21 @@
 
 ---
 
+## [0.9.0] — 2026-08-10
+
+### Added
+
+- **個人線(pm_47)· `wport personal apply` 投遞**(對接 talent `/api/v1/personal/applications`):
+  - 單筆:`personal apply <job_enc_id> --resume <enc_id> --message <text> | --message-file <path|-> --confirm`
+    ——message 互斥二擇一必填、trim 後 1~2000 字**本地先驗**(超長/空 exit 2 不發請求)、`-` 讀 stdin;
+    投遞對雇主可見,無 `--confirm` 一律 exit 2 不發請求;自動附 `Idempotency-Key`。
+  - 批次:`personal apply --file <batch.json> --confirm`——`{"applications":[…]}` ≤20 筆與逐筆 message
+    本地先驗(超限 exit 2);輸出 succeeded/failed 表,`--output json` 給完整陣列。
+  - **錯誤分流**:冷卻 409(印 `next_apply_at`)、職缺終態 409、日上限 429(印剩餘額度 / `resets_at`)
+    → 統一 exit 3 + 人類可讀;其餘 4xx 沿既有 exit code 契約。
+- codegen:凍結 `docs/handoff/swagger-wport-personal-api-v1.{json,yaml}` 納入 applications 端點,
+  `PERSONAL_APPLICATIONS_BASE` 常數;`gen:openapi:personal` 經 `--keep-prefix` 自動含 applications。
+
 ## [0.8.0] — 2026-07-30
 
 ### Added

package/README.md

@@ -139,6 +139,11 @@ wport personal resumes publish <enc_id>              # searchable by companies (
 wport personal resumes delete <enc_id> --confirm
 wport personal resumes export --out ./backup
 
+# Apply to jobs (visible to the employer; requires --confirm; 20/day)
+wport personal apply <job_enc_id> --resume <enc_id> --message "自我介紹…" --confirm
+wport personal apply <job_enc_id> --resume <enc_id> --message-file intro.txt --confirm   # or - for stdin
+wport personal apply --file batch.json --confirm     # { "applications": [...] }, max 20, partial success
+
 # Sign out (revokes the refresh token server-side, clears local credentials)
 wport logout
 ```

package/dist/index.js

@@ -179,7 +179,7 @@ function isTimeoutAbort(err) {
   return false;
 }
 function buildUserAgent() {
-  return `wport-cli/${"0.8.0"} (node ${process.version}; ${process.platform})`;
+  return `wport-cli/${"0.9.0"} (node ${process.version}; ${process.platform})`;
 }
 function unwrapDataResponse(body) {
   if (body && typeof body === "object" && "success" in body && "data" in body) {
@@ -1148,6 +1148,7 @@ function ensureFormat(key, source) {
 
 // src/lib/personal-types.ts
 var PERSONAL_RESUMES_BASE = "/api/v1/personal/resumes";
+var PERSONAL_APPLICATIONS_BASE = "/api/v1/personal/applications";
 var OAUTH_BASE = "/api/oauth";
 var OAUTH_SESSIONS_BASE = `${OAUTH_BASE}/sessions`;
 var SECTION_WRITE_PLAN = {
@@ -1252,7 +1253,7 @@ function registerDoctorCommand(program2) {
 }
 async function runDoctor(ctx) {
   const line = (s = "") => process.stdout.write(s + "\n");
-  line(`wport-cli ${"0.8.0"}`);
+  line(`wport-cli ${"0.9.0"}`);
   line(`  bundled schema fingerprint: ${"839e8a891dfb"}`);
   line("");
   line("Resolved configuration:");
@@ -4542,15 +4543,170 @@ function registerPersonalResumesCommand(parent) {
   registerPersonalResumesDelete(resumes);
 }
 
+// src/commands/personal/apply/index.ts
+var import_node_crypto15 = require("crypto");
+var import_node_fs11 = require("fs");
+
+// src/commands/personal/apply/message-input.ts
+var import_node_fs10 = require("fs");
+var MAX_MESSAGE = 2e3;
+function defaultReadStdin() {
+  return (0, import_node_fs10.readFileSync)(0, "utf8");
+}
+function validateMessageText(raw) {
+  const trimmed = raw.trim();
+  if (trimmed.length < 1) {
+    throw new CliError("application message must not be empty (1~2000 chars) \u61C9\u5FB5\u8A0A\u606F\u5FC5\u586B", ExitCode.InvalidArgument);
+  }
+  if (trimmed.length > MAX_MESSAGE) {
+    throw new CliError(`application message exceeds ${MAX_MESSAGE} chars \u61C9\u5FB5\u8A0A\u606F\u4E0D\u53EF\u8D85\u904E 2000 \u5B57`, ExitCode.InvalidArgument);
+  }
+  return trimmed;
+}
+function resolveMessage(opts) {
+  const hasMsg = opts.message !== void 0;
+  const hasFile = opts.messageFile !== void 0;
+  if (hasMsg && hasFile) {
+    throw new CliError("--message and --message-file are mutually exclusive \u4E92\u65A5", ExitCode.InvalidArgument);
+  }
+  if (!hasMsg && !hasFile) {
+    throw new CliError("--message or --message-file is required \u61C9\u5FB5\u8A0A\u606F\u5FC5\u586B", ExitCode.InvalidArgument);
+  }
+  if (hasMsg) return validateMessageText(opts.message);
+  const file = opts.messageFile;
+  const raw = file === "-" ? (opts.readStdin ?? defaultReadStdin)() : (0, import_node_fs10.readFileSync)(file, "utf8");
+  return validateMessageText(raw);
+}
+function validateBatchItems(items) {
+  if (!Array.isArray(items) || items.length < 1) {
+    throw new CliError('batch file must contain a non-empty "applications" array', ExitCode.InvalidArgument);
+  }
+  if (items.length > 20) {
+    throw new CliError(`batch exceeds 20 items (got ${items.length}) \u6279\u6B21\u4E0A\u9650 20 \u7B46`, ExitCode.InvalidArgument);
+  }
+  return items.map((it, i) => {
+    const o = it;
+    const jobId = typeof o?.enc_job_id === "string" ? o.enc_job_id.trim() : "";
+    const resumeId = typeof o?.enc_resume_id === "string" ? o.enc_resume_id.trim() : "";
+    if (!jobId || !resumeId) {
+      throw new CliError(`batch item #${i}: enc_job_id and enc_resume_id required`, ExitCode.InvalidArgument);
+    }
+    const message = validateMessageText(typeof o?.application_message === "string" ? o.application_message : "");
+    return { enc_job_id: jobId, enc_resume_id: resumeId, application_message: message };
+  });
+}
+
+// src/commands/personal/apply/index.ts
+function rethrowApplyError(err) {
+  if (err instanceof ServerClientHttpError) {
+    const body = err.body ?? null;
+    const code = body?.error_code;
+    if (err.status === 409 && code === "application_cooldown") {
+      throw new CliError(`Application in cooldown. Next apply at: ${body?.next_apply_at ?? "unknown"}`, ExitCode.ServerClientError);
+    }
+    if (err.status === 409 && code === "job_not_available") {
+      throw new CliError("Job is no longer available (closed or removed).", ExitCode.ServerClientError);
+    }
+    if (err.status === 429 && code === "apply_daily_limit_reached") {
+      throw new CliError(
+        `Daily application limit reached (${body?.used}/${body?.limit}). Resets at: ${body?.resets_at ?? "tomorrow"}`,
+        ExitCode.ServerClientError
+      );
+    }
+  }
+  throw err;
+}
+async function runPersonalApply(ctx, args) {
+  if (!args.confirm) {
+    throw new CliError(
+      "Refusing to apply without --confirm (application is visible to the employer)",
+      ExitCode.InvalidArgument
+    );
+  }
+  const opts = { baseUrl: ctx.baseUrl, locale: ctx.locale, timeoutMs: ctx.timeoutMs };
+  const body = { enc_job_id: args.encJobId, enc_resume_id: args.encResumeId, application_message: args.message };
+  let result;
+  try {
+    result = await personalPost(opts, PERSONAL_APPLICATIONS_BASE, body, { idempotencyKey: (0, import_node_crypto15.randomUUID)() });
+  } catch (err) {
+    rethrowApplyError(err);
+  }
+  const data = result.body?.data ?? {};
+  if (ctx.format === "json") {
+    printJson(data);
+    return;
+  }
+  process.stdout.write(`Applied. application: ${sanitizeForTerminal(String(data.enc_application_id ?? ""))}
+`);
+  const q = data.quota;
+  if (q) process.stdout.write(`Daily quota: ${q.used}/${q.limit} used, ${q.remaining} remaining
+`);
+}
+function registerPersonalApplyCommand(parent) {
+  parent.command("apply [job_enc_id]").description("Apply to a job (single) or batch via --file (requires --confirm)").option("--resume <enc_id>", "resume enc_id to apply with (single mode)").option("--message <text>", "application message (1~2000 chars)").option("--message-file <path>", "read application message from file (use - for stdin)").option("--file <path>", 'batch JSON file { "applications": [...] } (max 20)').option("--confirm", "confirm this outward-facing action").action(async (jobEncId, flags, command) => {
+    const ctx = resolveContext(command);
+    if (flags.file) {
+      await runPersonalApplyBatch(ctx, { file: flags.file, confirm: flags.confirm === true });
+      return;
+    }
+    if (!jobEncId || !flags.resume) {
+      throw new CliError("single apply requires <job_enc_id> and --resume", ExitCode.InvalidArgument);
+    }
+    const message = resolveMessage({ message: flags.message, messageFile: flags.messageFile });
+    await runPersonalApply(ctx, {
+      encJobId: jobEncId,
+      encResumeId: flags.resume,
+      message,
+      confirm: flags.confirm === true
+    });
+  });
+}
+async function runPersonalApplyBatch(ctx, args) {
+  if (!args.confirm) {
+    throw new CliError(
+      "Refusing to apply without --confirm (applications are visible to employers)",
+      ExitCode.InvalidArgument
+    );
+  }
+  let parsed;
+  try {
+    parsed = JSON.parse((0, import_node_fs11.readFileSync)(args.file, "utf8"));
+  } catch {
+    throw new CliError(`Cannot read/parse batch file: ${args.file}`, ExitCode.InvalidArgument);
+  }
+  const items = validateBatchItems(parsed?.applications);
+  const opts = { baseUrl: ctx.baseUrl, locale: ctx.locale, timeoutMs: ctx.timeoutMs };
+  let result;
+  try {
+    result = await personalPost(opts, `${PERSONAL_APPLICATIONS_BASE}/batch`, { applications: items }, { idempotencyKey: (0, import_node_crypto15.randomUUID)() });
+  } catch (err) {
+    rethrowApplyError(err);
+  }
+  const data = result.body?.data ?? {};
+  if (ctx.format === "json") {
+    printJson(data);
+    return;
+  }
+  const succeeded = data.succeeded ?? [];
+  const failed = data.failed ?? [];
+  process.stdout.write(`Batch applied: ${succeeded.length} succeeded, ${failed.length} failed
+`);
+  for (const f of failed) {
+    process.stdout.write(`  #${f.index} ${sanitizeForTerminal(f.enc_job_id)}: ${sanitizeForTerminal(f.error_code)}
+`);
+  }
+}
+
 // src/commands/personal/index.ts
 function registerPersonalCommand(program2) {
-  const personal = program2.command("personal").description("Manage your personal resumes and profile");
+  const personal = program2.command("personal").description("Manage your personal resumes, profile and applications");
   registerPersonalResumesCommand(personal);
+  registerPersonalApplyCommand(personal);
 }
 
 // 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.8.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.9.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);