careerclaw-js 0.11.0

package/dist/license.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"license.js","sourceRoot":"","sources":["../src/license.ts"],"names":[],"mappings":"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"}

package/dist/llm-enhance.d.ts

@@ -0,0 +1,69 @@
+/**
+ * llm-enhance.ts — LLM-powered outreach draft enhancement (Pro tier).
+ *
+ * `enhanceDraft()` replaces the deterministic baseline draft with a
+ * personalised LLM-generated version when a valid Pro key is active.
+ *
+ * Design principles:
+ *   - Silent fallback: any failure returns the original draft unchanged.
+ *     The function never throws.
+ *   - Privacy-first: only extracted keyword signals are sent to the LLM.
+ *     Raw resume text is NEVER included in the prompt.
+ *   - Failover chain: providers are tried left-to-right from LLM_CHAIN.
+ *     Each candidate is retried up to LLM_MAX_RETRIES times before moving
+ *     to the next. A circuit breaker opens after LLM_CIRCUIT_BREAKER_FAILS
+ *     consecutive failures across the whole chain.
+ *   - Testable: the fetch function is injectable so tests run fully offline.
+ */
+import type { NormalizedJob, UserProfile, OutreachDraft, ResumeIntelligence } from "./models.js";
+type OpenAITransport = "chat" | "responses";
+export interface ChainCandidate {
+    provider: "anthropic" | "openai";
+    model: string;
+    apiKey: string;
+    transport?: OpenAITransport;
+}
+export interface EnhanceOptions {
+    /**
+     * Injectable fetch — defaults to global fetch.
+     * Pass a stub in tests to avoid live network calls.
+     */
+    fetchFn?: typeof fetch;
+    /**
+     * Override the resolved provider chain — for testing only.
+     * Bypasses env-var key resolution so tests can run without real credentials.
+     */
+    _chainOverride?: ChainCandidate[];
+    /**
+     * Output mode.
+     *
+     * "draft"        — (default, Free tier) Short outreach email, max 250 words.
+     *                  Produced by the deterministic template on Free; LLM-enhanced on Pro.
+     * "cover_letter" — (Pro only, future) Tailored cover letter, max 300 words.
+     *                  Every sentence connects the candidate to this specific role.
+     *                  Zero generic filler. Requires active Pro license.
+     *
+     * TODO: Phase X — implement cover_letter mode. Stub is in buildPrompt().
+     */
+    mode?: "draft" | "cover_letter";
+}
+/**
+ * Attempt to replace `draft` with an LLM-enhanced version.
+ *
+ * @param job          - The job being applied to
+ * @param profile      - User profile (experience_years used in prompt)
+ * @param resumeIntel  - Section-aware keyword signals (impact_signals used)
+ * @param draft        - Deterministic baseline to fall back to on failure
+ * @param gapKeywords  - Keywords from the job not present in the profile
+ * @param options      - Injectable fetch for testing
+ * @returns Enhanced draft with llm_enhanced=true, or original draft on failure
+ */
+export declare function enhanceDraft(job: NormalizedJob, profile: UserProfile, resumeIntel: ResumeIntelligence, draft: OutreachDraft, gapKeywords?: string[], options?: EnhanceOptions): Promise<OutreachDraft>;
+/**
+ * System prompt — establishes the LLM as a senior career writer.
+ * Sent as the `system` field (Anthropic) or system role message (OpenAI).
+ */
+declare const SYSTEM_PROMPT = "You are a senior career consultant and professional writer with 15 years of experience placing candidates at top-tier companies. You write outreach emails and cover letters that are specific, compelling, and human \u2014 never generic.\n\nYour core method \u2014 the Bridge Sentence:\nFor every strength signal the candidate has, identify the corresponding requirement in the role and connect them with a concrete, specific sentence. Example: \"Because I architected the data pipeline at [Company], I can solve your need for reliable real-time ingestion from day one.\" Every paragraph must contain at least one Bridge Sentence.\n\nYour writing principles:\n- Every sentence earns its place. No filler, no padding, no throat-clearing.\n- Map the candidate's actual experience to this specific role's needs \u2014 not to \"the industry.\"\n- When the candidate has a gap, frame it as genuine motivation to grow, not as an apology.\n- Write like a thoughtful senior professional, not a cover letter generator.\n- Strict word limits: 250 words maximum for outreach emails, 300 words for cover letters.\n- Count words before finishing. If over the limit, cut the weakest sentence, not the strongest.\n- Output your final word count at the very bottom of the response in brackets.\n\nBanned phrases \u2014 never use these under any circumstances:\n\"I am writing to express my interest\", \"I am excited to apply\", \"I would be a great fit\", \"passion for\", \"passionate about\", \"leverage my skills\", \"leverage my experience\", \"dynamic team\", \"fast-paced environment\", \"detail-oriented\", \"results-driven\", \"team player\", \"go-getter\", \"hard worker\", \"strong work ethic\", \"I am a quick learner\", \"Enclosed please find\", \"Please find attached\", \"I am writing to\", \"I look forward to hearing from you\", \"Thank you for your consideration\", \"I believe I would\", \"synergy\", \"proactive\", \"self-starter\".";
+/** Exported for testing — same reference used by both API callers. */
+export { SYSTEM_PROMPT };
+//# sourceMappingURL=llm-enhance.d.ts.map

package/dist/llm-enhance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-enhance.d.ts","sourceRoot":"","sources":["../src/llm-enhance.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAejG,KAAK,eAAe,GAAG,MAAM,GAAG,WAAW,CAAC;AAE5C,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,WAAW,GAAG,QAAQ,CAAC;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,eAAe,CAAC;CAC7B;AAED,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,KAAK,CAAC;IACvB;;;OAGG;IACH,cAAc,CAAC,EAAE,cAAc,EAAE,CAAC;IAClC;;;;;;;;;;OAUG;IACH,IAAI,CAAC,EAAE,OAAO,GAAG,cAAc,CAAC;CACjC;AAMD;;;;;;;;;;GAUG;AACH,wBAAsB,YAAY,CAChC,GAAG,EAAE,aAAa,EAClB,OAAO,EAAE,WAAW,EACpB,WAAW,EAAE,kBAAkB,EAC/B,KAAK,EAAE,aAAa,EACpB,WAAW,GAAE,MAAM,EAAO,EAC1B,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,aAAa,CAAC,CAkCxB;AA2DD;;;GAGG;AACH,QAAA,MAAM,aAAa,m5DAe2gB,CAAC;AA8F/hB,sEAAsE;AACtE,OAAO,EAAE,aAAa,EAAE,CAAC"}

package/dist/llm-enhance.js

@@ -0,0 +1,376 @@
+/**
+ * llm-enhance.ts — LLM-powered outreach draft enhancement (Pro tier).
+ *
+ * `enhanceDraft()` replaces the deterministic baseline draft with a
+ * personalised LLM-generated version when a valid Pro key is active.
+ *
+ * Design principles:
+ *   - Silent fallback: any failure returns the original draft unchanged.
+ *     The function never throws.
+ *   - Privacy-first: only extracted keyword signals are sent to the LLM.
+ *     Raw resume text is NEVER included in the prompt.
+ *   - Failover chain: providers are tried left-to-right from LLM_CHAIN.
+ *     Each candidate is retried up to LLM_MAX_RETRIES times before moving
+ *     to the next. A circuit breaker opens after LLM_CIRCUIT_BREAKER_FAILS
+ *     consecutive failures across the whole chain.
+ *   - Testable: the fetch function is injectable so tests run fully offline.
+ */
+import { LLM_ANTHROPIC_KEY, LLM_OPENAI_KEY, LLM_API_KEY, LLM_CHAIN, LLM_MAX_RETRIES, LLM_CIRCUIT_BREAKER_FAILS, HTTP_TIMEOUT_MS, } from "./config.js";
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Attempt to replace `draft` with an LLM-enhanced version.
+ *
+ * @param job          - The job being applied to
+ * @param profile      - User profile (experience_years used in prompt)
+ * @param resumeIntel  - Section-aware keyword signals (impact_signals used)
+ * @param draft        - Deterministic baseline to fall back to on failure
+ * @param gapKeywords  - Keywords from the job not present in the profile
+ * @param options      - Injectable fetch for testing
+ * @returns Enhanced draft with llm_enhanced=true, or original draft on failure
+ */
+export async function enhanceDraft(job, profile, resumeIntel, draft, gapKeywords = [], options = {}) {
+    const fetchFn = options.fetchFn ?? fetch;
+    const mode = options.mode ?? "draft";
+    const chain = options._chainOverride ?? buildChain();
+    if (chain.length === 0) {
+        return draft; // No configured providers — degrade silently
+    }
+    let consecutiveFails = 0;
+    for (const candidate of chain) {
+        if (consecutiveFails >= LLM_CIRCUIT_BREAKER_FAILS) {
+            break; // Circuit breaker open
+        }
+        for (let attempt = 0; attempt < LLM_MAX_RETRIES; attempt++) {
+            if (consecutiveFails >= LLM_CIRCUIT_BREAKER_FAILS)
+                break;
+            try {
+                const prompt = buildPrompt(job, profile, resumeIntel, gapKeywords, mode);
+                const text = await callProvider(candidate, prompt, fetchFn);
+                const parsed = parseResponse(text, job);
+                if (parsed) {
+                    return { ...draft, subject: parsed.subject, body: parsed.body, llm_enhanced: true };
+                }
+                // Unparseable response counts as a soft failure — try next attempt
+                consecutiveFails++;
+            }
+            catch {
+                consecutiveFails++;
+            }
+        }
+    }
+    return draft; // All candidates exhausted or circuit open — fall back
+}
+// ---------------------------------------------------------------------------
+// Chain construction
+// ---------------------------------------------------------------------------
+/**
+ * Parse LLM_CHAIN into candidates with resolved API keys.
+ * Candidates without a usable key are silently skipped.
+ *
+ * Supported chain formats:
+ *   "anthropic/claude-haiku-4-5-20251001,openai/gpt-4o-mini"
+ *   "openai:chat/gpt-4o-mini,openai:responses/gpt-5.2"
+ */
+function buildChain() {
+    return LLM_CHAIN.split(",")
+        .map((entry) => entry.trim())
+        .filter(Boolean)
+        .flatMap((entry) => {
+        const slash = entry.indexOf("/");
+        if (slash === -1)
+            return [];
+        const left = entry.slice(0, slash).toLowerCase();
+        const model = entry.slice(slash + 1).trim();
+        if (!model)
+            return [];
+        let provider = null;
+        let transport;
+        if (left === "anthropic") {
+            provider = "anthropic";
+        }
+        else if (left === "openai") {
+            provider = "openai";
+        }
+        else if (left === "openai:chat") {
+            provider = "openai";
+            transport = "chat";
+        }
+        else if (left === "openai:responses") {
+            provider = "openai";
+            transport = "responses";
+        }
+        else {
+            return [];
+        }
+        const apiKey = resolveKey(provider);
+        if (!apiKey)
+            return []; // No key for this provider — skip
+        return [{ provider, model, apiKey, ...(transport !== undefined ? { transport } : {}) }];
+    });
+}
+function resolveKey(provider) {
+    if (provider === "anthropic")
+        return LLM_ANTHROPIC_KEY ?? LLM_API_KEY;
+    if (provider === "openai")
+        return LLM_OPENAI_KEY ?? LLM_API_KEY;
+}
+// ---------------------------------------------------------------------------
+// Prompt construction
+// ---------------------------------------------------------------------------
+/**
+ * System prompt — establishes the LLM as a senior career writer.
+ * Sent as the `system` field (Anthropic) or system role message (OpenAI).
+ */
+const SYSTEM_PROMPT = `You are a senior career consultant and professional writer with 15 years of experience placing candidates at top-tier companies. You write outreach emails and cover letters that are specific, compelling, and human — never generic.
+
+Your core method — the Bridge Sentence:
+For every strength signal the candidate has, identify the corresponding requirement in the role and connect them with a concrete, specific sentence. Example: "Because I architected the data pipeline at [Company], I can solve your need for reliable real-time ingestion from day one." Every paragraph must contain at least one Bridge Sentence.
+
+Your writing principles:
+- Every sentence earns its place. No filler, no padding, no throat-clearing.
+- Map the candidate's actual experience to this specific role's needs — not to "the industry."
+- When the candidate has a gap, frame it as genuine motivation to grow, not as an apology.
+- Write like a thoughtful senior professional, not a cover letter generator.
+- Strict word limits: 250 words maximum for outreach emails, 300 words for cover letters.
+- Count words before finishing. If over the limit, cut the weakest sentence, not the strongest.
+- Output your final word count at the very bottom of the response in brackets.
+
+Banned phrases — never use these under any circumstances:
+"I am writing to express my interest", "I am excited to apply", "I would be a great fit", "passion for", "passionate about", "leverage my skills", "leverage my experience", "dynamic team", "fast-paced environment", "detail-oriented", "results-driven", "team player", "go-getter", "hard worker", "strong work ethic", "I am a quick learner", "Enclosed please find", "Please find attached", "I am writing to", "I look forward to hearing from you", "Thank you for your consideration", "I believe I would", "synergy", "proactive", "self-starter".`;
+/**
+ * Build the LLM prompt for the requested output mode.
+ *
+ * Only sends keyword signals — never raw resume text.
+ * Uses impact_signals (skills + summary section, weight >= 0.8) as the
+ * candidate's strength summary, and gap_keywords for strategic gap framing.
+ *
+ * mode "draft"        — outreach email, max 250 words (Free tier baseline, LLM-enhanced on Pro)
+ * mode "cover_letter" — tailored cover letter, max 300 words, zero filler (Pro only, future)
+ */
+function buildPrompt(job, profile, resumeIntel, gapKeywords = [], mode = "draft") {
+    const experienceClause = profile.experience_years != null
+        ? `${profile.experience_years}+ years`
+        : "extensive experience";
+    // Cap signal lists to keep token usage low (Haiku: ~0.25¢/1K tokens)
+    const strengths = resumeIntel.impact_signals.slice(0, 12).join(", ") || "software engineering";
+    const gaps = gapKeywords.slice(0, 6).join(", ");
+    const gapsInstruction = gaps
+        ? `Gap keywords (acknowledge briefly as growth areas — do not apologise, do not skip): ${gaps}`
+        : "";
+    if (mode === "cover_letter") {
+        // TODO: Phase X — cover_letter mode (Pro only).
+        // Spec: under 300 words, zero generic filler, every sentence connects
+        // the candidate to this specific role. Paragraph structure:
+        //   1. Why this company/role specifically (1–2 sentences)
+        //   2. Strongest signal mapped to the role's core need (2–3 sentences)
+        //   3. Gap acknowledgement as motivation (1 sentence, only if gaps exist)
+        //   4. Clear call to action (1 sentence)
+        // For now fall through to draft mode until the feature ships.
+    }
+    // Draft mode — LLM-enhanced outreach email
+    return [
+        `Write a cold outreach email from a job candidate to a hiring team.`,
+        ``,
+        `Role: ${job.title}`,
+        `Company: ${job.company}`,
+        `Candidate experience: ${experienceClause}`,
+        `Candidate's strongest signals: ${strengths}`,
+        gapsInstruction,
+        ``,
+        `Output format (follow exactly):`,
+        `- First line: subject line prefixed with "Subject: "`,
+        `- One blank line`,
+        `- Email body: maximum 250 words — count before finishing and cut if over`,
+        ``,
+        `Writing requirements:`,
+        `- Opening: "Hi ${job.company} team,"`,
+        `- Bridge Sentence method: for each strength signal, identify the matching requirement`,
+        `  in this role and write one concrete sentence connecting them.`,
+        `  Example: "Because I [did X], I can solve your need for [Y] from day one."`,
+        `  Every paragraph must contain at least one Bridge Sentence.`,
+        `- First paragraph: connect the candidate's strongest 1–2 signals directly to what`,
+        `  this specific role needs — make the match feel specific and inevitable`,
+        `- Second paragraph: show how the candidate's background maps to a real challenge`,
+        `  this company faces — be concrete, not generic`,
+        `- If gap keywords are provided, one sentence frames them as active growth, not deficiency`,
+        `- Close with a single, low-friction call to action`,
+        `- Closing: "Best regards," on its own line, then "[Your Name]" on the next`,
+        `- Plain text only — no markdown, no bullet points`,
+        `- Do NOT invent specific projects, metrics, or company details`,
+        `- Do NOT include any placeholder other than [Your Name]`,
+    ]
+        .filter(Boolean)
+        .join("\n");
+}
+// ---------------------------------------------------------------------------
+// Provider API calls
+// ---------------------------------------------------------------------------
+async function callProvider(candidate, prompt, fetchFn) {
+    if (candidate.provider === "anthropic") {
+        return callAnthropic(candidate.apiKey, candidate.model, prompt, fetchFn);
+    }
+    return callOpenAI(candidate.apiKey, candidate.model, prompt, fetchFn, candidate.transport);
+}
+/** Exported for testing — same reference used by both API callers. */
+export { SYSTEM_PROMPT };
+async function callAnthropic(apiKey, model, prompt, fetchFn) {
+    const res = await fetchFn("https://api.anthropic.com/v1/messages", {
+        method: "POST",
+        headers: {
+            "Content-Type": "application/json",
+            "x-api-key": apiKey,
+            "anthropic-version": "2023-06-01",
+        },
+        body: JSON.stringify({
+            model,
+            max_tokens: 512,
+            system: SYSTEM_PROMPT,
+            messages: [{ role: "user", content: prompt }],
+        }),
+        signal: AbortSignal.timeout(HTTP_TIMEOUT_MS),
+    });
+    if (!res.ok) {
+        const body = await res.text().catch(() => "(no body)");
+        throw new Error(`Anthropic HTTP ${res.status}: ${body.slice(0, 200)}`);
+    }
+    const data = await res.json();
+    const text = data.content?.find((b) => b.type === "text")?.text ?? "";
+    if (!text)
+        throw new Error("Anthropic: empty response content");
+    return text;
+}
+function defaultOpenAITransport(model) {
+    const normalized = model.toLowerCase();
+    if (normalized.startsWith("gpt-4o"))
+        return "chat";
+    return "responses";
+}
+async function callOpenAI(apiKey, model, prompt, fetchFn, transport) {
+    const resolvedTransport = transport ?? defaultOpenAITransport(model);
+    if (resolvedTransport === "responses") {
+        return callOpenAIResponses(apiKey, model, prompt, fetchFn);
+    }
+    return callOpenAIChat(apiKey, model, prompt, fetchFn);
+}
+async function callOpenAIChat(apiKey, model, prompt, fetchFn) {
+    const res = await fetchFn("https://api.openai.com/v1/chat/completions", {
+        method: "POST",
+        headers: {
+            "Content-Type": "application/json",
+            "Authorization": `Bearer ${apiKey}`,
+        },
+        body: JSON.stringify({
+            model,
+            max_tokens: 512,
+            temperature: 0.7,
+            messages: [
+                { role: "system", content: SYSTEM_PROMPT },
+                { role: "user", content: prompt },
+            ],
+        }),
+        signal: AbortSignal.timeout(HTTP_TIMEOUT_MS),
+    });
+    if (!res.ok) {
+        const body = await res.text().catch(() => "(no body)");
+        throw new Error(`OpenAI chat HTTP ${res.status}: ${body.slice(0, 200)}`);
+    }
+    const data = await res.json();
+    const content = data.choices?.[0]?.message?.content;
+    if (typeof content === "string" && content.trim()) {
+        return content;
+    }
+    if (Array.isArray(content)) {
+        const text = content
+            .filter((part) => part?.type === "text" && typeof part.text === "string")
+            .map((part) => part.text ?? "")
+            .join("")
+            .trim();
+        if (text)
+            return text;
+    }
+    throw new Error("OpenAI chat: empty response content");
+}
+async function callOpenAIResponses(apiKey, model, prompt, fetchFn) {
+    const res = await fetchFn("https://api.openai.com/v1/responses", {
+        method: "POST",
+        headers: {
+            "Content-Type": "application/json",
+            "Authorization": `Bearer ${apiKey}`,
+        },
+        body: JSON.stringify({
+            model,
+            max_output_tokens: 512,
+            temperature: 0.7,
+            input: [
+                {
+                    role: "system",
+                    content: [{ type: "input_text", text: SYSTEM_PROMPT }],
+                },
+                {
+                    role: "user",
+                    content: [{ type: "input_text", text: prompt }],
+                },
+            ],
+        }),
+        signal: AbortSignal.timeout(HTTP_TIMEOUT_MS),
+    });
+    if (!res.ok) {
+        const body = await res.text().catch(() => "(no body)");
+        throw new Error(`OpenAI responses HTTP ${res.status}: ${body.slice(0, 200)}`);
+    }
+    const data = await res.json();
+    if (typeof data.output_text === "string" && data.output_text.trim()) {
+        return data.output_text;
+    }
+    const text = (data.output ?? [])
+        .flatMap((item) => item.content ?? [])
+        .filter((part) => part?.type === "output_text" && typeof part.text === "string")
+        .map((part) => part.text ?? "")
+        .join("")
+        .trim();
+    if (!text) {
+        throw new Error("OpenAI responses: empty response content");
+    }
+    return text;
+}
+// ---------------------------------------------------------------------------
+// Response parsing
+// ---------------------------------------------------------------------------
+/**
+ * Extract subject and body from raw LLM text.
+ *
+ * Expected format:
+ *   Subject: <subject line>
+ *   <blank line>
+ *   <body...>
+ *
+ * Returns null if the response cannot be parsed — caller treats as failure.
+ */
+function parseResponse(text, job) {
+    const lines = text.trim().split(/\r?\n/);
+    // Find subject line (must start with "Subject:")
+    const subjectIdx = lines.findIndex((l) => l.trimStart().toLowerCase().startsWith("subject:"));
+    if (subjectIdx === -1)
+        return null;
+    const subject = lines[subjectIdx]
+        .replace(/^subject:\s*/i, "")
+        .trim();
+    if (!subject)
+        return null;
+    // Body is everything after the subject (skip blank separator line)
+    let bodyStart = subjectIdx + 1;
+    while (bodyStart < lines.length && lines[bodyStart].trim() === "") {
+        bodyStart++;
+    }
+    const body = lines.slice(bodyStart).join("\n").trim();
+    if (!body)
+        return null;
+    // Sanity check: body must mention the company (guards against hallucination)
+    if (!body.toLowerCase().includes(job.company.toLowerCase().slice(0, 6))) {
+        return null;
+    }
+    return { subject, body };
+}
+//# sourceMappingURL=llm-enhance.js.map

package/dist/llm-enhance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-enhance.js","sourceRoot":"","sources":["../src/llm-enhance.ts"],"names":[],"mappings":"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"}

package/dist/matching/engine.d.ts

@@ -0,0 +1,31 @@
+/**
+ * matching/engine.ts — Matching engine orchestrator.
+ *
+ * `rankJobs()` is the single entry point for the briefing pipeline's
+ * ranking step. It scores every job against the user profile, filters
+ * out irrelevant jobs via the signal gate, sorts descending by composite
+ * score, and returns the top-K results as `ScoredJob[]`.
+ *
+ * Two-stage retrieval pipeline:
+ *   Stage 1 (Multiplier): compositeScore() — keyword overlap gates the
+ *     magnitude of the total score. Zero keyword overlap → score of 0.0.
+ *   Stage 2 (Gate): minKeywordScore filter — hard boundary that removes
+ *     any job below the minimum technical relevance threshold before
+ *     ranking. Prevents irrelevant jobs floating on neutral dimension
+ *     scores (the "dentist problem").
+ *
+ * Downstream layers (gap analysis, drafting, tracking) only consume
+ * `ScoredJob[]` — they are score-agnostic.
+ */
+import type { NormalizedJob, UserProfile, ScoredJob } from "../models.js";
+/**
+ * Score, filter, and rank jobs against a user profile.
+ *
+ * @param jobs           - Raw normalised jobs from source adapters
+ * @param profile        - User profile to rank against
+ * @param limit          - Maximum results to return (default: DEFAULT_TOP_K)
+ * @param minKeywordScore - Signal gate threshold; jobs with keyword score
+ *                         below this are dropped before ranking (default: 0.01)
+ */
+export declare function rankJobs(jobs: NormalizedJob[], profile: UserProfile, limit?: number, minKeywordScore?: number): ScoredJob[];
+//# sourceMappingURL=engine.d.ts.map

package/dist/matching/engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../src/matching/engine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAQ1E;;;;;;;;GAQG;AACH,wBAAgB,QAAQ,CACtB,IAAI,EAAE,aAAa,EAAE,EACrB,OAAO,EAAE,WAAW,EACpB,KAAK,GAAE,MAAsB,EAC7B,eAAe,GAAE,MAAa,GAC7B,SAAS,EAAE,CAgBb"}

package/dist/matching/engine.js

@@ -0,0 +1,51 @@
+/**
+ * matching/engine.ts — Matching engine orchestrator.
+ *
+ * `rankJobs()` is the single entry point for the briefing pipeline's
+ * ranking step. It scores every job against the user profile, filters
+ * out irrelevant jobs via the signal gate, sorts descending by composite
+ * score, and returns the top-K results as `ScoredJob[]`.
+ *
+ * Two-stage retrieval pipeline:
+ *   Stage 1 (Multiplier): compositeScore() — keyword overlap gates the
+ *     magnitude of the total score. Zero keyword overlap → score of 0.0.
+ *   Stage 2 (Gate): minKeywordScore filter — hard boundary that removes
+ *     any job below the minimum technical relevance threshold before
+ *     ranking. Prevents irrelevant jobs floating on neutral dimension
+ *     scores (the "dentist problem").
+ *
+ * Downstream layers (gap analysis, drafting, tracking) only consume
+ * `ScoredJob[]` — they are score-agnostic.
+ */
+import { DEFAULT_TOP_K } from "../config.js";
+import { compositeScore } from "./scoring.js";
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Score, filter, and rank jobs against a user profile.
+ *
+ * @param jobs           - Raw normalised jobs from source adapters
+ * @param profile        - User profile to rank against
+ * @param limit          - Maximum results to return (default: DEFAULT_TOP_K)
+ * @param minKeywordScore - Signal gate threshold; jobs with keyword score
+ *                         below this are dropped before ranking (default: 0.01)
+ */
+export function rankJobs(jobs, profile, limit = DEFAULT_TOP_K, minKeywordScore = 0.01) {
+    return jobs
+        .map((job) => {
+        const { total, breakdown, matched, gaps } = compositeScore(profile, job);
+        return {
+            job,
+            score: total,
+            breakdown,
+            matched_keywords: matched,
+            gap_keywords: gaps,
+        };
+    })
+        // Stage 2: drop jobs that fail the technical relevance gate
+        .filter((scored) => scored.breakdown.keyword >= minKeywordScore)
+        .sort((a, b) => b.score - a.score)
+        .slice(0, limit);
+}
+//# sourceMappingURL=engine.js.map

package/dist/matching/engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.js","sourceRoot":"","sources":["../../src/matching/engine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAGH,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9C,8EAA8E;AAC9E,aAAa;AACb,8EAA8E;AAE9E;;;;;;;;GAQG;AACH,MAAM,UAAU,QAAQ,CACtB,IAAqB,EACrB,OAAoB,EACpB,QAAgB,aAAa,EAC7B,kBAA0B,IAAI;IAE9B,OAAO,IAAI;SACR,GAAG,CAAC,CAAC,GAAG,EAAa,EAAE;QACtB,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,cAAc,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;QACzE,OAAO;YACL,GAAG;YACH,KAAK,EAAE,KAAK;YACZ,SAAS;YACT,gBAAgB,EAAE,OAAO;YACzB,YAAY,EAAE,IAAI;SACnB,CAAC;IACJ,CAAC,CAAC;QACF,4DAA4D;SAC3D,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,OAAO,IAAI,eAAe,CAAC;SAC/D,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC;SACjC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;AACrB,CAAC"}

package/dist/matching/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * matching/index.ts — Public matching API.
+ *
+ * Import from here rather than individual files.
+ */
+export { rankJobs } from "./engine.js";
+export { scoreKeyword, scoreExperience, scoreSalary, scoreWorkMode, compositeScore, } from "./scoring.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/matching/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/matching/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EACL,YAAY,EACZ,eAAe,EACf,WAAW,EACX,aAAa,EACb,cAAc,GACf,MAAM,cAAc,CAAC"}

package/dist/matching/index.js

@@ -0,0 +1,8 @@
+/**
+ * matching/index.ts — Public matching API.
+ *
+ * Import from here rather than individual files.
+ */
+export { rankJobs } from "./engine.js";
+export { scoreKeyword, scoreExperience, scoreSalary, scoreWorkMode, compositeScore, } from "./scoring.js";
+//# sourceMappingURL=index.js.map

package/dist/matching/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/matching/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EACL,YAAY,EACZ,eAAe,EACf,WAAW,EACX,aAAa,EACb,cAAc,GACf,MAAM,cAAc,CAAC"}