@curviate/cli 0.9.0 → 0.10.0

package/CHANGELOG.md

@@ -8,6 +8,19 @@ a new command or flag is a minor; a breaking command/flag/exit-code change is a
 
 ## [Unreleased]
 
+## [0.10.0] - 2026-07-03
+
+### Added
+
+- `job get <url|id>` — a new top-level `job` command retrieving one public LinkedIn job posting's full detail. Accepts a job URL (`https://www.linkedin.com/jobs/view/<id>`) or a bare numeric id — a job URL is resolved to its numeric id client-side; anything else passes through and the API is the final validator. Slim-default output: `object`, `id`, `title`, `company`, `company_id`, `location`, `state`, `applicants_counter`, `published_at`, `description` — `description` stays in the default output since retrieving it is the point of the command. Pass `--verbose` for the full response (adds `cost`, `created_at`, `hiring_team`). An unknown job id exits with the not-found exit code. This is a read command — `--preview` is a usage error, matching every other single-object read.
+- `recruiter job get <url|id>` — the Recruiter-lens sibling of `job get`, joining the existing `recruiter job` command group. Retrieves any public job posting (not only postings you manage) — unlike `recruiter jobs`, which lists your own. Same URL/id resolution and slim/verbose projection as the top-level command; requires the Recruiter add-on tier (exit `5` without it).
+- README gained a new numbered example chaining `search jobs` into `job get`, and a "Get any public job posting through the Recruiter lens" example in the Recruiter section.
+
+### Changed
+
+- `@curviate/sdk` dependency bumped to `^0.10.0`.
+- `recruiter job get --help` does not advertise `--limit`/`--cursor`/`--all`/`--max-pages` — a single-object read, consistent with the other Recruiter single-reads (`profile`, `project`, `applicant`). `--fields` and `--verbose` are unchanged and available.
+
 ## [0.9.0] - 2026-07-03
 
 ### Added

package/README.md

@@ -158,6 +158,20 @@ curviate account list --all --json \
   > accounts.csv
 ```
 
+### 7. Search jobs, then fetch full detail on the top result
+
+`job get` accepts either a job URL or the bare numeric id — including the `job_urn` field a
+job-search result already returns:
+
+```bash
+curviate search jobs --keywords "founding engineer" --location "Berlin" --account acc_1 --json \
+  | jq -r '.items[0].job_urn' \
+  | xargs -I{} curviate job get {} --account acc_1 --json
+
+# A pasted job URL works identically:
+curviate job get "https://www.linkedin.com/jobs/view/4428113858" --account acc_1
+```
+
 ## Sales Navigator
 
 Sales Navigator commands (`curviate sales-nav ...`) require an account with the Sales Navigator
@@ -327,6 +341,19 @@ curviate recruiter message new \
   "Hi — I came across your profile and think you'd be a great fit for a role we're hiring for."
 ```
 
+### 10. Get any public job posting through the Recruiter lens
+
+Unlike `recruiter jobs` (which lists postings you manage), `recruiter job get` retrieves the full
+detail of *any* public LinkedIn job posting — the Recruiter-seated counterpart to the top-level
+`job get` command:
+
+```bash
+curviate recruiter job get "https://www.linkedin.com/jobs/view/4428113858" --account acc_1 --json
+
+# Bare numeric id works identically:
+curviate recruiter job get 4428113858 --account acc_1 --verbose
+```
+
 ## Exit codes
 
 | Code | Meaning |

package/dist/{account-JCNH2HOR.js → account-XV3MU5S5.js}

@@ -1,15 +1,15 @@
 #!/usr/bin/env node
-import {
-  buildPreviewOutput
-} from "./chunk-R3VLWLVV.js";
 import {
   streamAll
 } from "./chunk-GXTZION6.js";
+import {
+  buildPreviewOutput
+} from "./chunk-R3VLWLVV.js";
 import {
   slimAccountGet,
   slimAccountList,
   slimAccountListItem
-} from "./chunk-P4UYBDCB.js";
+} from "./chunk-SSPILTKF.js";
 import {
   createClient,
   renderError,

package/dist/{chunk-SZB3CFRZ.js → chunk-DMQZEPQE.js}

@@ -33,8 +33,15 @@ function normalizeChatId(raw) {
   if (match?.[1]) return match[1];
   return raw;
 }
+var JOB_URL_RE = /\/jobs\/view\/(\d+)/;
+function resolveJobIdentifier(raw) {
+  const match = JOB_URL_RE.exec(raw);
+  if (match?.[1]) return match[1];
+  return raw;
+}
 
 export {
   resolveIdentifier,
-  normalizeChatId
+  normalizeChatId,
+  resolveJobIdentifier
 };

package/dist/{chunk-P4UYBDCB.js → chunk-SSPILTKF.js}

@@ -209,6 +209,21 @@ function slimAccountGet(data) {
     quotas: d["quotas"] ?? []
   };
 }
+function slimJob(data) {
+  const d = data !== null && data !== void 0 && typeof data === "object" ? data : {};
+  return {
+    object: d["object"] ?? null,
+    id: d["id"] ?? null,
+    title: d["title"] ?? null,
+    company: d["company"] ?? null,
+    company_id: d["company_id"] ?? null,
+    location: d["location"] ?? null,
+    state: d["state"] ?? null,
+    applicants_counter: d["applicants_counter"] ?? null,
+    published_at: d["published_at"] ?? null,
+    description: d["description"] ?? null
+  };
+}
 function slimCompany(data) {
   const d = data !== null && data !== void 0 && typeof data === "object" ? data : {};
   const rawMessaging = d["messaging"] !== null && d["messaging"] !== void 0 && typeof d["messaging"] === "object" ? d["messaging"] : null;
@@ -251,5 +266,6 @@ export {
   slimAccountListItem,
   slimAccountList,
   slimAccountGet,
+  slimJob,
   slimCompany
 };

package/dist/cli.js

@@ -143,17 +143,18 @@ var main = defineCommand({
     // ---------------------------------------------------------------------------
     // Noun groups — lazy-loaded on first invocation.
     // ---------------------------------------------------------------------------
-    profile: () => import("./profile-5EPEZGUD.js").then((m) => m.profileCommand),
-    company: () => import("./company-WMO42NXD.js").then((m) => m.companyCommand),
-    connect: () => import("./connect-35ZPFUSM.js").then((m) => m.connectCommand),
-    search: () => import("./search-BRFUS2JW.js").then((m) => m.searchCommand),
-    inbox: () => import("./inbox-YV6GPRG6.js").then((m) => m.inboxCommand),
-    message: () => import("./message-YRMLMHK7.js").then((m) => m.messageCommand),
-    post: () => import("./post-KBSR3ADF.js").then((m) => m.postCommand),
-    account: () => import("./account-JCNH2HOR.js").then((m) => m.accountCommand),
-    webhook: () => import("./webhook-F6CRIISR.js").then((m) => m.webhookCommand),
-    "sales-nav": () => import("./sales-nav-4DYBMHKN.js").then((m) => m.salesNavCommand),
-    recruiter: () => import("./recruiter-B5UIHTIN.js").then((m) => m.recruiterCommand)
+    profile: () => import("./profile-2YE3IC3O.js").then((m) => m.profileCommand),
+    company: () => import("./company-QB7VCLXJ.js").then((m) => m.companyCommand),
+    job: () => import("./job-QCKWY257.js").then((m) => m.jobCommand),
+    connect: () => import("./connect-2OAOLYQO.js").then((m) => m.connectCommand),
+    search: () => import("./search-5BBFRE6T.js").then((m) => m.searchCommand),
+    inbox: () => import("./inbox-AFVIF6ZU.js").then((m) => m.inboxCommand),
+    message: () => import("./message-MP4TJJXS.js").then((m) => m.messageCommand),
+    post: () => import("./post-Q3KR3TN3.js").then((m) => m.postCommand),
+    account: () => import("./account-XV3MU5S5.js").then((m) => m.accountCommand),
+    webhook: () => import("./webhook-7BJUYU4H.js").then((m) => m.webhookCommand),
+    "sales-nav": () => import("./sales-nav-SG6IXCTR.js").then((m) => m.salesNavCommand),
+    recruiter: () => import("./recruiter-2CETQNCU.js").then((m) => m.recruiterCommand)
   },
   async run() {
     const { runMain } = await import("citty");

package/dist/{company-WMO42NXD.js → company-QB7VCLXJ.js}

@@ -1,10 +1,10 @@
 #!/usr/bin/env node
-import {
-  resolveIdentifier
-} from "./chunk-SZB3CFRZ.js";
 import {
   slimCompany
-} from "./chunk-P4UYBDCB.js";
+} from "./chunk-SSPILTKF.js";
+import {
+  resolveIdentifier
+} from "./chunk-DMQZEPQE.js";
 import {
   createClient,
   renderError,

package/dist/{connect-35ZPFUSM.js → connect-2OAOLYQO.js}

@@ -1,19 +1,19 @@
 #!/usr/bin/env node
-import {
-  buildPreviewOutput
-} from "./chunk-R3VLWLVV.js";
-import {
-  resolveIdentifier
-} from "./chunk-SZB3CFRZ.js";
 import {
   streamAll
 } from "./chunk-GXTZION6.js";
+import {
+  buildPreviewOutput
+} from "./chunk-R3VLWLVV.js";
 import {
   slimInviteReceived,
   slimInviteReceivedItem,
   slimInviteSent,
   slimInviteSentItem
-} from "./chunk-P4UYBDCB.js";
+} from "./chunk-SSPILTKF.js";
+import {
+  resolveIdentifier
+} from "./chunk-DMQZEPQE.js";
 import {
   createClient,
   renderError,

package/dist/{inbox-YV6GPRG6.js → inbox-AFVIF6ZU.js}

@@ -1,10 +1,10 @@
 #!/usr/bin/env node
-import {
-  normalizeChatId
-} from "./chunk-SZB3CFRZ.js";
 import {
   streamAll
 } from "./chunk-GXTZION6.js";
+import {
+  normalizeChatId
+} from "./chunk-DMQZEPQE.js";
 import {
   createClient,
   renderError,

package/dist/job-QCKWY257.js

@@ -0,0 +1,105 @@
+#!/usr/bin/env node
+import {
+  slimJob
+} from "./chunk-SSPILTKF.js";
+import {
+  resolveJobIdentifier
+} from "./chunk-DMQZEPQE.js";
+import {
+  createClient,
+  renderError,
+  renderSuccess,
+  renderUnexpectedError,
+  resolveEffectiveConfig
+} from "./chunk-47SYFQRF.js";
+import {
+  READ_SINGLE_FLAGS
+} from "./chunk-TDYIQHQX.js";
+
+// src/commands/job.ts
+import { defineCommand } from "citty";
+function buildOutputStreams() {
+  return {
+    stdout: { write: (s) => process.stdout.write(s) },
+    stderr: { write: (s) => process.stderr.write(s) }
+  };
+}
+function requireAccount(account, out) {
+  if (!account) {
+    out.stderr.write("error: --account is required for this command. Set it via --account, CURVIATE_ACCOUNT, or `curviate config set-account`.\n");
+    process.exit(2);
+  }
+  return account;
+}
+function resolveOutputOpts(flags) {
+  return {
+    json: (flags.json ?? false) || !process.stdout.isTTY,
+    isTTY: process.stdout.isTTY ?? false,
+    fields: flags.fields,
+    verbose: flags.verbose ?? false
+  };
+}
+async function runJobGet(client, flags, out) {
+  if (flags.preview) {
+    out.stderr.write("error: --preview is only valid on write commands (mutations). Reads just run.\n");
+    process.exit(2);
+  }
+  const accountId = requireAccount(flags.account, out);
+  const rawId = flags.id ?? "";
+  const resolvedId = resolveJobIdentifier(rawId);
+  const ns = client.account(accountId);
+  const outOpts = resolveOutputOpts(flags);
+  try {
+    const result = await ns.jobs.get(resolvedId);
+    renderSuccess(result, { ...outOpts, slim: slimJob }, out);
+  } catch (err) {
+    const { CurviateError } = await import("@curviate/sdk");
+    if (err instanceof CurviateError) {
+      const { getExitCode } = await import("./exit-codes-NFIR57ZA.js");
+      renderError(err, outOpts, out);
+      process.exit(getExitCode(err.code));
+    }
+    renderUnexpectedError(err, out);
+    process.exit(1);
+  }
+}
+var jobGetCommand = defineCommand({
+  meta: { name: "get", description: "Retrieve one public LinkedIn job posting's full detail." },
+  args: {
+    ...READ_SINGLE_FLAGS,
+    id: { type: "positional", description: "Job URL (e.g. https://www.linkedin.com/jobs/view/4428113858) or a bare numeric job id." }
+  },
+  async run({ args }) {
+    const flags = args;
+    const cfg = await resolveEffectiveConfig({
+      apiKey: flags["api-key"],
+      baseUrl: flags["base-url"],
+      timeout: flags.timeout,
+      account: flags.account,
+      profile: flags.profile
+    });
+    if (!cfg.apiKey) {
+      process.stderr.write("error: no API key \u2014 run `curviate login` or pass --api-key.\n");
+      process.exit(3);
+    }
+    const client = createClient({ apiKey: cfg.apiKey, baseUrl: cfg.baseUrl, timeout: cfg.timeout });
+    const out = buildOutputStreams();
+    await runJobGet(client, { ...flags, account: flags.account ?? cfg.account }, out);
+  }
+});
+var jobCommand = defineCommand({
+  meta: { name: "job", description: "Public LinkedIn job posting operations." },
+  args: { ...READ_SINGLE_FLAGS },
+  subCommands: {
+    get: jobGetCommand
+  },
+  async run() {
+    process.stderr.write(
+      "Usage: curviate job get <url|id>\n"
+    );
+  }
+});
+export {
+  jobCommand,
+  runJobGet
+};

package/dist/{message-YRMLMHK7.js → message-MP4TJJXS.js}

@@ -16,7 +16,7 @@ import {
 import {
   normalizeChatId,
   resolveIdentifier
-} from "./chunk-SZB3CFRZ.js";
+} from "./chunk-DMQZEPQE.js";
 import {
   createClient,
   renderError,

package/dist/{profile-5EPEZGUD.js → profile-2YE3IC3O.js}

@@ -1,17 +1,17 @@
 #!/usr/bin/env node
-import {
-  buildPreviewOutput
-} from "./chunk-R3VLWLVV.js";
-import {
-  resolveIdentifier
-} from "./chunk-SZB3CFRZ.js";
 import {
   streamAll
 } from "./chunk-GXTZION6.js";
+import {
+  buildPreviewOutput
+} from "./chunk-R3VLWLVV.js";
 import {
   slimProfile,
   slimProfileMe
-} from "./chunk-P4UYBDCB.js";
+} from "./chunk-SSPILTKF.js";
+import {
+  resolveIdentifier
+} from "./chunk-DMQZEPQE.js";
 import {
   createClient,
   renderError,

package/dist/{recruiter-B5UIHTIN.js → recruiter-2CETQNCU.js}

@@ -3,24 +3,28 @@ import {
   BinaryOutputError,
   writeBinaryOutput
 } from "./chunk-UWO2D4HW.js";
+import {
+  DEFAULT_FILTER_READERS,
+  assembleFilters,
+  splitCsv
+} from "./chunk-42VUUKQ3.js";
 import {
   AttachError,
   readAttachment
 } from "./chunk-Q43HZUN3.js";
+import {
+  streamAll
+} from "./chunk-GXTZION6.js";
 import {
   buildPreviewOutput
 } from "./chunk-R3VLWLVV.js";
 import {
-  resolveIdentifier
-} from "./chunk-SZB3CFRZ.js";
-import {
-  DEFAULT_FILTER_READERS,
-  assembleFilters,
-  splitCsv
-} from "./chunk-42VUUKQ3.js";
+  slimJob
+} from "./chunk-SSPILTKF.js";
 import {
-  streamAll
-} from "./chunk-GXTZION6.js";
+  resolveIdentifier,
+  resolveJobIdentifier
+} from "./chunk-DMQZEPQE.js";
 import {
   createClient,
   renderError,
@@ -60,7 +64,8 @@ function resolveOutputOpts(flags) {
   return {
     json: (flags.json ?? false) || !process.stdout.isTTY,
     isTTY: process.stdout.isTTY ?? false,
-    fields: flags.fields
+    fields: flags.fields,
+    verbose: flags.verbose ?? false
   };
 }
 function normalizeAttachPaths(attach) {
@@ -532,6 +537,20 @@ async function runRecruiterListApplicants(client, flags, out) {
     await handleSdkError(err, outOpts, out);
   }
 }
+async function runRecruiterGetJob(client, flags, out) {
+  rejectPreviewOnRead(flags.preview, out);
+  const accountId = requireAccount(flags.account, out);
+  const rawJobId = flags.jobId ?? "";
+  const jobId = resolveJobIdentifier(rawJobId);
+  const ns = client.account(accountId);
+  const outOpts = resolveOutputOpts(flags);
+  try {
+    const result = await ns.recruiter.getJob(jobId);
+    renderSuccess(result, { ...outOpts, slim: slimJob }, out);
+  } catch (err) {
+    await handleSdkError(err, outOpts, out);
+  }
+}
 async function runRecruiterGetApplicant(client, flags, out) {
   rejectPreviewOnRead(flags.preview, out);
   const accountId = requireAccount(flags.account, out);
@@ -993,6 +1012,30 @@ var recruiterJobApplicantsCommand = defineCommand({
     await runRecruiterListApplicants(client, { ...flags, account: flags.account ?? cfg.account }, out);
   }
 });
+var recruiterJobGetCommand = defineCommand({
+  meta: { name: "get", description: "Get a job posting via the Recruiter lens (any public posting, not only your own)." },
+  args: {
+    ...READ_SINGLE_FLAGS,
+    jobId: { type: "positional", description: "Job URL (e.g. https://www.linkedin.com/jobs/view/4428113858) or a bare numeric job id." }
+  },
+  async run({ args }) {
+    const flags = args;
+    const cfg = await resolveEffectiveConfig({
+      apiKey: flags["api-key"],
+      baseUrl: flags["base-url"],
+      timeout: flags.timeout,
+      account: flags.account,
+      profile: flags.profile
+    });
+    if (!cfg.apiKey) {
+      process.stderr.write("error: no API key \u2014 run `curviate login` or pass --api-key.\n");
+      process.exit(3);
+    }
+    const client = createClient({ apiKey: cfg.apiKey, baseUrl: cfg.baseUrl, timeout: cfg.timeout });
+    const out = buildOutputStreams();
+    await runRecruiterGetJob(client, { ...flags, account: flags.account ?? cfg.account }, out);
+  }
+});
 var recruiterJobCommand = defineCommand({
   meta: { name: "job", description: "Recruiter job posting operations." },
   args: { ...GLOBAL_FLAGS },
@@ -1000,11 +1043,12 @@ var recruiterJobCommand = defineCommand({
     create: recruiterJobCreateCommand,
     publish: recruiterJobPublishCommand,
     checkpoint: recruiterJobCheckpointCommand,
-    applicants: recruiterJobApplicantsCommand
+    applicants: recruiterJobApplicantsCommand,
+    get: recruiterJobGetCommand
   },
   async run() {
     process.stderr.write(
-      "Usage: curviate recruiter job create [flags\u2026]\n       curviate recruiter job publish <job_id> [--mode <m>]\n       curviate recruiter job checkpoint <job_id> --input <v>\n       curviate recruiter job applicants <job_id>\n"
+      "Usage: curviate recruiter job create [flags\u2026]\n       curviate recruiter job publish <job_id> [--mode <m>]\n       curviate recruiter job checkpoint <job_id> --input <v>\n       curviate recruiter job applicants <job_id>\n       curviate recruiter job get <url|id>\n"
     );
   }
 });
@@ -1092,7 +1136,7 @@ var recruiterCommand = defineCommand({
   },
   async run() {
     process.stderr.write(
-      'Usage: curviate recruiter sync\n       curviate recruiter message new --to <id> "<text>"\n       curviate recruiter profile <identifier>\n       curviate recruiter search people [--keywords <k>]\n       curviate recruiter search parameters --type <t>\n       curviate recruiter projects\n       curviate recruiter project <project_id>\n       curviate recruiter add-candidate <user_id> --hiring-project-id <id>\n       curviate recruiter add-applicant <user_id> --hiring-project-id <id>\n       curviate recruiter reject-applicant <user_id> --hiring-project-id <id> --reason <r>\n       curviate recruiter jobs\n       curviate recruiter job create [flags\u2026]\n       curviate recruiter job publish <job_id> [--mode <m>]\n       curviate recruiter job checkpoint <job_id> --input <v>\n       curviate recruiter job applicants <job_id>\n       curviate recruiter applicant <applicant_id>\n       curviate recruiter applicant resume <applicant_id> -o <file>\n'
+      'Usage: curviate recruiter sync\n       curviate recruiter message new --to <id> "<text>"\n       curviate recruiter profile <identifier>\n       curviate recruiter search people [--keywords <k>]\n       curviate recruiter search parameters --type <t>\n       curviate recruiter projects\n       curviate recruiter project <project_id>\n       curviate recruiter add-candidate <user_id> --hiring-project-id <id>\n       curviate recruiter add-applicant <user_id> --hiring-project-id <id>\n       curviate recruiter reject-applicant <user_id> --hiring-project-id <id> --reason <r>\n       curviate recruiter jobs\n       curviate recruiter job create [flags\u2026]\n       curviate recruiter job publish <job_id> [--mode <m>]\n       curviate recruiter job checkpoint <job_id> --input <v>\n       curviate recruiter job applicants <job_id>\n       curviate recruiter job get <url|id>\n       curviate recruiter applicant <applicant_id>\n       curviate recruiter applicant resume <applicant_id> -o <file>\n'
     );
   }
 });
@@ -1103,6 +1147,7 @@ export {
   runRecruiterCreateJob,
   runRecruiterDownloadResume,
   runRecruiterGetApplicant,
+  runRecruiterGetJob,
   runRecruiterGetParameters,
   runRecruiterGetProject,
   runRecruiterJobCheckpoint,

package/dist/{sales-nav-4DYBMHKN.js → sales-nav-SG6IXCTR.js}

@@ -1,23 +1,23 @@
 #!/usr/bin/env node
-import {
-  AttachError,
-  readAttachment
-} from "./chunk-Q43HZUN3.js";
-import {
-  buildPreviewOutput
-} from "./chunk-R3VLWLVV.js";
-import {
-  resolveIdentifier
-} from "./chunk-SZB3CFRZ.js";
 import {
   DEFAULT_FILTER_READERS,
   assembleFilters,
   splitCsv,
   splitCsvNumbers
 } from "./chunk-42VUUKQ3.js";
+import {
+  AttachError,
+  readAttachment
+} from "./chunk-Q43HZUN3.js";
 import {
   streamAll
 } from "./chunk-GXTZION6.js";
+import {
+  buildPreviewOutput
+} from "./chunk-R3VLWLVV.js";
+import {
+  resolveIdentifier
+} from "./chunk-DMQZEPQE.js";
 import {
   createClient,
   renderError,

package/dist/{search-BRFUS2JW.js → search-5BBFRE6T.js}

@@ -17,7 +17,7 @@ import {
   slimSearchPeopleItem,
   slimSearchPosts,
   slimSearchPostsItem
-} from "./chunk-P4UYBDCB.js";
+} from "./chunk-SSPILTKF.js";
 import {
   createClient,
   renderError,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@curviate/cli",
-  "version": "0.9.0",
+  "version": "0.10.0",
   "private": false,
   "description": "Official command-line interface for the Curviate API.",
   "license": "MIT",
@@ -40,7 +40,7 @@
     "clean": "rm -rf dist *.tsbuildinfo"
   },
   "dependencies": {
-    "@curviate/sdk": "^0.9.0",
+    "@curviate/sdk": "^0.10.0",
     "citty": "^0.1.6"
   },
   "devDependencies": {

package/dist/{post-KBSR3ADF.js → post-Q3KR3TN3.js}

@@ -6,12 +6,12 @@ import {
 import {
   resolveTextOrStdin
 } from "./chunk-CHFKVAEI.js";
-import {
-  buildPreviewOutput
-} from "./chunk-R3VLWLVV.js";
 import {
   streamAll
 } from "./chunk-GXTZION6.js";
+import {
+  buildPreviewOutput
+} from "./chunk-R3VLWLVV.js";
 import {
   createClient,
   renderError,

package/dist/{webhook-F6CRIISR.js → webhook-7BJUYU4H.js}

@@ -1,10 +1,10 @@
 #!/usr/bin/env node
-import {
-  buildPreviewOutput
-} from "./chunk-R3VLWLVV.js";
 import {
   streamAll
 } from "./chunk-GXTZION6.js";
+import {
+  buildPreviewOutput
+} from "./chunk-R3VLWLVV.js";
 import {
   createClient,
   renderError,