careerclaw-js 0.11.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/adapters/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,iBAAiB,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACjF,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC5D,YAAY,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/adapters/index.js

@@ -0,0 +1,9 @@
+/**
+ * adapters/index.ts — Public adapter API.
+ *
+ * Import adapters from here rather than individual files.
+ * sources.ts (Phase 3) will use fetchAll() to merge results.
+ */
+export { fetchRemoteOkJobs, parseRss, stripHtml, stableId } from "./remoteok.js";
+export { fetchHnJobs, parseComment } from "./hackernews.js";
+//# sourceMappingURL=index.js.map

package/dist/adapters/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/adapters/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,iBAAiB,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACjF,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/adapters/remoteok.d.ts

@@ -0,0 +1,35 @@
+/**
+ * adapters/remoteok.ts — RemoteOK RSS adapter.
+ *
+ * Fetches the RemoteOK RSS feed and normalises each <item> into a
+ * NormalizedJob. Parsing is split from fetching so contract tests can
+ * call parseRss() directly with fixture XML — no network mocking needed.
+ *
+ * RemoteOK RSS structure (abridged):
+ *   <item>
+ *     <title><![CDATA[Senior Engineer at Acme]]></title>
+ *     <link>https://remoteok.com/remote-jobs/123</link>
+ *     <pubDate>Mon, 03 Mar 2026 10:00:00 +0000</pubDate>
+ *     <description><![CDATA[<p>HTML description...</p>]]></description>
+ *     <location>Worldwide</location>          <!-- optional -->
+ *     <salary>$120,000 - $180,000</salary>    <!-- optional -->
+ *     <company><![CDATA[Acme Corp]]></company> <!-- optional -->
+ *     <tag>typescript</tag>                    <!-- 0-n tags -->
+ *   </item>
+ */
+import type { NormalizedJob } from "../models.js";
+/** Fetch the RemoteOK RSS feed and return normalised jobs. */
+export declare function fetchRemoteOkJobs(): Promise<NormalizedJob[]>;
+/**
+ * Parse a RemoteOK RSS XML string into NormalizedJob[].
+ * Exported for offline contract testing.
+ */
+export declare function parseRss(xml: string): NormalizedJob[];
+/**
+ * Strip HTML tags and decode common entities.
+ * Intentionally minimal — avoids a DOM/cheerio dependency.
+ */
+export declare function stripHtml(html: string): string;
+/** SHA-256(text) → first 16 hex chars (matches Python job_id convention). */
+export declare function stableId(text: string): string;
+//# sourceMappingURL=remoteok.d.ts.map

package/dist/adapters/remoteok.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remoteok.d.ts","sourceRoot":"","sources":["../../src/adapters/remoteok.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAKH,OAAO,KAAK,EAAE,aAAa,EAAY,MAAM,cAAc,CAAC;AA+B5D,8DAA8D;AAC9D,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC,CAiBlE;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,EAAE,CAqBrD;AAkHD;;;GAGG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAoB9C;AAED,6EAA6E;AAC7E,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE7C"}

package/dist/adapters/remoteok.js

@@ -0,0 +1,212 @@
+/**
+ * adapters/remoteok.ts — RemoteOK RSS adapter.
+ *
+ * Fetches the RemoteOK RSS feed and normalises each <item> into a
+ * NormalizedJob. Parsing is split from fetching so contract tests can
+ * call parseRss() directly with fixture XML — no network mocking needed.
+ *
+ * RemoteOK RSS structure (abridged):
+ *   <item>
+ *     <title><![CDATA[Senior Engineer at Acme]]></title>
+ *     <link>https://remoteok.com/remote-jobs/123</link>
+ *     <pubDate>Mon, 03 Mar 2026 10:00:00 +0000</pubDate>
+ *     <description><![CDATA[<p>HTML description...</p>]]></description>
+ *     <location>Worldwide</location>          <!-- optional -->
+ *     <salary>$120,000 - $180,000</salary>    <!-- optional -->
+ *     <company><![CDATA[Acme Corp]]></company> <!-- optional -->
+ *     <tag>typescript</tag>                    <!-- 0-n tags -->
+ *   </item>
+ */
+import { createHash } from "node:crypto";
+import { XMLParser } from "fast-xml-parser";
+import { utcNow } from "../models.js";
+import { HTTP_TIMEOUT_MS, REMOTEOK_RSS_URL, USER_AGENT, } from "../config.js";
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/** Fetch the RemoteOK RSS feed and return normalised jobs. */
+export async function fetchRemoteOkJobs() {
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), HTTP_TIMEOUT_MS);
+    try {
+        const res = await fetch(REMOTEOK_RSS_URL, {
+            signal: controller.signal,
+            headers: { "User-Agent": USER_AGENT },
+        });
+        if (!res.ok) {
+            throw new Error(`RemoteOK RSS returned HTTP ${res.status}`);
+        }
+        const xml = await res.text();
+        return parseRss(xml);
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+/**
+ * Parse a RemoteOK RSS XML string into NormalizedJob[].
+ * Exported for offline contract testing.
+ */
+export function parseRss(xml) {
+    const parser = new XMLParser({
+        ignoreAttributes: false,
+        cdataPropName: "__cdata",
+        isArray: (_name, jpath) => jpath === "rss.channel.item",
+    });
+    const feed = parser.parse(xml);
+    const rawItems = feed?.rss?.channel?.item;
+    if (!rawItems)
+        return [];
+    const items = Array.isArray(rawItems) ? rawItems : [rawItems];
+    const fetched_at = utcNow();
+    return items.flatMap((item) => {
+        try {
+            return [normaliseItem(item, fetched_at)];
+        }
+        catch {
+            // Skip malformed items rather than aborting the whole feed
+            return [];
+        }
+    });
+}
+// ---------------------------------------------------------------------------
+// Internal helpers
+// ---------------------------------------------------------------------------
+function normaliseItem(item, fetched_at) {
+    const rawTitle = coerceString(item.title);
+    const url = coerceString(item.link);
+    const rawDescription = stripHtml(coerceString(item.description));
+    const rawLocation = coerceString(item.location);
+    const rawSalary = coerceString(item.salary);
+    const rawCompany = coerceString(item.company);
+    const { title, company } = parseTitle(rawTitle, rawCompany);
+    const { salary_min, salary_max } = parseSalary(rawSalary, rawDescription);
+    const work_mode = inferWorkMode(rawLocation, rawDescription);
+    const experience_years = inferExperienceYears(rawDescription);
+    // Combine location tag with description inference
+    const location = rawLocation || inferLocationLabel(rawDescription);
+    return {
+        job_id: stableId(url || `${company}:${title}`),
+        title,
+        company,
+        location,
+        description: rawDescription,
+        url,
+        source: "remoteok",
+        salary_min,
+        salary_max,
+        work_mode,
+        experience_years,
+        posted_at: parsePubDate(coerceString(item.pubDate)),
+        fetched_at,
+    };
+}
+/**
+ * Split "Senior Engineer at Acme Corp" → { title, company }.
+ * Falls back to raw company field if present, then empty string.
+ */
+function parseTitle(raw, companyField) {
+    const atIdx = raw.lastIndexOf(" at ");
+    if (atIdx > 0) {
+        return {
+            title: raw.slice(0, atIdx).trim(),
+            company: raw.slice(atIdx + 4).trim(),
+        };
+    }
+    return { title: raw.trim(), company: companyField.trim() };
+}
+/** Parse "$120,000 - $180,000" or "$120k - $180k" into annualised USD. */
+function parseSalary(salaryField, description) {
+    const src = salaryField || description;
+    // Match patterns: $120,000-$180,000 | $120k-$180k | 120000-180000
+    const m = src.match(/\$?([\d,]+)\s*k?\s*[-–to]+\s*\$?([\d,]+)\s*k?/i);
+    if (!m)
+        return { salary_min: null, salary_max: null };
+    const parse = (raw, isK) => {
+        const n = parseInt(raw.replace(/,/g, ""), 10);
+        return isK || n < 1_000 ? n * 1_000 : n;
+    };
+    const rawMin = m[1] ?? "";
+    const rawMax = m[2] ?? "";
+    const isK = /k/i.test(salaryField || "");
+    return {
+        salary_min: parse(rawMin, isK),
+        salary_max: parse(rawMax, isK),
+    };
+}
+function inferWorkMode(location, description) {
+    const text = `${location} ${description}`.toLowerCase();
+    if (/\bhybrid\b/.test(text))
+        return "hybrid";
+    if (/\bremote\b/.test(text))
+        return "remote";
+    if (/\bon-?site\b|\bin-?office\b/.test(text))
+        return "onsite";
+    return null;
+}
+function inferLocationLabel(description) {
+    if (/\bworldwide\b|\banywhere\b/i.test(description))
+        return "Worldwide";
+    if (/\bremote\b/i.test(description))
+        return "Remote";
+    return "";
+}
+function inferExperienceYears(text) {
+    const m = text.match(/(\d+)\+?\s*(?:or more\s+)?years?\s+(?:of\s+)?experience/i);
+    return m && m[1] ? parseInt(m[1], 10) : null;
+}
+function parsePubDate(raw) {
+    if (!raw)
+        return null;
+    try {
+        return new Date(raw).toISOString();
+    }
+    catch {
+        return null;
+    }
+}
+// ---------------------------------------------------------------------------
+// Shared utilities
+// ---------------------------------------------------------------------------
+/**
+ * Strip HTML tags and decode common entities.
+ * Intentionally minimal — avoids a DOM/cheerio dependency.
+ */
+export function stripHtml(html) {
+    return html
+        .replace(/<br\s*\/?>/gi, "\n")
+        .replace(/<p[^>]*>/gi, "\n") // opening <p> → newline (creates split point)
+        .replace(/<\/p>/gi, "")
+        .replace(/<[^>]+>/g, "")
+        .replace(/&amp;/g, "&")
+        .replace(/&lt;/g, "<")
+        .replace(/&gt;/g, ">")
+        .replace(/&quot;/g, '"')
+        .replace(/&#x27;/g, "'")
+        .replace(/&#39;/g, "'")
+        .replace(/&apos;/g, "'")
+        .replace(/&#x2F;/gi, "/")
+        .replace(/&#x([0-9a-f]{1,6});/gi, (_, hex) => String.fromCodePoint(parseInt(hex, 16)))
+        .replace(/&nbsp;/g, " ")
+        .replace(/\n{3,}/g, "\n\n")
+        .trim();
+}
+/** SHA-256(text) → first 16 hex chars (matches Python job_id convention). */
+export function stableId(text) {
+    return createHash("sha256").update(text).digest("hex").slice(0, 16);
+}
+/** Safely coerce a parsed value to string (fast-xml-parser can return numbers). */
+function coerceString(val) {
+    if (val === null || val === undefined)
+        return "";
+    if (typeof val === "string")
+        return val;
+    if (typeof val === "number")
+        return String(val);
+    // CDATA objects from fast-xml-parser
+    if (typeof val === "object" && val !== null && "__cdata" in val) {
+        return String(val["__cdata"] ?? "");
+    }
+    return "";
+}
+//# sourceMappingURL=remoteok.js.map

package/dist/adapters/remoteok.js.map

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

package/dist/briefing.d.ts

@@ -0,0 +1,81 @@
+/**
+ * briefing.ts — Daily briefing pipeline orchestrator.
+ *
+ * `runBriefing()` is the single entry point that wires every module
+ * into the complete end-to-end workflow:
+ *
+ *   fetch → deduplicate → rank → draft → persist → return bundle
+ *
+ * Design principles (from Phase 4 architecture doc):
+ *   - Skill-first: accepts UserProfile as a parameter, not a file path.
+ *     The caller (CLI or OpenClaw agent) is responsible for loading the
+ *     profile; the orchestrator never touches the filesystem for input.
+ *   - Dual-mode output: structured BriefingResult JSON for agents +
+ *     per-stage timings for observability.
+ *   - Dry-run: suppresses all writes; counts are still accurate.
+ *   - Testable: fetchFn and repo are injectable; no live network calls
+ *     required in tests.
+ *   - Graceful degradation: if the fetch stage returns zero jobs (e.g.
+ *     both adapters failed), the pipeline short-circuits cleanly with
+ *     an empty result rather than crashing.
+ */
+import type { UserProfile, BriefingResult, ResumeIntelligence } from "./models.js";
+import { type FetchResult } from "./sources.js";
+import { type EnhanceOptions } from "./llm-enhance.js";
+import { type CheckLicenseOptions } from "./license.js";
+import { TrackingRepository } from "./tracking.js";
+export interface BriefingOptions {
+    /** Number of top matches to return (default: DEFAULT_TOP_K = 3). */
+    topK?: number;
+    /** Suppress all file writes when true. Counts remain accurate. */
+    dryRun?: boolean;
+    /**
+     * Injectable fetch function — defaults to the real fetchAllJobs().
+     * Pass a stub in tests to avoid live network calls.
+     */
+    fetchFn?: () => Promise<FetchResult>;
+    /**
+     * Injectable TrackingRepository — defaults to a new instance with
+     * standard paths. Pass a tmpdir-backed instance in tests.
+     */
+    repo?: TrackingRepository;
+    /**
+     * Resume intelligence from buildResumeIntelligence().
+     * Required for LLM draft enhancement — ignored when proKey is absent.
+     */
+    resumeIntel?: ResumeIntelligence;
+    /**
+     * CareerClaw Pro license key (CAREERCLAW_PRO_KEY).
+     * Validated against Gumroad before enabling LLM-enhanced drafts.
+     * Falls back to deterministic draft if validation fails.
+     */
+    proKey?: string;
+    /**
+     * Injectable fetch for the LLM API calls — passed through to enhanceDraft().
+     * Defaults to global fetch. Pass a stub in tests.
+     */
+    enhanceFetchFn?: EnhanceOptions["fetchFn"];
+    /**
+     * Injectable fetch for the Gumroad license API call.
+     * Defaults to global fetch. Pass a stub in tests.
+     */
+    licenseFetchFn?: CheckLicenseOptions["fetchFn"];
+    /**
+     * Override the license cache file path — for tests using a tmpdir.
+     */
+    licenseCachePath?: string;
+}
+/**
+ * Run a full briefing pipeline for the given user profile.
+ *
+ * Stages and timings:
+ *   1. fetch_ms  — fetch + deduplicate jobs from all sources
+ *   2. rank_ms   — score and rank jobs against profile
+ *   3. draft_ms  — generate one OutreachDraft per top match
+ *   4. persist_ms — upsert tracking entries + append run record
+ *
+ * @param profile - User profile (passed in by caller, not loaded here)
+ * @param options - Injection points and run flags
+ */
+export declare function runBriefing(profile: UserProfile, options?: BriefingOptions): Promise<BriefingResult>;
+//# sourceMappingURL=briefing.d.ts.map

package/dist/briefing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"briefing.d.ts","sourceRoot":"","sources":["../src/briefing.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAIH,OAAO,KAAK,EACV,WAAW,EAIX,cAAc,EACd,kBAAkB,EACnB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAgB,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AAG9D,OAAO,EAAgB,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACrE,OAAO,EAAgB,KAAK,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACtE,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAOnD,MAAM,WAAW,eAAe;IAC9B,oEAAoE;IACpE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,kEAAkE;IAClE,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,OAAO,CAAC,WAAW,CAAC,CAAC;IACrC;;;OAGG;IACH,IAAI,CAAC,EAAE,kBAAkB,CAAC;IAC1B;;;OAGG;IACH,WAAW,CAAC,EAAE,kBAAkB,CAAC;IACjC;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,cAAc,CAAC,EAAE,cAAc,CAAC,SAAS,CAAC,CAAC;IAC3C;;;OAGG;IACH,cAAc,CAAC,EAAE,mBAAmB,CAAC,SAAS,CAAC,CAAC;IAChD;;OAEG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAMD;;;;;;;;;;;GAWG;AACH,wBAAsB,WAAW,CAC/B,OAAO,EAAE,WAAW,EACpB,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,cAAc,CAAC,CAwHzB"}

package/dist/briefing.js

@@ -0,0 +1,152 @@
+/**
+ * briefing.ts — Daily briefing pipeline orchestrator.
+ *
+ * `runBriefing()` is the single entry point that wires every module
+ * into the complete end-to-end workflow:
+ *
+ *   fetch → deduplicate → rank → draft → persist → return bundle
+ *
+ * Design principles (from Phase 4 architecture doc):
+ *   - Skill-first: accepts UserProfile as a parameter, not a file path.
+ *     The caller (CLI or OpenClaw agent) is responsible for loading the
+ *     profile; the orchestrator never touches the filesystem for input.
+ *   - Dual-mode output: structured BriefingResult JSON for agents +
+ *     per-stage timings for observability.
+ *   - Dry-run: suppresses all writes; counts are still accurate.
+ *   - Testable: fetchFn and repo are injectable; no live network calls
+ *     required in tests.
+ *   - Graceful degradation: if the fetch stage returns zero jobs (e.g.
+ *     both adapters failed), the pipeline short-circuits cleanly with
+ *     an empty result rather than crashing.
+ */
+import { randomUUID } from "crypto";
+import { createRequire } from "module";
+import { fetchAllJobs } from "./sources.js";
+import { rankJobs } from "./matching/index.js";
+import { draftOutreach } from "./drafting.js";
+import { enhanceDraft } from "./llm-enhance.js";
+import { checkLicense } from "./license.js";
+import { TrackingRepository } from "./tracking.js";
+import { DEFAULT_TOP_K } from "./config.js";
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Run a full briefing pipeline for the given user profile.
+ *
+ * Stages and timings:
+ *   1. fetch_ms  — fetch + deduplicate jobs from all sources
+ *   2. rank_ms   — score and rank jobs against profile
+ *   3. draft_ms  — generate one OutreachDraft per top match
+ *   4. persist_ms — upsert tracking entries + append run record
+ *
+ * @param profile - User profile (passed in by caller, not loaded here)
+ * @param options - Injection points and run flags
+ */
+export async function runBriefing(profile, options = {}) {
+    const { topK = DEFAULT_TOP_K, dryRun = false, fetchFn = fetchAllJobs, repo = new TrackingRepository({ dryRun }), resumeIntel, proKey, enhanceFetchFn, licenseFetchFn, licenseCachePath, } = options;
+    // Validate Pro license before enabling LLM enhancement.
+    // Runs only when proKey is present; result degrades gracefully on network
+    // failure (cached result used for up to LICENSE_CACHE_TTL_MS = 7 days).
+    let isProActive = false;
+    if (proKey && proKey.trim().length > 0 && resumeIntel) {
+        const licenseOptions = {};
+        if (licenseFetchFn !== undefined)
+            licenseOptions.fetchFn = licenseFetchFn;
+        if (licenseCachePath !== undefined)
+            licenseOptions.cachePath = licenseCachePath;
+        const licenseResult = await checkLicense(proKey, licenseOptions);
+        isProActive = licenseResult.valid;
+    }
+    const runAt = new Date().toISOString();
+    const runId = randomUUID();
+    const version = readPackageVersion();
+    // -------------------------------------------------------------------------
+    // Stage 1: Fetch + deduplicate
+    // -------------------------------------------------------------------------
+    const fetchStart = Date.now();
+    let fetchResult;
+    try {
+        fetchResult = await fetchFn();
+    }
+    catch {
+        // Catastrophic fetch failure — return an empty result rather than throwing
+        fetchResult = { jobs: [], counts: {}, errors: {} };
+    }
+    const fetchMs = Date.now() - fetchStart;
+    const { jobs, counts: sourceCounts } = fetchResult;
+    // -------------------------------------------------------------------------
+    // Stage 2: Rank
+    // -------------------------------------------------------------------------
+    const rankStart = Date.now();
+    const matches = jobs.length > 0 ? rankJobs(jobs, profile, topK) : [];
+    const rankMs = Date.now() - rankStart;
+    // -------------------------------------------------------------------------
+    // Stage 3: Draft
+    // -------------------------------------------------------------------------
+    const draftStart = Date.now();
+    const drafts = await Promise.all(matches.map(async (scored) => {
+        const baseline = draftOutreach(scored.job, profile, scored.matched_keywords);
+        if (isProActive) {
+            return enhanceDraft(scored.job, profile, resumeIntel, baseline, scored.gap_keywords, enhanceFetchFn !== undefined ? { fetchFn: enhanceFetchFn } : {});
+        }
+        return baseline;
+    }));
+    const draftMs = Date.now() - draftStart;
+    // -------------------------------------------------------------------------
+    // Stage 4: Persist
+    // -------------------------------------------------------------------------
+    const persistStart = Date.now();
+    const trackingResult = repo.upsertEntries(matches.map((s) => s.job), matches);
+    const run = {
+        run_id: runId,
+        run_at: runAt,
+        dry_run: dryRun,
+        jobs_fetched: jobs.length,
+        jobs_ranked: jobs.length,
+        jobs_matched: matches.length,
+        sources: sourceCounts,
+        timings: {
+            fetch_ms: fetchMs,
+            rank_ms: rankMs,
+            draft_ms: draftMs,
+            persist_ms: null, // filled below after appendRun
+        },
+        version,
+    };
+    repo.appendRun(run);
+    const persistMs = Date.now() - persistStart;
+    // Back-fill persist_ms (the field exists for observability; the run
+    // record on disk will have null for persist_ms — that is acceptable
+    // and consistent with the Python implementation)
+    run.timings.persist_ms = persistMs;
+    // -------------------------------------------------------------------------
+    // Result bundle
+    // -------------------------------------------------------------------------
+    return {
+        run,
+        matches,
+        drafts,
+        tracking: {
+            created: trackingResult.created,
+            already_present: trackingResult.already_present,
+        },
+        dry_run: dryRun,
+    };
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/** Read the package version from package.json at runtime. */
+function readPackageVersion() {
+    try {
+        const require = createRequire(import.meta.url);
+        // Walk up from src/ to find package.json
+        const pkg = require("../package.json");
+        return pkg.version;
+    }
+    catch {
+        return "unknown";
+    }
+}
+//# sourceMappingURL=briefing.js.map

package/dist/briefing.js.map

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

package/dist/cli.d.ts

@@ -0,0 +1,22 @@
+#!/usr/bin/env node
+/**
+ * cli.ts — CareerClaw command-line entry point.
+ *
+ * Usage:
+ *   npx careerclaw-js [options]
+ *   node --env-file=.env dist/cli.js [options]
+ *
+ * Options:
+ *   --profile PATH     Path to profile.json (default: ~/.careerclaw/profile.json)
+ *   --resume-txt PATH  Plain-text resume file to enhance matching
+ *   --top-k INT        Number of top matches to return (default: 3)
+ *   --dry-run          Run without writing tracking or run log
+ *   --json             Print JSON output only (machine-readable; no colour)
+ *   --help             Print this help message and exit
+ *
+ * Exit codes:
+ *   0 — briefing completed (even if 0 matches — not an error)
+ *   1 — fatal error (profile not found, unreadable, or invalid JSON)
+ */
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;;GAkBG"}