@velaro/cli 0.7.0 → 1.4.8

package/lib/commands/recruiting.js

@@ -0,0 +1,374 @@
+import { writeFileSync } from 'fs';
+import { messagingGet, messagingPost, messagingPut, messagingDel, getCredentials } from '../api.js';
+import { runCommand } from '../run.js';
+
+// -- velaro recruiting --------------------------------------------------------
+// CLI surface for the Recruiting Bot: job-feed sync (JSON/XML/RSS/Indeed/
+// SuccessFactors/HTML), job listing management, and site config. siteId is
+// applied server-side from the vmsg-siteId header (see cli/lib/api.js
+// messagingRequest), never a CLI arg, matching every other messaging
+// command in this file.
+//
+// Backend contract: server/Velaro.Messaging/Controllers/RecruitingController.cs
+//   GET    Recruiting/Config                          -> config
+//   PUT    Recruiting/Config                           { jobsFeedUrl, feedType?, recruiterEmail?, companyName?, companyDescription?, isEnabled } -> config
+//   POST   Recruiting/Sync                             -> { success, error, added, updated, total }
+//   GET    Recruiting/Jobs?search=&location=&department= -> jobListing[]
+//   DELETE Recruiting/Jobs/{id}                        -> { success }
+//   GET    Recruiting/Applications                     -> candidateApplication[]
+//   GET    Recruiting/Applications/ExportEeoc           -> text/csv (Professional tier+, EnableRecruitingBotEeoc)
+
+const BOLD = '\x1b[1m';
+const DIM  = '\x1b[2m';
+const GRN  = '\x1b[32m';
+const RED  = '\x1b[31m';
+const RST  = '\x1b[0m';
+
+async function syncHandler() {
+  const result = await messagingPost('/Recruiting/Sync', {});
+  if (!result.success) {
+    console.log(`\n${RED}FAILED${RST} Recruiting Bot sync failed: ${result.error || 'unknown error'}\n`);
+    process.exitCode = 1;
+    return;
+  }
+  console.log(`\n${GRN}OK${RST} Recruiting Bot job feed synced.`);
+  console.log(`  Added:   ${result.added}`);
+  console.log(`  Updated: ${result.updated}`);
+  console.log(`  Total:   ${result.total}\n`);
+}
+
+async function configGetHandler() {
+  const config = await messagingGet('/Recruiting/Config');
+  console.log(`\n${BOLD}Recruiting Bot config${RST}  (id ${config.id})`);
+  console.log(`  Enabled:      ${config.isEnabled ? `${GRN}yes${RST}` : 'no'}`);
+  console.log(`  Feed URL:     ${config.jobsFeedUrl || '(not set)'}`);
+  console.log(`  Feed type:    ${config.feedType || 'auto'}`);
+  console.log(`  Recruiter:    ${config.recruiterEmail || '(not set)'}`);
+  console.log(`  Company:      ${config.companyName || '(not set)'}`);
+  console.log('');
+}
+
+async function configSetHandler(argv) {
+  const existing = await messagingGet('/Recruiting/Config');
+  const body = {
+    jobsFeedUrl:         argv.feedUrl ?? existing.jobsFeedUrl,
+    feedType:            argv.feedType ?? existing.feedType,
+    recruiterEmail:      argv.recruiterEmail ?? existing.recruiterEmail,
+    companyName:         argv.companyName ?? existing.companyName,
+    companyDescription:  argv.companyDescription ?? existing.companyDescription,
+    isEnabled:           argv.enabled ?? existing.isEnabled,
+  };
+  const config = await messagingPut('/Recruiting/Config', body);
+  console.log(`\n${GRN}OK${RST} Recruiting Bot config updated (id ${config.id}).\n`);
+}
+
+async function jobsListHandler(argv) {
+  const jobs = await messagingGet(`/Recruiting/Jobs${buildQuery(argv)}`);
+  if (!Array.isArray(jobs) || !jobs.length) {
+    console.log('\n  No job listings found.\n');
+    return;
+  }
+  console.log(`\n${BOLD}Recruiting Bot job listings${RST} (${jobs.length})\n`);
+  for (const j of jobs) {
+    console.log(`  ${DIM}#${j.id}${RST}  ${j.title}  ${DIM}${j.department || '-'} / ${j.location || '-'}${RST}`);
+  }
+  console.log('');
+}
+
+function buildQuery(argv) {
+  const params = new URLSearchParams();
+  if (argv.search)     params.set('search', argv.search);
+  if (argv.location)   params.set('location', argv.location);
+  if (argv.department) params.set('department', argv.department);
+  const qs = params.toString();
+  return qs ? `?${qs}` : '';
+}
+
+async function jobsDeleteHandler(argv) {
+  await messagingDel(`/Recruiting/Jobs/${argv.jobId}`);
+  console.log(`\n${GRN}OK${RST} Job listing ${argv.jobId} deleted.\n`);
+}
+
+async function applicationsListHandler() {
+  const apps = await messagingGet('/Recruiting/Applications');
+  if (!Array.isArray(apps) || !apps.length) {
+    console.log('\n  No candidate applications found.\n');
+    return;
+  }
+  console.log(`\n${BOLD}Recruiting Bot applications${RST} (${apps.length})\n`);
+  for (const a of apps) {
+    console.log(`  ${DIM}#${a.id}${RST}  ${a.candidateName}  ${DIM}${a.roleInterest || '-'}  ${a.submittedAt}${RST}`);
+  }
+  console.log('');
+}
+
+// Recruiting/Applications/ExportEeoc returns text/csv, not JSON -- messagingGet() always
+// JSON.parse()s the body, so this fetches the raw response directly using the same
+// messagingApiBase + vmsg-siteId header convention instead of going through messagingGet.
+async function applicationsExportEeocHandler(argv) {
+  const creds = await getCredentials();
+  const res = await fetch(`${creds.messagingApiBase.replace(/\/+$/, '')}/Recruiting/Applications/ExportEeoc`, {
+    headers: {
+      Authorization: `Bearer ${creds.velaroToken}`,
+      ...(creds.siteId ? { 'vmsg-siteId': String(creds.siteId) } : {}),
+    },
+  });
+  if (!res.ok) {
+    const text = await res.text().catch(() => '');
+    throw new Error(`GET /Recruiting/Applications/ExportEeoc -> ${res.status}: ${text.slice(0, 300)}`);
+  }
+  const csv = await res.text();
+  const outPath = argv.out || `eeoc-export-${Date.now()}.csv`;
+  writeFileSync(outPath, csv);
+  console.log(`\n${GRN}OK${RST} EEOC export saved to ${outPath}\n`);
+}
+
+const syncCommand = {
+  command:  'sync',
+  describe: 'Manually trigger a Recruiting Bot job-feed sync for this site',
+  handler:  runCommand(syncHandler),
+};
+
+const configCommand = {
+  command:  'config <subcommand>',
+  describe: 'Get or set this site\'s Recruiting Bot config',
+  builder:  (y) => y
+    .command({
+      command:  'get',
+      describe: 'Show this site\'s Recruiting Bot config',
+      handler:  runCommand(configGetHandler),
+    })
+    .command({
+      command:  'set',
+      describe: 'Update this site\'s Recruiting Bot config (apply-if-present, omit a flag to leave it unchanged)',
+      builder:  (y2) => y2
+        .option('feed-url',           { describe: 'URL of the jobs feed to sync from (JSON/XML/RSS/SuccessFactors/HTML)', type: 'string' })
+        .option('feed-type',          { describe: 'Feed type hint: auto | json | xml | successfactors | workday | html', type: 'string' })
+        .option('recruiter-email',    { describe: 'Email to notify when a candidate submits interest via the bot', type: 'string' })
+        .option('company-name',       { describe: 'Company name shown to candidates', type: 'string' })
+        .option('company-description',{ describe: 'Short company description shown to candidates', type: 'string' })
+        .option('enabled',            { describe: 'Enable/disable the Recruiting Bot for this site', type: 'boolean' }),
+      handler: runCommand(configSetHandler),
+    })
+    .demandCommand(1, 'Specify a config subcommand: get | set'),
+  handler: () => {},
+};
+
+const jobsCommand = {
+  command:  'jobs <subcommand>',
+  describe: 'List or remove synced job listings',
+  builder:  (y) => y
+    .command({
+      command:  'list',
+      describe: 'List synced job listings, optionally filtered',
+      builder:  (y2) => y2
+        .option('search',     { describe: 'Free-text search across title/description', type: 'string' })
+        .option('location',   { describe: 'Filter by location', type: 'string' })
+        .option('department', { describe: 'Filter by department', type: 'string' }),
+      handler: runCommand(jobsListHandler),
+    })
+    .command({
+      command:  'delete <jobId>',
+      describe: 'Delete a synced job listing',
+      builder:  (y2) => y2.positional('jobId', { describe: 'Job listing ID', type: 'number' }),
+      handler:  runCommand(jobsDeleteHandler),
+    })
+    .demandCommand(1, 'Specify a jobs subcommand: list | delete'),
+  handler: () => {},
+};
+
+const applicationsCommand = {
+  command:  'applications <subcommand>',
+  describe: 'List candidate applications or export EEOC voluntary self-ID data',
+  builder:  (y) => y
+    .command({
+      command:  'list',
+      describe: 'List candidate applications submitted via the Recruiting Bot',
+      handler:  runCommand(applicationsListHandler),
+    })
+    .command({
+      command:  'export-eeoc',
+      describe: 'Export voluntary EEOC self-ID responses to a CSV file (Professional tier+)',
+      builder:  (y2) => y2.option('out', { describe: 'Output CSV file path (default: eeoc-export-<timestamp>.csv)', type: 'string' }),
+      handler:  runCommand(applicationsExportEeocHandler),
+    })
+    .demandCommand(1, 'Specify an applications subcommand: list | export-eeoc'),
+  handler: () => {},
+};
+
+// -- Multi-employer job board: named posting sources -------------------------
+// Backend contract (server/Velaro.Messaging/Controllers/RecruitingController.cs, gated on
+// EnableRecruitingBot + EnableJobBoardMultiEmployer):
+//   GET    Recruiting/Sources                          -> jobPostingSource[]
+//   POST   Recruiting/Sources                           { name, employerName?, sourceType?, jobsFeedUrl?, feedType?, fieldsJson?, isActive? } -> jobPostingSource
+//   PUT    Recruiting/Sources/{id}                       (apply-if-present) -> jobPostingSource
+//   DELETE Recruiting/Sources/{id}                      -> { success }
+//   POST   Recruiting/Sources/{id}/Sync                 -> { success, error, added, updated, total }
+//   POST   Recruiting/Sources/{id}/Listings              { title, department?, location?, description?, applyUrl?, employmentType?, employerName?, customFieldValuesJson? } -> jobListing
+//   PUT    Recruiting/Applications/{id}/Stage            { stage } -> candidateApplication
+
+async function sourcesListHandler() {
+  const sources = await messagingGet('/Recruiting/Sources');
+  if (!Array.isArray(sources) || !sources.length) {
+    console.log('\n  No job posting sources found.\n');
+    return;
+  }
+  console.log(`\n${BOLD}Job posting sources${RST} (${sources.length})\n`);
+  for (const s of sources) {
+    console.log(`  ${DIM}#${s.id}${RST}  ${s.name}  ${DIM}${s.sourceType} / ${s.employerName || '-'} / active=${s.isActive}${RST}`);
+  }
+  console.log('');
+}
+
+async function sourcesCreateHandler(argv) {
+  const source = await messagingPost('/Recruiting/Sources', {
+    name: argv.name,
+    employerName: argv.employerName,
+    sourceType: argv.sourceType || 'feed',
+    jobsFeedUrl: argv.feedUrl,
+    feedType: argv.feedType || 'auto',
+    fieldsJson: argv.fieldsJson,
+  });
+  console.log(`\n${GRN}OK${RST} Job posting source created (id ${source.id}).\n`);
+}
+
+async function sourcesUpdateHandler(argv) {
+  const body = {};
+  if (argv.name !== undefined) body.name = argv.name;
+  if (argv.employerName !== undefined) body.employerName = argv.employerName;
+  if (argv.sourceType !== undefined) body.sourceType = argv.sourceType;
+  if (argv.feedUrl !== undefined) body.jobsFeedUrl = argv.feedUrl;
+  if (argv.feedType !== undefined) body.feedType = argv.feedType;
+  if (argv.fieldsJson !== undefined) body.fieldsJson = argv.fieldsJson;
+  if (argv.active !== undefined) body.isActive = argv.active;
+  const source = await messagingPut(`/Recruiting/Sources/${argv.sourceId}`, body);
+  console.log(`\n${GRN}OK${RST} Job posting source ${source.id} updated.\n`);
+}
+
+async function sourcesDeleteHandler(argv) {
+  await messagingDel(`/Recruiting/Sources/${argv.sourceId}`);
+  console.log(`\n${GRN}OK${RST} Job posting source ${argv.sourceId} deleted/deactivated.\n`);
+}
+
+async function sourcesSyncHandler(argv) {
+  const result = await messagingPost(`/Recruiting/Sources/${argv.sourceId}/Sync`, {});
+  if (!result.success) {
+    console.log(`\n${RED}FAILED${RST} Source sync failed: ${result.error || 'unknown error'}\n`);
+    process.exitCode = 1;
+    return;
+  }
+  console.log(`\n${GRN}OK${RST} Source ${argv.sourceId} synced.`);
+  console.log(`  Added:   ${result.added}`);
+  console.log(`  Updated: ${result.updated}`);
+  console.log(`  Total:   ${result.total}\n`);
+}
+
+async function sourcesAddListingHandler(argv) {
+  const listing = await messagingPost(`/Recruiting/Sources/${argv.sourceId}/Listings`, {
+    title: argv.title,
+    department: argv.department,
+    location: argv.location,
+    description: argv.description,
+    applyUrl: argv.applyUrl,
+    employmentType: argv.employmentType,
+    employerName: argv.employerName,
+  });
+  console.log(`\n${GRN}OK${RST} Manual job listing created (id ${listing.id}).\n`);
+}
+
+async function pipelineMoveHandler(argv) {
+  const app = await messagingPut(`/Recruiting/Applications/${argv.applicationId}/Stage`, { stage: argv.stage });
+  console.log(`\n${GRN}OK${RST} Application ${app.id} moved to stage "${app.pipelineStage}".\n`);
+}
+
+const sourcesCommand = {
+  command:  'sources <subcommand>',
+  describe: 'Manage named job posting sources for a multi-employer job board (EnableJobBoardMultiEmployer)',
+  builder:  (y) => y
+    .command({ command: 'list', describe: 'List job posting sources', handler: runCommand(sourcesListHandler) })
+    .command({
+      command:  'create',
+      describe: 'Create a new named job posting source',
+      builder:  (y2) => y2
+        .option('name',          { describe: 'Display name for this source', type: 'string', demandOption: true })
+        .option('employer-name', { describe: 'Public-facing employer/agency name', type: 'string' })
+        .option('source-type',   { describe: 'feed | manual', type: 'string' })
+        .option('feed-url',      { describe: 'Feed URL (source-type=feed)', type: 'string' })
+        .option('feed-type',     { describe: 'auto | json | xml | successfactors | workday', type: 'string' })
+        .option('fields-json',   { describe: 'JSON array of custom field definitions for this source', type: 'string' }),
+      handler: runCommand(sourcesCreateHandler),
+    })
+    .command({
+      command:  'update <sourceId>',
+      describe: 'Update a job posting source (apply-if-present, omit a flag to leave it unchanged)',
+      builder:  (y2) => y2
+        .positional('sourceId', { describe: 'Job posting source ID', type: 'number' })
+        .option('name',          { type: 'string' })
+        .option('employer-name', { type: 'string' })
+        .option('source-type',   { type: 'string' })
+        .option('feed-url',      { type: 'string' })
+        .option('feed-type',     { type: 'string' })
+        .option('fields-json',   { type: 'string' })
+        .option('active',        { type: 'boolean' }),
+      handler: runCommand(sourcesUpdateHandler),
+    })
+    .command({
+      command:  'delete <sourceId>',
+      describe: 'Delete (or deactivate, if it has listings) a job posting source',
+      builder:  (y2) => y2.positional('sourceId', { type: 'number' }),
+      handler:  runCommand(sourcesDeleteHandler),
+    })
+    .command({
+      command:  'sync <sourceId>',
+      describe: 'Manually trigger a sync for one job posting source',
+      builder:  (y2) => y2.positional('sourceId', { type: 'number' }),
+      handler:  runCommand(sourcesSyncHandler),
+    })
+    .command({
+      command:  'add-listing <sourceId>',
+      describe: 'Manually add a job listing to a source (employer submission / admin entry)',
+      builder:  (y2) => y2
+        .positional('sourceId', { describe: 'Job posting source ID', type: 'number' })
+        .option('title',           { type: 'string', demandOption: true })
+        .option('department',      { type: 'string' })
+        .option('location',        { type: 'string' })
+        .option('description',     { type: 'string' })
+        .option('apply-url',       { type: 'string' })
+        .option('employment-type', { type: 'string' })
+        .option('employer-name',   { type: 'string' }),
+      handler: runCommand(sourcesAddListingHandler),
+    })
+    .demandCommand(1, 'Specify a sources subcommand: list | create | update | delete | sync | add-listing'),
+  handler: () => {},
+};
+
+const pipelineCommand = {
+  command:  'pipeline <subcommand>',
+  describe: 'HR/agency-side applicant pipeline (Kanban board) for candidate applications',
+  builder:  (y) => y
+    .command({
+      command:  'move <applicationId> <stage>',
+      describe: 'Move a candidate application to a new pipeline stage (Applied|Screened|Interview|Offer|Hired|Rejected)',
+      builder:  (y2) => y2
+        .positional('applicationId', { type: 'number' })
+        .positional('stage', { type: 'string' }),
+      handler: runCommand(pipelineMoveHandler),
+    })
+    .demandCommand(1, 'Specify a pipeline subcommand: move'),
+  handler: () => {},
+};
+
+export const recruitingCommand = {
+  command:  'recruiting <subcommand>',
+  describe: 'Recruiting Bot: sync job feeds, manage listings, applications, config, and multi-employer job board sources',
+  builder:  (y) => y
+    .command(syncCommand)
+    .command(configCommand)
+    .command(jobsCommand)
+    .command(applicationsCommand)
+    .command(sourcesCommand)
+    .command(pipelineCommand)
+    .demandCommand(1, 'Specify a recruiting subcommand: sync | config | jobs | applications | sources | pipeline')
+    .strict(),
+  handler: () => {},
+};