JobCtrl Automation Worker

This package contains JobCtrl's Python automation engine and CLI. It owns job discovery, enrichment, scoring, tailoring, cover letters, PDF generation, profile import, and local browser apply automation.

Use it from the repository root through uv:

uv --project workers/automation run jobctrl doctor
uv --project workers/automation run jobctrl run
uv --project workers/automation run jobctrl worker

The full local application is normally started from the repository root with corepack pnpm dev, which runs Temporal, the TypeScript API, the React web app, and this worker together.

Provider generation runs through agent-runtime-kit. The worker owns the persistent async service and idle runtime cache; provider SDKs remain optional source/runtime packs. See docs/architecture/agent-runtime.md for request isolation, reuse, permissions and shutdown.

Useful docs:

• root README.md for the public overview and quick start;
• docs/user/getting-started.md for setup and local stack commands;
• docs/user/configuration.md for environment variables;
• docs/architecture/ and docs/architecture/pipeline/ for internal runtime ownership.

Profile data, generated materials, browser state, logs, and SQLite databases are sensitive local artifacts. Do not commit them or include them in public bug reports.