applypilot 0.2.0__tar.gz

applypilot-0.2.0/.env.example

@@ -0,0 +1,14 @@
+# ApplyPilot Environment Configuration
+# Copy to ~/.applypilot/.env and fill in your values.
+
+# LLM Provider (pick one)
+GEMINI_API_KEY=           # Gemini 2.0 Flash (recommended, cheapest)
+# OPENAI_API_KEY=         # OpenAI (GPT-4o-mini)
+# LLM_URL=http://127.0.0.1:8080/v1  # Local LLM (llama.cpp, Ollama)
+# LLM_MODEL=              # Override model name
+
+# Auto-Apply (optional)
+CAPSOLVER_API_KEY=        # For CAPTCHA solving during auto-apply
+
+# Proxy (optional, for scraping)
+# PROXY=host:port:user:pass

applypilot-0.2.0/.github/workflows/ci.yml

@@ -0,0 +1,29 @@
+name: CI
+
+on:
+  workflow_dispatch:  # manual trigger only
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.11", "3.12", "3.13"]
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install dependencies
+        run: pip install -e ".[dev]"
+
+      - name: Lint
+        run: ruff check src/
+
+      - name: Test
+        run: pytest tests/ -v

applypilot-0.2.0/.github/workflows/publish.yml

@@ -0,0 +1,31 @@
+name: Publish to PyPI
+
+on:
+  push:
+    tags:
+      - "v*"
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write  # required for OIDC trusted publishing
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install build tools
+        run: pip install build
+
+      - name: Build package
+        run: python -m build
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

applypilot-0.2.0/.gitignore

@@ -0,0 +1,41 @@
+# User data (NEVER commit)
+profile.json
+resume.txt
+resume.pdf
+*.env
+.env.*
+!.env.example
+
+# Runtime artifacts
+*.db
+tailored_resumes/
+cover_letters/
+chrome-workers/
+apply-workers/
+apply_logs/
+logs/
+
+# MCP configs (per-machine)
+.mcp*.json
+
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.egg-info/
+dist/
+build/
+*.egg
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Claude Code
+.claude/

applypilot-0.2.0/CHANGELOG.md

@@ -0,0 +1,70 @@
+# Changelog
+
+All notable changes to ApplyPilot will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.2.0] - 2026-02-17
+
+### Added
+- **Parallel workers for discovery/enrichment** - `applypilot run --workers N` enables
+  ThreadPoolExecutor-based parallelism for Workday scraping, smart extract, and detail
+  enrichment. Default is sequential (1); power users can scale up.
+- **Apply utility modes** - `--gen` (generate prompt for manual debugging), `--mark-applied`,
+  `--mark-failed`, `--reset-failed` flags on `applypilot apply`
+- **Dry-run mode** - `applypilot apply --dry-run` fills forms without clicking Submit
+- **5 new tracking columns** - `agent_id`, `last_attempted_at`, `apply_duration_ms`,
+  `apply_task_id`, `verification_confidence` for better apply-stage observability
+- **Manual ATS detection** - `manual_ats` list in `config/sites.yaml` skips sites with
+  unsolvable CAPTCHAs (e.g. TCS iBegin)
+- **Qwen3 `/no_think` optimization** - automatically saves tokens when using Qwen models
+- **`config.DEFAULTS`** - centralized dict for magic numbers (`min_score`, `max_apply_attempts`,
+  `poll_interval`, `apply_timeout`, `viewport`)
+
+### Fixed
+- **Config YAML not found after install** - moved `config/` into the package at
+  `src/applypilot/config/` so YAML files (employers, sites, searches) ship with `pip install`
+- **Search config format mismatch** - wizard wrote `searches:` key but discovery code
+  expected `queries:` with tier support. Aligned wizard output and example config
+- **JobSpy install isolation** - removed python-jobspy from package dependencies due to
+  broken numpy==1.26.3 exact pin in jobspy metadata. Installed separately with `--no-deps`
+- **Scoring batch limit** - default limit of 50 silently left jobs unscored across runs.
+  Changed to no limit (scores all pending jobs in one pass)
+- **Missing logging output** - added `logging.basicConfig(INFO)` so per-job progress for
+  scoring, tailoring, and cover letters is visible during pipeline runs
+
+### Changed
+- **Blocked sites externalized** - moved from hardcoded sets in launcher.py to
+  `config/sites.yaml` under `blocked:` key
+- **Site base URLs externalized** - moved from hardcoded dict in detail.py to
+  `config/sites.yaml` under `base_urls:` key
+- **SSO domains externalized** - moved from hardcoded list in prompt.py to
+  `config/sites.yaml` under `blocked_sso:` key
+- **Prompt improvements** - screening context uses `target_role` from profile,
+  salary section includes `currency_conversion_note` and dynamic hourly rate examples
+- **`acquire_job()` fixed** - writes `agent_id` and `last_attempted_at` to proper columns
+  instead of misusing `apply_error`
+- **`profile.example.json`** - added `currency_conversion_note` and `target_role` fields
+
+## [0.1.0] - 2026-02-17
+
+### Added
+- 6-stage pipeline: discover, enrich, score, tailor, cover letter, apply
+- Multi-source job discovery: Indeed, LinkedIn, Glassdoor, ZipRecruiter, Google Jobs
+- Workday employer portal support (46 preconfigured employers)
+- Direct career site scraping (28 preconfigured sites)
+- 3-tier job description extraction cascade (JSON-LD, CSS selectors, AI fallback)
+- AI-powered job scoring (1-10 fit scale with rationale)
+- Resume tailoring with factual preservation (no fabrication)
+- Cover letter generation per job
+- Autonomous browser-based application submission via Playwright
+- Interactive setup wizard (`applypilot init`)
+- Cross-platform Chrome/Chromium detection (Windows, macOS, Linux)
+- Multi-provider LLM support (Gemini, OpenAI, local models via OpenAI-compatible endpoints)
+- Pipeline stats and HTML results dashboard
+- YAML-based configuration for employers, career sites, and search queries
+- Job deduplication across sources
+- Configurable score threshold filtering
+- Safety limits for maximum applications per run
+- Detailed application results logging

applypilot-0.2.0/CONTRIBUTING.md

@@ -0,0 +1,149 @@
+# Contributing to ApplyPilot
+
+Thank you for your interest in contributing to ApplyPilot. This guide covers everything you need to get started.
+
+## Development Setup
+
+### Prerequisites
+
+- Python 3.11 or higher
+- Git
+
+### Clone and Install
+
+```bash
+git clone https://github.com/Pickle-Pixel/ApplyPilot.git
+cd ApplyPilot
+pip install -e ".[dev]"
+playwright install chromium
+```
+
+This installs ApplyPilot in editable mode with all development dependencies (pytest, ruff, etc.) and downloads the Chromium browser binary for Playwright.
+
+### Verify Installation
+
+```bash
+applypilot --version
+pytest tests/ -v
+ruff check src/
+```
+
+## How to Contribute
+
+### Adding New Workday Employers
+
+Workday employer portals are configured in `config/employers.yaml`. To add a new employer:
+
+1. Find the company's Workday career portal URL (usually `https://company.wd5.myworkdaysite.com/`)
+2. Identify the Workday instance number (wd1, wd3, wd5, etc.) and the tenant ID
+3. Add an entry to `config/employers.yaml`:
+
+```yaml
+- name: "Company Name"
+  tenant: "company_tenant_id"
+  instance: "wd5"
+  url: "https://company.wd5.myworkdaysite.com/en-US/recruiting"
+```
+
+4. Test discovery: `applypilot discover --employer "Company Name"`
+5. Submit a PR with the new entry
+
+### Adding New Career Sites
+
+Direct career site scrapers are configured in `config/sites.yaml`. To add a new site:
+
+1. Inspect the company's careers page and identify the job listing structure
+2. Add an entry to `config/sites.yaml` with CSS selectors:
+
+```yaml
+- name: "Company Name"
+  url: "https://company.com/careers"
+  selectors:
+    job_list: ".job-listing"
+    title: ".job-title"
+    location: ".job-location"
+    link: "a.job-link"
+    description: ".job-description"
+```
+
+3. Test: `applypilot discover --site "Company Name"`
+4. Submit a PR
+
+### Bug Fixes and Features
+
+1. Check existing [issues](https://github.com/Pickle-Pixel/ApplyPilot/issues) to avoid duplicating work
+2. For new features, open an issue first to discuss the approach
+3. Fork the repo and create a feature branch from `main`
+4. Write your code with type hints and docstrings
+5. Add tests for new functionality
+6. Update the CHANGELOG.md under an `[Unreleased]` section
+7. Submit a PR
+
+## Running Tests
+
+```bash
+# Run all tests
+pytest tests/ -v
+
+# Run a specific test file
+pytest tests/test_scoring.py -v
+
+# Run with coverage
+pytest tests/ --cov=src/applypilot --cov-report=term-missing
+```
+
+## Linting and Code Style
+
+ApplyPilot uses [Ruff](https://docs.astral.sh/ruff/) for linting and formatting.
+
+```bash
+# Check for issues
+ruff check src/
+
+# Auto-fix what can be fixed
+ruff check src/ --fix
+
+# Format code
+ruff format src/
+```
+
+### Code Style Guidelines
+
+- **Type hints**: All function signatures must have type annotations
+- **Docstrings**: All public functions and classes must have docstrings (Google style)
+- **Naming**: snake_case for functions and variables, PascalCase for classes
+- **Imports**: Sorted by Ruff (isort-compatible)
+- **Line length**: 100 characters maximum
+
+## PR Guidelines
+
+- **One feature per PR.** Keep changes focused and reviewable.
+- **Include tests.** New features need test coverage. Bug fixes need a regression test.
+- **Update CHANGELOG.md.** Add your changes under `[Unreleased]`.
+- **Write a clear PR description.** Explain what changed and why.
+- **Keep commits clean.** Squash fixup commits before requesting review.
+- **CI must pass.** All linting and tests must be green.
+
+## Project Structure
+
+```
+ApplyPilot/
+├── src/applypilot/       # Main package
+│   ├── __init__.py
+│   ├── cli.py            # CLI entry points
+│   ├── discover/         # Stage 1: job discovery scrapers
+│   ├── enrich/           # Stage 2: description extraction
+│   ├── score/            # Stage 3: AI scoring
+│   ├── tailor/           # Stage 4: resume tailoring
+│   ├── cover/            # Stage 5: cover letter generation
+│   ├── apply/            # Stage 6: browser automation
+│   └── utils/            # Shared utilities
+├── config/               # Default configuration files
+├── tests/                # Test suite
+├── docs/                 # Documentation
+└── pyproject.toml        # Package configuration
+```
+
+## License
+
+By contributing to ApplyPilot, you agree that your contributions will be licensed under the [GNU Affero General Public License v3.0](LICENSE).