jd-intel 0.7.0 → 0.8.1

package/registry/workday.json

@@ -1,29 +1,29 @@
-[
-  {"slug": "cisco",              "name": "Cisco",                       "sector": "networking", "config": {"tenant": "cisco", "env": "wd5", "site": "Cisco_Careers"}},
-  {"slug": "salesforce",         "name": "Salesforce",                  "sector": "crm / saas", "config": {"tenant": "salesforce", "env": "wd12", "site": "External_Career_Site"}},
-  {"slug": "bankofamerica",      "name": "Bank of America",             "sector": "banking", "config": {"tenant": "ghr", "env": "wd1", "site": "Lateral-US"}},
-  {"slug": "adobe",              "name": "Adobe",                       "sector": "creative software", "config": {"tenant": "adobe", "env": "wd5", "site": "external_experienced"}},
-  {"slug": "nvidia",             "name": "Nvidia",                      "sector": "semiconductors", "config": {"tenant": "nvidia", "env": "wd5", "site": "NVIDIAExternalCareerSite"}},
-  {"slug": "servicetitan",       "name": "ServiceTitan",                "sector": "vertical saas", "config": {"tenant": "servicetitan", "env": "wd1", "site": "ServiceTitan"}},
-  {"slug": "cvshealth",          "name": "CVS Health",                  "sector": "healthcare / pharmacy", "config": {"tenant": "cvshealth", "env": "wd1", "site": "CVS_Health_Careers"}},
-  {"slug": "target",             "name": "Target",                      "sector": "retail", "config": {"tenant": "target", "env": "wd5", "site": "targetcareers"}},
-  {"slug": "rbc",                "name": "Royal Bank of Canada",        "sector": "banking", "config": {"tenant": "rbc", "env": "wd3", "site": "RBCGLOBAL1"}},
-  {"slug": "capitalone",         "name": "Capital One",                 "sector": "banking / fintech", "config": {"tenant": "capitalone", "env": "wd12", "site": "Capital_One"}},
-  {"slug": "bmo",                "name": "Bank of Montreal",            "sector": "banking", "config": {"tenant": "bmo", "env": "wd3", "site": "External"}},
-  {"slug": "hpe",                "name": "Hewlett Packard Enterprise",  "sector": "enterprise tech", "config": {"tenant": "hpe", "env": "wd5", "site": "Jobsathpe"}},
-  {"slug": "mastercard",         "name": "Mastercard",                  "sector": "payments", "config": {"tenant": "mastercard", "env": "wd1", "site": "CorporateCareers"}},
-  {"slug": "hp",                 "name": "HP Inc.",                     "sector": "personal computing", "config": {"tenant": "hp", "env": "wd5", "site": "ExternalCareerSite"}},
-  {"slug": "wolterskluwer",      "name": "Wolters Kluwer",              "sector": "information services", "config": {"tenant": "wk", "env": "wd3", "site": "External"}},
-  {"slug": "mckesson",           "name": "McKesson",                    "sector": "healthcare distribution", "config": {"tenant": "mckesson", "env": "wd3", "site": "External_Careers"}},
-  {"slug": "thehartford",        "name": "The Hartford",                "sector": "insurance", "config": {"tenant": "thehartford", "env": "wd5", "site": "Careers_External"}},
-  {"slug": "equifax",            "name": "Equifax",                     "sector": "credit data", "config": {"tenant": "equifax", "env": "wd5", "site": "External"}},
-  {"slug": "zillow",             "name": "Zillow Group",                "sector": "real estate tech", "config": {"tenant": "zillow", "env": "wd5", "site": "Zillow_Group_External"}},
-  {"slug": "nationwide",         "name": "Nationwide",                  "sector": "insurance / financial services", "config": {"tenant": "nationwide", "env": "wd1", "site": "Nationwide_Career"}},
-  {"slug": "toyota",             "name": "Toyota Motor North America",  "sector": "automotive", "config": {"tenant": "toyota", "env": "wd503", "site": "TMNA"}},
-  {"slug": "progressiveleasing", "name": "Progressive Leasing",         "sector": "fintech / lease-to-own", "config": {"tenant": "progleasing", "env": "wd5", "site": "ProgLeasingCareers"}},
-  {"slug": "fico",               "name": "FICO",                        "sector": "analytics / credit", "config": {"tenant": "fico", "env": "wd1", "site": "External"}},
-  {"slug": "sonyglobal",         "name": "Sony Group",                  "sector": "electronics / entertainment", "config": {"tenant": "sonyglobal", "env": "wd1", "site": "SonyGlobalCareers"}},
-  {"slug": "sonypictures",       "name": "Sony Pictures Entertainment", "sector": "media / entertainment", "config": {"tenant": "spe", "env": "wd1", "site": "SonyPicturesEntertainment"}},
-  {"slug": "merative",           "name": "Merative",                    "sector": "health data", "config": {"tenant": "merative", "env": "wd12", "site": "External_Career_Site"}},
-  {"slug": "duckcreek",          "name": "Duck Creek Technologies",     "sector": "insurance software", "config": {"tenant": "duckcreek", "env": "wd1", "site": "duckcreekcareers"}}
-]
+[
+  {"slug": "cisco",              "name": "Cisco",                       "sector": "networking", "config": {"tenant": "cisco", "env": "wd5", "site": "Cisco_Careers"}},
+  {"slug": "salesforce",         "name": "Salesforce",                  "sector": "crm / saas", "config": {"tenant": "salesforce", "env": "wd12", "site": "External_Career_Site"}},
+  {"slug": "bankofamerica",      "name": "Bank of America",             "sector": "banking", "config": {"tenant": "ghr", "env": "wd1", "site": "Lateral-US"}},
+  {"slug": "adobe",              "name": "Adobe",                       "sector": "creative software", "config": {"tenant": "adobe", "env": "wd5", "site": "external_experienced"}},
+  {"slug": "nvidia",             "name": "Nvidia",                      "sector": "semiconductors", "config": {"tenant": "nvidia", "env": "wd5", "site": "NVIDIAExternalCareerSite"}},
+  {"slug": "servicetitan",       "name": "ServiceTitan",                "sector": "vertical saas", "config": {"tenant": "servicetitan", "env": "wd1", "site": "ServiceTitan"}},
+  {"slug": "cvshealth",          "name": "CVS Health",                  "sector": "healthcare / pharmacy", "config": {"tenant": "cvshealth", "env": "wd1", "site": "CVS_Health_Careers"}},
+  {"slug": "target",             "name": "Target",                      "sector": "retail", "config": {"tenant": "target", "env": "wd5", "site": "targetcareers"}},
+  {"slug": "rbc",                "name": "Royal Bank of Canada",        "sector": "banking", "config": {"tenant": "rbc", "env": "wd3", "site": "RBCGLOBAL1"}},
+  {"slug": "capitalone",         "name": "Capital One",                 "sector": "banking / fintech", "config": {"tenant": "capitalone", "env": "wd12", "site": "Capital_One"}},
+  {"slug": "bmo",                "name": "Bank of Montreal",            "sector": "banking", "config": {"tenant": "bmo", "env": "wd3", "site": "External"}},
+  {"slug": "hpe",                "name": "Hewlett Packard Enterprise",  "sector": "enterprise tech", "config": {"tenant": "hpe", "env": "wd5", "site": "Jobsathpe"}},
+  {"slug": "mastercard",         "name": "Mastercard",                  "sector": "payments", "config": {"tenant": "mastercard", "env": "wd1", "site": "CorporateCareers"}},
+  {"slug": "hp",                 "name": "HP Inc.",                     "sector": "personal computing", "config": {"tenant": "hp", "env": "wd5", "site": "ExternalCareerSite"}},
+  {"slug": "wolterskluwer",      "name": "Wolters Kluwer",              "sector": "information services", "config": {"tenant": "wk", "env": "wd3", "site": "External"}},
+  {"slug": "mckesson",           "name": "McKesson",                    "sector": "healthcare distribution", "config": {"tenant": "mckesson", "env": "wd3", "site": "External_Careers"}},
+  {"slug": "thehartford",        "name": "The Hartford",                "sector": "insurance", "config": {"tenant": "thehartford", "env": "wd5", "site": "Careers_External"}},
+  {"slug": "equifax",            "name": "Equifax",                     "sector": "credit data", "config": {"tenant": "equifax", "env": "wd5", "site": "External"}},
+  {"slug": "zillow",             "name": "Zillow Group",                "sector": "real estate tech", "config": {"tenant": "zillow", "env": "wd5", "site": "Zillow_Group_External"}},
+  {"slug": "nationwide",         "name": "Nationwide",                  "sector": "insurance / financial services", "config": {"tenant": "nationwide", "env": "wd1", "site": "Nationwide_Career"}},
+  {"slug": "toyota",             "name": "Toyota Motor North America",  "sector": "automotive", "config": {"tenant": "toyota", "env": "wd503", "site": "TMNA"}},
+  {"slug": "progressiveleasing", "name": "Progressive Leasing",         "sector": "fintech / lease-to-own", "config": {"tenant": "progleasing", "env": "wd5", "site": "ProgLeasingCareers"}},
+  {"slug": "fico",               "name": "FICO",                        "sector": "analytics / credit", "config": {"tenant": "fico", "env": "wd1", "site": "External"}},
+  {"slug": "sonyglobal",         "name": "Sony Group",                  "sector": "electronics / entertainment", "config": {"tenant": "sonyglobal", "env": "wd1", "site": "SonyGlobalCareers"}},
+  {"slug": "sonypictures",       "name": "Sony Pictures Entertainment", "sector": "media / entertainment", "config": {"tenant": "spe", "env": "wd1", "site": "SonyPicturesEntertainment"}},
+  {"slug": "merative",           "name": "Merative",                    "sector": "health data", "config": {"tenant": "merative", "env": "wd12", "site": "External_Career_Site"}},
+  {"slug": "duckcreek",          "name": "Duck Creek Technologies",     "sector": "insurance software", "config": {"tenant": "duckcreek", "env": "wd1", "site": "duckcreekcareers"}}
+]

package/src/adapters/ashby.js

@@ -1,4 +1,5 @@
 import { normalize } from '../normalizer.js';
+import { atsErrorFromStatus } from '../errors.js';
 
 const API_URL = 'https://jobs.ashbyhq.com/api/non-user-graphql';
 const BOARD_URL = 'https://api.ashbyhq.com/posting-api/job-board';
@@ -28,7 +29,7 @@ async function fetchAshbyRest(slug) {
 
   if (!resp.ok) {
     if (resp.status === 404) return [];
-    throw new Error(`Ashby REST API error for ${slug}: ${resp.status}`);
+    throw atsErrorFromStatus(resp.status, `Ashby REST API error for ${slug}: ${resp.status}`);
   }
 
   const data = await resp.json();

package/src/adapters/greenhouse.js

@@ -1,4 +1,5 @@
 import { normalize, stripHtml } from '../normalizer.js';
+import { atsErrorFromStatus } from '../errors.js';
 
 const BASE_URL = 'https://boards-api.greenhouse.io/v1/boards';
 
@@ -16,7 +17,7 @@ export async function fetchGreenhouse(slug) {
 
   if (!resp.ok) {
     if (resp.status === 404) return []; // Company not found or no jobs
-    throw new Error(`Greenhouse API error for ${slug}: ${resp.status}`);
+    throw atsErrorFromStatus(resp.status, `Greenhouse API error for ${slug}: ${resp.status}`);
   }
 
   const data = await resp.json();

package/src/adapters/lever.js

@@ -1,4 +1,5 @@
 import { normalize, stripHtml } from '../normalizer.js';
+import { atsErrorFromStatus } from '../errors.js';
 
 const BASE_URL = 'https://api.lever.co/v0/postings';
 
@@ -15,7 +16,7 @@ export async function fetchLever(slug) {
 
   if (!resp.ok) {
     if (resp.status === 404) return [];
-    throw new Error(`Lever API error for ${slug}: ${resp.status}`);
+    throw atsErrorFromStatus(resp.status, `Lever API error for ${slug}: ${resp.status}`);
   }
 
   const jobs = await resp.json();

package/src/adapters/recruitee.js

@@ -1,4 +1,5 @@
 import { normalize, stripHtml } from '../normalizer.js';
+import { atsErrorFromStatus } from '../errors.js';
 
 /**
  * Fetch jobs from a Recruitee career site.
@@ -18,7 +19,7 @@ export async function fetchRecruitee(slug) {
 
   if (!resp.ok) {
     if (resp.status === 404) return []; // No Recruitee site for this slug
-    throw new Error(`Recruitee API error for ${slug}: ${resp.status}`);
+    throw atsErrorFromStatus(resp.status, `Recruitee API error for ${slug}: ${resp.status}`);
   }
 
   const data = await resp.json();

package/src/adapters/smartrecruiters.js

@@ -1,4 +1,5 @@
 import { normalize, stripHtml } from '../normalizer.js';
+import { atsErrorFromStatus } from '../errors.js';
 
 const BASE_URL = 'https://api.smartrecruiters.com/v1/companies';
 const PAGE_SIZE = 100;
@@ -30,7 +31,7 @@ export async function fetchSmartrecruiters(slug) {
 
     if (!resp.ok) {
       if (resp.status === 404) return []; // Company not found
-      throw new Error(`SmartRecruiters API error for ${slug}: ${resp.status}`);
+      throw atsErrorFromStatus(resp.status, `SmartRecruiters API error for ${slug}: ${resp.status}`);
     }
 
     const data = await resp.json();
@@ -101,7 +102,12 @@ export async function fetchSmartrecruiters(slug) {
 export async function hasSmartrecruiters(slug) {
   try {
     const resp = await fetch(`${BASE_URL}/${slug}/postings?limit=1`);
-    return resp.ok;
+    if (!resp.ok) return false;
+    // SmartRecruiters returns 200 with an empty page (not 404) for unknown
+    // companies, so resp.ok alone false-positives on any slug. Confirm at
+    // least one real posting exists before claiming a match.
+    const data = await resp.json();
+    return (data.totalFound || 0) > 0 || (data.content || []).length > 0;
   } catch {
     return false;
   }

package/src/adapters/teamtailor.js

@@ -1,4 +1,5 @@
 import { normalize, stripHtml } from '../normalizer.js';
+import { atsErrorFromStatus } from '../errors.js';
 
 /**
  * Fetch jobs from a TeamTailor career site via its public RSS feed.
@@ -43,7 +44,7 @@ async function resolveFeed(slug, method = 'GET') {
     });
     if (resp.ok) return resp;
     if (resp.status !== 404) {
-      throw new Error(`TeamTailor RSS error for ${slug}: ${resp.status}`);
+      throw atsErrorFromStatus(resp.status, `TeamTailor RSS error for ${slug}: ${resp.status}`);
     }
     // 404 on this host — try the next region.
   }

package/src/adapters/workday.js

@@ -1,4 +1,5 @@
 import { normalize, stripHtml } from '../normalizer.js';
+import { atsErrorFromStatus } from '../errors.js';
 
 const MAX_DETAIL_FETCHES = 100;
 const LIST_PAGE_SIZE = 20;
@@ -49,7 +50,7 @@ export async function fetchWorkday(slug, ctx = {}) {
     if (!resp.ok) {
       if (resp.status === 404) return []; // wrong site / no such board
       if (offset === 0) {
-        throw new Error(`Workday API error for ${slug} (${tenant}/${env}/${site}): ${resp.status}`);
+        throw atsErrorFromStatus(resp.status, `Workday API error for ${slug} (${tenant}/${env}/${site}): ${resp.status}`);
       }
       break; // mid-paging failure: keep what we have
     }

package/src/cli.js

@@ -1,190 +1,190 @@
-#!/usr/bin/env node
-
-/**
- * jd-intel CLI
- *
- * Usage:
- *   jd-intel fetch <company> [--ats <platform>] [--filter keyword|pattern]
- *   jd-intel detect <company>
- *   jd-intel registry search <query>
- */
-
-import { fetchJobs } from './index.js';
-import { detectAts, searchRegistry } from './registry.js';
-
-const [,, command, ...args] = process.argv;
-
-async function main() {
-  switch (command) {
-    case 'fetch': {
-      const company = args[0];
-      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;
-      };
-      let ats = getArg('--ats');
-      const titleFilter = getArg('--title-filter');
-      const filter = getArg('--filter');
-      const postedWithinRaw = getArg('--posted-within-days');
-      const postedWithinDays = postedWithinRaw !== undefined ? Number(postedWithinRaw) : undefined;
-      const locIncludeRaw = getArg('--location-include');
-      const locationIncludes = locIncludeRaw ? locIncludeRaw.split(',').map(s => s.trim()).filter(Boolean) : undefined;
-      const locExcludeRaw = getArg('--location-exclude');
-      const locationExcludes = locExcludeRaw ? locExcludeRaw.split(',').map(s => s.trim()).filter(Boolean) : undefined;
-      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}`);
-      if (postedWithinDays !== undefined) parts.push(`within ${postedWithinDays}d`);
-      if (locationIncludes) parts.push(`loc+: ${locationIncludes.join('|')}`);
-      if (locationExcludes) parts.push(`loc-: ${locationExcludes.join('|')}`);
-      const suffix = parts.length ? ` [${parts.join(', ')}]` : '';
-
-      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)) {
-        const salary = job.salary ? ` | $${job.salary.min?.toLocaleString()}-$${job.salary.max?.toLocaleString()}` : '';
-        const loc = job.location ? ` | ${job.location}` : '';
-        const dept = job.department ? ` [${job.department}]` : '';
-        console.log(`  ${job.title}${dept}${loc}${salary}`);
-        console.log(`  ${job.url}`);
-        if (job.description) {
-          const preview = job.description.substring(0, 120).replace(/\n/g, ' ');
-          console.log(`  ${preview}...`);
-        }
-        console.log();
-      }
-
-      if (jobs.length > 20) {
-        console.log(`  ... and ${jobs.length - 20} more. Use --json for full output.`);
-      }
-
-      if (args.includes('--json')) {
-        console.log(JSON.stringify(jobs, null, 2));
-      }
-      break;
-    }
-
-    case 'detect': {
-      const company = args[0];
-      if (!company) { console.error('Usage: jd-intel detect <company>'); process.exit(1); }
-      console.log(`Detecting ATS for ${company}...`);
-      const results = await detectAts(company);
-      if (results.length === 0) {
-        console.log('No ATS board found for this company.');
-      } else {
-        for (const r of results) {
-          console.log(`  Found: ${r.ats} (slug: ${r.slug})`);
-        }
-      }
-      break;
-    }
-
-    case 'registry': {
-      const subcommand = args[0];
-      if (subcommand === 'search') {
-        const query = args.slice(1).join(' ');
-        if (!query) { console.error('Usage: jd-intel registry search <query>'); process.exit(1); }
-        const results = await searchRegistry(query);
-        console.log(`Found ${results.length} companies matching "${query}":\n`);
-        for (const r of results) {
-          console.log(`  ${r.name || r.slug} (${r.ats})${r.sector ? ` — ${r.sector}` : ''}`);
-        }
-      } else {
-        console.error('Usage: jd-intel registry search <query>');
-      }
-      break;
-    }
-
-    default:
-      console.log(`jd-intel — JD intelligence toolkit for your AI assistant.
-
-Usage:
-  jd-intel fetch <company> [options]
-  jd-intel detect <company>
-  jd-intel registry search <query>
-
-Fetch options:
-  --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
-  --location-include "A,B,C"      Keep jobs whose location contains any of these
-  --location-exclude "A,B,C"      Drop jobs whose location contains any of these
-  --limit N                       Cap results (default 100)
-  --json                          Output full JSON
-
-Filter guidance:
-  Use --title-filter for "what KIND of role" (PM, engineer, designer).
-  Use --filter for "what it's ABOUT" (integrations, growth, payments).
-  Both AND together. Avoid --filter "product manager" — description
-  mentions of PMs in other roles' JDs create false positives.
-
-Examples:
-  jd-intel fetch stripe
-  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`);
-  }
-}
-
-main().catch(err => {
-  console.error('Error:', err.message);
-  process.exit(1);
-});
+#!/usr/bin/env node
+
+/**
+ * jd-intel CLI
+ *
+ * Usage:
+ *   jd-intel fetch <company> [--ats <platform>] [--filter keyword|pattern]
+ *   jd-intel detect <company>
+ *   jd-intel registry search <query>
+ */
+
+import { fetchJobs } from './index.js';
+import { detectAts, searchRegistry } from './registry.js';
+
+const [,, command, ...args] = process.argv;
+
+async function main() {
+  switch (command) {
+    case 'fetch': {
+      const company = args[0];
+      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;
+      };
+      let ats = getArg('--ats');
+      const titleFilter = getArg('--title-filter');
+      const filter = getArg('--filter');
+      const postedWithinRaw = getArg('--posted-within-days');
+      const postedWithinDays = postedWithinRaw !== undefined ? Number(postedWithinRaw) : undefined;
+      const locIncludeRaw = getArg('--location-include');
+      const locationIncludes = locIncludeRaw ? locIncludeRaw.split(',').map(s => s.trim()).filter(Boolean) : undefined;
+      const locExcludeRaw = getArg('--location-exclude');
+      const locationExcludes = locExcludeRaw ? locExcludeRaw.split(',').map(s => s.trim()).filter(Boolean) : undefined;
+      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}`);
+      if (postedWithinDays !== undefined) parts.push(`within ${postedWithinDays}d`);
+      if (locationIncludes) parts.push(`loc+: ${locationIncludes.join('|')}`);
+      if (locationExcludes) parts.push(`loc-: ${locationExcludes.join('|')}`);
+      const suffix = parts.length ? ` [${parts.join(', ')}]` : '';
+
+      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)) {
+        const salary = job.salary ? ` | $${job.salary.min?.toLocaleString()}-$${job.salary.max?.toLocaleString()}` : '';
+        const loc = job.location ? ` | ${job.location}` : '';
+        const dept = job.department ? ` [${job.department}]` : '';
+        console.log(`  ${job.title}${dept}${loc}${salary}`);
+        console.log(`  ${job.url}`);
+        if (job.description) {
+          const preview = job.description.substring(0, 120).replace(/\n/g, ' ');
+          console.log(`  ${preview}...`);
+        }
+        console.log();
+      }
+
+      if (jobs.length > 20) {
+        console.log(`  ... and ${jobs.length - 20} more. Use --json for full output.`);
+      }
+
+      if (args.includes('--json')) {
+        console.log(JSON.stringify(jobs, null, 2));
+      }
+      break;
+    }
+
+    case 'detect': {
+      const company = args[0];
+      if (!company) { console.error('Usage: jd-intel detect <company>'); process.exit(1); }
+      console.log(`Detecting ATS for ${company}...`);
+      const results = await detectAts(company);
+      if (results.length === 0) {
+        console.log('No ATS board found for this company.');
+      } else {
+        for (const r of results) {
+          console.log(`  Found: ${r.ats} (slug: ${r.slug})`);
+        }
+      }
+      break;
+    }
+
+    case 'registry': {
+      const subcommand = args[0];
+      if (subcommand === 'search') {
+        const query = args.slice(1).join(' ');
+        if (!query) { console.error('Usage: jd-intel registry search <query>'); process.exit(1); }
+        const results = await searchRegistry(query);
+        console.log(`Found ${results.length} companies matching "${query}":\n`);
+        for (const r of results) {
+          console.log(`  ${r.name || r.slug} (${r.ats})${r.sector ? ` — ${r.sector}` : ''}`);
+        }
+      } else {
+        console.error('Usage: jd-intel registry search <query>');
+      }
+      break;
+    }
+
+    default:
+      console.log(`jd-intel — JD intelligence toolkit for your AI assistant.
+
+Usage:
+  jd-intel fetch <company> [options]
+  jd-intel detect <company>
+  jd-intel registry search <query>
+
+Fetch options:
+  --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
+  --location-include "A,B,C"      Keep jobs whose location contains any of these
+  --location-exclude "A,B,C"      Drop jobs whose location contains any of these
+  --limit N                       Cap results (default 100)
+  --json                          Output full JSON
+
+Filter guidance:
+  Use --title-filter for "what KIND of role" (PM, engineer, designer).
+  Use --filter for "what it's ABOUT" (integrations, growth, payments).
+  Both AND together. Avoid --filter "product manager" — description
+  mentions of PMs in other roles' JDs create false positives.
+
+Examples:
+  jd-intel fetch stripe
+  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`);
+  }
+}
+
+main().catch(err => {
+  console.error('Error:', err.message);
+  process.exit(1);
+});

package/src/errors.js

@@ -0,0 +1,38 @@
+/**
+ * Error taxonomy + typed error for the jd-intel toolkit.
+ *
+ * Codes are short and stable; the MCP tool descriptions teach the AI what each
+ * one means. Adapters throw AtsError with a code so callers map failures by
+ * `err.code` instead of parsing the message.
+ */
+
+export const ERROR_CODES = {
+  COMPANY_NOT_FOUND: 'company_not_found',  // Slug not in registry and not detected
+  ATS_UNREACHABLE: 'ats_unreachable',      // Known ATS failed (500, timeout)
+  PARTIAL_FAILURE: 'partial_failure',      // Discovery mode; some adapters failed
+  INVALID_ARGS: 'invalid_args',            // Missing required, wrong type, bad pattern
+  NO_RESULTS: 'no_results',                // Query succeeded, filters returned nothing
+  RATE_LIMITED: 'rate_limited',            // Upstream returned 429
+};
+
+/**
+ * Thrown by adapters on an upstream HTTP failure. Carries a stable `code`
+ * (ats_unreachable / rate_limited) so the MCP layer maps it without parsing
+ * the message. Extends Error, so the message, stack, and `instanceof Error`
+ * all keep working for existing library consumers.
+ */
+export class AtsError extends Error {
+  constructor(code, message) {
+    super(message);
+    this.name = 'AtsError';
+    this.code = code;
+  }
+}
+
+/**
+ * Helper for adapters: build an AtsError from an HTTP status (429 => rate
+ * limited, anything else => unreachable) with the given message.
+ */
+export function atsErrorFromStatus(status, message) {
+  return new AtsError(status === 429 ? ERROR_CODES.RATE_LIMITED : ERROR_CODES.ATS_UNREACHABLE, message);
+}