jd-intel 0.5.0 → 0.6.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jd-intel",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "Fetch and normalize job descriptions across every major ATS (Greenhouse, Lever, Ashby, Workday, and more) — for your AI assistant, no copy-paste.",
   "type": "module",
   "main": "src/index.js",

package/src/cli.js

@@ -4,7 +4,7 @@
  * jd-intel CLI
  *
  * Usage:
- *   jd-intel fetch <company> [--ats greenhouse|lever|ashby] [--filter keyword|pattern]
+ *   jd-intel fetch <company> [--ats <platform>] [--filter keyword|pattern]
  *   jd-intel detect <company>
  *   jd-intel registry search <query>
  */
@@ -18,12 +18,12 @@ async function main() {
   switch (command) {
     case 'fetch': {
       const company = args[0];
-      if (!company) { console.error('Usage: jd-intel fetch <company> [--ats greenhouse|lever|ashby]'); process.exit(1); }
+      if (!company) { console.error('Usage: jd-intel fetch <company> [--ats <platform>]  (omit --ats to auto-detect; run "jd-intel" for the platform list)'); process.exit(1); }
       const getArg = (flag) => {
         const idx = args.indexOf(flag);
         return idx >= 0 ? args[idx + 1] : undefined;
       };
-      const ats = getArg('--ats');
+      let ats = getArg('--ats');
       const titleFilter = getArg('--title-filter');
       const filter = getArg('--filter');
       const postedWithinRaw = getArg('--posted-within-days');
@@ -35,6 +35,28 @@ async function main() {
       const limitRaw = getArg('--limit');
       const limit = limitRaw !== undefined ? Number(limitRaw) : undefined;
 
+      // Workday is keyed by a {tenant, env, site} triple, not a slug.
+      // Supplying it here makes a Workday board reachable without a
+      // registry entry; presence of the flags infers --ats workday.
+      const wdTenant = getArg('--workday-tenant');
+      const wdEnv = getArg('--workday-env');
+      const wdSite = getArg('--workday-site');
+      let config;
+      if (wdTenant || wdEnv || wdSite) {
+        if (!wdTenant || !wdEnv || !wdSite) {
+          console.error('Workday needs all three: --workday-tenant, --workday-env, --workday-site.');
+          console.error('Find them in the careers URL: https://{tenant}.{env}.myworkdayjobs.com/{site}');
+          console.error('e.g. https://expedia.wd108.myworkdayjobs.com/search  ->  --workday-tenant expedia --workday-env wd108 --workday-site search');
+          process.exit(1);
+        }
+        if (ats && ats !== 'workday') {
+          console.error(`--ats ${ats} conflicts with the --workday-* flags (workday is inferred). Drop one.`);
+          process.exit(1);
+        }
+        config = { tenant: wdTenant, env: wdEnv, site: wdSite };
+        ats = 'workday';
+      }
+
       const parts = [];
       if (titleFilter) parts.push(`title: ${titleFilter}`);
       if (filter) parts.push(`topic: ${filter}`);
@@ -43,10 +65,23 @@ async function main() {
       if (locationExcludes) parts.push(`loc-: ${locationExcludes.join('|')}`);
       const suffix = parts.length ? ` [${parts.join(', ')}]` : '';
 
-      console.log(`Fetching jobs from ${company}${ats ? ` (${ats})` : ' (auto-detect)'}${suffix}...`);
-      const jobs = await fetchJobs({
-        company, ats, titleFilter, filter, postedWithinDays, locationIncludes, locationExcludes, limit,
-      });
+      const atsLabel = config
+        ? ` (workday: ${config.tenant}/${config.env}/${config.site})`
+        : ats ? ` (${ats})` : ' (auto-detect)';
+      console.log(`Fetching jobs from ${company}${atsLabel}${suffix}...`);
+      let jobs;
+      try {
+        jobs = await fetchJobs({
+          company, ats, config, titleFilter, filter, postedWithinDays, locationIncludes, locationExcludes, limit,
+        });
+      } catch (err) {
+        if (config) {
+          console.error(`Could not reach that Workday board (${config.tenant}/${config.env}/${config.site}): ${err.message}`);
+          console.error('Verify the triple against the careers URL: https://{tenant}.{env}.myworkdayjobs.com/{site}');
+          process.exit(1);
+        }
+        throw err;
+      }
       console.log(`Found ${jobs.length} jobs\n`);
 
       for (const job of jobs.slice(0, 20)) {
@@ -112,7 +147,18 @@ Usage:
   jd-intel registry search <query>
 
 Fetch options:
-  --ats greenhouse|lever|ashby    Skip auto-detect
+  --ats <platform>                Skip auto-detect. One of: greenhouse, lever,
+                                  ashby, smartrecruiters, teamtailor, recruitee,
+                                  workday. Omit to auto-detect (registry-backed).
+  --workday-tenant T              Workday is keyed by a {tenant, env, site}
+  --workday-env wdN               triple, not a slug. Registered Workday
+  --workday-site S                companies work via auto-detect or --ats
+                                  workday; for any other Workday board pass
+                                  all three, read from the careers URL
+                                  https://{tenant}.{env}.myworkdayjobs.com/{site}
+                                  e.g. https://expedia.wd108.myworkdayjobs.com/search
+                                  -> --workday-tenant expedia --workday-env wd108
+                                     --workday-site search
   --title-filter pattern          Regex matched against TITLE only (role identity)
   --filter pattern                Regex matched across title, department, description (topic/scope)
   --posted-within-days N          Only jobs posted in the last N days
@@ -132,6 +178,7 @@ Examples:
   jd-intel fetch stripe --title-filter "product manager" --filter "growth|platform"
   jd-intel fetch ramp --location-include "United States,US,Remote - US" --location-exclude "London,Dublin"
   jd-intel fetch notion --ats ashby --title-filter engineer --posted-within-days 14
+  jd-intel fetch expedia --workday-tenant expedia --workday-env wd108 --workday-site search
   jd-intel detect figma
   jd-intel registry search fintech`);
   }

package/src/index.js

@@ -2,7 +2,8 @@
  * jd-intel — JD intelligence toolkit: fetch, normalize, and search job descriptions across every major ATS.
  *
  * Fetches, normalizes, and enriches job data from public ATS APIs
- * (Greenhouse, Lever, Ashby) into a unified schema.
+ * (Greenhouse, Lever, Ashby, SmartRecruiters, Teamtailor, Recruitee,
+ * Workday) into a unified schema.
  */
 
 import { ADAPTERS, ATS_NAMES } from './adapters/index.js';
@@ -15,6 +16,7 @@ import { applyFilters } from './filters.js';
  * @param {Object} options
  * @param {string} options.company - Company slug or name
  * @param {string} [options.ats] - Specific ATS platform. If omitted, auto-detects.
+ * @param {object} [options.config] - Adapter-specific config (e.g. Workday {tenant, env, site}). Bypasses the registry; the only way to reach a Workday company not in the registry.
  * @param {string} [options.titleFilter] - Regex matched against title only. Use for role identity ("product manager", "staff engineer").
  * @param {string} [options.filter] - Regex matched across title, department, description. Use for topic/scope.
  * @param {number} [options.postedWithinDays] - Only return jobs posted within N days.
@@ -26,6 +28,7 @@ import { applyFilters } from './filters.js';
 export async function fetchJobs({
   company,
   ats,
+  config,
   titleFilter,
   filter,
   postedWithinDays,
@@ -48,16 +51,33 @@ export async function fetchJobs({
   if (ats) {
     const adapter = ADAPTERS[ats];
     if (!adapter) throw new Error(`Unknown ATS: ${ats}. Supported: ${ATS_NAMES.join(', ')}`);
-    jobs = await adapter.fetch(slug, { filterContext });
+    // Explicit ATS: an explicitly passed config wins (the only path that
+    // can reach a Workday company not in the registry). With no explicit
+    // config, fall back to the registry so config-keyed adapters
+    // (Workday) and canonically-cased registry slugs (SmartRecruiters
+    // "Visa") also work on the explicit path, not just under auto-detect.
+    let fetchSlug = slug;
+    let cfg = config;
+    let companyName;
+    if (!cfg) {
+      const hit = await findEntryBySlug(slug);
+      if (hit && hit.ats === ats) {
+        fetchSlug = hit.entry.slug;
+        cfg = hit.entry.config;
+        companyName = hit.entry.name;
+      }
+    }
+    jobs = await adapter.fetch(fetchSlug, { config: cfg, companyName, filterContext });
   } else {
     // Consult registry first — if we know which ATS this company uses,
     // skip probing the others (saves API calls, clearer error semantics).
-    // The full entry is needed so adapter-specific config (e.g. the
-    // Workday {tenant,env,site} triple) reaches the adapter.
+    // The registry entry carries the canonical slug (so the adapter is
+    // called with the ATS's own casing, e.g. SmartRecruiters "Visa") and
+    // any adapter-specific config (the Workday {tenant,env,site} triple).
     const hit = await findEntryBySlug(slug);
     if (hit) {
-      jobs = await ADAPTERS[hit.ats].fetch(slug, {
-        config: hit.entry.config,
+      jobs = await ADAPTERS[hit.ats].fetch(hit.entry.slug, {
+        config: config || hit.entry.config,
         companyName: hit.entry.name,
         filterContext,
       });
@@ -92,7 +112,7 @@ export { detectAts } from './registry.js';
 
 /**
  * Look up which ATS a slug belongs to in the registry (cached, no network).
- * Returns the ATS name ("greenhouse" | "lever" | "ashby") or null if not in registry.
+ * Returns the ATS name (e.g. "greenhouse", "workday") or null if not in registry.
  */
 export { findAtsBySlug } from './registry.js';
 

package/src/registry.js

@@ -58,14 +58,21 @@ export async function searchRegistry(query) {
   return results;
 }
 
+// Slug match is case/punctuation-insensitive: registry slugs are stored
+// in each ATS's canonical form (SmartRecruiters uses PascalCase, e.g.
+// "Visa"), but callers pass a lowercased/alnum-stripped slug. Comparing
+// normalized forms keeps registry-first routing working for those.
+const normSlug = (s) => String(s).toLowerCase().replace(/[^a-z0-9]/g, '');
+
 /**
  * Look up which ATS a slug belongs to in the registry.
  * Returns the ATS name (e.g., "greenhouse") or null if not in registry.
  */
 export async function findAtsBySlug(slug) {
   const all = await loadRegistry();
+  const key = normSlug(slug);
   for (const [ats, companies] of Object.entries(all)) {
-    if (companies.some(c => c.slug === slug)) return ats;
+    if (companies.some(c => normSlug(c.slug) === key)) return ats;
   }
   return null;
 }
@@ -81,8 +88,9 @@ export async function findAtsBySlug(slug) {
  */
 export async function findEntryBySlug(slug) {
   const all = await loadRegistry();
+  const key = normSlug(slug);
   for (const [ats, companies] of Object.entries(all)) {
-    const entry = companies.find(c => c.slug === slug);
+    const entry = companies.find(c => normSlug(c.slug) === key);
     if (entry) return { ats, entry };
   }
   return null;