Jobber/docs-site/docs/features/orchestrator.md

id, title, description, sidebar_position

id	title	description	sidebar_position
orchestrator	Orchestrator	Job states, ready flow, and PDF generation/regeneration behavior.	1

What it is

The Orchestrator is the primary jobs workspace in JobOps.

It controls:

• job lifecycle states
• manual and automatic ready flow
• PDF generation and regeneration
• handoff to post-application tracking

Job states:

• discovered: found by crawler/import, not tailored yet
• processing: tailoring and/or PDF generation in progress
• ready: tailored PDF generated and ready to apply
• applied: marked as applied
• skipped: explicitly excluded from active queue
• expired: deadline passed

When you skip or mark applied, JobOps also skips matching open duplicates (same company + title or description) and blocks re-import on future runs. See Duplicate job detection.

Why it exists

Orchestrator centralizes the transition from discovered opportunities to application-ready artifacts.

It exists to ensure:

• a consistent path from discovery to tailored output
• clear status transitions across manual and automated workflows
• predictable regeneration behavior when job data changes
• faster external research from the Ready tab with prebuilt search links for LinkedIn, GitHub, and broader web results

How to use it

Intended ready flow

1. Manual flow:
   1. Job starts in discovered.
   2. Open the job and choose Tailor.
   3. Edit JD/tailored fields/project picks.
   4. Click Finalize & Move to Ready.
2. Auto flow:
   1. Pipeline scores discovered jobs.
   2. Top jobs above threshold are auto-processed.
   3. Jobs move directly to ready with generated PDFs.

Ghostwriter availability

Ghostwriter is available in discovered and ready job views.

For details, see Ghostwriter.

Ready tab search links

In the ready view, JobOps can show prebuilt search links based on the current job's employer, title, and skills.

This enables you to:

• quickly open Google searches for likely LinkedIn profiles tied to the company and target skills
• search GitHub for matching public profiles or repositories without rewriting the query yourself
• run a broader web search to gather context before applying

Open the search links row in the Ready summary to reveal the generated links.

Opening documentation from the sidebar

1. Open the sidebar menu.
2. In the footer section under Version vX.Y.Z, click Documentation, which opens the locally hosted docs in a new tab.

Generating PDFs

PDF generation uses:

• base resume selected from RxResume
• job description
• tailored summary/headline/skills/projects

Common paths:

• Discovered to finalization: POST /api/jobs/actions with { "action": "move_to_ready", "jobIds": ["<jobId>"] }
• Ready regeneration: POST /api/jobs/:id/generate-pdf

Regenerating PDFs after edits (copy-pasteable examples)

If JD or tailoring changes, regenerate PDF to keep output in sync.

curl -X PATCH "http://localhost:3001/api/jobs/<jobId>" \
  -H "content-type: application/json" \
  -d '{
    "jobDescription": "<new JD>",
    "tailoredSummary": "<optional>",
    "tailoredHeadline": "<optional>",
    "tailoredSkills": [{"name":"Backend","keywords":["TypeScript","Node.js"]}],
    "selectedProjectIds": "p1,p2"
  }'

curl -X POST "http://localhost:3001/api/jobs/<jobId>/summarize?force=true"
curl -X POST "http://localhost:3001/api/jobs/<jobId>/generate-pdf"

External payload and sanitization defaults

• LLM prompts send minimized profile/job fields.
• Webhooks are sanitized and whitelisted by default.
• Logs and error details are redacted/truncated by default.
• Correlation fields include requestId, and when available pipelineRunId and jobId.

Common problems

Job is stuck in processing

• processing is transient; failures generally revert the job to discovered.
• Check run logs and retry generation.

PDF does not reflect recent edits

• Run summarize with force=true after changing the JD/tailoring.
• Regenerate PDF after summarize completes.

Reopen skipped/applied jobs

• Patch status back to discovered to return the job to the active queue.

Duplicate postings

• Skipping one listing auto-skips other Discovered / Ready rows that match the same normalized employer+title (or employer+description when available).
• The Jobs list hides open rows that match a job you already skipped or applied to.
• Details: Duplicate job detection.

Related pages

• Duplicate job detection
• Pipeline Run
• Ghostwriter
• Reactive Resume
• Post-Application Tracking