@jsonresume/jobs 0.11.0 → 0.13.0

package/README.md

@@ -102,7 +102,7 @@ npx @jsonresume/jobs
 
 The TUI has three main regions:
 
-- **Header** — shows the app title, active search profile name, tab bar (All / Interested / Applied / Maybe / Passed) with live counts, and any active filter pills
+- **Header** — shows the app title, active search profile name, tab bar (All / New / Reviewed / Interested / Applied / Maybe / Passed) with live counts, and any active filter pills
 - **Content area** — job list in list view, or a split-pane layout (40% compact list + 60% job detail) in detail view
 - **Status bar** — context-sensitive keyboard hints, loading/reranking indicators, and toast notifications
 
@@ -206,6 +206,8 @@ In split-pane detail view, the left pane shows a compact list with just score, t
 | Tab | Shows |
 |-----|-------|
 | All | All jobs from the current search (excludes passed/dismissed) |
+| New | Jobs with no state and no dossier — completely untouched |
+| Reviewed | Jobs with a dossier but no decision yet |
 | Interested | Jobs you marked with `i` |
 | Applied | Jobs you marked with `x` |
 | Maybe | Jobs you marked with `m` |
@@ -269,6 +271,228 @@ npx @jsonresume/jobs help                                # All options
 
 ![architecture](./architecture.svg)
 
+## API Reference
+
+All endpoints live at `https://registry.jsonresume.org/api/v1`. Authenticated endpoints require a `Bearer` token in the `Authorization` header.
+
+### Authentication
+
+```bash
+# Generate an API key (no auth required)
+curl -s -X POST https://registry.jsonresume.org/api/v1/keys \
+  -H 'Content-Type: application/json' \
+  -d '{"username":"YOUR_GITHUB_USERNAME"}'
+# → { "key": "jr_username_xxxxx", "username": "username" }
+
+# Use in all subsequent requests
+export JSONRESUME_API_KEY="jr_username_xxxxx"
+AUTH="Authorization: Bearer $JSONRESUME_API_KEY"
+```
+
+### GET /api/v1/me
+
+Returns your resume and profile.
+
+```bash
+curl -s -H "$AUTH" https://registry.jsonresume.org/api/v1/me
+# → { "username": "...", "resume": { ... } }
+```
+
+### GET /api/v1/jobs
+
+Get jobs matched to your resume via vector similarity.
+
+| Param | Type | Default | Description |
+|-------|------|---------|-------------|
+| `top` | int | 20 | Number of results (max 100) |
+| `days` | int | 30 | How far back to search |
+| `remote` | bool | false | Remote jobs only |
+| `min_salary` | int | 0 | Minimum salary in thousands (e.g. `150` = $150k) |
+| `search` | string | | Keyword filter across all fields |
+| `search_id` | uuid | | Use a saved search profile's embedding |
+| `rerank` | bool | auto | LLM reranking (defaults to true when `search_id` is set) |
+
+```bash
+# Basic search
+curl -s -H "$AUTH" "https://registry.jsonresume.org/api/v1/jobs?top=50&days=30"
+
+# Remote jobs, $150k+, keyword filter
+curl -s -H "$AUTH" "https://registry.jsonresume.org/api/v1/jobs?top=50&remote=true&min_salary=150&search=react"
+
+# Using a search profile with reranking
+curl -s -H "$AUTH" "https://registry.jsonresume.org/api/v1/jobs?top=50&search_id=UUID&rerank=true"
+```
+
+**Response:**
+```json
+{
+  "jobs": [
+    {
+      "id": 237247,
+      "uuid": "...",
+      "title": "Full-Stack Engineer",
+      "company": "Acme Corp",
+      "location": { "city": "San Francisco", "countryCode": "US" },
+      "remote": "Full",
+      "salary": "$180k - $220k",
+      "salary_usd": 180000,
+      "experience": "Senior",
+      "type": "Full-time",
+      "description": "...",
+      "skills": [{ "name": "React" }, { "name": "Node.js" }],
+      "url": "https://news.ycombinator.com/item?id=...",
+      "posted_at": "2026-03-01T...",
+      "similarity": 0.654,
+      "rerank_score": 8,
+      "combined_score": 0.74,
+      "state": "interested",
+      "has_dossier": true
+    }
+  ],
+  "total": 50
+}
+```
+
+### POST /api/v1/jobs
+
+Match jobs against a provided resume — **no auth required**. Useful for local mode or one-off queries.
+
+```bash
+curl -s -X POST https://registry.jsonresume.org/api/v1/jobs \
+  -H 'Content-Type: application/json' \
+  -d '{
+    "resume": { "basics": { "name": "...", "label": "..." }, "skills": [...] },
+    "top": 20,
+    "days": 30,
+    "remote": true
+  }'
+```
+
+### GET /api/v1/jobs/:id
+
+Full details for a single job including raw posting content.
+
+```bash
+curl -s -H "$AUTH" https://registry.jsonresume.org/api/v1/jobs/237247
+```
+
+### PUT /api/v1/jobs/:id
+
+Mark a job's state.
+
+| Body Param | Type | Description |
+|------------|------|-------------|
+| `state` | string | `interested`, `applied`, `maybe`, `not_interested`, or `dismissed` |
+| `feedback` | string | Optional reason/notes |
+
+```bash
+# Mark as interested
+curl -s -X PUT -H "$AUTH" -H 'Content-Type: application/json' \
+  https://registry.jsonresume.org/api/v1/jobs/237247 \
+  -d '{"state":"interested","feedback":"great remote role, strong tech stack"}'
+
+# Mark as applied
+curl -s -X PUT -H "$AUTH" -H 'Content-Type: application/json' \
+  https://registry.jsonresume.org/api/v1/jobs/237247 \
+  -d '{"state":"applied","feedback":"applied via email 2026-03-13"}'
+
+# Pass on a job
+curl -s -X PUT -H "$AUTH" -H 'Content-Type: application/json' \
+  https://registry.jsonresume.org/api/v1/jobs/237247 \
+  -d '{"state":"not_interested","feedback":"salary too low"}'
+```
+
+### GET /api/v1/jobs/:id/dossier
+
+Fetch saved research dossier for a job.
+
+```bash
+curl -s -H "$AUTH" https://registry.jsonresume.org/api/v1/jobs/237247/dossier
+# → { "content": "# Dossier\n\n## Compensation...", "created_at": "..." }
+# → { "content": null } if no dossier exists
+```
+
+### PUT /api/v1/jobs/:id/dossier
+
+Save or update a research dossier.
+
+```bash
+curl -s -X PUT -H "$AUTH" -H 'Content-Type: application/json' \
+  https://registry.jsonresume.org/api/v1/jobs/237247/dossier \
+  -d '{"content":"# Company Research\n\n..."}'
+```
+
+### PUT /api/v1/resume
+
+Update your resume on the registry.
+
+```bash
+curl -s -X PUT -H "$AUTH" -H 'Content-Type: application/json' \
+  https://registry.jsonresume.org/api/v1/resume \
+  -d @resume.json
+# → { "username": "...", "message": "Resume updated" }
+```
+
+### GET /api/v1/searches
+
+List your saved search profiles.
+
+```bash
+curl -s -H "$AUTH" https://registry.jsonresume.org/api/v1/searches
+# → { "searches": [{ "id": "uuid", "name": "Remote React", "prompt": "...", "filters": [...] }] }
+```
+
+### POST /api/v1/searches
+
+Create a new search profile. The server generates a HyDE embedding from your prompt + resume.
+
+```bash
+curl -s -X POST -H "$AUTH" -H 'Content-Type: application/json' \
+  https://registry.jsonresume.org/api/v1/searches \
+  -d '{"name":"Remote React","prompt":"remote React roles at climate tech startups"}'
+# → { "search": { "id": "uuid", "name": "Remote React", "prompt": "..." } }
+```
+
+### PUT /api/v1/searches/:id
+
+Update a search profile's name or filters.
+
+```bash
+curl -s -X PUT -H "$AUTH" -H 'Content-Type: application/json' \
+  https://registry.jsonresume.org/api/v1/searches/UUID \
+  -d '{"name":"Updated Name","filters":[{"type":"remote"},{"type":"minSalary","value":"150"}]}'
+```
+
+### DELETE /api/v1/searches/:id
+
+Delete a search profile.
+
+```bash
+curl -s -X DELETE -H "$AUTH" https://registry.jsonresume.org/api/v1/searches/UUID
+# → { "ok": true }
+```
+
+### Example: Automated Job Application Workflow
+
+Use the API to build your own automation — e.g., have Claude in Chrome review your "maybe" jobs and apply:
+
+```bash
+# 1. Get all jobs, filter to "maybe" state
+JOBS=$(curl -s -H "$AUTH" "https://registry.jsonresume.org/api/v1/jobs?top=100" \
+  | jq '[.jobs[] | select(.state == "maybe")]')
+
+# 2. For each, get the full detail + dossier
+for ID in $(echo $JOBS | jq -r '.[].id'); do
+  DETAIL=$(curl -s -H "$AUTH" "https://registry.jsonresume.org/api/v1/jobs/$ID")
+  DOSSIER=$(curl -s -H "$AUTH" "https://registry.jsonresume.org/api/v1/jobs/$ID/dossier")
+  echo "$DETAIL" | jq '{title: .title, company: .company, url: .url}'
+  # ... use the detail + dossier to apply, then mark as applied
+  curl -s -X PUT -H "$AUTH" -H 'Content-Type: application/json' \
+    "https://registry.jsonresume.org/api/v1/jobs/$ID" \
+    -d '{"state":"applied","feedback":"auto-applied via script"}'
+done
+```
+
 ## How Ranking Works
 
 The system uses a five-stage pipeline to match and rank jobs against your resume.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jsonresume/jobs",
-  "version": "0.11.0",
+  "version": "0.13.0",
   "type": "module",
   "description": "Search Hacker News jobs matched against your JSON Resume",
   "bin": {

package/src/tui/AIPanel.js

@@ -9,6 +9,7 @@ export default function AIPanel({
   error,
   onDismiss,
   onExport,
+  onRegenerate,
   onMark,
   job,
   isActive,
@@ -54,6 +55,9 @@ export default function AIPanel({
           }, 3000);
         }
       }
+      if (input === 'r' && job && onRegenerate && !loading) {
+        onRegenerate(job);
+      }
       // Mark keys
       if (job && onMark) {
         if (input === 'i') onMark(job.id, 'interested');
@@ -106,14 +110,15 @@ export default function AIPanel({
       : '';
 
   const exportHint = text ? ' · e export' : '';
+  const regenHint = isCover && !loading && job ? ' · r regenerate' : '';
   const statusLine =
     loading && text
       ? 'Streaming… ESC to cancel'
       : loading
       ? 'ESC to cancel'
       : scrollHint
-      ? `${scrollHint}${exportHint}  ·  ESC to dismiss`
-      : `ESC to dismiss${exportHint}`;
+      ? `${scrollHint}${exportHint}${regenHint}  ·  ESC to dismiss`
+      : `ESC to dismiss${exportHint}${regenHint}`;
 
   return h(
     Box,

package/src/tui/App.js

@@ -24,9 +24,19 @@ import StatusBar from './StatusBar.js';
 import AIPanel from './AIPanel.js';
 import HelpModal from './HelpModal.js';
 
-const TABS = ['all', 'interested', 'applied', 'maybe', 'passed'];
+const TABS = [
+  'all',
+  'new',
+  'reviewed',
+  'interested',
+  'applied',
+  'maybe',
+  'passed',
+];
 const TAB_LABELS = {
   all: 'All',
+  new: 'New',
+  reviewed: 'Reviewed',
   interested: 'Interested',
   applied: 'Applied',
   maybe: 'Maybe',
@@ -111,6 +121,7 @@ function App({ baseUrl, apiKey, apiClient }) {
     });
   }, [searchesHook.searches]);
 
+  const ai = useAI(resume);
   const {
     jobs: rawJobs,
     allJobs,
@@ -119,11 +130,15 @@ function App({ baseUrl, apiKey, apiClient }) {
     error,
     markJob,
     forceRefresh,
-  } = useJobs(api, activeFilters, tab, activeSearchId);
-  const ai = useAI(resume);
+  } = useJobs(api, activeFilters, tab, activeSearchId, ai.getDossierStatus);
   const { toast, show: showToast } = useToast();
   const [confirmExit, setConfirmExit] = useState(false);
 
+  // Seed dossier icons from server-side flags when jobs load
+  useEffect(() => {
+    if (allJobs.length) ai.seedDossierFlags(allJobs);
+  }, [allJobs, ai]);
+
   // Kill claude processes on exit (Ctrl+C)
   useEffect(() => {
     const cleanup = () => ai.cancel();
@@ -304,6 +319,16 @@ function App({ baseUrl, apiKey, apiClient }) {
 
   const counts = {
     all: allJobs.length,
+    new: allJobs.filter(
+      (j) =>
+        !j.state &&
+        !j.has_dossier &&
+        ai.getDossierStatus(j.id) !== 'done' &&
+        ai.getDossierStatus(j.id) !== 'generating'
+    ).length,
+    reviewed: allJobs.filter(
+      (j) => (j.has_dossier || ai.getDossierStatus(j.id) === 'done') && !j.state
+    ).length,
     interested: allJobs.filter((j) => j.state === 'interested').length,
     applied: allJobs.filter((j) => j.state === 'applied').length,
     maybe: allJobs.filter((j) => j.state === 'maybe').length,
@@ -449,6 +474,10 @@ function App({ baseUrl, apiKey, apiClient }) {
               if (f) showToast(`Saved ./${f}`, 'export');
               return f;
             },
+            onRegenerate: (job) => {
+              ai.regenerateDossier(job, api);
+              showToast('Regenerating dossier…', 'info');
+            },
             isActive: true,
           })
         )

package/src/tui/useAI.js

@@ -214,7 +214,20 @@ ${jobText}
 
 Research everything you can and produce a complete dossier covering:
 
-### 1. Company Deep Dive
+### 1. Compensation Context
+- Market rate for this role/level/location
+- How the listed salary compares
+- Negotiation leverage points
+
+### 2. AI Engineering Culture
+- Does the company use or encourage AI coding tools (Copilot, Claude Code, Cursor, agentic workflows)?
+- Any public statements, blog posts, or job descriptions mentioning AI-assisted development?
+- Is the engineering culture likely to embrace engineers who ship faster using AI tools, or is there resistance?
+- Look for signals: do they mention "AI-native", "agentic", "LLM-augmented" workflows, or similar?
+- Are there concerns about AI tool usage (IP policies, code review friction, etc.)?
+- Rating: AI-Forward / AI-Friendly / Neutral / Unknown / AI-Resistant
+
+### 3. Company Deep Dive
 - What the company does, their products/services
 - Funding stage, size, recent news
 - Tech stack and engineering culture
@@ -222,38 +235,33 @@ Research everything you can and produce a complete dossier covering:
 - Employee sentiment and Glassdoor/Blind highlights
 - Any red flags or concerns
 
-### 2. Role Analysis
+### 4. Role Analysis
 - What you'd actually be doing day-to-day
 - Team context — who you'd work with
 - Growth trajectory for this role
 - How this role fits into the company's current priorities
 
-### 3. Fit Assessment
+### 5. Fit Assessment
 - Matching skills and experience (be specific, reference the candidate's actual background)
 - Skill gaps to acknowledge or address
 - Adjacent experience that transfers
 - Overall fit rating: Strong / Good / Stretch
 
-### 4. Cover Letter Talking Points
+### 6. Cover Letter Talking Points
 - 5-7 specific bullet points to mention, each referencing the candidate's real experience
 - What angle to take (technical depth? leadership? domain expertise?)
 - What to emphasize vs. downplay
 
-### 5. Contact Info
+### 7. Contact Info
 - Email addresses from the posting
 - Who posted (HN username from the URL if available)
 - Best way to reach out
 
-### 6. Interview Prep
+### 8. Interview Prep
 - Questions they'll likely ask for this role
 - Questions the candidate should ask
 - Topics to research before interviewing
 
-### 7. Compensation Context
-- Market rate for this role/level/location
-- How the listed salary compares
-- Negotiation leverage points
-
 Be thorough, specific, and opinionated. Reference the candidate's actual experience when making recommendations.`;
 
       try {
@@ -458,6 +466,22 @@ Be thorough, specific, and opinionated. Reference the candidate's actual experie
     return filename;
   }, []);
 
+  // Seed cache with server-side dossier flags from job list
+  const seedDossierFlags = useCallback((jobs) => {
+    let changed = false;
+    for (const job of jobs) {
+      if (job.has_dossier && !dossierCache.current.has(job.id)) {
+        dossierCache.current.set(job.id, {
+          text: '',
+          done: true,
+          loading: false,
+        });
+        changed = true;
+      }
+    }
+    if (changed) bumpTick();
+  }, []);
+
   // Expose dossier status for job list icons
   // Returns: 'generating' | 'done' | null
   const getDossierStatus = useCallback((jobId) => {
@@ -468,6 +492,19 @@ Be thorough, specific, and opinionated. Reference the candidate's actual experie
     return null;
   }, []);
 
+  const regenerateDossier = useCallback(
+    (job, api) => {
+      // Clear cached dossier so dossier() starts fresh
+      dossierCache.current.delete(job.id);
+      cancel();
+      setText('');
+      setError(null);
+      bumpTick();
+      dossier(job, api);
+    },
+    [dossier, cancel]
+  );
+
   return {
     text,
     loading,
@@ -476,8 +513,10 @@ Be thorough, specific, and opinionated. Reference the candidate's actual experie
     mode,
     hasActiveProcess: Boolean(childRef.current),
     getDossierStatus,
+    seedDossierFlags,
     summarizeJob,
     dossier,
+    regenerateDossier,
     batchReview,
     exportDossier,
     cancel,

package/src/tui/useJobs.js

@@ -1,7 +1,7 @@
 import { useState, useEffect, useCallback, useMemo, useRef } from 'react';
 import { getCached, setCache, updateCachedJob } from '../cache.js';
 
-export function useJobs(api, activeFilters, tab, searchId) {
+export function useJobs(api, activeFilters, tab, searchId, getDossierStatus) {
   const [allJobs, setAllJobs] = useState([]);
   const [loading, setLoading] = useState(true);
   const [reranking, setReranking] = useState(false);
@@ -135,6 +135,22 @@ export function useJobs(api, activeFilters, tab, searchId) {
       }
     }
 
+    if (tab === 'new')
+      return filtered.filter(
+        (j) =>
+          !j.state &&
+          !j.has_dossier &&
+          (!getDossierStatus ||
+            (getDossierStatus(j.id) !== 'done' &&
+              getDossierStatus(j.id) !== 'generating'))
+      );
+    if (tab === 'reviewed')
+      return filtered.filter(
+        (j) =>
+          !j.state &&
+          (j.has_dossier ||
+            (getDossierStatus && getDossierStatus(j.id) === 'done'))
+      );
     if (tab === 'interested')
       return filtered.filter((j) => j.state === 'interested');
     if (tab === 'applied') return filtered.filter((j) => j.state === 'applied');
@@ -145,7 +161,7 @@ export function useJobs(api, activeFilters, tab, searchId) {
     return filtered.filter(
       (j) => j.state !== 'not_interested' && j.state !== 'dismissed'
     );
-  }, [allJobs, activeFilters, tab]);
+  }, [allJobs, activeFilters, tab, getDossierStatus]);
 
   const markJob = useCallback(
     async (id, state, feedback) => {