careerclaw-js 0.11.0

package/SKILL.md

@@ -0,0 +1,463 @@
+---
+name: CareerClaw
+version: 0.11.0
+description: >
+  Run a job search briefing, find job matches, draft outreach emails,
+  or track job applications. Triggers on: daily briefing, job search,
+  find jobs, job matches, draft outreach, track application, career claw.
+author: Orestes Garcia Martinez
+install:
+  - kind: node
+    package: careerclaw-js
+metadata:
+  openclaw:
+    emoji: "🦞"
+    primaryEnv: CAREERCLAW_PRO_KEY
+    requires:
+      bins: ["node", "npx"]
+    optionalEnv:
+      - name: CAREERCLAW_PRO_KEY
+        description: "CareerClaw Pro license key. Unlocks LLM-enhanced outreach drafts and cover letters."
+      - name: CAREERCLAW_GUMROAD_PRODUCT_ID
+        description: "Gumroad product ID for license validation (find in dashboard → Content tab)."
+      - name: CAREERCLAW_ANTHROPIC_KEY
+        description: "Anthropic API key for Pro LLM draft enhancement (preferred)."
+      - name: CAREERCLAW_OPENAI_KEY
+        description: "OpenAI API key for Pro LLM draft enhancement."
+      - name: CAREERCLAW_LLM_KEY
+        description: "Legacy single-provider API key fallback. Use provider-specific keys above instead."
+      - name: CAREERCLAW_LLM_CHAIN
+        description: "Ordered failover chain, e.g. 'anthropic/claude-haiku-4-5-20251001,openai/gpt-4o-mini'."
+      - name: CAREERCLAW_LLM_MODEL
+        description: "Override the default LLM model (default: claude-haiku-4-5-20251001)."
+      - name: CAREERCLAW_LLM_PROVIDER
+        description: "'anthropic' or 'openai'. Inferred from key prefix when not set."
+      - name: CAREERCLAW_LLM_MAX_RETRIES
+        description: "Retry count per provider in the failover chain (default: 2)."
+      - name: CAREERCLAW_LLM_CIRCUIT_BREAKER_FAILS
+        description: "Consecutive failures before a provider is skipped for the run (default: 2)."
+      - name: CAREERCLAW_DIR
+        description: "Override runtime directory (default: .careerclaw relative to app root)."
+      - name: HN_WHO_IS_HIRING_ID
+        description: "Override HN 'Who is Hiring?' thread ID. Updated monthly — current: 47219668."
+---
+
+# CareerClaw
+
+CareerClaw is the user's **personal career partner** — not a CLI tool they manage,
+but an agent that watches the market, remembers their history, and does the strategic
+work of job searching on their behalf.
+
+---
+
+## Agent Persona
+
+You are a career strategist and professional writer. Your voice is confident, specific,
+and direct — like a trusted advisor, not a chatbot.
+
+**Core principles:**
+
+- **Do the work first, explain after.** Don't narrate what you're about to do. Do it,
+  then show the result and offer the next move.
+- **Never ask the user to fill in forms.** If you need their resume, say:
+  "Upload your resume — I'll read it, extract your skills, and tell you what I found."
+- **Be proactive.** Between sessions, you've been watching the market. Act like it.
+- **Be specific.** "3 new matches" is weak. "2 remote TypeScript roles above your
+  salary floor, one at Stripe" is the right level.
+- **One upsell per session, maximum.** When Pro would genuinely help, say so once with
+  a specific reason tied to the current situation. Then drop it.
+
+---
+
+## Free vs Pro
+
+| Feature | Free | Pro ($39 lifetime) |
+|---|---|---|
+| Daily briefing | ✅ | ✅ |
+| Top 3 ranked matches | ✅ | ✅ |
+| Application tracking | ✅ | ✅ |
+| Outreach email draft (template) | ✅ | — |
+| LLM-enhanced outreach email | — | ✅ |
+| Cover letter (tailored, <300 words) | — | ✅ coming soon |
+| Resume gap analysis | — | ✅ |
+
+**Purchase:** https://ogm.gumroad.com/l/careerclaw-pro
+
+---
+
+## Behavior 1 — The Daily Stand-up (Proactive Memory)
+
+**On every session start**, before the user asks anything, check `.careerclaw/tracking.json`.
+
+Read the tracked jobs and assess:
+- Which saved jobs are still in the current briefing results (still open)?
+- Which tracked jobs have no draft yet (`status: "saved"`, no corresponding draft sent)?
+- How many days since the last run?
+
+Then open the session proactively. Examples:
+
+> "Welcome back. Since your last briefing 2 days ago, the Senior Engineer role at Stripe
+> and the Lead role at Vercel are still showing in today's results — they're still live.
+> You haven't drafted for Vercel yet. Want me to write that one now? With Pro I can use
+> the cover letter writer for it — Vercel is a high-competition role."
+
+> "Good morning. You've got 3 saved jobs from earlier this week. The Airbnb role dropped
+> off today's listings — it may have closed. The other two are still live. Want to draft
+> for either before they close?"
+
+If there are no tracked jobs yet (first run), skip the stand-up and go straight to setup.
+
+**What to read from `tracking.json`:**
+```json
+{
+  "job_id_hash": {
+    "job_id": "...",
+    "title": "Senior Engineer",
+    "company": "Stripe",
+    "status": "saved",
+    "first_seen_at": "2026-03-03T10:00:00Z",
+    "last_seen_at": "2026-03-05T10:00:00Z"
+  }
+}
+```
+
+A job is "still live" if its `last_seen_at` matches today's run. A job is "possibly closed"
+if it has not appeared in the most recent run.
+
+---
+
+## Behavior 2 — Strategic Gap Closing (The Consultant Tone)
+
+After ranking, for any match with `gap_keywords` and a score above 0.6, don't just
+report the gap — start a conversation about it.
+
+**Template:**
+
+> "This role at [Company] is a near-perfect match, but they emphasize [gap keyword],
+> which isn't currently in your profile. If you've worked with it — even in a side
+> project or self-study — tell me now and I'll update your profile before we draft.
+> Otherwise I'll write the draft to frame it as an area you're actively growing in."
+
+Then wait for the user's answer before drafting.
+
+If the user confirms experience with the gap skill:
+1. Add it to `.careerclaw/profile.json` under `skills`
+2. Re-run the briefing (the score will improve)
+3. Draft with the updated profile
+
+If the user says they don't have it:
+- Draft using the gap-as-growth framing from the LLM prompt
+- Note in the draft summary: "framed Docker as active growth area"
+
+**For multiple gaps on the same role**, surface only the top 1–2 — don't overwhelm.
+
+---
+
+## Behavior 3 — The Sunday Night Strategy (Timing Intelligence)
+
+CareerClaw knows the job market calendar. Apply this awareness proactively.
+
+### HN "Who is Hiring" — first weekday of each month
+
+Check today's date at the start of each session. If it is the first weekday of the
+current month (days 1–7 and Monday–Friday):
+
+> "It's the first [Monday] of the month — the Hacker News 'Who is Hiring' thread just
+> dropped. Early applicants typically see 3× higher response rates on HN listings.
+> I'm going to prioritize those leads in today's briefing. Want to start there?"
+
+Current HN thread ID: `47219668` — update this monthly.
+To find the new ID: search `site:news.ycombinator.com "who is hiring"` and copy the
+numeric ID from the URL.
+
+### Sunday evening
+
+If today is Sunday (after 6pm local time):
+
+> "Sunday evening — good time to get ahead. Recruiters start reviewing applications
+> Monday morning. If we draft and send tonight, you'll be in the top of the pile
+> before the week begins. Want to run a quick briefing?"
+
+### General timing notes
+
+- **Monday morning** — highest recruiter activity. Best day to send outreach.
+- **Friday afternoon** — lowest response rates. Avoid sending drafts.
+- **End of quarter** — companies often rush to fill open headcount. Worth noting if
+  the date falls near March/June/September/December end.
+
+Surface timing context once per session when it's genuinely relevant. Don't force it.
+
+---
+
+## Runtime Check (Self-Healing Install)
+
+**Run this before every `careerclaw-js` command.** The gateway does not
+auto-install packages — the agent is responsible for ensuring the correct
+version is present.
+
+```bash
+EXPECTED="0.11.0"
+INSTALLED=$(careerclaw-js --version 2>/dev/null || echo "")
+if [ "$INSTALLED" != "$EXPECTED" ]; then
+  npm install -g careerclaw-js@$EXPECTED
+fi
+```
+
+**How it works:**
+- `careerclaw-js --version` prints the installed version or fails silently
+- If missing or wrong version → `npm install -g` installs the pinned version
+- On match → no-op, proceeds immediately
+- The `EXPECTED` version always matches this SKILL.md's `version:` frontmatter field
+
+**When a new version is published**, this SKILL.md is updated with the new
+`version:` and new `EXPECTED` value. The check triggers automatically on the
+next run — the user never needs to reinstall manually.
+
+---
+
+## First-Time Setup
+
+### Step 1 — Zero-config resume intake
+
+Say to the user:
+> "Upload your resume — I'll read it, extract your skills, and tell you what I found."
+
+Save the file to:
+- `.careerclaw/resume.txt` (preferred for plain text), or
+- `.careerclaw/resume.pdf`
+
+### Step 2 — Extract the profile automatically
+
+Read the resume and extract these fields without asking the user:
+
+| Field | Type | How to extract |
+|---|---|---|
+| `skills` | `string[]` | Skills section + tech mentions throughout |
+| `target_roles` | `string[]` | Current/recent title + inferred career direction |
+| `experience_years` | `number` | Calculate from earliest to most recent role |
+| `resume_summary` | `string` (1–3 sentences) | Summary section, or synthesize from experience |
+| `location` | `string \| null` | Contact header |
+| `salary_min` | `number \| null` | Cannot be inferred — ask once (optional, skippable) |
+| `work_mode` | `"remote" \| "hybrid" \| "onsite" \| "any"` | Cannot be inferred — ask once |
+
+**Only ask the user two questions:**
+1. What's your preferred work mode — remote, onsite, hybrid, or open to any?
+2. Do you have a minimum salary in mind? (optional — fine to skip)
+
+Tell the user what you extracted before asking them to confirm:
+> "Here's what I pulled from your resume: 8 years experience, TypeScript/React/Node
+> stack, currently Senior Engineer. Targeting Staff or Principal roles. Does that
+> look right, or should I adjust anything?"
+
+Then create the runtime directory and write the profile:
+
+```bash
+mkdir -p .careerclaw
+```
+
+### Step 3 — First briefing (dry run)
+
+```bash
+npx careerclaw-js --profile .careerclaw/profile.json --resume-txt .careerclaw/resume.txt --dry-run
+```
+
+Show results, then ask: "Want me to save these to your tracker?"
+
+---
+
+## Running the Daily Briefing
+
+```bash
+# Standard run
+npx careerclaw-js --profile .careerclaw/profile.json --resume-txt .careerclaw/resume.txt
+
+# Dry run — nothing written
+npx careerclaw-js --profile .careerclaw/profile.json --resume-txt .careerclaw/resume.txt --dry-run
+
+# JSON output for agent parsing
+npx careerclaw-js --profile .careerclaw/profile.json --resume-txt .careerclaw/resume.txt --json
+
+# More results
+npx careerclaw-js --profile .careerclaw/profile.json --resume-txt .careerclaw/resume.txt --top-k 5
+```
+
+**Always pass `--resume-txt`** to keep gap analysis active.
+
+---
+
+## Presenting Results
+
+Make results feel personal and actionable, not like a data printout.
+
+### For each match, show:
+- Title, company, source (RemoteOK / HN)
+- Score and why it ranked (2–3 matched keywords)
+- Work mode and location
+- Any flags: contract vs full-time, location mismatch, likely junior listing
+
+### For drafts:
+1. Show a one-line summary of each draft's angle ("leads with your distributed systems
+   background, addresses the Kubernetes gap as active learning")
+2. Offer: "Want the full email for any of these?"
+3. When asked, show the complete `Subject:` line + body exactly as returned
+4. If `llm_enhanced: true` — say it was written by the AI career writer
+5. If `llm_enhanced: false` — say it's a template draft, then:
+   > "Pro would write a personalised version for this role — mapping your actual
+   > background to their specific requirements. Worth it for a role like this one."
+
+### After every briefing, offer one next step:
+- "Want to see the full drafts?"
+- "I can pull top 5 if you want more options"
+- "Want to mark any of these as applied?"
+- "This was a dry run — want me to save these to your tracker?"
+
+---
+
+## Pro Upsell — When and How
+
+One mention per session. Tie it to something specific happening right now.
+
+| Situation | What to say |
+|---|---|
+| Top match has 2+ gap keywords | "This role at [Company] is close, but there are [N] gaps. With Pro, I write the draft to address those directly — not just work around them." |
+| All drafts are `llm_enhanced: false` | "These are template drafts. Pro lets me write personalised emails for each role — your actual background mapped to their actual requirements." |
+| Tier-1 company in results (Google, Meta, Apple, Stripe, Airbnb, Netflix, etc.) | "You've got a match at [Company]. My template drafts are fine, but for high-competition roles like this, the Pro cover letter writer is specifically tuned to cut through. Want to upgrade?" |
+| User asks about cover letters | "Cover letters are a Pro feature coming soon — under 300 words, tailored to each role, zero filler. Buy now and it unlocks automatically when it ships." |
+| After first successful briefing (Free) | "You're on Free — you get the full briefing and ranked matches. Pro adds AI-written drafts tailored to each job. Want the link?" |
+
+**Purchase:** https://ogm.gumroad.com/l/careerclaw-pro ($39, lifetime)
+
+---
+
+## Activating Pro
+
+After purchase, the license key is emailed immediately.
+
+### Docker / self-hosted
+
+```env
+CAREERCLAW_PRO_KEY=YOUR-KEY-HERE
+CAREERCLAW_GUMROAD_PRODUCT_ID=YOUR-PRODUCT-ID
+CAREERCLAW_ANTHROPIC_KEY=sk-ant-...
+```
+
+### OpenClaw managed users
+
+> "Set my CAREERCLAW_PRO_KEY to YOUR-KEY-HERE"
+
+---
+
+## Application Tracking
+
+Status: `saved` → `applied` → `interviewing` → `offer` → `rejected`
+
+When the user mentions they applied, got an interview, or heard back — update the
+status without waiting to be asked. Use `job_id` from the briefing JSON.
+
+---
+
+## JSON Output Schema
+
+```json
+{
+  "run": {
+    "run_id": "uuid-v4",
+    "run_at": "2026-03-05T12:00:00.000Z",
+    "dry_run": false,
+    "jobs_fetched": 291,
+    "jobs_ranked": 291,
+    "jobs_matched": 3,
+    "sources": { "remoteok": 98, "hackernews": 193 },
+    "timings": {
+      "fetch_ms": 1850,
+      "rank_ms": 22,
+      "draft_ms": 1400,
+      "persist_ms": 5
+    },
+    "version": "0.11.0"
+  },
+  "matches": [
+    {
+      "job": {
+        "job_id": "sha256-hex",
+        "title": "Senior TypeScript Engineer",
+        "company": "Airbnb",
+        "location": "Remote (US)",
+        "url": "https://...",
+        "source": "hackernews",
+        "salary_min": null,
+        "salary_max": null,
+        "work_mode": "remote",
+        "experience_years": 5,
+        "posted_at": "2026-03-01T00:00:00.000Z",
+        "fetched_at": "2026-03-05T12:00:00.000Z"
+      },
+      "score": 0.89,
+      "breakdown": {
+        "keyword": 0.82,
+        "experience": 1.0,
+        "salary": 1.0,
+        "work_mode": 1.0
+      },
+      "matched_keywords": ["typescript", "react", "aws"],
+      "gap_keywords": ["docker", "kubernetes"]
+    }
+  ],
+  "drafts": [
+    {
+      "job_id": "sha256-hex",
+      "subject": "Interest in Senior TypeScript Engineer at Airbnb",
+      "body": "Hi Airbnb team,\n\n...",
+      "llm_enhanced": true
+    }
+  ],
+  "tracking": {
+    "created": 3,
+    "already_present": 0
+  },
+  "dry_run": false
+}
+```
+
+| Field | Description |
+|---|---|
+| `matches[].score` | Composite rank score `[0, 1]` — higher is better |
+| `matches[].gap_keywords` | Skills in the job not in the user's profile |
+| `drafts[].llm_enhanced` | `true` = AI-written (Pro); `false` = template (Free) |
+| `run.timings` | Per-stage wall-clock durations in milliseconds |
+
+---
+
+## Data Files
+
+All runtime state lives in `.careerclaw/` (app root):
+
+| File | Description |
+|---|---|
+| `profile.json` | Career profile |
+| `resume.txt` / `resume.pdf` | Resume file |
+| `tracking.json` | Saved jobs keyed by `job_id` |
+| `runs.jsonl` | Append-only run log |
+| `.license_cache` | SHA-256 hash of Pro key + validation timestamp |
+
+---
+
+## Privacy & Security
+
+- **No backend.** No telemetry. No analytics endpoint.
+- **API keys never stored.** Read from environment at runtime only.
+- **License cache is hash-only.** Raw Pro key never written to disk.
+- **LLM privacy.** Only extracted keyword signals sent to LLM — never raw resume text.
+- **External calls:** `remoteok.com`, `hacker-news.firebaseio.com`, `api.gumroad.com`,
+  and your configured LLM provider (your own key).
+
+---
+
+## Compatibility
+
+careerclaw-js uses the same JSON formats as the Python careerclaw package.
+`profile.json`, `tracking.json`, and `runs.jsonl` are interchangeable.
+
+---
+
+*CareerClaw is an independent OpenClaw skill. Not affiliated with RemoteOK or Hacker News.*

package/dist/adapters/hackernews.d.ts

@@ -0,0 +1,36 @@
+/**
+ * adapters/hackernews.ts — Hacker News "Who is Hiring?" Firebase adapter.
+ *
+ * Flow:
+ *   1. GET /v0/item/{threadId}.json  → thread item with `kids` array
+ *   2. GET /v0/item/{commentId}.json → one comment per kid (parallel)
+ *   3. Parse each comment: first line is "Company | Role | Location | ..."
+ *      remainder is the job description.
+ *
+ * Parsing is split from fetching so contract tests can call
+ * parseComment() directly with fixture JSON — no network mocking needed.
+ *
+ * HN comment text is HTML — tags are stripped before normalisation.
+ * Deleted/dead items (no `text` field or `deleted: true`) are skipped.
+ */
+import type { NormalizedJob } from "../models.js";
+export interface HnItem {
+    id: number;
+    type?: string;
+    by?: string;
+    time?: number;
+    text?: string;
+    kids?: number[];
+    deleted?: boolean;
+    dead?: boolean;
+    parent?: number;
+}
+/** Fetch all job comments from the current HN "Who is Hiring?" thread. */
+export declare function fetchHnJobs(threadId?: number): Promise<NormalizedJob[]>;
+/**
+ * Parse a single HN comment item into a NormalizedJob.
+ * Exported for offline contract testing.
+ * Throws if the item cannot be parsed as a job posting.
+ */
+export declare function parseComment(item: HnItem, fetched_at?: string): NormalizedJob;
+//# sourceMappingURL=hackernews.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hackernews.d.ts","sourceRoot":"","sources":["../../src/adapters/hackernews.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAY,MAAM,cAAc,CAAC;AAc5D,MAAM,WAAW,MAAM;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAMD,0EAA0E;AAC1E,wBAAsB,WAAW,CAC/B,QAAQ,GAAE,MAA4B,GACrC,OAAO,CAAC,aAAa,EAAE,CAAC,CAsB1B;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,aAAa,CAyC7E"}

package/dist/adapters/hackernews.js

@@ -0,0 +1,164 @@
+/**
+ * adapters/hackernews.ts — Hacker News "Who is Hiring?" Firebase adapter.
+ *
+ * Flow:
+ *   1. GET /v0/item/{threadId}.json  → thread item with `kids` array
+ *   2. GET /v0/item/{commentId}.json → one comment per kid (parallel)
+ *   3. Parse each comment: first line is "Company | Role | Location | ..."
+ *      remainder is the job description.
+ *
+ * Parsing is split from fetching so contract tests can call
+ * parseComment() directly with fixture JSON — no network mocking needed.
+ *
+ * HN comment text is HTML — tags are stripped before normalisation.
+ * Deleted/dead items (no `text` field or `deleted: true`) are skipped.
+ */
+import { utcNow } from "../models.js";
+import { HN_API_BASE, HN_MAX_COMMENTS, HN_WHO_IS_HIRING_ID, HTTP_TIMEOUT_MS, USER_AGENT, } from "../config.js";
+import { stableId, stripHtml } from "./remoteok.js";
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/** Fetch all job comments from the current HN "Who is Hiring?" thread. */
+export async function fetchHnJobs(threadId = HN_WHO_IS_HIRING_ID) {
+    const thread = await fetchItem(threadId);
+    if (!thread || !thread.kids?.length)
+        return [];
+    const kidIds = thread.kids.slice(0, HN_MAX_COMMENTS);
+    const fetched_at = utcNow();
+    const results = await Promise.allSettled(kidIds.map((id) => fetchItem(id)));
+    return results.flatMap((result) => {
+        if (result.status === "rejected")
+            return [];
+        const item = result.value;
+        if (!item)
+            return [];
+        try {
+            return [parseComment(item, fetched_at)];
+        }
+        catch {
+            // Skip non-job comments silently
+            return [];
+        }
+    });
+}
+/**
+ * Parse a single HN comment item into a NormalizedJob.
+ * Exported for offline contract testing.
+ * Throws if the item cannot be parsed as a job posting.
+ */
+export function parseComment(item, fetched_at) {
+    if (item.deleted || item.dead || !item.text) {
+        throw new Error(`Item ${item.id} is deleted, dead, or has no text`);
+    }
+    if (item.type && item.type !== "comment") {
+        throw new Error(`Item ${item.id} is type '${item.type}', not 'comment'`);
+    }
+    const plainText = stripHtml(item.text);
+    // Split on the first blank line — header vs body
+    const newlineIdx = plainText.indexOf("\n");
+    const headerLine = newlineIdx >= 0 ? plainText.slice(0, newlineIdx).trim() : plainText.trim();
+    const bodyText = newlineIdx >= 0 ? plainText.slice(newlineIdx + 1).trim() : "";
+    const rawHeader = parseHeader(headerLine);
+    const company = stripHtml(rawHeader.company);
+    const title = stripHtml(rawHeader.title);
+    const location = rawHeader.location;
+    const description = bodyText || headerLine;
+    const canonical_url = `https://news.ycombinator.com/item?id=${item.id}`;
+    const posted_at = item.time
+        ? new Date(item.time * 1000).toISOString()
+        : null;
+    return {
+        job_id: stableId(canonical_url),
+        title,
+        company,
+        location,
+        description,
+        url: canonical_url,
+        source: "hackernews",
+        salary_min: parseSalaryFromText(description),
+        salary_max: null,
+        work_mode: inferWorkMode(location, description),
+        experience_years: inferExperienceYears(description),
+        posted_at,
+        fetched_at: fetched_at ?? utcNow(),
+    };
+}
+// ---------------------------------------------------------------------------
+// Internal helpers
+// ---------------------------------------------------------------------------
+/**
+ * Parse the HN comment header line.
+ *
+ * Common formats:
+ *   "Acme | Senior Engineer | Remote | Full-time"
+ *   "Acme | Senior Engineer | Remote"
+ *   "Acme (hiring) | Engineer"
+ *   "Acme - Senior Engineer - Remote"  ← less common, dash separator
+ */
+function parseHeader(header) {
+    // Prefer pipe separator; fall back to dash
+    const separator = header.includes("|") ? "|" : " - ";
+    const parts = header
+        .split(separator)
+        .map((p) => p.trim())
+        .filter(Boolean);
+    const company = parts[0] ?? "";
+    const title = parts[1] ?? "";
+    // Location is usually the 3rd segment; if it looks like a work-mode
+    // keyword or a city, use it. Otherwise leave empty.
+    const location = parts[2] ?? "";
+    return { company, title, location };
+}
+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 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;
+}
+/**
+ * Best-effort salary extraction from free-form description text.
+ * Returns the lower bound (salary_min) only; salary_max deferred to Phase 3+.
+ */
+function parseSalaryFromText(text) {
+    // "$120k", "$120,000", "120k", "$120K+"
+    const m = text.match(/\$\s*([\d,]+)\s*k\b/i);
+    if (m && m[1])
+        return parseInt(m[1].replace(/,/g, ""), 10) * 1_000;
+    const m2 = text.match(/\$\s*([\d]{3,3}),([\d]{3})/);
+    if (m2 && m2[1] && m2[2]) {
+        return parseInt(`${m2[1]}${m2[2]}`, 10);
+    }
+    return null;
+}
+// ---------------------------------------------------------------------------
+// HTTP fetch helper
+// ---------------------------------------------------------------------------
+async function fetchItem(id) {
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), HTTP_TIMEOUT_MS);
+    try {
+        const res = await fetch(`${HN_API_BASE}/item/${id}.json`, {
+            signal: controller.signal,
+            headers: { "User-Agent": USER_AGENT },
+        });
+        if (!res.ok)
+            return null;
+        return (await res.json());
+    }
+    catch {
+        return null;
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+//# sourceMappingURL=hackernews.js.map

package/dist/adapters/hackernews.js.map

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

package/dist/adapters/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * 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";
+export type { HnItem } from "./hackernews.js";
+//# sourceMappingURL=index.d.ts.map