job-pro 0.6.0 → 0.7.0

package/dist/cicc.js

@@ -0,0 +1,152 @@
+// Thin client for CICC / 中金公司 (China International Capital Corporation) campus recruiting.
+//
+// ============================================================
+// API DISCOVERY (probed 2026-05-14)
+//
+// Five potential portals were investigated:
+//
+//   1. careers.cicc.com  (CICC dedicated careers subdomain)
+//      DNS resolves to 198.18.1.66 (IANA RFC 2544 benchmarking range — unreachable
+//      from public internet; SSL handshake fails at TCP level).
+//      This hostname is dead from outside the CICC intranet.
+//
+//   2. hr.cicc.com  (HR portal)
+//      DNS resolves to 198.18.1.212 — same IANA-reserved range.
+//      Unreachable: SSL handshake fails.
+//
+//   3. www.cicc.com/career  (main site career section)
+//      Returns HTTP 521 (Cloudflare "Web server is down"). Cloudflare can reach
+//      the origin but the origin is not responding. No API endpoints discoverable.
+//
+//   4. app.mokahr.com — Moka ATS, orgId 28961 (reconnaissance-flagged candidate)
+//      The Moka platform (app.mokahr.com) is reachable (resolves to Aliyun WAF
+//      47.93.92.61 via authoritative DNS). However:
+//        - /campus-recruitment/cicc/28961        → HTTP 302 self-redirect (infinite loop)
+//        - /campus-recruitment/cicc-career/28961 → HTTP 200 HTML, but init-data
+//          contains {"message":"您访问的页面不存在"} — org page does not exist
+//        - /social-recruitment/cicc-career/28961 → same "page not found" response
+//        - All /api/campus/jobs?organizationId=28961 variants → {"code":-1,"message":"您访问的页面不存在"}
+//      Conclusion: orgId 28961 is either wrong or the CICC Moka tenant is fully
+//      auth-gated behind enterprise SSO. No public JSON feed is accessible.
+//
+//   5. Alternative slugs tried on Moka: "cicc", "cicc-career", "zhongjin", numeric
+//      variants of orgId (28960–28965) — all return either the same "not found"
+//      response or an infinite self-redirect.
+//
+// VERDICT: No public unauthenticated API exists for CICC campus recruiting as of
+// 2026-05-14. All externally-facing hostnames resolve to IANA-reserved IPs (intranet)
+// or return infrastructure errors (521). The Moka tenant, if it exists, is fully
+// auth-gated with no discoverable public endpoints.
+//
+// The canonical path for candidates is the CICC official career portal:
+//   https://www.cicc.com/career  (may load once the origin is healthy)
+// Or the known Moka URL patterns (require an active employee/candidate session):
+//   https://app.mokahr.com/campus-recruitment/cicc-career/28961
+//
+// ============================================================
+// PositionSummary field mapping (canonical keys, matches all other adapters)
+//   post_id       — string job identifier
+//   title         — position title
+//   project       — job category / department (e.g. "投行" / "研究" / "固收")
+//   recruit_label — recruit type label (e.g. "校园招聘" / "实习")
+//   bgs           — business group / division (not exposed without auth, always "")
+//   work_cities   — work location string
+//   apply_url     — deep link to the job posting
+// ============================================================
+import { extractResumeSignals, scoreOverlap, checkResume } from "./tencent.js";
+export { checkResume };
+const SOURCE = "www.cicc.com";
+const CAMPUS_PAGE = "https://www.cicc.com/career";
+// Moka tenant URL kept for reference — requires auth
+const MOKA_PAGE = "https://app.mokahr.com/campus-recruitment/cicc-career/28961";
+// ---------- stub message ----------
+const STUB_MSG = "CICC (中金公司) campus recruiting has no publicly accessible API as of 2026-05-14. " +
+    "careers.cicc.com and hr.cicc.com resolve to IANA-reserved IPs (198.18.x.x, " +
+    "unreachable outside the CICC intranet; SSL handshake fails). " +
+    "www.cicc.com returns HTTP 521 (Cloudflare origin-down). " +
+    "The Moka ATS tenant (orgId 28961) is fully auth-gated: all public API paths " +
+    'return {"code":-1,"message":"您访问的页面不存在"}. ' +
+    `Apply directly at ${CAMPUS_PAGE} or via the Moka portal (login required): ${MOKA_PAGE}`;
+// ---------- searchPositions ----------
+export async function searchPositions(_opts = {}) {
+    return {
+        ok: false,
+        source: SOURCE,
+        message: STUB_MSG,
+        apply_url: CAMPUS_PAGE,
+        moka_url: MOKA_PAGE,
+        positions: [],
+    };
+}
+// ---------- fetchAllPositions ----------
+export async function fetchAllPositions(_opts = {}) {
+    return {
+        ok: false,
+        source: SOURCE,
+        message: STUB_MSG,
+        apply_url: CAMPUS_PAGE,
+        moka_url: MOKA_PAGE,
+        fetched: 0,
+        positions: [],
+    };
+}
+// ---------- fetchPositionDetail ----------
+export async function fetchPositionDetail(_postId) {
+    return {
+        ok: false,
+        source: SOURCE,
+        message: STUB_MSG,
+        apply_url: CAMPUS_PAGE,
+        moka_url: MOKA_PAGE,
+    };
+}
+// ---------- fetchDictionaries ----------
+export async function fetchDictionaries() {
+    return {
+        ok: false,
+        source: SOURCE,
+        message: STUB_MSG,
+        apply_url: CAMPUS_PAGE,
+        moka_url: MOKA_PAGE,
+    };
+}
+// ---------- notices (no public endpoint) ----------
+export async function listNotices() {
+    return {
+        ok: false,
+        source: SOURCE,
+        message: "CICC: no public notices endpoint",
+    };
+}
+export async function getNotice(_id) {
+    return {
+        ok: false,
+        source: SOURCE,
+        message: "CICC: no public notices endpoint",
+    };
+}
+export async function findNoticesByQuestion(_question, _opts = {}) {
+    return {
+        ok: false,
+        source: SOURCE,
+        message: "CICC: no public notices endpoint",
+    };
+}
+// ---------- matchResume ----------
+// Resume matching cannot fetch live position data without auth.
+// We extract signals from the resume and direct the user to the CICC career portal.
+export async function matchResume(text, opts = {}) {
+    void opts;
+    const { terms, cities } = extractResumeSignals(text ?? "");
+    return {
+        ok: false,
+        source: SOURCE,
+        message: STUB_MSG,
+        apply_url: CAMPUS_PAGE,
+        moka_url: MOKA_PAGE,
+        extracted_terms: terms,
+        city_preferences: cities,
+    };
+}
+// Export helpers so callers that import from this module can use them.
+export { extractResumeSignals, scoreOverlap };

package/dist/deepseek.js

@@ -0,0 +1,39 @@
+// DeepSeek (深度求索) — stub adapter for `job-pro`.
+//
+// STATUS: stub-only. DeepSeek is part of High-Flyer (幻方量化) and lists
+// careers via the parent company on Moka social-recruitment. Probe results:
+//   www.deepseek.com/careers       → 200 HTML, no inline job data / API path
+//   careers.deepseek.com           → DNS resolves but TLS rejects from non-CN IPs
+//   app.mokahr.com/social-recruitment/high-flyer/140576/  → Moka SPA, auth-gated
+// Moka public anonymous API is gated (confirmed; see Moka probe in repo
+// history). When DeepSeek opens a public JSON endpoint we rewrite in one pass.
+import { extractResumeSignals, checkResume } from "./tencent.js";
+export { checkResume };
+const SOURCE = "www.deepseek.com";
+const STUB_MESSAGE = "DeepSeek: no public job API — careers route through Moka social-recruitment " +
+    "(high-flyer/140576), which requires session auth. corporate careers page is HTML only.";
+export async function searchPositions(_opts = {}) {
+    return { ok: false, source: SOURCE, message: STUB_MESSAGE, query: {}, positions: [] };
+}
+export async function fetchAllPositions(_opts = {}) {
+    return { ok: false, source: SOURCE, message: STUB_MESSAGE, total: 0, fetched: 0, positions: [] };
+}
+export async function fetchPositionDetail(postId) {
+    return { ok: false, source: SOURCE, message: STUB_MESSAGE, post_id: postId };
+}
+export async function fetchDictionaries() {
+    return { ok: false, source: SOURCE, message: STUB_MESSAGE };
+}
+export async function listNotices() {
+    return { ok: false, source: SOURCE, message: STUB_MESSAGE, notices: [] };
+}
+export async function getNotice(noticeId) {
+    return { ok: false, source: SOURCE, message: STUB_MESSAGE, notice_id: noticeId };
+}
+export async function findNoticesByQuestion(question, _opts = {}) {
+    return { ok: false, source: SOURCE, question, message: STUB_MESSAGE, matches: [] };
+}
+export async function matchResume(text, _opts = {}) {
+    const { terms, cities } = extractResumeSignals(text ?? "");
+    return { ok: false, source: SOURCE, extracted_terms: terms, city_preferences: cities, matches: [], message: STUB_MESSAGE };
+}

package/dist/galaxyuniversal.js

@@ -0,0 +1,37 @@
+// 银河通用 / Galaxy Universal (Galbot — embodied AI robotics) — stub for `job-pro`.
+//
+// STATUS: stub-only. Galaxy Universal lists careers via Moka social-recruitment
+// (orgId 165930, slug yinhetongyong), which is auth-gated for anonymous access.
+// Probe results:
+//   www.galbot.com/careers, galaxyuniversal.com/careers → no public API discoverable
+//   app.mokahr.com/social-recruitment/yinhetongyong/165930  → Moka SPA, session auth required
+import { extractResumeSignals, checkResume } from "./tencent.js";
+export { checkResume };
+const SOURCE = "galbot.com";
+const STUB_MESSAGE = "Galaxy Universal / 银河通用: no public job API — Moka social-recruitment portal " +
+    "(yinhetongyong/165930) requires session auth (verified Moka anon path is gated).";
+export async function searchPositions(_opts = {}) {
+    return { ok: false, source: SOURCE, message: STUB_MESSAGE, query: {}, positions: [] };
+}
+export async function fetchAllPositions(_opts = {}) {
+    return { ok: false, source: SOURCE, message: STUB_MESSAGE, total: 0, fetched: 0, positions: [] };
+}
+export async function fetchPositionDetail(postId) {
+    return { ok: false, source: SOURCE, message: STUB_MESSAGE, post_id: postId };
+}
+export async function fetchDictionaries() {
+    return { ok: false, source: SOURCE, message: STUB_MESSAGE };
+}
+export async function listNotices() {
+    return { ok: false, source: SOURCE, message: STUB_MESSAGE, notices: [] };
+}
+export async function getNotice(noticeId) {
+    return { ok: false, source: SOURCE, message: STUB_MESSAGE, notice_id: noticeId };
+}
+export async function findNoticesByQuestion(question, _opts = {}) {
+    return { ok: false, source: SOURCE, question, message: STUB_MESSAGE, matches: [] };
+}
+export async function matchResume(text, _opts = {}) {
+    const { terms, cities } = extractResumeSignals(text ?? "");
+    return { ok: false, source: SOURCE, extracted_terms: terms, city_preferences: cities, matches: [], message: STUB_MESSAGE };
+}

package/dist/geely.js

@@ -0,0 +1,62 @@
+// 吉利汽车 (Geely Auto) — stub adapter for `job-pro`.
+//
+// STATUS: stub-only. The careers domains do not resolve over public DNS,
+// and the third-party ATS slugs (Greenhouse, Lever, Feishu, Moka) all return
+// 404 or are unprovisioned. Public-facing recruiting appears to run only
+// through WeChat / official-account channels.
+//
+// ============================================================
+// RECONNAISSANCE RESULTS (probed 2026-05):
+//
+//   https://career.geely.com             — 000 (no public DNS / unreachable)
+//   https://join.geely.com               — 000 (no public DNS)
+//   https://hr.geely.com                 — 000 (no public DNS)
+//
+//   Feishu ATSX:    geely.jobs.feishu.cn — HTTP 400 (no portal)
+//                   zeekr.jobs.feishu.cn — HTTP 400 (no portal)
+//   Greenhouse:     geely / zeekr        — HTTP 404 (no board)
+//   Lever:          geely / zeekr        — HTTP 404 (no posting)
+//   Moka:           app.mokahr.com/social-recruitment/geely → 302 (slug unprovisioned)
+//
+// Conclusion: Geely's recruiting flow is gated behind WeChat / official-account
+// channels and a non-public corporate ATS. No public unauthenticated API
+// available. Visit Geely's official WeChat 吉利汽车招聘 for postings.
+import { extractResumeSignals, scoreOverlap, checkResume } from "./tencent.js";
+export { checkResume };
+const SOURCE = "geely.com";
+const STUB_MESSAGE = "Geely (吉利汽车): careers subdomains (career / join / hr.geely.com) fail to resolve over public DNS, " +
+    "and no Greenhouse / Lever / Feishu / Moka tenant is provisioned. Recruiting runs through WeChat " +
+    "official-account channels. No unauthenticated public API available.";
+export async function searchPositions(_opts = {}) {
+    return { ok: false, source: SOURCE, message: STUB_MESSAGE, query: {}, positions: [] };
+}
+export async function fetchAllPositions(_opts = {}) {
+    return { ok: false, source: SOURCE, message: STUB_MESSAGE, total: 0, fetched: 0, positions: [] };
+}
+export async function fetchPositionDetail(postId) {
+    return { ok: false, source: SOURCE, message: STUB_MESSAGE, post_id: postId };
+}
+export async function fetchDictionaries() {
+    return { ok: false, source: SOURCE, message: STUB_MESSAGE };
+}
+export async function listNotices() {
+    return { ok: false, source: SOURCE, message: STUB_MESSAGE, notices: [] };
+}
+export async function getNotice(noticeId) {
+    return { ok: false, source: SOURCE, message: STUB_MESSAGE, notice_id: noticeId };
+}
+export async function findNoticesByQuestion(question, _opts = {}) {
+    return { ok: false, source: SOURCE, question, message: STUB_MESSAGE, matches: [] };
+}
+export async function matchResume(text, _opts = {}) {
+    const { terms, cities } = extractResumeSignals(text ?? "");
+    return {
+        ok: false,
+        source: SOURCE,
+        extracted_terms: terms,
+        city_preferences: cities,
+        matches: [],
+        message: STUB_MESSAGE,
+    };
+}
+export { extractResumeSignals, scoreOverlap };

package/dist/greenhouse.js

@@ -0,0 +1,370 @@
+// Generic Greenhouse Boards adapter factory.
+//
+// Greenhouse (boards-api.greenhouse.io) is a widely-used SaaS ATS. Multiple
+// Chinese companies (or their international arms) self-host their public job
+// board on a `<slug>` namespace there. The unauthenticated REST surface is
+// stable across tenants:
+//
+//   GET https://boards-api.greenhouse.io/v1/boards/<slug>/jobs
+//     → { jobs: [...], meta: { total: <int> } }
+//
+//   GET https://boards-api.greenhouse.io/v1/boards/<slug>/jobs/<id>?content=true
+//     → full job object including the rendered description HTML
+//
+//   GET https://boards-api.greenhouse.io/v1/boards/<slug>/departments
+//     → { departments: [{ id, name, child_ids[], parent_id }] }
+//
+//   GET https://boards-api.greenhouse.io/v1/boards/<slug>/offices
+//     → { offices: [{ id, name, location, child_ids[], parent_id }] }
+//
+// All endpoints are GET-only, return JSON, and require no auth headers.
+//
+// ---- PositionSummary field mapping (Greenhouse → canonical) ----
+//   post_id       ← String(job.id)
+//   title         ← job.title
+//   project       ← job.departments[0]?.name (or "")
+//   recruit_label ← job.metadata where name matches "Employment Type" (else "")
+//   bgs           ← ""  (Greenhouse has no BG dimension)
+//   work_cities   ← job.location.name
+//   apply_url     ← job.absolute_url
+//
+// ---- Discovery notes ----
+//   * Greenhouse returns the full job list in a single call — no pagination is
+//     required for ATS sizes seen so far (<2000 jobs).
+//   * The `meta.total` field is always present.
+//   * `content=true` on the detail endpoint returns description as escaped HTML.
+import { extractResumeSignals, scoreOverlap, checkResume } from "./tencent.js";
+export { checkResume };
+// ---------- createAdapter ----------
+export function createAdapter(cfg) {
+    const API_ROOT = `https://boards-api.greenhouse.io/v1/boards/${encodeURIComponent(cfg.slug)}`;
+    const SOURCE = `boards-api.greenhouse.io/${cfg.slug}`;
+    const BOARD_URL = `https://job-boards.greenhouse.io/${encodeURIComponent(cfg.slug)}`;
+    const HEADERS = {
+        "User-Agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/124.0.0.0 Safari/537.36",
+        Accept: "application/json",
+    };
+    function summarize(job) {
+        const id = String(job.id ?? "");
+        const dept = job.departments?.[0]?.name ?? "";
+        const employmentType = (job.metadata ?? []).find((m) => (m.name ?? "").toLowerCase() === "employment type")?.value;
+        const recruit_label = typeof employmentType === "string" ? employmentType : "";
+        return {
+            post_id: id,
+            title: job.title ?? "",
+            project: dept,
+            recruit_label,
+            bgs: "",
+            work_cities: job.location?.name ?? "",
+            apply_url: job.absolute_url ?? `${BOARD_URL}/jobs/${id}`,
+        };
+    }
+    let _allCache = null;
+    async function fetchAllRaw() {
+        const now = Date.now();
+        if (_allCache && now - _allCache.fetchedAt < 5 * 60 * 1000) {
+            return _allCache.ok ? { ok: true, jobs: _allCache.jobs } : { ok: false, message: _allCache.message };
+        }
+        let response;
+        try {
+            response = await fetch(`${API_ROOT}/jobs?content=false`, { headers: HEADERS });
+        }
+        catch (err) {
+            const msg = `network error: ${err instanceof Error ? err.message : String(err)}`;
+            _allCache = { ok: false, message: msg, fetchedAt: now };
+            return { ok: false, message: msg };
+        }
+        if (!response.ok) {
+            const msg = `HTTP ${response.status}: ${response.statusText}`;
+            _allCache = { ok: false, message: msg, fetchedAt: now };
+            return { ok: false, message: msg };
+        }
+        let payload;
+        try {
+            payload = (await response.json());
+        }
+        catch (err) {
+            const msg = `bad JSON: ${err instanceof Error ? err.message : String(err)}`;
+            _allCache = { ok: false, message: msg, fetchedAt: now };
+            return { ok: false, message: msg };
+        }
+        const jobs = payload.jobs ?? [];
+        _allCache = { ok: true, jobs, fetchedAt: now };
+        return { ok: true, jobs };
+    }
+    function applyFilters(jobs, opts) {
+        const kw = (opts.keyword ?? "").trim().toLowerCase();
+        const deptFilters = (opts.departments ?? []).map((s) => String(s).toLowerCase());
+        const cityFilters = (opts.cities ?? []).map((s) => String(s).toLowerCase());
+        return jobs.filter((job) => {
+            if (kw) {
+                const blob = [
+                    job.title ?? "",
+                    job.location?.name ?? "",
+                    (job.departments ?? []).map((d) => d.name).join(" "),
+                ]
+                    .join(" ")
+                    .toLowerCase();
+                if (!blob.includes(kw))
+                    return false;
+            }
+            if (deptFilters.length) {
+                const blob = (job.departments ?? [])
+                    .map((d) => (d.name ?? "").toLowerCase())
+                    .join(" ");
+                if (!deptFilters.some((d) => blob.includes(d)))
+                    return false;
+            }
+            if (cityFilters.length) {
+                const blob = (job.location?.name ?? "").toLowerCase();
+                if (!cityFilters.some((c) => blob.includes(c)))
+                    return false;
+            }
+            return true;
+        });
+    }
+    async function searchPositions(opts = {}) {
+        const pageSize = Math.max(1, Math.min(200, opts.pageSize ?? 20));
+        const page = Math.max(1, opts.page ?? 1);
+        const pool = await fetchAllRaw();
+        if (!pool.ok) {
+            return {
+                ok: false,
+                message: pool.message,
+                source: SOURCE,
+                apply_url: BOARD_URL,
+                positions: [],
+            };
+        }
+        const filtered = applyFilters(pool.jobs, opts);
+        const offset = (page - 1) * pageSize;
+        const paginated = filtered.slice(offset, offset + pageSize);
+        return {
+            ok: true,
+            source: SOURCE,
+            query: opts,
+            page,
+            page_size: pageSize,
+            total: filtered.length,
+            positions: paginated.map(summarize),
+        };
+    }
+    async function fetchAllPositions(opts = {}) {
+        const pool = await fetchAllRaw();
+        if (!pool.ok) {
+            return {
+                ok: false,
+                message: pool.message,
+                source: SOURCE,
+                apply_url: BOARD_URL,
+                fetched: 0,
+                positions: [],
+            };
+        }
+        const filtered = applyFilters(pool.jobs, opts);
+        return {
+            ok: true,
+            source: SOURCE,
+            total: filtered.length,
+            fetched: filtered.length,
+            positions: filtered.map(summarize),
+        };
+    }
+    async function fetchPositionDetail(postId) {
+        const id = (postId ?? "").trim();
+        if (!id) {
+            return { ok: false, source: SOURCE, message: "post_id is required" };
+        }
+        let response;
+        try {
+            response = await fetch(`${API_ROOT}/jobs/${encodeURIComponent(id)}?content=true`, { headers: HEADERS });
+        }
+        catch (err) {
+            return {
+                ok: false,
+                source: SOURCE,
+                post_id: id,
+                message: `network error: ${err instanceof Error ? err.message : String(err)}`,
+            };
+        }
+        if (!response.ok) {
+            return {
+                ok: false,
+                source: SOURCE,
+                post_id: id,
+                message: `HTTP ${response.status}: ${response.statusText}`,
+            };
+        }
+        let job;
+        try {
+            job = (await response.json());
+        }
+        catch (err) {
+            return {
+                ok: false,
+                source: SOURCE,
+                post_id: id,
+                message: `bad JSON: ${err instanceof Error ? err.message : String(err)}`,
+            };
+        }
+        const summary = summarize(job);
+        const html = job.content ?? "";
+        // Crude HTML-to-text: decode common entities, strip tags.
+        const description = html
+            .replace(/<[^>]+>/g, " ")
+            .replace(/&nbsp;/g, " ")
+            .replace(/&amp;/g, "&")
+            .replace(/&lt;/g, "<")
+            .replace(/&gt;/g, ">")
+            .replace(/&quot;/g, '"')
+            .replace(/&#39;/g, "'")
+            .replace(/\s+/g, " ")
+            .trim();
+        return {
+            ok: true,
+            source: SOURCE,
+            post_id: id,
+            title: job.title ?? "",
+            project: summary.project,
+            recruit_label: summary.recruit_label,
+            requisition_id: job.requisition_id ?? "",
+            first_published: job.first_published ?? "",
+            updated_at: job.updated_at ?? "",
+            description,
+            work_cities: job.location?.name ?? "",
+            apply_url: summary.apply_url,
+        };
+    }
+    // ---------- fetchDictionaries ----------
+    let _dictCache = null;
+    async function fetchDictionaries() {
+        if (_dictCache !== null)
+            return _dictCache;
+        try {
+            const [deptRes, offRes] = await Promise.all([
+                fetch(`${API_ROOT}/departments`, { headers: HEADERS }),
+                fetch(`${API_ROOT}/offices`, { headers: HEADERS }),
+            ]);
+            if (!deptRes.ok && !offRes.ok) {
+                const r = {
+                    ok: false,
+                    source: SOURCE,
+                    message: `HTTP ${deptRes.status}/${offRes.status}`,
+                };
+                _dictCache = r;
+                return r;
+            }
+            const deptJson = deptRes.ok
+                ? (await deptRes.json())
+                : { departments: [] };
+            const offJson = offRes.ok
+                ? (await offRes.json())
+                : { offices: [] };
+            const result = {
+                ok: true,
+                source: SOURCE,
+                departments: (deptJson.departments ?? []).map((d) => ({
+                    id: d.id ?? 0,
+                    name: d.name ?? "",
+                    parent_id: d.parent_id ?? null,
+                })),
+                offices: (offJson.offices ?? []).map((o) => ({
+                    id: o.id ?? 0,
+                    name: o.name ?? "",
+                    location: o.location ?? "",
+                    parent_id: o.parent_id ?? null,
+                })),
+            };
+            _dictCache = result;
+            return result;
+        }
+        catch (err) {
+            const r = {
+                ok: false,
+                source: SOURCE,
+                message: `network error: ${err instanceof Error ? err.message : String(err)}`,
+            };
+            _dictCache = r;
+            return r;
+        }
+    }
+    // ---------- notices (stub) ----------
+    const NOTICES_STUB = {
+        ok: false,
+        source: SOURCE,
+        message: `${cfg.label}: Greenhouse boards have no announcements endpoint`,
+    };
+    async function listNotices() {
+        return NOTICES_STUB;
+    }
+    async function getNotice(_id) {
+        return NOTICES_STUB;
+    }
+    async function findNoticesByQuestion(_question, _opts = {}) {
+        return NOTICES_STUB;
+    }
+    // ---------- matchResume ----------
+    async function matchResume(text, opts = {}) {
+        const topN = Math.max(1, opts.topN ?? 5);
+        const candidates = Math.max(topN, opts.candidates ?? 20);
+        const { terms, cities } = extractResumeSignals(text ?? "");
+        if (!terms.length) {
+            return {
+                ok: false,
+                source: SOURCE,
+                message: "could not extract any technical signals from the text",
+                preview: (text ?? "").slice(0, 120),
+            };
+        }
+        const pool = await fetchAllRaw();
+        if (!pool.ok) {
+            return { ok: false, source: SOURCE, message: pool.message, positions: [] };
+        }
+        const scored = [];
+        for (const job of pool.jobs) {
+            const blob = [
+                job.title ?? "",
+                job.location?.name ?? "",
+                (job.departments ?? []).map((d) => d.name).join(" "),
+            ].join(" ");
+            const { score, reasons } = scoreOverlap(blob, terms, cities);
+            if (score > 0)
+                scored.push({ score, raw: job, reasons });
+        }
+        scored.sort((a, b) => b.score - a.score);
+        let shortlist = scored.slice(0, Math.max(topN, candidates));
+        if (!shortlist.length) {
+            shortlist = pool.jobs.slice(0, candidates).map((raw) => ({
+                score: 0,
+                raw,
+                reasons: [],
+            }));
+        }
+        const matches = shortlist.slice(0, topN).map((s) => {
+            const mr = s.reasons.length > 0
+                ? s.reasons.slice(0, 5)
+                : ["no specific keyword overlap — surfaced from full board listing"];
+            return { ...summarize(s.raw), match_reasons: mr };
+        });
+        return {
+            ok: true,
+            source: SOURCE,
+            extracted_terms: terms,
+            city_preferences: cities,
+            matches,
+            note: "match_reasons surfaces overlapping keywords, not a probability of getting an interview. " +
+                "The only authority on selection is HR.",
+        };
+    }
+    return {
+        searchPositions,
+        fetchAllPositions,
+        fetchPositionDetail,
+        fetchDictionaries,
+        listNotices,
+        getNotice,
+        findNoticesByQuestion,
+        matchResume,
+        checkResume,
+    };
+}