@jsonresume/jobs 0.7.0

package/skills/jsonresume-hunt/SKILL.md

@@ -0,0 +1,208 @@
+---
+name: jsonresume-hunt
+description: Interactive job hunting assistant. Interviews you about what you want, searches HN "Who is Hiring" jobs matched to your JSON Resume, researches companies, does skill gap analysis, and builds a shortlist of jobs to apply for. Use when looking for a job, exploring opportunities, or reviewing new job postings.
+argument-hint: "[optional: preferences like 'remote react jobs' or 'startups in SF']"
+---
+
+You are an expert job hunting assistant. Guide the user through a complete job search — from understanding what they want, to delivering a final shortlist of jobs ready to apply for.
+
+## Tools
+
+You have the `@jsonresume/job-search` CLI. If it's not installed, run:
+
+```bash
+npx @jsonresume/job-search help
+```
+
+If `JSONRESUME_API_KEY` is not set, tell the user to generate one:
+
+```bash
+curl -s -X POST https://jsonresume.org/api/v1/keys \
+  -H 'Content-Type: application/json' \
+  -d '{"username":"YOUR_GITHUB_USERNAME"}'
+```
+
+CLI commands:
+
+```
+npx @jsonresume/job-search search --json --top 50 --days 30
+npx @jsonresume/job-search search --json --remote --min-salary 150 --search "react"
+npx @jsonresume/job-search detail <id> --json
+npx @jsonresume/job-search mark <id> interested --feedback "reason"
+npx @jsonresume/job-search mark <id> not_interested --feedback "reason"
+npx @jsonresume/job-search me --json
+npx @jsonresume/job-search update <path-to-resume.json>
+```
+
+You also have WebSearch for company research and full file read/write for creating the tracker.
+
+## Phase 1: Discovery
+
+Start by pulling their resume:
+
+```bash
+npx @jsonresume/job-search me --json
+```
+
+Read and understand their background. Then interview them — don't dump all questions at once, have a conversation:
+
+1. What kind of role? (same path, pivot, step up, something new?)
+2. Remote / hybrid / onsite? Location preferences or restrictions?
+3. Salary floor and ideal?
+4. Company stage? (early startup, growth, big tech, agency, non-profit)
+5. Industries to avoid? (gambling, defense, crypto, adtech, etc.)
+6. What matters most right now? (compensation, mission, tech stack, growth, balance)
+7. Dream companies?
+8. Dealbreakers? (on-call, travel, tech you dislike, visa issues)
+
+If the user passed $ARGUMENTS, use those as starting preferences and skip questions they already answered.
+
+After the interview, summarize their profile and confirm before searching.
+
+If you notice their resume is missing skills, has outdated job titles, or could better reflect what they told you, offer to update it:
+
+1. Save a modified `resume.json` with improvements
+2. Push it: `npx @jsonresume/job-search update resume.json`
+3. Confirm the update before proceeding
+
+This improves match quality for the search phase.
+
+## Phase 2: Search
+
+Cast a wide net with multiple searches:
+
+```bash
+npx @jsonresume/job-search search --json --top 50 --days 30
+npx @jsonresume/job-search search --json --top 50 --days 30 --remote
+npx @jsonresume/job-search search --json --top 50 --days 60 --search "<keyword>"
+```
+
+Run different keyword searches based on their stated interests. Deduplicate by job ID.
+
+Filter results against Phase 1 preferences. Sort into tiers:
+
+**Tier 1 — Strong matches**: Fits most criteria, high similarity score, right level
+**Tier 2 — Worth a look**: Partial fit, interesting company or upside
+**Tier 3 — Long shots**: Stretch roles, imperfect fit but compelling opportunity
+
+Present max 10 at a time in a clean table:
+
+```
+| # | Score | Title                    | Company       | Location     | Salary  | Tier |
+|---|-------|--------------------------|---------------|--------------|---------|------|
+| 1 | 0.60  | Senior Full Stack Eng    | Acme Corp     | Remote       | $180k   | T1   |
+```
+
+Include your quick take on each: why it fits, any yellow flags.
+
+## Phase 3: Research
+
+For each Tier 1 job and any Tier 2 the user wants to explore:
+
+1. Pull full details:
+
+```bash
+npx @jsonresume/job-search detail <id> --json
+```
+
+2. Research the company using WebSearch:
+
+   - What they do, funding stage, headcount, recent news
+   - Tech blog / GitHub / open source presence
+   - Employee sentiment if findable
+   - Who posted on HN (the URL has the poster's username)
+
+3. Skill gap analysis — compare `me --json` against job requirements:
+   - **Matching skills**: What they have that the job wants
+   - **Missing skills**: Gaps to acknowledge or address
+   - **Adjacent skills**: Related experience that transfers
+   - **Fit rating**: Strong / Good / Stretch
+
+Present research in a clear block per job. Include the HN URL so they can read the original post.
+
+## Phase 4: Decisions
+
+After presenting each researched job, ask: **Apply, Maybe, or Pass?**
+
+Mark their decision:
+
+```bash
+npx @jsonresume/job-search mark <id> interested --feedback "strong remote role, good tech stack"
+npx @jsonresume/job-search mark <id> not_interested --feedback "salary too low for the location"
+npx @jsonresume/job-search mark <id> maybe --feedback "interesting but want to research more"
+```
+
+Always capture the reason. Notice patterns — if they keep passing on similar jobs, adjust.
+
+Keep a running tally:
+
+> Reviewed 12 jobs. Shortlisted: 3. Maybe: 2. Passed: 7. Remaining: 5.
+
+## Phase 5: Application Tracker
+
+Once they have their shortlist, create a markdown file:
+
+**File: `job-hunt-YYYY-MM-DD.md`** in the current working directory.
+
+Use this structure:
+
+```markdown
+# Job Hunt — [Date]
+
+## What I'm Looking For
+
+[Summary from Phase 1]
+
+## Shortlist
+
+### 1. [Title] at [Company]
+
+- **Job ID:** [id]
+- **Match Score:** [similarity]
+- **HN Post:** [url]
+- **Salary:** [salary]
+- **Location:** [location/remote]
+- **Type:** [full-time/contract]
+- **Why this role:** [2-3 sentences on fit]
+- **Skill gaps:** [honest assessment]
+- **Company:** [1-2 sentences]
+- **Next step:** [what to do — apply on site, email poster, etc.]
+- **Status:** Ready to apply
+
+### 2. ...
+
+## Maybe — Revisit Later
+
+- [Company] — [Title]: [why maybe]
+
+## Passed
+
+- [Company] — [Title]: [reason]
+
+## Patterns & Notes
+
+- [Trends noticed across jobs]
+- [Advice for the user]
+```
+
+## Phase 6: Outreach
+
+For each shortlisted job, offer to:
+
+1. **Draft outreach**: Write a personalized message to the HN poster referencing the user's specific experience and any open source work. Keep it short — 4-5 sentences max.
+
+2. **Resume highlights**: Identify which sections of their JSON Resume are most relevant for this role and suggest what to emphasize or tailor.
+
+3. **Company connections**: Search if the user might have connections (shared open source projects, past companies, mutual communities).
+
+Create outreach drafts as a separate file if there are 3+ jobs: `outreach-YYYY-MM-DD.md`
+
+## Behavior
+
+- Be direct and opinionated. If a job is wrong, say why.
+- Don't present more than 10 jobs at once.
+- Always show the HN URL.
+- If search returns few results, widen `--days` or loosen filters automatically.
+- Help them think through tradeoffs when they're unsure.
+- When done, remind them to re-run in a few days — new HN threads post monthly.
+- If they say "just show me everything", still tier and annotate — don't dump raw results.

package/src/api.js

@@ -0,0 +1,61 @@
+const DEFAULT_BASE_URL = 'https://registry.jsonresume.org';
+
+export function createApiClient({ baseUrl, apiKey }) {
+  const base = baseUrl || DEFAULT_BASE_URL;
+
+  async function request(path, options = {}) {
+    const url = `${base}/api/v1${path}`;
+    const res = await fetch(url, {
+      ...options,
+      headers: {
+        Authorization: `Bearer ${apiKey}`,
+        'Content-Type': 'application/json',
+        ...options.headers,
+      },
+    });
+    const text = await res.text();
+    let data;
+    try {
+      data = JSON.parse(text);
+    } catch {
+      throw new Error(`Non-JSON response: ${res.status}`);
+    }
+    if (!res.ok) throw new Error(data.error || res.statusText);
+    return data;
+  }
+
+  return {
+    fetchJobs: (params = {}) => {
+      const qs = new URLSearchParams();
+      qs.set('top', String(params.top || 50));
+      qs.set('days', String(params.days || 30));
+      if (params.remote) qs.set('remote', 'true');
+      if (params.minSalary) qs.set('min_salary', String(params.minSalary));
+      if (params.search) qs.set('search', params.search);
+      if (params.searchId) qs.set('search_id', params.searchId);
+      if (params.rerank !== undefined) qs.set('rerank', String(params.rerank));
+      return request(`/jobs?${qs}`);
+    },
+    fetchJobDetail: (id) => request(`/jobs/${id}`),
+    markJob: (id, state, feedback) =>
+      request(`/jobs/${id}`, {
+        method: 'PUT',
+        body: JSON.stringify({ state, feedback: feedback || state }),
+      }),
+    fetchMe: () => request('/me'),
+
+    // Search profiles
+    listSearches: () => request('/searches'),
+    createSearch: (name, prompt) =>
+      request('/searches', {
+        method: 'POST',
+        body: JSON.stringify({ name, prompt }),
+      }),
+    updateSearch: (id, updates) =>
+      request(`/searches/${id}`, {
+        method: 'PUT',
+        body: JSON.stringify(updates),
+      }),
+    deleteSearch: (id) => request(`/searches/${id}`, { method: 'DELETE' }),
+  };
+}

package/src/auth.js

@@ -0,0 +1,115 @@
+import { readFileSync, writeFileSync, mkdirSync } from 'fs';
+import { join } from 'path';
+import { homedir } from 'os';
+import { createInterface } from 'readline';
+
+const DIR = join(homedir(), '.jsonresume');
+const CONFIG_FILE = join(DIR, 'config.json');
+
+function ensureDir() {
+  try {
+    mkdirSync(DIR, { recursive: true });
+  } catch {}
+}
+
+export function loadConfig() {
+  try {
+    return JSON.parse(readFileSync(CONFIG_FILE, 'utf-8'));
+  } catch {
+    return {};
+  }
+}
+
+export function saveConfig(config) {
+  ensureDir();
+  writeFileSync(CONFIG_FILE, JSON.stringify(config, null, 2));
+}
+
+function prompt(question) {
+  const rl = createInterface({ input: process.stdin, output: process.stderr });
+  return new Promise((resolve) => {
+    rl.question(question, (answer) => {
+      rl.close();
+      resolve(answer.trim());
+    });
+  });
+}
+
+/**
+ * Ensures we have a valid API key. Checks in order:
+ * 1. JSONRESUME_API_KEY env var
+ * 2. Saved config at ~/.jsonresume/config.json
+ * 3. Interactive login (prompt for GitHub username → generate key)
+ */
+export async function ensureApiKey(baseUrl) {
+  // 1. Env var takes priority
+  if (process.env.JSONRESUME_API_KEY) {
+    return process.env.JSONRESUME_API_KEY;
+  }
+
+  // 2. Saved config
+  const config = loadConfig();
+  if (config.apiKey) {
+    // Verify it still works
+    try {
+      const res = await fetch(`${baseUrl}/api/v1/me`, {
+        headers: { Authorization: `Bearer ${config.apiKey}` },
+      });
+      if (res.ok) return config.apiKey;
+    } catch {}
+    // Key is stale — fall through to login
+  }
+
+  // 3. Interactive login
+  console.error('\n  Welcome to JSON Resume Job Search!\n');
+  console.error(
+    '  You need a JSON Resume hosted at registry.jsonresume.org to use this tool.'
+  );
+  console.error("  If you don't have one yet, visit: https://jsonresume.org\n");
+
+  const username = await prompt('  Enter your GitHub username: ');
+
+  if (!username) {
+    console.error('\n  No username provided. Exiting.');
+    process.exit(1);
+  }
+
+  console.error(
+    `\n  Checking for resume at registry.jsonresume.org/${username}...`
+  );
+
+  // Verify resume exists
+  const resumeRes = await fetch(`${baseUrl}/${username}.json`);
+  if (!resumeRes.ok) {
+    console.error(`\n  No resume found for "${username}".`);
+    console.error('  Create one at https://jsonresume.org and try again.\n');
+    process.exit(1);
+  }
+
+  console.error('  Resume found! Generating API key...');
+
+  // Generate key
+  const keyRes = await fetch(`${baseUrl}/api/v1/keys`, {
+    method: 'POST',
+    headers: { 'Content-Type': 'application/json' },
+    body: JSON.stringify({ username }),
+  });
+
+  if (!keyRes.ok) {
+    const err = await keyRes.json().catch(() => ({}));
+    console.error(
+      `\n  Failed to generate key: ${err.error || keyRes.statusText}`
+    );
+    process.exit(1);
+  }
+
+  const { key } = await keyRes.json();
+
+  // Save it
+  saveConfig({ ...config, apiKey: key, username });
+
+  console.error(`  API key saved to ~/.jsonresume/config.json`);
+  console.error(`  Logged in as: ${username}\n`);
+
+  return key;
+}

package/src/cache.js

@@ -0,0 +1,48 @@
+import { readFileSync, writeFileSync, mkdirSync } from 'fs';
+import { join } from 'path';
+import { homedir } from 'os';
+
+const CACHE_DIR = join(homedir(), '.jsonresume', 'cache');
+const CACHE_TTL = 24 * 60 * 60 * 1000; // 1 day
+
+function ensureDir() {
+  try {
+    mkdirSync(CACHE_DIR, { recursive: true });
+  } catch {}
+}
+
+function cacheKey(params) {
+  const parts = [`jobs_${params.days || 30}_${params.top || 100}`];
+  if (params.searchId) parts.push(`s_${params.searchId.slice(0, 8)}`);
+  return parts.join('_') + '.json';
+}
+
+export function getCached(params) {
+  try {
+    const file = join(CACHE_DIR, cacheKey(params));
+    const raw = readFileSync(file, 'utf-8');
+    const { timestamp, data } = JSON.parse(raw);
+    if (Date.now() - timestamp < CACHE_TTL) return data;
+  } catch {}
+  return null;
+}
+
+export function setCache(params, data) {
+  try {
+    ensureDir();
+    const file = join(CACHE_DIR, cacheKey(params));
+    writeFileSync(file, JSON.stringify({ timestamp: Date.now(), data }));
+  } catch {}
+}
+
+export function updateCachedJob(params, jobId, updates) {
+  try {
+    const file = join(CACHE_DIR, cacheKey(params));
+    const raw = readFileSync(file, 'utf-8');
+    const cache = JSON.parse(raw);
+    cache.data = cache.data.map((j) =>
+      j.id === jobId ? { ...j, ...updates } : j
+    );
+    writeFileSync(file, JSON.stringify(cache));
+  } catch {}
+}

package/src/export.js

@@ -0,0 +1,65 @@
+import { writeFileSync } from 'fs';
+import { formatSalary, formatLocation } from './formatters.js';
+
+/**
+ * Export jobs to a markdown tracker file.
+ * Returns the filename written.
+ */
+export function exportShortlist(allJobs) {
+  const date = new Date().toISOString().slice(0, 10);
+  const filename = `job-hunt-${date}.md`;
+
+  const interested = allJobs.filter((j) => j.state === 'interested');
+  const applied = allJobs.filter((j) => j.state === 'applied');
+  const maybe = allJobs.filter((j) => j.state === 'maybe');
+
+  const formatJob = (j, i) => {
+    const loc = formatLocation(j.location, j.remote);
+    const sal = formatSalary(j.salary, j.salary_usd);
+    const skills = j.skills ? j.skills.map((s) => s.name || s).join(', ') : '—';
+    return [
+      `### ${i + 1}. ${j.title} at ${j.company}`,
+      '',
+      `- **Job ID:** ${j.id}`,
+      `- **Match Score:** ${j.similarity}`,
+      j.url ? `- **HN Post:** ${j.url}` : null,
+      `- **Salary:** ${sal}`,
+      `- **Location:** ${loc}`,
+      `- **Skills:** ${skills}`,
+      '',
+    ]
+      .filter((l) => l !== null)
+      .join('\n');
+  };
+
+  const sections = [];
+
+  sections.push(`# Job Hunt — ${date}\n`);
+
+  if (interested.length > 0) {
+    sections.push(`## Shortlist (${interested.length})\n`);
+    sections.push(interested.map(formatJob).join('\n'));
+  }
+
+  if (applied.length > 0) {
+    sections.push(`## Applied (${applied.length})\n`);
+    sections.push(applied.map(formatJob).join('\n'));
+  }
+
+  if (maybe.length > 0) {
+    sections.push(`## Maybe — Revisit Later (${maybe.length})\n`);
+    sections.push(
+      maybe
+        .map((j) => `- **${j.company}** — ${j.title} (score: ${j.similarity})`)
+        .join('\n')
+    );
+  }
+
+  sections.push(
+    `\n---\n*Exported from [JSON Resume Job Search](https://github.com/jsonresume/jsonresume.org)*`
+  );
+
+  const content = sections.join('\n\n');
+  writeFileSync(filename, content);
+  return filename;
+}

package/src/filters.js

@@ -0,0 +1,59 @@
+import { readFileSync, writeFileSync, mkdirSync } from 'fs';
+import { join } from 'path';
+import { homedir } from 'os';
+
+const DIR = join(homedir(), '.jsonresume');
+const FILE = join(DIR, 'filters.json');
+
+function ensureDir() {
+  try {
+    mkdirSync(DIR, { recursive: true });
+  } catch {}
+}
+
+/**
+ * Filter state shape:
+ * {
+ *   default: { active: [] },          // filters for default resume search
+ *   searches: {
+ *     "<search-id>": { active: [] },  // filters per saved search
+ *   }
+ * }
+ */
+export function loadFilters() {
+  try {
+    const raw = JSON.parse(readFileSync(FILE, 'utf-8'));
+    // Migrate old format: { active: [] } → { default: { active: [] }, searches: {} }
+    if (Array.isArray(raw.active)) {
+      return { default: { active: raw.active }, searches: {} };
+    }
+    return {
+      default: raw.default || { active: [] },
+      searches: raw.searches || {},
+    };
+  } catch {
+    return { default: { active: [] }, searches: {} };
+  }
+}
+
+export function saveFilters(state) {
+  ensureDir();
+  writeFileSync(FILE, JSON.stringify(state, null, 2));
+}
+
+/** Get filters for a specific search (or default) */
+export function getFiltersForSearch(state, searchId) {
+  if (!searchId) return state.default?.active || [];
+  return state.searches?.[searchId]?.active || [];
+}
+
+/** Set filters for a specific search (or default) */
+export function setFiltersForSearch(state, searchId, active) {
+  const next = { ...state, searches: { ...state.searches } };
+  if (!searchId) {
+    next.default = { active };
+  } else {
+    next.searches[searchId] = { active };
+  }
+  return next;
+}

package/src/formatters.js

@@ -0,0 +1,71 @@
+export function formatSalary(salary, salaryUsd) {
+  if (salaryUsd) return `$${Math.round(salaryUsd / 1000)}k`;
+  if (salary) return salary;
+  return '—';
+}
+
+export function formatLocation(loc, remote) {
+  const parts = [];
+  if (loc?.city) parts.push(loc.city);
+  if (loc?.countryCode) parts.push(loc.countryCode);
+  if (remote) parts.push(`(${remote})`);
+  return parts.join(', ') || '—';
+}
+
+export function stateIcon(state) {
+  const icons = {
+    interested: '⭐',
+    applied: '📨',
+    not_interested: '✗',
+    dismissed: '👁',
+    maybe: '?',
+  };
+  return icons[state] || ' ';
+}
+
+export function stateColor(state) {
+  const colors = {
+    interested: 'green',
+    applied: 'blue',
+    not_interested: 'red',
+    dismissed: 'gray',
+    maybe: 'yellow',
+  };
+  return colors[state] || 'white';
+}
+
+export function truncate(str, len) {
+  if (!str) return '';
+  return str.length > len ? str.slice(0, len - 1) + '…' : str;
+}
+
+/**
+ * Render a score as a sparkline bar: ████░░░░ 0.72
+ * Uses Unicode block characters for sub-character precision.
+ */
+const BLOCKS = [' ', '▏', '▎', '▍', '▌', '▋', '▊', '▉', '█'];
+
+export function scoreBar(score, width = 6) {
+  if (typeof score !== 'number' || isNaN(score)) return '░'.repeat(width);
+  const clamped = Math.max(0, Math.min(1, score));
+  const filled = clamped * width;
+  const full = Math.floor(filled);
+  const frac = Math.round((filled - full) * 8);
+  const empty = width - full - (frac > 0 ? 1 : 0);
+  return (
+    '█'.repeat(full) +
+    (frac > 0 ? BLOCKS[frac] : '') +
+    '░'.repeat(Math.max(0, empty))
+  );
+}
+
+export function stateLabel(state) {
+  const labels = {
+    interested: 'Interested',
+    applied: 'Applied',
+    not_interested: 'Passed',
+    dismissed: 'Dismissed',
+    maybe: 'Maybe',
+  };
+  return labels[state] || '';
+}

package/src/tui/AIPanel.js

@@ -0,0 +1,37 @@
+import { Box, Text, useInput } from 'ink';
+import Spinner from 'ink-spinner';
+import { h } from './h.js';
+
+export default function AIPanel({ text, loading, error, onDismiss, isActive }) {
+  useInput(
+    (_input, key) => {
+      if (key.escape) onDismiss();
+    },
+    { isActive }
+  );
+
+  return h(
+    Box,
+    {
+      flexDirection: 'column',
+      borderStyle: 'double',
+      borderColor: 'magenta',
+      padding: 1,
+      marginX: 2,
+    },
+    h(Text, { bold: true, color: 'magenta' }, '🤖 AI Analysis'),
+    h(Text, null, ' '),
+    loading
+      ? h(
+          Box,
+          null,
+          h(Spinner, { type: 'dots' }),
+          h(Text, null, ' Thinking...')
+        )
+      : null,
+    error ? h(Text, { color: 'red' }, `Error: ${error}`) : null,
+    text ? h(Text, { wrap: 'wrap' }, text) : null,
+    h(Text, null, ' '),
+    h(Text, { dimColor: true }, 'Press ESC to dismiss')
+  );
+}