careerclaw-js 0.11.0

package/dist/resume-intel.js

@@ -0,0 +1,111 @@
+/**
+ * resume-intel.ts — Section-aware resume intelligence builder.
+ *
+ * `buildResumeIntelligence()` extracts a weighted keyword/phrase corpus
+ * from multiple resume/profile inputs. Each source has a section weight
+ * (from SECTION_WEIGHTS) that determines how important its tokens are
+ * for gap analysis.
+ *
+ * Key design from PR-E: UserProfile.skills are injected as a synthetic
+ * "skills" section at weight 1.0 — the highest weight. This prevents
+ * skills the user explicitly listed from appearing as gaps.
+ *
+ * Output schema is JSON-compatible with Python careerclaw so
+ * `.careerclaw/resume_intel.json` files are portable across
+ * implementations.
+ */
+import { tokenizeUnique, extractPhrasesFromText, SECTION_WEIGHTS, } from "./core/text-processing.js";
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Build section-aware resume intelligence from available inputs.
+ *
+ * Sections processed (highest weight first):
+ *   1. skills        (weight 1.0)  — UserProfile.skills list
+ *   2. summary       (weight 0.8)  — resume_summary + target_roles
+ *   3. experience    (weight 0.6)  — resume_text (if provided)
+ *
+ * For each keyword, the final keyword_weight is the maximum weight
+ * across all sections in which it appeared.
+ */
+export function buildResumeIntelligence(params) {
+    const { resume_summary, resume_text, skills = [], target_roles = [] } = params;
+    // Determine source flag
+    const hasSkills = skills.length > 0 || target_roles.length > 0;
+    const hasResumeText = !!resume_text?.trim();
+    const source = hasSkills
+        ? "skills_injected"
+        : hasResumeText
+            ? "resume_text"
+            : "summary_only";
+    // Collect (tokens, weight) pairs per section
+    const sections = [];
+    // Section 1: skills (weight 1.0)
+    if (skills.length > 0) {
+        sections.push({
+            tokens: tokenizeUnique(skills.join(" ")),
+            weight: SECTION_WEIGHTS["skills"] ?? 1.0,
+        });
+    }
+    // Section 2: summary + target_roles (weight 0.8)
+    const summaryText = [resume_summary, ...target_roles].join(" ");
+    if (summaryText.trim()) {
+        sections.push({
+            tokens: tokenizeUnique(summaryText),
+            weight: SECTION_WEIGHTS["summary"] ?? 0.8,
+        });
+    }
+    // Section 3: full resume text (weight 0.6)
+    if (hasResumeText) {
+        sections.push({
+            tokens: tokenizeUnique(resume_text),
+            weight: SECTION_WEIGHTS["experience"] ?? 0.6,
+        });
+    }
+    // Build keyword_weights: max weight across sections
+    const keyword_weights = {};
+    const keyword_stream = [];
+    for (const { tokens, weight } of sections) {
+        for (const token of tokens) {
+            const existing = keyword_weights[token] ?? 0;
+            if (existing === 0)
+                keyword_stream.push(token); // first appearance
+            keyword_weights[token] = Math.max(existing, weight);
+        }
+    }
+    // extracted_keywords = unique set (insertion order)
+    const extracted_keywords = [...new Set(keyword_stream)];
+    // impact_signals = keywords with weight >= 0.8 (skills + summary section)
+    const impact_signals = extracted_keywords.filter((k) => (keyword_weights[k] ?? 0) >= 0.8);
+    // Phrases: extract from combined text of all sections
+    const allText = [
+        skills.join(" "),
+        target_roles.join(" "),
+        resume_summary,
+        resume_text ?? "",
+    ]
+        .filter(Boolean)
+        .join(" ");
+    const phrase_stream = extractPhrasesFromText(allText);
+    const extracted_phrases = [...new Set(phrase_stream)];
+    // phrase_weights: use the weight of the lower-weight component token
+    // (conservative — a phrase is only as strong as its weakest token)
+    const phrase_weights = {};
+    for (const phrase of extracted_phrases) {
+        const parts = phrase.split(" ");
+        const minWeight = Math.min(...parts.map((p) => keyword_weights[p] ?? SECTION_WEIGHTS["other"] ?? 0.3));
+        phrase_weights[phrase] = minWeight;
+    }
+    return {
+        extracted_keywords,
+        extracted_phrases,
+        keyword_stream,
+        phrase_stream,
+        impact_signals,
+        keyword_weights,
+        phrase_weights,
+        source,
+    };
+}
+//# sourceMappingURL=resume-intel.js.map

package/dist/resume-intel.js.map

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

package/dist/sources.d.ts

@@ -0,0 +1,32 @@
+/**
+ * sources.ts — Source aggregation layer.
+ *
+ * `fetchAllJobs()` is the single entry point for the briefing pipeline.
+ * It calls both adapters independently (per-source error isolation), merges
+ * results, and deduplicates by `job_id` (first-seen wins).
+ *
+ * Downstream layers (matching engine, gap analysis) are source-agnostic —
+ * they only see `NormalizedJob[]`.
+ */
+import type { NormalizedJob, JobSource } from "./models.js";
+export interface FetchResult {
+    jobs: NormalizedJob[];
+    /** Per-source job counts for run instrumentation. */
+    counts: Partial<Record<JobSource, number>>;
+    /** Per-source errors — non-empty means a source was degraded. */
+    errors: Partial<Record<JobSource, string>>;
+}
+/**
+ * Fetch jobs from all configured sources and return a deduplicated list.
+ *
+ * Failures in individual sources are caught and recorded in `errors` —
+ * the pipeline continues with whatever sources succeeded. This mirrors
+ * the Python careerclaw per-source resilience pattern.
+ */
+export declare function fetchAllJobs(): Promise<FetchResult>;
+/**
+ * Deduplicate a list of jobs by `job_id`.
+ * First-seen wins — preserves RemoteOK order before HN order.
+ */
+export declare function deduplicate(jobs: NormalizedJob[]): NormalizedJob[];
+//# sourceMappingURL=sources.d.ts.map

package/dist/sources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sources.d.ts","sourceRoot":"","sources":["../src/sources.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAQ5D,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,aAAa,EAAE,CAAC;IACtB,qDAAqD;IACrD,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC;IAC3C,iEAAiE;IACjE,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC;CAC5C;AAMD;;;;;;GAMG;AACH,wBAAsB,YAAY,IAAI,OAAO,CAAC,WAAW,CAAC,CAgCzD;AAMD;;;GAGG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,aAAa,EAAE,GAAG,aAAa,EAAE,CAUlE"}

package/dist/sources.js

@@ -0,0 +1,72 @@
+/**
+ * sources.ts — Source aggregation layer.
+ *
+ * `fetchAllJobs()` is the single entry point for the briefing pipeline.
+ * It calls both adapters independently (per-source error isolation), merges
+ * results, and deduplicates by `job_id` (first-seen wins).
+ *
+ * Downstream layers (matching engine, gap analysis) are source-agnostic —
+ * they only see `NormalizedJob[]`.
+ */
+import { fetchRemoteOkJobs } from "./adapters/remoteok.js";
+import { fetchHnJobs } from "./adapters/hackernews.js";
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Fetch jobs from all configured sources and return a deduplicated list.
+ *
+ * Failures in individual sources are caught and recorded in `errors` —
+ * the pipeline continues with whatever sources succeeded. This mirrors
+ * the Python careerclaw per-source resilience pattern.
+ */
+export async function fetchAllJobs() {
+    const counts = {};
+    const errors = {};
+    const allJobs = [];
+    // Run both adapters concurrently; isolate failures per source
+    const [remoteokResult, hnResult] = await Promise.allSettled([
+        fetchRemoteOkJobs(),
+        fetchHnJobs(),
+    ]);
+    if (remoteokResult.status === "fulfilled") {
+        counts["remoteok"] = remoteokResult.value.length;
+        allJobs.push(...remoteokResult.value);
+    }
+    else {
+        errors["remoteok"] = String(remoteokResult.reason);
+        counts["remoteok"] = 0;
+    }
+    if (hnResult.status === "fulfilled") {
+        counts["hackernews"] = hnResult.value.length;
+        allJobs.push(...hnResult.value);
+    }
+    else {
+        errors["hackernews"] = String(hnResult.reason);
+        counts["hackernews"] = 0;
+    }
+    return {
+        jobs: deduplicate(allJobs),
+        counts,
+        errors,
+    };
+}
+// ---------------------------------------------------------------------------
+// Deduplication
+// ---------------------------------------------------------------------------
+/**
+ * Deduplicate a list of jobs by `job_id`.
+ * First-seen wins — preserves RemoteOK order before HN order.
+ */
+export function deduplicate(jobs) {
+    const seen = new Set();
+    const result = [];
+    for (const job of jobs) {
+        if (!seen.has(job.job_id)) {
+            seen.add(job.job_id);
+            result.push(job);
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=sources.js.map

package/dist/sources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sources.js","sourceRoot":"","sources":["../src/sources.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAcvD,8EAA8E;AAC9E,aAAa;AACb,8EAA8E;AAE9E;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY;IAChC,MAAM,MAAM,GAAuC,EAAE,CAAC;IACtD,MAAM,MAAM,GAAuC,EAAE,CAAC;IACtD,MAAM,OAAO,GAAoB,EAAE,CAAC;IAEpC,8DAA8D;IAC9D,MAAM,CAAC,cAAc,EAAE,QAAQ,CAAC,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC;QAC1D,iBAAiB,EAAE;QACnB,WAAW,EAAE;KACd,CAAC,CAAC;IAEH,IAAI,cAAc,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;QAC1C,MAAM,CAAC,UAAU,CAAC,GAAG,cAAc,CAAC,KAAK,CAAC,MAAM,CAAC;QACjD,OAAO,CAAC,IAAI,CAAC,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;IACxC,CAAC;SAAM,CAAC;QACN,MAAM,CAAC,UAAU,CAAC,GAAG,MAAM,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;QACnD,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;IACzB,CAAC;IAED,IAAI,QAAQ,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;QACpC,MAAM,CAAC,YAAY,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC;QAC7C,OAAO,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAClC,CAAC;SAAM,CAAC;QACN,MAAM,CAAC,YAAY,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QAC/C,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC;IAED,OAAO;QACL,IAAI,EAAE,WAAW,CAAC,OAAO,CAAC;QAC1B,MAAM;QACN,MAAM;KACP,CAAC;AACJ,CAAC;AAED,8EAA8E;AAC9E,gBAAgB;AAChB,8EAA8E;AAE9E;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,IAAqB;IAC/C,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,MAAM,GAAoB,EAAE,CAAC;IACnC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;YAC1B,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YACrB,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACnB,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/tracking.d.ts

@@ -0,0 +1,68 @@
+/**
+ * tracking.ts — Persistence layer for tracking.json and runs.jsonl.
+ *
+ * `TrackingRepository` manages two runtime files under `.careerclaw/`:
+ *
+ *   tracking.json  — keyed object of TrackingEntry records, one per
+ *                    saved job_id. First-seen wins for status; re-runs
+ *                    update `last_seen_at` only.
+ *
+ *   runs.jsonl     — append-only newline-delimited JSON log; one
+ *                    BriefingRun per line. Never rewritten, only grown.
+ *
+ * Dry-run mode: all write operations are no-ops. The repository is
+ * fully functional for reads; callers can inspect what *would* have
+ * been written via the return values of upsertEntry() / appendRun().
+ *
+ * The runtime directory is created automatically on first write if it
+ * does not exist.
+ */
+import type { TrackingEntry, BriefingRun, NormalizedJob, ScoredJob } from "./models.js";
+/** In-memory store: job_id → TrackingEntry. */
+type TrackingStore = Record<string, TrackingEntry>;
+export interface UpsertResult {
+    /** Number of new entries created this call. */
+    created: number;
+    /** Number of entries already present (last_seen_at updated). */
+    already_present: number;
+}
+export declare class TrackingRepository {
+    private readonly trackingPath;
+    private readonly runsPath;
+    private readonly dryRun;
+    constructor(options?: {
+        trackingPath?: string;
+        runsPath?: string;
+        dryRun?: boolean;
+    });
+    /**
+     * Load tracking.json from disk.
+     * Returns an empty store when the file does not yet exist.
+     */
+    load(): TrackingStore;
+    /**
+     * Persist the in-memory store to tracking.json.
+     * No-op in dry-run mode.
+     */
+    save(store: TrackingStore): void;
+    /**
+     * Upsert a batch of jobs into the tracking store.
+     *
+     * Behaviour:
+     *   - New job_id → creates a TrackingEntry with status "saved"
+     *   - Existing job_id → updates last_seen_at only; status is preserved
+     *
+     * Writes the updated store to disk unless dry-run.
+     * Returns counts of created vs already_present entries.
+     */
+    upsertEntries(jobs: NormalizedJob[], scored?: ScoredJob[]): UpsertResult;
+    /**
+     * Append a BriefingRun record to runs.jsonl.
+     * Each call adds exactly one newline-terminated JSON line.
+     * No-op in dry-run mode.
+     */
+    appendRun(run: BriefingRun): void;
+    private ensureDir;
+}
+export {};
+//# sourceMappingURL=tracking.d.ts.map

package/dist/tracking.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracking.d.ts","sourceRoot":"","sources":["../src/tracking.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAIH,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAOxF,+CAA+C;AAC/C,KAAK,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;AAEnD,MAAM,WAAW,YAAY;IAC3B,+CAA+C;IAC/C,OAAO,EAAE,MAAM,CAAC;IAChB,gEAAgE;IAChE,eAAe,EAAE,MAAM,CAAC;CACzB;AAMD,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAU;gBAErB,OAAO,CAAC,EAAE;QACpB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,MAAM,CAAC,EAAE,OAAO,CAAC;KAClB;IAUD;;;OAGG;IACH,IAAI,IAAI,aAAa;IAerB;;;OAGG;IACH,IAAI,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI;IAMhC;;;;;;;;;OASG;IACH,aAAa,CACX,IAAI,EAAE,aAAa,EAAE,EACrB,MAAM,CAAC,EAAE,SAAS,EAAE,GACnB,YAAY;IA2Bf;;;;OAIG;IACH,SAAS,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI;IAUjC,OAAO,CAAC,SAAS;CAMlB"}

package/dist/tracking.js

@@ -0,0 +1,140 @@
+/**
+ * tracking.ts — Persistence layer for tracking.json and runs.jsonl.
+ *
+ * `TrackingRepository` manages two runtime files under `.careerclaw/`:
+ *
+ *   tracking.json  — keyed object of TrackingEntry records, one per
+ *                    saved job_id. First-seen wins for status; re-runs
+ *                    update `last_seen_at` only.
+ *
+ *   runs.jsonl     — append-only newline-delimited JSON log; one
+ *                    BriefingRun per line. Never rewritten, only grown.
+ *
+ * Dry-run mode: all write operations are no-ops. The repository is
+ * fully functional for reads; callers can inspect what *would* have
+ * been written via the return values of upsertEntry() / appendRun().
+ *
+ * The runtime directory is created automatically on first write if it
+ * does not exist.
+ */
+import { readFileSync, writeFileSync, appendFileSync, mkdirSync, existsSync } from "fs";
+import { dirname } from "path";
+import { TRACKING_PATH, RUNS_PATH } from "./config.js";
+// ---------------------------------------------------------------------------
+// TrackingRepository
+// ---------------------------------------------------------------------------
+export class TrackingRepository {
+    trackingPath;
+    runsPath;
+    dryRun;
+    constructor(options) {
+        this.trackingPath = options?.trackingPath ?? TRACKING_PATH;
+        this.runsPath = options?.runsPath ?? RUNS_PATH;
+        this.dryRun = options?.dryRun ?? false;
+    }
+    // -------------------------------------------------------------------------
+    // Read
+    // -------------------------------------------------------------------------
+    /**
+     * Load tracking.json from disk.
+     * Returns an empty store when the file does not yet exist.
+     */
+    load() {
+        if (!existsSync(this.trackingPath))
+            return {};
+        try {
+            const raw = readFileSync(this.trackingPath, "utf8");
+            return JSON.parse(raw);
+        }
+        catch {
+            // Corrupt or unreadable file — start fresh rather than crashing.
+            return {};
+        }
+    }
+    // -------------------------------------------------------------------------
+    // Write — tracking.json
+    // -------------------------------------------------------------------------
+    /**
+     * Persist the in-memory store to tracking.json.
+     * No-op in dry-run mode.
+     */
+    save(store) {
+        if (this.dryRun)
+            return;
+        this.ensureDir(this.trackingPath);
+        writeFileSync(this.trackingPath, JSON.stringify(store, null, 2), "utf8");
+    }
+    /**
+     * Upsert a batch of jobs into the tracking store.
+     *
+     * Behaviour:
+     *   - New job_id → creates a TrackingEntry with status "saved"
+     *   - Existing job_id → updates last_seen_at only; status is preserved
+     *
+     * Writes the updated store to disk unless dry-run.
+     * Returns counts of created vs already_present entries.
+     */
+    upsertEntries(jobs, scored) {
+        const store = this.load();
+        const now = new Date().toISOString();
+        let created = 0;
+        let already_present = 0;
+        for (const job of jobs) {
+            const existing = store[job.job_id];
+            if (existing) {
+                // Update last_seen_at; preserve all other fields including status.
+                existing.last_seen_at = now;
+                existing.updated_at = now;
+                already_present++;
+            }
+            else {
+                store[job.job_id] = makeEntry(job, now);
+                created++;
+            }
+        }
+        this.save(store);
+        return { created, already_present };
+    }
+    // -------------------------------------------------------------------------
+    // Write — runs.jsonl
+    // -------------------------------------------------------------------------
+    /**
+     * Append a BriefingRun record to runs.jsonl.
+     * Each call adds exactly one newline-terminated JSON line.
+     * No-op in dry-run mode.
+     */
+    appendRun(run) {
+        if (this.dryRun)
+            return;
+        this.ensureDir(this.runsPath);
+        appendFileSync(this.runsPath, JSON.stringify(run) + "\n", "utf8");
+    }
+    // -------------------------------------------------------------------------
+    // Helpers
+    // -------------------------------------------------------------------------
+    ensureDir(filePath) {
+        const dir = dirname(filePath);
+        if (!existsSync(dir)) {
+            mkdirSync(dir, { recursive: true });
+        }
+    }
+}
+// ---------------------------------------------------------------------------
+// Factory helpers
+// ---------------------------------------------------------------------------
+function makeEntry(job, now) {
+    return {
+        job_id: job.job_id,
+        status: "saved",
+        title: job.title,
+        company: job.company,
+        url: job.url,
+        source: job.source,
+        saved_at: now,
+        applied_at: null,
+        updated_at: now,
+        last_seen_at: now,
+        notes: null,
+    };
+}
+//# sourceMappingURL=tracking.js.map

package/dist/tracking.js.map

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

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "careerclaw-js",
+  "version": "0.11.0",
+  "description": "AI-powered job search automation for OpenClaw — Node.js rewrite of CareerClaw",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "careerclaw-js": "dist/cli.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "lint": "tsc --noEmit",
+    "clean": "rm -rf dist",
+    "smoke:sources": "npx tsx scripts/smoke_sources.ts",
+    "smoke:briefing": "npx tsx scripts/smoke_briefing.ts",
+    "smoke:llm": "npx tsx --env-file=.env scripts/smoke_llm.ts",
+    "debugging:license": "npx tsx --env-file=.env scripts/debug_license.ts",
+    "debugging:pro": "npx tsx --env-file=.env scripts/debug_pro_gate.ts",
+    "debugging:llm-response": "npx tsx --env-file=.env scripts/debug_llm_response.ts",
+    "cli": "tsx src/cli.ts --profile .careerclaw/profile.json --resume-txt .careerclaw/resume.txt --dry-run",
+    "cli:enhanced": "npx tsx --env-file=.env src/cli.ts --json --dry-run"
+  },
+  "files": [
+    "dist",
+    "SKILL.md",
+    "README.md",
+    "CHANGELOG.md",
+    "SECURITY.md"
+  ],
+  "keywords": [
+    "careerclaw",
+    "openclaw",
+    "clawhub",
+    "job-search",
+    "automation",
+    "ai"
+  ],
+  "author": "Orestes Garcia Martinez",
+  "license": "MIT",
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "@vitest/coverage-v8": "^2.1.9",
+    "tsx": "^4.21.0",
+    "typescript": "^5.5.0",
+    "vitest": "^2.0.0"
+  },
+  "dependencies": {
+    "fast-xml-parser": "^5.4.2"
+  }
+}