@curviate/cli 0.41.0 → 0.43.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 (33) hide show
  1. package/CHANGELOG.md +70 -0
  2. package/dist/{account-QZ5RYKIT.js → account-FDPUPVFB.js} +118 -29
  3. package/dist/{chunk-CBHL3QQJ.js → chunk-B5NIX4G6.js} +1 -1
  4. package/dist/{chunk-BLFGJIJJ.js → chunk-BLJGV6ST.js} +2 -2
  5. package/dist/{chunk-XP2LN6F6.js → chunk-EGDDVF3Q.js} +3 -1
  6. package/dist/{chunk-6W7364S3.js → chunk-KJ24DIAJ.js} +1 -1
  7. package/dist/{chunk-4AAKZPOM.js → chunk-OUMMWC7G.js} +76 -26
  8. package/dist/{chunk-WAE7YLO5.js → chunk-PCZH5QJA.js} +1 -1
  9. package/dist/{chunk-XDQHNUEU.js → chunk-TC4ZPUWI.js} +12 -6
  10. package/dist/{chunk-DCZR4M7G.js → chunk-UJOTQPL6.js} +1 -1
  11. package/dist/cli.js +64 -53
  12. package/dist/{comment-SYA6OKEY.js → comment-G4EXIIAQ.js} +83 -29
  13. package/dist/{company-IXQ4OFU3.js → company-2WKYM34T.js} +101 -51
  14. package/dist/{config-RUBXWFQ3.js → config-K4G3VSBA.js} +44 -9
  15. package/dist/{connect-TTA2X3KO.js → connect-GHABKXB2.js} +45 -22
  16. package/dist/{doctor-ET7XQ22E.js → doctor-ICAEETCL.js} +8 -4
  17. package/dist/examples-IJL3A6SZ.js +18 -0
  18. package/dist/{feed-556LS3CN.js → feed-XC5235UF.js} +16 -14
  19. package/dist/{group-DIIG4XQT.js → group-JDP2HVSV.js} +29 -20
  20. package/dist/{inbox-SRVTUTE6.js → inbox-W3KR65VD.js} +49 -24
  21. package/dist/{inboxes-XHZTAUQ7.js → inboxes-XYS3IRT6.js} +21 -17
  22. package/dist/{job-QNVGEM4J.js → job-OJB4VSI2.js} +109 -35
  23. package/dist/{login-YTVPIN27.js → login-OHAHNBRW.js} +7 -3
  24. package/dist/{message-2JEL6P7E.js → message-5XC7U4JC.js} +5 -5
  25. package/dist/{notification-T4SRAIJ3.js → notification-RIUSYJV6.js} +26 -16
  26. package/dist/{post-PV4UQVPO.js → post-LSEBRQYK.js} +94 -32
  27. package/dist/{profile-K5BZNGX5.js → profile-BHZPRUFU.js} +125 -44
  28. package/dist/{recruiter-OBKS4ZVL.js → recruiter-JUA4BZIC.js} +211 -68
  29. package/dist/{sales-nav-WPTMS6QF.js → sales-nav-77NP3UXV.js} +100 -42
  30. package/dist/{search-YAKZKK74.js → search-3MRQE6VC.js} +81 -40
  31. package/dist/{setup-NZQUWJYC.js → setup-BPNLAHPC.js} +9 -4
  32. package/dist/{webhook-PXSLDB2F.js → webhook-TOQUQPT4.js} +79 -31
  33. package/package.json +3 -2
@@ -3,10 +3,10 @@ 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
- } from "./chunk-XP2LN6F6.js";
9
+ } from "./chunk-EGDDVF3Q.js";
10
10
  import {
11
11
  BinaryOutputError,
12
12
  writeBinaryOutput
@@ -22,7 +22,7 @@ import {
22
22
  } from "./chunk-UEAX6KUB.js";
23
23
  import {
24
24
  requireAccount
25
- } from "./chunk-BLFGJIJJ.js";
25
+ } from "./chunk-BLJGV6ST.js";
26
26
  import {
27
27
  buildPreviewOutput
28
28
  } from "./chunk-TCUYH5GO.js";
@@ -39,20 +39,21 @@ import {
39
39
  resolveEffectiveConfig,
40
40
  streamAll,
41
41
  writeNdjsonItem
42
- } from "./chunk-CBHL3QQJ.js";
42
+ } from "./chunk-B5NIX4G6.js";
43
43
  import "./chunk-XZJQQJBE.js";
44
44
  import {
45
45
  createClient,
46
46
  downloadBinary
47
- } from "./chunk-DCZR4M7G.js";
47
+ } from "./chunk-UJOTQPL6.js";
48
48
  import {
49
49
  GLOBAL_FLAGS,
50
50
  NON_STREAM_FLAGS,
51
51
  READ_SINGLE_FLAGS,
52
52
  WRITE_FLAGS,
53
53
  WRITE_SINGLE_FLAGS,
54
- isStdinToken
55
- } from "./chunk-XDQHNUEU.js";
54
+ isStdinToken,
55
+ readOnly
56
+ } from "./chunk-TC4ZPUWI.js";
56
57
 
57
58
  // src/commands/recruiter.ts
58
59
  import { defineCommand } from "citty";
@@ -63,12 +64,6 @@ function buildOutputStreams() {
63
64
  stderr: { write: (s) => process.stderr.write(s) }
64
65
  };
65
66
  }
66
- function rejectPreviewOnRead(preview, out) {
67
- if (preview) {
68
- out.stderr.write("error: --preview is only valid on write commands (mutations). Reads just run.\n");
69
- process.exit(2);
70
- }
71
- }
72
67
  function resolveOutputOpts(flags) {
73
68
  return {
74
69
  json: (flags.json ?? false) || !process.stdout.isTTY,
@@ -257,7 +252,6 @@ async function runRecruiterMessageNew(client, flags, out) {
257
252
  }
258
253
  }
259
254
  async function runRecruiterProfile(client, flags, out) {
260
- rejectPreviewOnRead(flags.preview, out);
261
255
  const accountId = await requireAccount(client, flags, out);
262
256
  const rawId = flags.identifier ?? "";
263
257
  const resolvedId = resolveIdentifier(rawId);
@@ -272,7 +266,6 @@ async function runRecruiterProfile(client, flags, out) {
272
266
  }
273
267
  }
274
268
  async function runRecruiterSearchPeople(client, flags, out, readers = DEFAULT_FILTER_READERS) {
275
- rejectPreviewOnRead(flags.preview, out);
276
269
  rejectPaginationModifiersWithoutAll(flags, out);
277
270
  const accountId = await requireAccount(client, flags, out);
278
271
  const ns = client.account(accountId);
@@ -323,7 +316,6 @@ async function runRecruiterSearchPeople(client, flags, out, readers = DEFAULT_FI
323
316
  }
324
317
  }
325
318
  async function runRecruiterSearchParameters(client, flags, out) {
326
- rejectPreviewOnRead(flags.preview, out);
327
319
  if (!flags.source) {
328
320
  out.stderr.write("error: --source is required (APPLICANTS, PIPELINE, SEARCH, JOB_POSTING, or JOBS).\n");
329
321
  process.exit(2);
@@ -353,7 +345,6 @@ async function runRecruiterSearchParameters(client, flags, out) {
353
345
  }
354
346
  }
355
347
  async function runRecruiterSearchFromUrl(client, flags, out) {
356
- rejectPreviewOnRead(flags.preview, out);
357
348
  rejectPaginationModifiersWithoutAll(flags, out);
358
349
  const accountId = await requireAccount(client, flags, out);
359
350
  const url = flags.url ?? "";
@@ -394,7 +385,6 @@ async function runRecruiterSearchFromUrl(client, flags, out) {
394
385
  }
395
386
  }
396
387
  async function runRecruiterListProjects(client, flags, out) {
397
- rejectPreviewOnRead(flags.preview, out);
398
388
  rejectPaginationModifiersWithoutAll(flags, out);
399
389
  const accountId = await requireAccount(client, flags, out);
400
390
  const ns = client.account(accountId);
@@ -426,7 +416,6 @@ async function runRecruiterListProjects(client, flags, out) {
426
416
  }
427
417
  }
428
418
  async function runRecruiterGetProject(client, flags, out) {
429
- rejectPreviewOnRead(flags.preview, out);
430
419
  const accountId = await requireAccount(client, flags, out);
431
420
  const projectId = flags.projectId ?? "";
432
421
  const ns = client.account(accountId);
@@ -476,7 +465,6 @@ async function runRecruiterUpdateProject(client, flags, out) {
476
465
  }
477
466
  }
478
467
  async function runRecruiterListPipeline(client, flags, out) {
479
- rejectPreviewOnRead(flags.preview, out);
480
468
  rejectPaginationModifiersWithoutAll(flags, out);
481
469
  const accountId = await requireAccount(client, flags, out);
482
470
  const projectId = flags.projectId ?? "";
@@ -525,7 +513,6 @@ async function runRecruiterListPipeline(client, flags, out) {
525
513
  }
526
514
  }
527
515
  async function runRecruiterGetProjectJob(client, flags, out) {
528
- rejectPreviewOnRead(flags.preview, out);
529
516
  const accountId = await requireAccount(client, flags, out);
530
517
  const projectId = flags.projectId ?? "";
531
518
  const ns = client.account(accountId);
@@ -539,7 +526,6 @@ async function runRecruiterGetProjectJob(client, flags, out) {
539
526
  }
540
527
  }
541
528
  async function runRecruiterGetProjectJobBudget(client, flags, out) {
542
- rejectPreviewOnRead(flags.preview, out);
543
529
  const accountId = await requireAccount(client, flags, out);
544
530
  const projectId = flags.projectId ?? "";
545
531
  const jobId = flags.jobId ?? "";
@@ -580,7 +566,6 @@ async function runRecruiterSaveCandidate(client, flags, out) {
580
566
  }
581
567
  }
582
568
  async function runRecruiterListJobs(client, flags, out) {
583
- rejectPreviewOnRead(flags.preview, out);
584
569
  rejectPaginationModifiersWithoutAll(flags, out);
585
570
  const accountId = await requireAccount(client, flags, out);
586
571
  const ns = client.account(accountId);
@@ -785,7 +770,6 @@ async function runRecruiterCloseJob(client, flags, out) {
785
770
  }
786
771
  }
787
772
  async function runRecruiterSearchTalentPool(client, flags, out, readers = DEFAULT_FILTER_READERS) {
788
- rejectPreviewOnRead(flags.preview, out);
789
773
  rejectPaginationModifiersWithoutAll(flags, out);
790
774
  if (!flags["channel-id"]) {
791
775
  out.stderr.write("error: --channel-id is required.\n");
@@ -838,7 +822,6 @@ async function runRecruiterSearchTalentPool(client, flags, out, readers = DEFAUL
838
822
  }
839
823
  }
840
824
  async function runRecruiterListApplicants(client, flags, out) {
841
- rejectPreviewOnRead(flags.preview, out);
842
825
  if (!flags["channel-id"]) {
843
826
  out.stderr.write("error: --channel-id is required.\n");
844
827
  process.exit(2);
@@ -861,7 +844,6 @@ async function runRecruiterListApplicants(client, flags, out) {
861
844
  }
862
845
  }
863
846
  async function runRecruiterGetJob(client, flags, out) {
864
- rejectPreviewOnRead(flags.preview, out);
865
847
  const accountId = await requireAccount(client, flags, out);
866
848
  const rawJobId = flags.jobId ?? "";
867
849
  const jobId = resolveJobIdentifier(rawJobId);
@@ -876,7 +858,6 @@ async function runRecruiterGetJob(client, flags, out) {
876
858
  }
877
859
  }
878
860
  async function runRecruiterGetApplicant(client, flags, out) {
879
- rejectPreviewOnRead(flags.preview, out);
880
861
  const accountId = await requireAccount(client, flags, out);
881
862
  const projectId = flags.projectId ?? "";
882
863
  const applicantId = flags.applicantId ?? "";
@@ -891,7 +872,6 @@ async function runRecruiterGetApplicant(client, flags, out) {
891
872
  }
892
873
  }
893
874
  async function runRecruiterDownloadResume(client, flags, out, isTTY) {
894
- rejectPreviewOnRead(flags.preview, out);
895
875
  const accountId = await requireAccount(client, flags, out);
896
876
  const projectId = flags.projectId ?? "";
897
877
  const applicantId = flags.applicantId ?? "";
@@ -914,7 +894,13 @@ async function runRecruiterDownloadResume(client, flags, out, isTTY) {
914
894
  }
915
895
  }
916
896
  var recruiterMessageNewCommand = defineCommand({
917
- 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
+ },
918
904
  args: {
919
905
  // Write command: WRITE_FLAGS omits pagination/projection flags
920
906
  ...WRITE_FLAGS,
@@ -959,10 +945,16 @@ var recruiterMessageCommand = defineCommand({
959
945
  }
960
946
  });
961
947
  var recruiterProfileCommand = defineCommand({
962
- 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
+ },
963
955
  args: {
964
956
  // Single-object read: READ_SINGLE_FLAGS omits pagination flags, keeps --fields
965
- ...READ_SINGLE_FLAGS,
957
+ ...readOnly(READ_SINGLE_FLAGS),
966
958
  identifier: { type: "positional", description: "LinkedIn URL, slug, or native id." }
967
959
  },
968
960
  async run({ args }) {
@@ -984,9 +976,16 @@ var recruiterProfileCommand = defineCommand({
984
976
  }
985
977
  });
986
978
  var recruiterSearchPeopleCommand = defineCommand({
987
- 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
+ },
988
987
  args: {
989
- ...GLOBAL_FLAGS,
988
+ ...readOnly(GLOBAL_FLAGS),
990
989
  keywords: { type: "string", description: "Keyword search string." },
991
990
  filters: { type: "string", stdinArg: true, description: "Filter body as a JSON object (escape hatch for the full filter surface); '-' reads JSON from stdin." },
992
991
  "filters-file": { type: "string", description: "Path to a JSON file with the filter body." },
@@ -1013,9 +1012,18 @@ var recruiterSearchPeopleCommand = defineCommand({
1013
1012
  }
1014
1013
  });
1015
1014
  var recruiterSearchParametersCommand = defineCommand({
1016
- 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
+ },
1017
1025
  args: {
1018
- ...NON_STREAM_FLAGS,
1026
+ ...readOnly(NON_STREAM_FLAGS),
1019
1027
  source: {
1020
1028
  type: "string",
1021
1029
  description: "Filter family to resolve within: APPLICANTS or PIPELINE (both require --project-id), SEARCH, JOB_POSTING, or JOBS.",
@@ -1049,9 +1057,15 @@ var recruiterSearchParametersCommand = defineCommand({
1049
1057
  }
1050
1058
  });
1051
1059
  var recruiterSearchCommand = defineCommand({
1052
- 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
+ },
1053
1067
  args: {
1054
- ...GLOBAL_FLAGS,
1068
+ ...readOnly(GLOBAL_FLAGS),
1055
1069
  url: {
1056
1070
  type: "positional",
1057
1071
  required: false,
@@ -1087,8 +1101,15 @@ var recruiterSearchCommand = defineCommand({
1087
1101
  }
1088
1102
  });
1089
1103
  var recruiterProjectsCommand = defineCommand({
1090
- meta: { name: "projects", description: "List Recruiter hiring projects." },
1091
- 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) },
1092
1113
  async run({ args }) {
1093
1114
  const flags = args;
1094
1115
  const cfg = await resolveEffectiveConfig({
@@ -1108,7 +1129,14 @@ var recruiterProjectsCommand = defineCommand({
1108
1129
  }
1109
1130
  });
1110
1131
  var recruiterProjectUpdateCommand = defineCommand({
1111
- 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
+ },
1112
1140
  args: {
1113
1141
  // Write command: WRITE_SINGLE_FLAGS omits pagination flags, keeps --fields
1114
1142
  ...WRITE_SINGLE_FLAGS,
@@ -1142,10 +1170,16 @@ var recruiterProjectUpdateCommand = defineCommand({
1142
1170
  }
1143
1171
  });
1144
1172
  var recruiterProjectCommand = defineCommand({
1145
- 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
+ },
1146
1180
  args: {
1147
1181
  // Single-object read: READ_SINGLE_FLAGS omits pagination flags, keeps --fields
1148
- ...READ_SINGLE_FLAGS,
1182
+ ...readOnly(READ_SINGLE_FLAGS),
1149
1183
  projectId: { type: "positional", description: "Recruiter project ID." }
1150
1184
  },
1151
1185
  subCommands: {
@@ -1176,9 +1210,16 @@ var recruiterProjectCommand = defineCommand({
1176
1210
  }
1177
1211
  });
1178
1212
  var recruiterPipelineCommand = defineCommand({
1179
- 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
+ },
1180
1221
  args: {
1181
- ...GLOBAL_FLAGS,
1222
+ ...readOnly(GLOBAL_FLAGS),
1182
1223
  projectId: { type: "positional", description: "Recruiter project ID." },
1183
1224
  keywords: { type: "string", description: "Free-text keyword search." },
1184
1225
  "stage-id": { type: "string", description: "Filter to a single pipeline stage id." },
@@ -1204,7 +1245,13 @@ var recruiterPipelineCommand = defineCommand({
1204
1245
  }
1205
1246
  });
1206
1247
  var recruiterSaveCandidateCommand = defineCommand({
1207
- 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
+ },
1208
1255
  args: {
1209
1256
  // Write command: WRITE_FLAGS omits pagination/projection flags
1210
1257
  ...WRITE_FLAGS,
@@ -1231,8 +1278,15 @@ var recruiterSaveCandidateCommand = defineCommand({
1231
1278
  }
1232
1279
  });
1233
1280
  var recruiterJobsCommand = defineCommand({
1234
- meta: { name: "jobs", description: "List Recruiter job postings." },
1235
- 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) },
1236
1290
  async run({ args }) {
1237
1291
  const flags = args;
1238
1292
  const cfg = await resolveEffectiveConfig({
@@ -1270,7 +1324,16 @@ var RECRUITER_JOB_BODY_FLAGS = {
1270
1324
  "website-url": { type: "string", description: "External apply URL (used when --apply-method is external)." }
1271
1325
  };
1272
1326
  var recruiterJobCreateCommand = defineCommand({
1273
- 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
+ },
1274
1337
  args: {
1275
1338
  // Write command: WRITE_FLAGS omits pagination/projection flags
1276
1339
  ...WRITE_FLAGS,
@@ -1296,7 +1359,16 @@ var recruiterJobCreateCommand = defineCommand({
1296
1359
  }
1297
1360
  });
1298
1361
  var recruiterJobPublishCommand = defineCommand({
1299
- 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
+ },
1300
1372
  args: {
1301
1373
  // Write command: WRITE_SINGLE_FLAGS omits pagination flags, keeps --fields
1302
1374
  ...WRITE_SINGLE_FLAGS,
@@ -1326,9 +1398,15 @@ var recruiterJobPublishCommand = defineCommand({
1326
1398
  }
1327
1399
  });
1328
1400
  var recruiterApplicantsCommand = defineCommand({
1329
- 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
+ },
1330
1408
  args: {
1331
- ...NON_STREAM_FLAGS,
1409
+ ...readOnly(NON_STREAM_FLAGS),
1332
1410
  projectId: { type: "positional", description: "Recruiter project ID." },
1333
1411
  "channel-id": { type: "string", description: "The project's JOB_POSTING talent-pool channel ID (required).", required: true }
1334
1412
  },
@@ -1351,9 +1429,16 @@ var recruiterApplicantsCommand = defineCommand({
1351
1429
  }
1352
1430
  });
1353
1431
  var recruiterJobGetCommand = defineCommand({
1354
- 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
+ },
1355
1440
  args: {
1356
- ...READ_SINGLE_FLAGS,
1441
+ ...readOnly(READ_SINGLE_FLAGS),
1357
1442
  jobId: { type: "positional", description: "Job URL (e.g. https://www.linkedin.com/jobs/view/4428113858) or a bare numeric job id." }
1358
1443
  },
1359
1444
  async run({ args }) {
@@ -1375,7 +1460,13 @@ var recruiterJobGetCommand = defineCommand({
1375
1460
  }
1376
1461
  });
1377
1462
  var recruiterJobCloseCommand = defineCommand({
1378
- 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
+ },
1379
1470
  args: {
1380
1471
  // Write command: WRITE_SINGLE_FLAGS omits pagination flags, keeps --fields
1381
1472
  ...WRITE_SINGLE_FLAGS,
@@ -1416,10 +1507,16 @@ var recruiterJobCommand = defineCommand({
1416
1507
  }
1417
1508
  });
1418
1509
  var recruiterProjectJobGetCommand = defineCommand({
1419
- 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
+ },
1420
1517
  args: {
1421
1518
  // Single-object read: READ_SINGLE_FLAGS omits pagination flags, keeps --fields
1422
- ...READ_SINGLE_FLAGS,
1519
+ ...readOnly(READ_SINGLE_FLAGS),
1423
1520
  projectId: { type: "positional", description: "Recruiter project ID." }
1424
1521
  },
1425
1522
  async run({ args }) {
@@ -1441,7 +1538,16 @@ var recruiterProjectJobGetCommand = defineCommand({
1441
1538
  }
1442
1539
  });
1443
1540
  var recruiterProjectJobCreateCommand = defineCommand({
1444
- 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
+ },
1445
1551
  args: {
1446
1552
  // Write command: WRITE_SINGLE_FLAGS omits pagination flags, keeps --fields
1447
1553
  ...WRITE_SINGLE_FLAGS,
@@ -1467,10 +1573,16 @@ var recruiterProjectJobCreateCommand = defineCommand({
1467
1573
  }
1468
1574
  });
1469
1575
  var recruiterProjectJobBudgetCommand = defineCommand({
1470
- 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
+ },
1471
1583
  args: {
1472
1584
  // Single-object read: READ_SINGLE_FLAGS omits pagination flags, keeps --fields
1473
- ...READ_SINGLE_FLAGS,
1585
+ ...readOnly(READ_SINGLE_FLAGS),
1474
1586
  projectId: { type: "positional", description: "Recruiter project ID." },
1475
1587
  jobId: { type: "positional", description: "Job posting ID." }
1476
1588
  },
@@ -1493,7 +1605,13 @@ var recruiterProjectJobBudgetCommand = defineCommand({
1493
1605
  }
1494
1606
  });
1495
1607
  var recruiterProjectJobUpdateCommand = defineCommand({
1496
- 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
+ },
1497
1615
  args: {
1498
1616
  // Write command: WRITE_SINGLE_FLAGS omits pagination flags, keeps --fields
1499
1617
  ...WRITE_SINGLE_FLAGS,
@@ -1520,9 +1638,15 @@ var recruiterProjectJobUpdateCommand = defineCommand({
1520
1638
  }
1521
1639
  });
1522
1640
  var recruiterProjectJobCommand = defineCommand({
1523
- 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
+ },
1524
1648
  args: {
1525
- ...READ_SINGLE_FLAGS,
1649
+ ...readOnly(READ_SINGLE_FLAGS),
1526
1650
  projectId: { type: "positional", description: "Recruiter project ID.", required: false }
1527
1651
  },
1528
1652
  subCommands: {
@@ -1556,9 +1680,16 @@ var recruiterProjectJobCommand = defineCommand({
1556
1680
  }
1557
1681
  });
1558
1682
  var recruiterTalentSearchCommand = defineCommand({
1559
- 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
+ },
1560
1691
  args: {
1561
- ...GLOBAL_FLAGS,
1692
+ ...readOnly(GLOBAL_FLAGS),
1562
1693
  projectId: { type: "positional", description: "Recruiter project ID." },
1563
1694
  "channel-id": { type: "string", description: "The project's RECRUITER_SEARCH talent-pool channel ID (required).", required: true },
1564
1695
  keywords: { type: "string", description: "Free-text keyword search." },
@@ -1584,10 +1715,16 @@ var recruiterTalentSearchCommand = defineCommand({
1584
1715
  }
1585
1716
  });
1586
1717
  var recruiterApplicantResumeCommand = defineCommand({
1587
- 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
+ },
1588
1725
  args: {
1589
1726
  // Single-object read: READ_SINGLE_FLAGS omits pagination flags, keeps --fields
1590
- ...READ_SINGLE_FLAGS,
1727
+ ...readOnly(READ_SINGLE_FLAGS),
1591
1728
  projectId: { type: "positional", description: "Recruiter project ID." },
1592
1729
  applicantId: { type: "positional", description: "Applicant ID." },
1593
1730
  output: { type: "string", alias: "o", description: "Path to write the resume file." }
@@ -1616,10 +1753,16 @@ var recruiterApplicantResumeCommand = defineCommand({
1616
1753
  }
1617
1754
  });
1618
1755
  var recruiterApplicantCommand = defineCommand({
1619
- 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
+ },
1620
1763
  args: {
1621
1764
  // Single-object read: READ_SINGLE_FLAGS omits pagination flags, keeps --fields
1622
- ...READ_SINGLE_FLAGS,
1765
+ ...readOnly(READ_SINGLE_FLAGS),
1623
1766
  projectId: { type: "positional", description: "Recruiter project ID.", required: false },
1624
1767
  applicantId: { type: "positional", description: "Applicant ID.", required: false }
1625
1768
  },