@curviate/cli 0.40.0 → 0.42.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (32) hide show
  1. package/CHANGELOG.md +67 -0
  2. package/dist/{account-LTXAUBBP.js → account-PFK5YROZ.js} +81 -26
  3. package/dist/{chunk-OTBJATDE.js → chunk-B5NIX4G6.js} +6 -1
  4. package/dist/{chunk-LD5KJSCT.js → chunk-BLJGV6ST.js} +2 -2
  5. package/dist/{chunk-6W7364S3.js → chunk-KJ24DIAJ.js} +1 -1
  6. package/dist/{chunk-T6G5AASF.js → chunk-OUMMWC7G.js} +79 -26
  7. package/dist/{chunk-BGVK73VI.js → chunk-PCZH5QJA.js} +1 -1
  8. package/dist/{chunk-XDQHNUEU.js → chunk-TC4ZPUWI.js} +12 -6
  9. package/dist/{chunk-DCZR4M7G.js → chunk-UJOTQPL6.js} +1 -1
  10. package/dist/cli.js +64 -53
  11. package/dist/{comment-2CSBSBOH.js → comment-G4EXIIAQ.js} +83 -29
  12. package/dist/{company-ZUIUR5UN.js → company-WX5QOASS.js} +104 -50
  13. package/dist/{config-RUBXWFQ3.js → config-K4G3VSBA.js} +44 -9
  14. package/dist/{connect-LSXKNEL2.js → connect-IYTFL7NT.js} +44 -21
  15. package/dist/{doctor-FHOHIQPX.js → doctor-ICAEETCL.js} +8 -4
  16. package/dist/examples-IJL3A6SZ.js +18 -0
  17. package/dist/{feed-UUHB2FXI.js → feed-XC5235UF.js} +16 -14
  18. package/dist/{group-NUCO3P2W.js → group-JDP2HVSV.js} +31 -20
  19. package/dist/{inbox-DEZTGTPO.js → inbox-W3KR65VD.js} +51 -24
  20. package/dist/{inboxes-F3NIQQRK.js → inboxes-XYS3IRT6.js} +23 -17
  21. package/dist/{job-YMGO3WJH.js → job-XW3WM57J.js} +112 -34
  22. package/dist/{login-YTVPIN27.js → login-OHAHNBRW.js} +7 -3
  23. package/dist/{message-RSBUXI64.js → message-5XC7U4JC.js} +5 -5
  24. package/dist/{notification-EJ35OD3Q.js → notification-RIUSYJV6.js} +26 -16
  25. package/dist/{post-VHVQ56A7.js → post-LSEBRQYK.js} +96 -32
  26. package/dist/{profile-3CBNI42H.js → profile-NHTYGX7K.js} +130 -43
  27. package/dist/{recruiter-M7XUFYNR.js → recruiter-4SDAROK4.js} +219 -67
  28. package/dist/{sales-nav-S47OCEUC.js → sales-nav-77NP3UXV.js} +102 -42
  29. package/dist/{search-UWI37MKG.js → search-XDOQZAVG.js} +80 -39
  30. package/dist/{setup-3EQRACT6.js → setup-BPNLAHPC.js} +9 -4
  31. package/dist/{webhook-I4U4C4XE.js → webhook-XOPRW63N.js} +62 -23
  32. package/package.json +3 -2
@@ -3,7 +3,7 @@ import {
3
3
  DEFAULT_FILTER_READERS,
4
4
  assembleFilters,
5
5
  splitCsv
6
- } from "./chunk-6W7364S3.js";
6
+ } from "./chunk-KJ24DIAJ.js";
7
7
  import {
8
8
  slimJob
9
9
  } from "./chunk-XP2LN6F6.js";
@@ -22,7 +22,7 @@ import {
22
22
  } from "./chunk-UEAX6KUB.js";
23
23
  import {
24
24
  requireAccount
25
- } from "./chunk-LD5KJSCT.js";
25
+ } from "./chunk-BLJGV6ST.js";
26
26
  import {
27
27
  buildPreviewOutput
28
28
  } from "./chunk-TCUYH5GO.js";
@@ -30,6 +30,7 @@ import {
30
30
  pageDelayFromFlags,
31
31
  readCursorFlag,
32
32
  readMaxPagesFlag,
33
+ readableObject,
33
34
  readablePage,
34
35
  rejectPaginationModifiersWithoutAll,
35
36
  renderError,
@@ -38,20 +39,21 @@ import {
38
39
  resolveEffectiveConfig,
39
40
  streamAll,
40
41
  writeNdjsonItem
41
- } from "./chunk-OTBJATDE.js";
42
+ } from "./chunk-B5NIX4G6.js";
42
43
  import "./chunk-XZJQQJBE.js";
43
44
  import {
44
45
  createClient,
45
46
  downloadBinary
46
- } from "./chunk-DCZR4M7G.js";
47
+ } from "./chunk-UJOTQPL6.js";
47
48
  import {
48
49
  GLOBAL_FLAGS,
49
50
  NON_STREAM_FLAGS,
50
51
  READ_SINGLE_FLAGS,
51
52
  WRITE_FLAGS,
52
53
  WRITE_SINGLE_FLAGS,
53
- isStdinToken
54
- } from "./chunk-XDQHNUEU.js";
54
+ isStdinToken,
55
+ readOnly
56
+ } from "./chunk-TC4ZPUWI.js";
55
57
 
56
58
  // src/commands/recruiter.ts
57
59
  import { defineCommand } from "citty";
@@ -62,12 +64,6 @@ function buildOutputStreams() {
62
64
  stderr: { write: (s) => process.stderr.write(s) }
63
65
  };
64
66
  }
65
- function rejectPreviewOnRead(preview, out) {
66
- if (preview) {
67
- out.stderr.write("error: --preview is only valid on write commands (mutations). Reads just run.\n");
68
- process.exit(2);
69
- }
70
- }
71
67
  function resolveOutputOpts(flags) {
72
68
  return {
73
69
  json: (flags.json ?? false) || !process.stdout.isTTY,
@@ -256,7 +252,6 @@ async function runRecruiterMessageNew(client, flags, out) {
256
252
  }
257
253
  }
258
254
  async function runRecruiterProfile(client, flags, out) {
259
- rejectPreviewOnRead(flags.preview, out);
260
255
  const accountId = await requireAccount(client, flags, out);
261
256
  const rawId = flags.identifier ?? "";
262
257
  const resolvedId = resolveIdentifier(rawId);
@@ -264,13 +259,13 @@ async function runRecruiterProfile(client, flags, out) {
264
259
  const outOpts = resolveOutputOpts(flags);
265
260
  try {
266
261
  const result = await ns.recruiter.getProfile(resolvedId, {});
262
+ readableObject(result);
267
263
  renderSuccess(result, outOpts, out);
268
264
  } catch (err) {
269
265
  await handleSdkError(err, outOpts, out);
270
266
  }
271
267
  }
272
268
  async function runRecruiterSearchPeople(client, flags, out, readers = DEFAULT_FILTER_READERS) {
273
- rejectPreviewOnRead(flags.preview, out);
274
269
  rejectPaginationModifiersWithoutAll(flags, out);
275
270
  const accountId = await requireAccount(client, flags, out);
276
271
  const ns = client.account(accountId);
@@ -321,7 +316,6 @@ async function runRecruiterSearchPeople(client, flags, out, readers = DEFAULT_FI
321
316
  }
322
317
  }
323
318
  async function runRecruiterSearchParameters(client, flags, out) {
324
- rejectPreviewOnRead(flags.preview, out);
325
319
  if (!flags.source) {
326
320
  out.stderr.write("error: --source is required (APPLICANTS, PIPELINE, SEARCH, JOB_POSTING, or JOBS).\n");
327
321
  process.exit(2);
@@ -344,13 +338,13 @@ async function runRecruiterSearchParameters(client, flags, out) {
344
338
  if (flags.limit) params["limit"] = parseInt(flags.limit, 10);
345
339
  try {
346
340
  const result = await ns.recruiter.searchParameters(body, Object.keys(params).length > 0 ? params : void 0);
341
+ readableObject(result);
347
342
  renderSuccess(result, outOpts, out);
348
343
  } catch (err) {
349
344
  await handleSdkError(err, outOpts, out);
350
345
  }
351
346
  }
352
347
  async function runRecruiterSearchFromUrl(client, flags, out) {
353
- rejectPreviewOnRead(flags.preview, out);
354
348
  rejectPaginationModifiersWithoutAll(flags, out);
355
349
  const accountId = await requireAccount(client, flags, out);
356
350
  const url = flags.url ?? "";
@@ -391,7 +385,6 @@ async function runRecruiterSearchFromUrl(client, flags, out) {
391
385
  }
392
386
  }
393
387
  async function runRecruiterListProjects(client, flags, out) {
394
- rejectPreviewOnRead(flags.preview, out);
395
388
  rejectPaginationModifiersWithoutAll(flags, out);
396
389
  const accountId = await requireAccount(client, flags, out);
397
390
  const ns = client.account(accountId);
@@ -423,13 +416,13 @@ async function runRecruiterListProjects(client, flags, out) {
423
416
  }
424
417
  }
425
418
  async function runRecruiterGetProject(client, flags, out) {
426
- rejectPreviewOnRead(flags.preview, out);
427
419
  const accountId = await requireAccount(client, flags, out);
428
420
  const projectId = flags.projectId ?? "";
429
421
  const ns = client.account(accountId);
430
422
  const outOpts = resolveOutputOpts(flags);
431
423
  try {
432
424
  const result = await ns.recruiter.getProject(projectId);
425
+ readableObject(result);
433
426
  renderSuccess(result, outOpts, out);
434
427
  } catch (err) {
435
428
  await handleSdkError(err, outOpts, out);
@@ -472,7 +465,6 @@ async function runRecruiterUpdateProject(client, flags, out) {
472
465
  }
473
466
  }
474
467
  async function runRecruiterListPipeline(client, flags, out) {
475
- rejectPreviewOnRead(flags.preview, out);
476
468
  rejectPaginationModifiersWithoutAll(flags, out);
477
469
  const accountId = await requireAccount(client, flags, out);
478
470
  const projectId = flags.projectId ?? "";
@@ -521,20 +513,19 @@ async function runRecruiterListPipeline(client, flags, out) {
521
513
  }
522
514
  }
523
515
  async function runRecruiterGetProjectJob(client, flags, out) {
524
- rejectPreviewOnRead(flags.preview, out);
525
516
  const accountId = await requireAccount(client, flags, out);
526
517
  const projectId = flags.projectId ?? "";
527
518
  const ns = client.account(accountId);
528
519
  const outOpts = resolveOutputOpts(flags);
529
520
  try {
530
521
  const result = await ns.recruiter.getProjectJob(projectId);
522
+ readableObject(result);
531
523
  renderSuccess(result, outOpts, out);
532
524
  } catch (err) {
533
525
  await handleSdkError(err, outOpts, out);
534
526
  }
535
527
  }
536
528
  async function runRecruiterGetProjectJobBudget(client, flags, out) {
537
- rejectPreviewOnRead(flags.preview, out);
538
529
  const accountId = await requireAccount(client, flags, out);
539
530
  const projectId = flags.projectId ?? "";
540
531
  const jobId = flags.jobId ?? "";
@@ -542,6 +533,7 @@ async function runRecruiterGetProjectJobBudget(client, flags, out) {
542
533
  const outOpts = resolveOutputOpts(flags);
543
534
  try {
544
535
  const result = await ns.recruiter.getProjectJobBudget(projectId, jobId);
536
+ readableObject(result);
545
537
  renderSuccess(result, outOpts, out);
546
538
  } catch (err) {
547
539
  await handleSdkError(err, outOpts, out);
@@ -574,7 +566,6 @@ async function runRecruiterSaveCandidate(client, flags, out) {
574
566
  }
575
567
  }
576
568
  async function runRecruiterListJobs(client, flags, out) {
577
- rejectPreviewOnRead(flags.preview, out);
578
569
  rejectPaginationModifiersWithoutAll(flags, out);
579
570
  const accountId = await requireAccount(client, flags, out);
580
571
  const ns = client.account(accountId);
@@ -779,7 +770,6 @@ async function runRecruiterCloseJob(client, flags, out) {
779
770
  }
780
771
  }
781
772
  async function runRecruiterSearchTalentPool(client, flags, out, readers = DEFAULT_FILTER_READERS) {
782
- rejectPreviewOnRead(flags.preview, out);
783
773
  rejectPaginationModifiersWithoutAll(flags, out);
784
774
  if (!flags["channel-id"]) {
785
775
  out.stderr.write("error: --channel-id is required.\n");
@@ -832,7 +822,6 @@ async function runRecruiterSearchTalentPool(client, flags, out, readers = DEFAUL
832
822
  }
833
823
  }
834
824
  async function runRecruiterListApplicants(client, flags, out) {
835
- rejectPreviewOnRead(flags.preview, out);
836
825
  if (!flags["channel-id"]) {
837
826
  out.stderr.write("error: --channel-id is required.\n");
838
827
  process.exit(2);
@@ -848,13 +837,13 @@ async function runRecruiterListApplicants(client, flags, out) {
848
837
  if (cursor) params["cursor"] = cursor;
849
838
  try {
850
839
  const result = await ns.recruiter.listApplicants(projectId, body, Object.keys(params).length > 0 ? params : void 0);
840
+ readablePage(result);
851
841
  renderSuccess(result, outOpts, out);
852
842
  } catch (err) {
853
843
  await handleSdkError(err, outOpts, out);
854
844
  }
855
845
  }
856
846
  async function runRecruiterGetJob(client, flags, out) {
857
- rejectPreviewOnRead(flags.preview, out);
858
847
  const accountId = await requireAccount(client, flags, out);
859
848
  const rawJobId = flags.jobId ?? "";
860
849
  const jobId = resolveJobIdentifier(rawJobId);
@@ -862,13 +851,13 @@ async function runRecruiterGetJob(client, flags, out) {
862
851
  const outOpts = resolveOutputOpts(flags);
863
852
  try {
864
853
  const result = await ns.recruiter.getJob(jobId);
854
+ readableObject(result);
865
855
  renderSuccess(result, { ...outOpts, slim: slimJob }, out);
866
856
  } catch (err) {
867
857
  await handleSdkError(err, outOpts, out);
868
858
  }
869
859
  }
870
860
  async function runRecruiterGetApplicant(client, flags, out) {
871
- rejectPreviewOnRead(flags.preview, out);
872
861
  const accountId = await requireAccount(client, flags, out);
873
862
  const projectId = flags.projectId ?? "";
874
863
  const applicantId = flags.applicantId ?? "";
@@ -876,13 +865,13 @@ async function runRecruiterGetApplicant(client, flags, out) {
876
865
  const outOpts = resolveOutputOpts(flags);
877
866
  try {
878
867
  const result = await ns.recruiter.getApplicant(projectId, applicantId);
868
+ readableObject(result);
879
869
  renderSuccess(result, outOpts, out);
880
870
  } catch (err) {
881
871
  await handleSdkError(err, outOpts, out);
882
872
  }
883
873
  }
884
874
  async function runRecruiterDownloadResume(client, flags, out, isTTY) {
885
- rejectPreviewOnRead(flags.preview, out);
886
875
  const accountId = await requireAccount(client, flags, out);
887
876
  const projectId = flags.projectId ?? "";
888
877
  const applicantId = flags.applicantId ?? "";
@@ -905,7 +894,13 @@ async function runRecruiterDownloadResume(client, flags, out, isTTY) {
905
894
  }
906
895
  }
907
896
  var recruiterMessageNewCommand = defineCommand({
908
- meta: { name: "new", description: "Start a new Recruiter chat with a member." },
897
+ meta: {
898
+ name: "new",
899
+ description: "Start a new Recruiter chat with a member.",
900
+ examples: [
901
+ 'curviate recruiter message new --to AEMAAA1234567 --subject "Staff Engineer role" --signature "Jane, Acme" "Hi Sam, your work on evals caught my eye."'
902
+ ]
903
+ },
909
904
  args: {
910
905
  // Write command: WRITE_FLAGS omits pagination/projection flags
911
906
  ...WRITE_FLAGS,
@@ -950,10 +945,16 @@ var recruiterMessageCommand = defineCommand({
950
945
  }
951
946
  });
952
947
  var recruiterProfileCommand = defineCommand({
953
- meta: { name: "profile", description: "Get a Recruiter enriched member profile." },
948
+ meta: {
949
+ name: "profile",
950
+ description: "Get a Recruiter enriched member profile.",
951
+ examples: [
952
+ "curviate recruiter profile https://www.linkedin.com/in/janesmith"
953
+ ]
954
+ },
954
955
  args: {
955
956
  // Single-object read: READ_SINGLE_FLAGS omits pagination flags, keeps --fields
956
- ...READ_SINGLE_FLAGS,
957
+ ...readOnly(READ_SINGLE_FLAGS),
957
958
  identifier: { type: "positional", description: "LinkedIn URL, slug, or native id." }
958
959
  },
959
960
  async run({ args }) {
@@ -975,9 +976,16 @@ var recruiterProfileCommand = defineCommand({
975
976
  }
976
977
  });
977
978
  var recruiterSearchPeopleCommand = defineCommand({
978
- meta: { name: "people", description: "Search Recruiter member profiles." },
979
+ meta: {
980
+ name: "people",
981
+ description: "Search Recruiter member profiles.",
982
+ examples: [
983
+ 'curviate recruiter search people --keywords "staff engineer"',
984
+ "curviate recruiter search people --filters-file filters.json"
985
+ ]
986
+ },
979
987
  args: {
980
- ...GLOBAL_FLAGS,
988
+ ...readOnly(GLOBAL_FLAGS),
981
989
  keywords: { type: "string", description: "Keyword search string." },
982
990
  filters: { type: "string", stdinArg: true, description: "Filter body as a JSON object (escape hatch for the full filter surface); '-' reads JSON from stdin." },
983
991
  "filters-file": { type: "string", description: "Path to a JSON file with the filter body." },
@@ -1004,9 +1012,18 @@ var recruiterSearchPeopleCommand = defineCommand({
1004
1012
  }
1005
1013
  });
1006
1014
  var recruiterSearchParametersCommand = defineCommand({
1007
- meta: { name: "parameters", description: "Resolve Recruiter filter parameter IDs (POST, source-scoped)." },
1015
+ meta: {
1016
+ name: "parameters",
1017
+ description: "Resolve Recruiter filter parameter IDs (POST, source-scoped).",
1018
+ examples: [
1019
+ "curviate recruiter search parameters --source SEARCH --type LOCATION --keywords Berlin"
1020
+ ],
1021
+ requires: [
1022
+ "--project-id with --source APPLICANTS or PIPELINE."
1023
+ ]
1024
+ },
1008
1025
  args: {
1009
- ...NON_STREAM_FLAGS,
1026
+ ...readOnly(NON_STREAM_FLAGS),
1010
1027
  source: {
1011
1028
  type: "string",
1012
1029
  description: "Filter family to resolve within: APPLICANTS or PIPELINE (both require --project-id), SEARCH, JOB_POSTING, or JOBS.",
@@ -1040,9 +1057,15 @@ var recruiterSearchParametersCommand = defineCommand({
1040
1057
  }
1041
1058
  });
1042
1059
  var recruiterSearchCommand = defineCommand({
1043
- meta: { name: "search", description: "Recruiter search operations. Also runs a pasted Recruiter search/talent-pool/applicant URL directly." },
1060
+ meta: {
1061
+ name: "search",
1062
+ description: "Recruiter search operations. Also runs a pasted Recruiter search/talent-pool/applicant URL directly.",
1063
+ examples: [
1064
+ 'curviate recruiter search "https://www.linkedin.com/talent/search?searchContextId=YOUR_SEARCH"'
1065
+ ]
1066
+ },
1044
1067
  args: {
1045
- ...GLOBAL_FLAGS,
1068
+ ...readOnly(GLOBAL_FLAGS),
1046
1069
  url: {
1047
1070
  type: "positional",
1048
1071
  required: false,
@@ -1078,8 +1101,15 @@ var recruiterSearchCommand = defineCommand({
1078
1101
  }
1079
1102
  });
1080
1103
  var recruiterProjectsCommand = defineCommand({
1081
- meta: { name: "projects", description: "List Recruiter hiring projects." },
1082
- args: { ...GLOBAL_FLAGS },
1104
+ meta: {
1105
+ name: "projects",
1106
+ description: "List Recruiter hiring projects.",
1107
+ examples: [
1108
+ "curviate recruiter projects",
1109
+ "curviate recruiter projects --all"
1110
+ ]
1111
+ },
1112
+ args: { ...readOnly(GLOBAL_FLAGS) },
1083
1113
  async run({ args }) {
1084
1114
  const flags = args;
1085
1115
  const cfg = await resolveEffectiveConfig({
@@ -1099,7 +1129,14 @@ var recruiterProjectsCommand = defineCommand({
1099
1129
  }
1100
1130
  });
1101
1131
  var recruiterProjectUpdateCommand = defineCommand({
1102
- meta: { name: "update", description: "Edit a Recruiter project's config. All fields optional; omitted fields are left unchanged." },
1132
+ meta: {
1133
+ name: "update",
1134
+ description: "Edit a Recruiter project's config. All fields optional; omitted fields are left unchanged.",
1135
+ examples: [
1136
+ 'curviate recruiter project update PROJECT_ID --name "Staff Engineer 2026"',
1137
+ "curviate recruiter project update PROJECT_ID --visibility PRIVATE"
1138
+ ]
1139
+ },
1103
1140
  args: {
1104
1141
  // Write command: WRITE_SINGLE_FLAGS omits pagination flags, keeps --fields
1105
1142
  ...WRITE_SINGLE_FLAGS,
@@ -1133,10 +1170,16 @@ var recruiterProjectUpdateCommand = defineCommand({
1133
1170
  }
1134
1171
  });
1135
1172
  var recruiterProjectCommand = defineCommand({
1136
- meta: { name: "project", description: "Get a Recruiter hiring project by ID." },
1173
+ meta: {
1174
+ name: "project",
1175
+ description: "Get a Recruiter hiring project by ID.",
1176
+ examples: [
1177
+ "curviate recruiter project PROJECT_ID"
1178
+ ]
1179
+ },
1137
1180
  args: {
1138
1181
  // Single-object read: READ_SINGLE_FLAGS omits pagination flags, keeps --fields
1139
- ...READ_SINGLE_FLAGS,
1182
+ ...readOnly(READ_SINGLE_FLAGS),
1140
1183
  projectId: { type: "positional", description: "Recruiter project ID." }
1141
1184
  },
1142
1185
  subCommands: {
@@ -1167,9 +1210,16 @@ var recruiterProjectCommand = defineCommand({
1167
1210
  }
1168
1211
  });
1169
1212
  var recruiterPipelineCommand = defineCommand({
1170
- meta: { name: "pipeline", description: "List candidates in a project's pipeline (POST-as-list)." },
1213
+ meta: {
1214
+ name: "pipeline",
1215
+ description: "List candidates in a project's pipeline (POST-as-list).",
1216
+ examples: [
1217
+ "curviate recruiter pipeline PROJECT_ID",
1218
+ "curviate recruiter pipeline PROJECT_ID --sort-by LAST_MODIFIED"
1219
+ ]
1220
+ },
1171
1221
  args: {
1172
- ...GLOBAL_FLAGS,
1222
+ ...readOnly(GLOBAL_FLAGS),
1173
1223
  projectId: { type: "positional", description: "Recruiter project ID." },
1174
1224
  keywords: { type: "string", description: "Free-text keyword search." },
1175
1225
  "stage-id": { type: "string", description: "Filter to a single pipeline stage id." },
@@ -1195,7 +1245,13 @@ var recruiterPipelineCommand = defineCommand({
1195
1245
  }
1196
1246
  });
1197
1247
  var recruiterSaveCandidateCommand = defineCommand({
1198
- meta: { name: "save-candidate", description: "Save a candidate to a project's pipeline at a given stage." },
1248
+ meta: {
1249
+ name: "save-candidate",
1250
+ description: "Save a candidate to a project's pipeline at a given stage.",
1251
+ examples: [
1252
+ "curviate recruiter save-candidate PROJECT_ID --stage-id STAGE_ID --candidate-id CANDIDATE_ID"
1253
+ ]
1254
+ },
1199
1255
  args: {
1200
1256
  // Write command: WRITE_FLAGS omits pagination/projection flags
1201
1257
  ...WRITE_FLAGS,
@@ -1222,8 +1278,15 @@ var recruiterSaveCandidateCommand = defineCommand({
1222
1278
  }
1223
1279
  });
1224
1280
  var recruiterJobsCommand = defineCommand({
1225
- meta: { name: "jobs", description: "List Recruiter job postings." },
1226
- args: { ...GLOBAL_FLAGS },
1281
+ meta: {
1282
+ name: "jobs",
1283
+ description: "List Recruiter job postings.",
1284
+ examples: [
1285
+ "curviate recruiter jobs",
1286
+ "curviate recruiter jobs --all"
1287
+ ]
1288
+ },
1289
+ args: { ...readOnly(GLOBAL_FLAGS) },
1227
1290
  async run({ args }) {
1228
1291
  const flags = args;
1229
1292
  const cfg = await resolveEffectiveConfig({
@@ -1261,7 +1324,16 @@ var RECRUITER_JOB_BODY_FLAGS = {
1261
1324
  "website-url": { type: "string", description: "External apply URL (used when --apply-method is external)." }
1262
1325
  };
1263
1326
  var recruiterJobCreateCommand = defineCommand({
1264
- meta: { name: "create", description: "Create a Recruiter job posting draft, opening a brand-new hiring project." },
1327
+ meta: {
1328
+ name: "create",
1329
+ description: "Create a Recruiter job posting draft, opening a brand-new hiring project.",
1330
+ examples: [
1331
+ 'curviate recruiter job create --project-name "Staff Engineer 2026" --body-file job.json'
1332
+ ],
1333
+ requires: [
1334
+ "Each job field from its flag or from --body-file / --body -: --job-title-id with --job-title, --company-id or --company-name, --workplace-type, --location, --employment-status, --seniority-level, --description, --industry, --job-function, --apply-method."
1335
+ ]
1336
+ },
1265
1337
  args: {
1266
1338
  // Write command: WRITE_FLAGS omits pagination/projection flags
1267
1339
  ...WRITE_FLAGS,
@@ -1287,7 +1359,16 @@ var recruiterJobCreateCommand = defineCommand({
1287
1359
  }
1288
1360
  });
1289
1361
  var recruiterJobPublishCommand = defineCommand({
1290
- meta: { name: "publish", description: "Publish a Recruiter job posting draft. PROMOTED/PROMOTED_PLUS spend real money and require --budget-amount, --budget-currency, and --budget-scope." },
1362
+ meta: {
1363
+ name: "publish",
1364
+ description: "Publish a Recruiter job posting draft. PROMOTED/PROMOTED_PLUS spend real money and require --budget-amount, --budget-currency, and --budget-scope.",
1365
+ examples: [
1366
+ "curviate recruiter job publish PROJECT_ID JOB_ID --mode FREE"
1367
+ ],
1368
+ requires: [
1369
+ "--budget-currency, --budget-amount and --budget-scope with --mode PROMOTED or PROMOTED_PLUS."
1370
+ ]
1371
+ },
1291
1372
  args: {
1292
1373
  // Write command: WRITE_SINGLE_FLAGS omits pagination flags, keeps --fields
1293
1374
  ...WRITE_SINGLE_FLAGS,
@@ -1317,9 +1398,15 @@ var recruiterJobPublishCommand = defineCommand({
1317
1398
  }
1318
1399
  });
1319
1400
  var recruiterApplicantsCommand = defineCommand({
1320
- meta: { name: "applicants", description: "List applicants in a Recruiter project's talent pool." },
1401
+ meta: {
1402
+ name: "applicants",
1403
+ description: "List applicants in a Recruiter project's talent pool.",
1404
+ examples: [
1405
+ "curviate recruiter applicants PROJECT_ID --channel-id CHANNEL_ID"
1406
+ ]
1407
+ },
1321
1408
  args: {
1322
- ...NON_STREAM_FLAGS,
1409
+ ...readOnly(NON_STREAM_FLAGS),
1323
1410
  projectId: { type: "positional", description: "Recruiter project ID." },
1324
1411
  "channel-id": { type: "string", description: "The project's JOB_POSTING talent-pool channel ID (required).", required: true }
1325
1412
  },
@@ -1342,9 +1429,16 @@ var recruiterApplicantsCommand = defineCommand({
1342
1429
  }
1343
1430
  });
1344
1431
  var recruiterJobGetCommand = defineCommand({
1345
- meta: { name: "get", description: "Get a job posting via the Recruiter lens (any public posting, not only your own)." },
1432
+ meta: {
1433
+ name: "get",
1434
+ description: "Get a job posting via the Recruiter lens (any public posting, not only your own).",
1435
+ examples: [
1436
+ "curviate recruiter job get 4100000000",
1437
+ "curviate recruiter job get https://www.linkedin.com/jobs/view/4100000000"
1438
+ ]
1439
+ },
1346
1440
  args: {
1347
- ...READ_SINGLE_FLAGS,
1441
+ ...readOnly(READ_SINGLE_FLAGS),
1348
1442
  jobId: { type: "positional", description: "Job URL (e.g. https://www.linkedin.com/jobs/view/4428113858) or a bare numeric job id." }
1349
1443
  },
1350
1444
  async run({ args }) {
@@ -1366,7 +1460,13 @@ var recruiterJobGetCommand = defineCommand({
1366
1460
  }
1367
1461
  });
1368
1462
  var recruiterJobCloseCommand = defineCommand({
1369
- meta: { name: "close", description: "Stop a project's job posting from accepting applications (irreversible once LISTED)." },
1463
+ meta: {
1464
+ name: "close",
1465
+ description: "Stop a project's job posting from accepting applications (irreversible once LISTED).",
1466
+ examples: [
1467
+ "curviate recruiter job close PROJECT_ID JOB_ID"
1468
+ ]
1469
+ },
1370
1470
  args: {
1371
1471
  // Write command: WRITE_SINGLE_FLAGS omits pagination flags, keeps --fields
1372
1472
  ...WRITE_SINGLE_FLAGS,
@@ -1407,10 +1507,16 @@ var recruiterJobCommand = defineCommand({
1407
1507
  }
1408
1508
  });
1409
1509
  var recruiterProjectJobGetCommand = defineCommand({
1410
- meta: { name: "get", description: "Get the single job posting attached to a project (404 when none is attached)." },
1510
+ meta: {
1511
+ name: "get",
1512
+ description: "Get the single job posting attached to a project (404 when none is attached).",
1513
+ examples: [
1514
+ "curviate recruiter project-job get PROJECT_ID"
1515
+ ]
1516
+ },
1411
1517
  args: {
1412
1518
  // Single-object read: READ_SINGLE_FLAGS omits pagination flags, keeps --fields
1413
- ...READ_SINGLE_FLAGS,
1519
+ ...readOnly(READ_SINGLE_FLAGS),
1414
1520
  projectId: { type: "positional", description: "Recruiter project ID." }
1415
1521
  },
1416
1522
  async run({ args }) {
@@ -1432,7 +1538,16 @@ var recruiterProjectJobGetCommand = defineCommand({
1432
1538
  }
1433
1539
  });
1434
1540
  var recruiterProjectJobCreateCommand = defineCommand({
1435
- meta: { name: "create", description: "Create a job-posting draft attached to an existing project." },
1541
+ meta: {
1542
+ name: "create",
1543
+ description: "Create a job-posting draft attached to an existing project.",
1544
+ examples: [
1545
+ "curviate recruiter project-job create PROJECT_ID --body-file job.json"
1546
+ ],
1547
+ requires: [
1548
+ "Each job field from its flag or from --body-file / --body -: --job-title-id with --job-title, --company-id or --company-name, --workplace-type, --location, --employment-status, --seniority-level, --description, --industry, --job-function, --apply-method."
1549
+ ]
1550
+ },
1436
1551
  args: {
1437
1552
  // Write command: WRITE_SINGLE_FLAGS omits pagination flags, keeps --fields
1438
1553
  ...WRITE_SINGLE_FLAGS,
@@ -1458,10 +1573,16 @@ var recruiterProjectJobCreateCommand = defineCommand({
1458
1573
  }
1459
1574
  });
1460
1575
  var recruiterProjectJobBudgetCommand = defineCommand({
1461
- meta: { name: "budget", description: "Get pricing to publish a project's job posting." },
1576
+ meta: {
1577
+ name: "budget",
1578
+ description: "Get pricing to publish a project's job posting.",
1579
+ examples: [
1580
+ "curviate recruiter project-job budget PROJECT_ID JOB_ID"
1581
+ ]
1582
+ },
1462
1583
  args: {
1463
1584
  // Single-object read: READ_SINGLE_FLAGS omits pagination flags, keeps --fields
1464
- ...READ_SINGLE_FLAGS,
1585
+ ...readOnly(READ_SINGLE_FLAGS),
1465
1586
  projectId: { type: "positional", description: "Recruiter project ID." },
1466
1587
  jobId: { type: "positional", description: "Job posting ID." }
1467
1588
  },
@@ -1484,7 +1605,13 @@ var recruiterProjectJobBudgetCommand = defineCommand({
1484
1605
  }
1485
1606
  });
1486
1607
  var recruiterProjectJobUpdateCommand = defineCommand({
1487
- meta: { name: "update", description: "Apply a partial update to a project's job posting." },
1608
+ meta: {
1609
+ name: "update",
1610
+ description: "Apply a partial update to a project's job posting.",
1611
+ examples: [
1612
+ "curviate recruiter project-job update PROJECT_ID JOB_ID --workplace-type HYBRID"
1613
+ ]
1614
+ },
1488
1615
  args: {
1489
1616
  // Write command: WRITE_SINGLE_FLAGS omits pagination flags, keeps --fields
1490
1617
  ...WRITE_SINGLE_FLAGS,
@@ -1511,9 +1638,15 @@ var recruiterProjectJobUpdateCommand = defineCommand({
1511
1638
  }
1512
1639
  });
1513
1640
  var recruiterProjectJobCommand = defineCommand({
1514
- meta: { name: "project-job", description: "The single job posting attached to a Recruiter project." },
1641
+ meta: {
1642
+ name: "project-job",
1643
+ description: "The single job posting attached to a Recruiter project.",
1644
+ examples: [
1645
+ "curviate recruiter project-job PROJECT_ID"
1646
+ ]
1647
+ },
1515
1648
  args: {
1516
- ...READ_SINGLE_FLAGS,
1649
+ ...readOnly(READ_SINGLE_FLAGS),
1517
1650
  projectId: { type: "positional", description: "Recruiter project ID.", required: false }
1518
1651
  },
1519
1652
  subCommands: {
@@ -1547,9 +1680,16 @@ var recruiterProjectJobCommand = defineCommand({
1547
1680
  }
1548
1681
  });
1549
1682
  var recruiterTalentSearchCommand = defineCommand({
1550
- meta: { name: "talent-search", description: "Search a project's talent pool." },
1683
+ meta: {
1684
+ name: "talent-search",
1685
+ description: "Search a project's talent pool.",
1686
+ examples: [
1687
+ "curviate recruiter talent-search PROJECT_ID --channel-id CHANNEL_ID",
1688
+ "curviate recruiter talent-search PROJECT_ID --channel-id CHANNEL_ID --keywords typescript"
1689
+ ]
1690
+ },
1551
1691
  args: {
1552
- ...GLOBAL_FLAGS,
1692
+ ...readOnly(GLOBAL_FLAGS),
1553
1693
  projectId: { type: "positional", description: "Recruiter project ID." },
1554
1694
  "channel-id": { type: "string", description: "The project's RECRUITER_SEARCH talent-pool channel ID (required).", required: true },
1555
1695
  keywords: { type: "string", description: "Free-text keyword search." },
@@ -1575,10 +1715,16 @@ var recruiterTalentSearchCommand = defineCommand({
1575
1715
  }
1576
1716
  });
1577
1717
  var recruiterApplicantResumeCommand = defineCommand({
1578
- meta: { name: "resume", description: "Download a job applicant's resume." },
1718
+ meta: {
1719
+ name: "resume",
1720
+ description: "Download a job applicant's resume.",
1721
+ examples: [
1722
+ "curviate recruiter applicant resume PROJECT_ID APPLICANT_ID -o resume.pdf"
1723
+ ]
1724
+ },
1579
1725
  args: {
1580
1726
  // Single-object read: READ_SINGLE_FLAGS omits pagination flags, keeps --fields
1581
- ...READ_SINGLE_FLAGS,
1727
+ ...readOnly(READ_SINGLE_FLAGS),
1582
1728
  projectId: { type: "positional", description: "Recruiter project ID." },
1583
1729
  applicantId: { type: "positional", description: "Applicant ID." },
1584
1730
  output: { type: "string", alias: "o", description: "Path to write the resume file." }
@@ -1607,10 +1753,16 @@ var recruiterApplicantResumeCommand = defineCommand({
1607
1753
  }
1608
1754
  });
1609
1755
  var recruiterApplicantCommand = defineCommand({
1610
- meta: { name: "applicant", description: "Recruiter job applicant operations." },
1756
+ meta: {
1757
+ name: "applicant",
1758
+ description: "Recruiter job applicant operations.",
1759
+ examples: [
1760
+ "curviate recruiter applicant PROJECT_ID APPLICANT_ID"
1761
+ ]
1762
+ },
1611
1763
  args: {
1612
1764
  // Single-object read: READ_SINGLE_FLAGS omits pagination flags, keeps --fields
1613
- ...READ_SINGLE_FLAGS,
1765
+ ...readOnly(READ_SINGLE_FLAGS),
1614
1766
  projectId: { type: "positional", description: "Recruiter project ID.", required: false },
1615
1767
  applicantId: { type: "positional", description: "Applicant ID.", required: false }
1616
1768
  },