How jeffersonislima/job-hunter works
Job Hunter automates finding, evaluating, storing, and alerting on job listings. A run prepares its context, gathers listings from web search and JobSpy sources, curates and validates them, then notifies through Telegram; SQLite tracks processed and pending jobs. Scheduling and environment-based assembly support unattended execution. The graph follows the pipeline and wiring visible in the indexed sources; external-service links are marked optional where the excerpts do not establish their runtime calls.
Main entry points: jobHunter.ts Job hunter · createJobHunter.ts Dependency assembly · gatherAndCurateStep.ts Gather and curate · curateStep.ts Curation service
Components 22
Run orchestration
- Application entry
src/main.ts - Dependency assembly
src/bootstrap/createJobHunter.ts - Hunt scheduler
src/infrastructure/scheduling/huntScheduler.ts - Job hunter
src/application/jobHunter.ts
Hunt pipeline
- Pipeline context
src/application/pipeline/context.ts - Pipeline runner
src/application/pipeline/hunterPipeline.ts - Prepare step
src/application/pipeline/prepareStep.ts - Gather and curate
src/application/pipeline/gatherAndCurateStep.ts - Curation service
src/application/pipeline/curateStep.ts - Notification step
src/application/pipeline/notifyStep.ts
External adapters
- Web search source
src/infrastructure/sources/webSearchSource.ts - JobSpy sources
src/infrastructure/sources/jobSpySource.ts - Job scraper
src/infrastructure/scraping/scraper.ts - Listing validation
src/infrastructure/scraping/jobValidation.ts - LLM curator
src/infrastructure/llm/curator.ts - Telegram notifier
src/infrastructure/messaging/telegram.ts
Domain and storage
- Job and port contracts
src/domain - Job repository
src/infrastructure/persistence/jobRepository.ts - SQLite database
src/infrastructure/persistence/database.ts
Other components
- Operator
- Telegram service
- LLM service
Connections 32
- Operator → Application entry: starts
- Application entry → Dependency assembly: creates hunter
src/main.ts - Application entry → Hunt scheduler: starts scheduling
src/main.ts - Dependency assembly → Job hunter: assembles
src/bootstrap/createJobHunter.ts - Dependency assembly → Job repository: creates
src/bootstrap/createJobHunter.ts - Dependency assembly → SQLite database: creates
src/bootstrap/createJobHunter.ts - Dependency assembly → Job scraper: creates
src/bootstrap/createJobHunter.ts - Dependency assembly → LLM curator: creates
src/bootstrap/createJobHunter.ts - Dependency assembly → Telegram notifier: creates
src/bootstrap/createJobHunter.ts - Job hunter → Pipeline context: initializes
src/application/jobHunter.ts - Job hunter → Pipeline runner: runs
src/application/jobHunter.ts - Job hunter → Prepare step: constructs
src/application/jobHunter.ts - Job hunter → Gather and curate: constructs
src/application/jobHunter.ts - Job hunter → Notification step: constructs
src/application/jobHunter.ts - Job hunter → Web search source: constructs
src/application/jobHunter.ts - Job hunter → JobSpy sources: constructs
src/application/jobHunter.ts - Pipeline runner → Pipeline context: passes state
src/application/pipeline/hunterPipeline.ts - Gather and curate → Web search source: searches
src/application/pipeline/gatherAndCurateStep.ts - Gather and curate → JobSpy sources: searches
src/application/pipeline/gatherAndCurateStep.ts - Gather and curate → Curation service: evaluates listings
src/application/pipeline/gatherAndCurateStep.ts - Web search source → Job scraper: requests listings
src/infrastructure/sources/webSearchSource.ts - JobSpy sources → Job scraper: requests listings
src/infrastructure/sources/jobSpySource.ts - Curation service → LLM curator: scores listings
src/application/pipeline/curateStep.ts - Curation service → Listing validation: validates listings
src/application/pipeline/curateStep.ts - Curation service → Job repository: checks and saves
- Notification step → Telegram notifier: sends alerts
src/application/pipeline/notifyStep.ts - Notification step → Listing validation: checks listings
src/application/pipeline/notifyStep.ts - Telegram notifier → Telegram service: sends messages
- LLM curator → LLM service: requests evaluation
- Job repository → SQLite database: reads and writes
src/infrastructure/persistence/jobRepository.ts - Job repository → Listing validation: canonicalizes links
src/infrastructure/persistence/jobRepository.ts - SQLite database → Listing validation: canonicalizes links
src/infrastructure/persistence/database.ts