divapply 0.4.2__tar.gz → 0.4.4__tar.gz

divapply-0.4.4/.dockerignore

@@ -0,0 +1,34 @@
+.git
+.github
+.pytest_cache
+.ruff_cache
+__pycache__
+*.py[cod]
+*.egg-info
+build
+dist
+.venv
+.vendor
+
+# User/runtime data must be mounted at runtime, not baked into images.
+.divapply
+.applypilot
+profile.json
+resume.txt
+resume.pdf
+answers.yaml
+credentials.yaml
+*.env
+.env.*
+*.db
+*.sqlite
+*.sqlite3
+tailored_resumes
+cover_letters
+chrome-workers
+apply-workers
+logs
+apply_logs
+screenshots
+social_screenshots
+.mcp*.json

divapply-0.4.4/.github/workflows/ci.yml

@@ -0,0 +1,92 @@
+name: CI
+
+on:
+  pull_request:
+  push:
+    branches: ["main"]
+    tags-ignore: ["v*"]
+  workflow_dispatch:
+
+concurrency:
+  group: ci-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      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 }}
+          cache: pip
+
+      - name: Install dependencies
+        run: python -m pip install --upgrade pip && python -m pip install -e ".[dev]"
+
+      - name: Lint
+        run: ruff check .
+
+      - name: Test
+        run: pytest -q
+
+  package:
+    runs-on: ubuntu-latest
+    needs: test
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+          cache: pip
+
+      - name: Build package
+        run: |
+          python -m pip install --upgrade pip build twine
+          python -m build
+          python -m twine check dist/*
+
+      - name: Smoke test wheel install
+        run: |
+          python -m venv .venv-smoke
+          . .venv-smoke/bin/activate
+          python -m pip install --upgrade pip
+          WHEEL="$(ls dist/*.whl)"
+          python -m pip install "$WHEEL[full]"
+          divapply --version
+          divapply selfcheck
+
+      - name: Upload distribution artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: python-dist
+          path: dist/*
+          if-no-files-found: error
+
+  container:
+    runs-on: ubuntu-latest
+    needs: test
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Build image
+        run: docker build -t divapply:ci .
+
+      - name: Smoke test image
+        run: |
+          docker run --rm divapply:ci --version
+          docker run --rm divapply:ci selfcheck

divapply-0.4.4/.github/workflows/publish.yml

@@ -0,0 +1,79 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - "v*"
+
+concurrency:
+  group: release-${{ github.ref }}
+  cancel-in-progress: false
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/p/divapply
+    permissions:
+      contents: write
+      id-token: write
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+          cache: pip
+
+      - name: Install build tools
+        run: python -m pip install --upgrade pip build twine
+
+      - name: Validate release version
+        shell: python
+        run: |
+          import pathlib
+          import re
+          import tomllib
+
+          tag_version = "${{ github.ref_name }}".removeprefix("v")
+          pyproject_version = tomllib.loads(pathlib.Path("pyproject.toml").read_text())["project"]["version"]
+          init_text = pathlib.Path("src/divapply/__init__.py").read_text()
+          init_version = re.search(r'__version__\s*=\s*"([^"]+)"', init_text).group(1)
+
+          if tag_version != pyproject_version or tag_version != init_version:
+              raise SystemExit(
+                  f"Version mismatch: tag={tag_version}, pyproject={pyproject_version}, __init__={init_version}"
+              )
+
+          changelog = pathlib.Path("CHANGELOG.md").read_text(encoding="utf-8")
+          if f"## {tag_version}" not in changelog:
+              raise SystemExit(f"CHANGELOG.md is missing a section for {tag_version}")
+
+      - name: Build package
+        run: python -m build
+
+      - name: Check package metadata
+        run: python -m twine check dist/*
+
+      - name: Smoke test built wheel
+        run: |
+          python -m venv .venv-smoke
+          . .venv-smoke/bin/activate
+          python -m pip install --upgrade pip
+          WHEEL="$(ls dist/*.whl)"
+          python -m pip install "$WHEEL[full]"
+          divapply --version
+          divapply selfcheck
+
+      - name: Publish package to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+
+      - name: Create GitHub release
+        uses: softprops/action-gh-release@v2
+        with:
+          generate_release_notes: true
+          files: dist/*

{divapply-0.4.2 → divapply-0.4.4}/.gitignore

@@ -1,19 +1,38 @@
 # User data (NEVER commit)
+.divapply/
+.applypilot/
 profile.json
 resume.txt
 resume.pdf
+answers.yaml
 *.env
 .env.*
 !.env.example
+coursework/
+transcripts/
+# Local search config can carry personal targeting rules; the example
+# version (src/divapply/config/searches.example.yaml) stays tracked.
+/searches.yaml
+searches.local.yaml
 
 # Runtime artifacts
 *.db
+*.db-wal
+*.db-shm
+*.sqlite
+*.sqlite3
+divapply.db*
+applypilot.db*
 tailored_resumes/
 cover_letters/
 chrome-workers/
 apply-workers/
 apply_logs/
 logs/
+*.log
+screenshots/
+social_screenshots/
+.mcp-apply-*.json
 .venv/
 .vendor/
 academic_progress.txt

divapply-0.4.4/CHANGELOG.md

@@ -0,0 +1,45 @@
+# Changelog
+
+All notable changes to DivApply will be documented here.
+
+## Unreleased
+
+- Future work will continue under the DivApply branding.
+
+## 0.4.4
+
+- Added `divapply edit` as the local browser setup editor for profile and search configuration.
+- Simplified profile/search examples around no-password profile data and tiered search queries.
+- Preserved rich profile fields when saving through the editor, including references, certifications, and education metadata.
+- Improved scoring/search setup compatibility for simple `skills`, preferred roles, and ApplyPilot-style search YAML.
+- Added dashboard/accessibility, discovery, enrichment, Workday, SmartExtract, scoring, and editor regression coverage.
+- Cleaned root documentation by moving migration and AI disclosure notes under `docs/`.
+
+## 0.4.3
+
+- Fixed neutral job scoring edge cases for preferred qualifications and hard requirement gaps.
+- Kept company and source/job-board fields separate in scoring, apply prompts, logs, traces, and exports.
+- Fixed ultimate resume job selection to prioritize highest fit scores before recency.
+- Hardened resume and cover letter HTML escaping for generated PDFs.
+- Added regression coverage for scoring, apply prompt context, PDF template output, and safe exports.
+
+## 0.4.2
+
+- Added a PyPI trusted-publishing workflow for `pip install divapply` releases.
+- Reworked the README around the simple pip-first install path.
+- Kept the GitHub clone installers as fallback/development options.
+
+## 0.4.1
+
+- Fixed the GitHub Actions PyPI publish workflow so it requests repository contents access before checkout.
+- Kept the DivApply release/docs branding aligned with the Codex-assisted development disclosure.
+
+## 0.4.0
+
+- Renamed the project from ApplyPilot to DivApply.
+- Moved the Python package to `src/divapply/`.
+- Kept the public CLI entry point as `divapply`.
+- Added a Windows bootstrap install flow for fresh GitHub clones.
+- Added legacy migration support for previous `~/.applypilot` data.
+- Added hidden coursework storage for profile matching.
+- Added one-page resume shaping and tighter PDF layout defaults.

divapply-0.4.4/Dockerfile

@@ -0,0 +1,23 @@
+FROM python:3.12-slim
+
+ENV DIVAPPLY_DIR=/data \
+    PYTHONUNBUFFERED=1 \
+    PIP_NO_CACHE_DIR=1
+
+WORKDIR /app
+
+RUN useradd --create-home --uid 10001 appuser \
+    && mkdir -p /data \
+    && chown -R appuser:appuser /data
+
+COPY pyproject.toml README.md LICENSE ./
+COPY src ./src
+
+RUN python -m pip install --upgrade pip \
+    && python -m pip install .
+
+USER appuser
+VOLUME ["/data"]
+
+ENTRYPOINT ["divapply"]
+CMD ["--help"]

divapply-0.4.4/PKG-INFO

@@ -0,0 +1,321 @@
+Metadata-Version: 2.4
+Name: divapply
+Version: 0.4.4
+Summary: DivApply: AI-assisted end-to-end job application pipeline
+Project-URL: Homepage, https://github.com/InnitDivine/DivApply
+Project-URL: Repository, https://github.com/InnitDivine/DivApply
+Project-URL: Issues, https://github.com/InnitDivine/DivApply/issues
+Author: InnitDivine
+License-Expression: AGPL-3.0-only
+License-File: LICENSE
+Keywords: ai,apply,automation,job-application,job-search,resume
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: License :: OSI Approved :: GNU Affero General Public License v3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Office/Business
+Requires-Python: >=3.11
+Requires-Dist: beautifulsoup4>=4.12
+Requires-Dist: httpx>=0.24
+Requires-Dist: pandas>=2.0
+Requires-Dist: playwright>=1.40
+Requires-Dist: python-dotenv>=1.2.2
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: rich>=13.0
+Requires-Dist: typer>=0.9.0
+Provides-Extra: coursework
+Requires-Dist: pypdf>=4.0; extra == 'coursework'
+Provides-Extra: dev
+Requires-Dist: pip-audit>=2.10; extra == 'dev'
+Requires-Dist: pytest>=7.0; extra == 'dev'
+Requires-Dist: ruff>=0.1; extra == 'dev'
+Provides-Extra: full
+Requires-Dist: pypdf>=4.0; extra == 'full'
+Requires-Dist: python-jobspy<1.2,>=1.1.82; extra == 'full'
+Provides-Extra: jobspy-runtime
+Requires-Dist: python-jobspy<1.2,>=1.1.82; extra == 'jobspy-runtime'
+Description-Content-Type: text/markdown
+
+# DivApply
+
+DivApply is a local-first job application assistant. It can find jobs, enrich postings, score fit, tailor resumes, write cover letters, export PDFs, and optionally help with browser-based applications.
+
+It is designed to stay factual: it works from your profile, resume, saved preferences, and optional coursework notes. It should not invent jobs, credentials, degrees, tools, dates, metrics, or experience.
+
+## What It Does
+
+```text
+discover -> enrich -> score -> tailor -> cover -> pdf -> apply
+```
+
+- Finds jobs from configured searches and direct sources.
+- Expands postings with full descriptions and application links.
+- Scores jobs against your real experience and required criteria.
+- Separates required qualifications from preferred/nice-to-have items.
+- Generates one-page tailored resumes and cover letters.
+- Exports safe job tracking data.
+- Can run browser apply flows only when you confirm it.
+
+## Quick Start
+
+Use Python 3.12 for the smoothest setup.
+
+Recommended CLI install with `pipx`:
+
+```powershell
+python -m pip install --user pipx
+python -m pipx ensurepath
+pipx install "divapply[full]"
+pipx run --spec playwright playwright install chromium firefox
+divapply init
+divapply edit
+divapply doctor
+```
+
+Virtualenv install:
+
+```powershell
+python -m venv .venv
+.\.venv\Scripts\Activate.ps1
+python -m pip install --upgrade pip
+python -m pip install "divapply[full]"
+python -m playwright install chromium firefox
+divapply init
+divapply edit
+divapply doctor
+```
+
+Install directly from GitHub before a PyPI release is available:
+
+```powershell
+python -m pip install "divapply[full] @ git+https://github.com/InnitDivine/DivApply.git"
+```
+
+Use `divapply` without extras for the lightest install. Use `divapply[coursework]` for PDF transcript import, `divapply[jobspy-runtime]` for JobSpy-backed board discovery, or `divapply[full]` for both.
+
+Auto-apply mode also needs Node.js 18+ and an agent CLI such as Codex or Claude Code.
+
+## Clone Setup
+
+Use this if you want the repo files locally.
+
+```powershell
+git clone https://github.com/InnitDivine/DivApply.git
+cd DivApply
+.\install.ps1
+```
+
+Update an existing clone:
+
+```powershell
+git pull
+python -m pip install --upgrade -e ".[full]"
+```
+
+## First Run
+
+```powershell
+divapply init
+divapply edit
+```
+
+This creates your local app folder and setup files:
+
+- `profile.json` - personal details, work history, preferences
+- `resume.txt` - master resume facts
+- `searches.yaml` - job searches and filters
+- `.env` - API keys and runtime settings
+- `divapply.db` - local jobs database
+
+These files are private and ignored by git.
+
+Use `divapply edit` as the normal setup screen after initialization. It opens a local-only browser editor for:
+
+- Personal/contact details
+- Target work type and hourly pay
+- Preferred roles and skills
+- Work history, education, certifications, references, projects, and real metrics
+- Search locations, query tiers, job boards, and filters
+
+The editor saves `profile.json` and `searches.yaml` for you, so most users do not need to hand-edit JSON or YAML.
+
+## Daily Workflow
+
+```powershell
+divapply doctor
+divapply run
+divapply status
+divapply export jobs --out jobs.csv
+```
+
+Useful targeted runs:
+
+```powershell
+divapply run discover enrich
+divapply run score tailor cover
+divapply explain https://example.com/job
+divapply ultimate https://example.com/job
+```
+
+Use dry runs before any real browser submission:
+
+```powershell
+divapply apply --dry-run
+divapply apply --gen --url https://example.com/job
+divapply apply --yes
+```
+
+## Search Config
+
+`searches.yaml` controls what DivApply looks for.
+
+Example:
+
+```yaml
+queries:
+  - query: "student assistant"
+    tier: 1
+  - query: "front desk part time"
+    tier: 2
+  - query: "customer service"
+    tier: 3
+locations:
+  - location: "Logan, UT"
+    remote: false
+  - location: "Remote"
+    remote: true
+location:
+  accept_patterns:
+    - "Logan"
+    - "Cache Valley"
+    - "Remote"
+  reject_patterns:
+    - "Salt Lake City"
+country: "USA"
+boards:
+  - indeed
+  - linkedin
+defaults:
+  results_per_site: 50
+  hours_old: 168
+exclude_titles:
+  - "senior"
+  - "director"
+  - "clearance required"
+```
+
+Tier `1` should be your best, most specific searches. Tier `2` should be strong adjacent matches. Tier `3` should be broad fallback searches.
+
+## Resume Rules
+
+Treat `resume.txt` as the source of truth.
+
+- Keep it broad, truthful, and complete.
+- Add only real work, projects, education, certifications, tools, and dates.
+- Generated resumes are job-specific views of the master resume.
+- Coursework can help matching, but it is not copied into resumes unless it belongs there.
+
+Validation modes:
+
+```powershell
+divapply run score tailor --validation strict
+divapply run score tailor --validation normal
+divapply run score tailor --validation lenient
+```
+
+## Scoring
+
+DivApply blends:
+
+- Required/preferred keyword matching
+- Local similarity scoring
+- LLM judgment
+
+Required gaps matter more than preferred gaps. Missing preferred certifications should not block a good job match. Missing required non-substitutable items, such as a required license, degree, or clearance, can cap the score.
+
+Inspect a job:
+
+```powershell
+divapply explain https://example.com/job
+```
+
+## Exports
+
+```powershell
+divapply export jobs --out jobs.csv
+divapply export jobs --out jobs.json --format json
+```
+
+Exports include safe fields such as title, company, source site, URLs, fit score, lifecycle dates, and redacted apply errors. They do not print your full profile, resume, transcript text, or secrets.
+
+## Answer Bank
+
+Save reusable factual answers for application forms:
+
+```powershell
+divapply answers add "How many years of Python experience do you have?" "2 years."
+divapply answers list
+divapply answers match "Years using Python?"
+```
+
+Answers are local-only and must stay supported by your profile or resume.
+
+## Coursework
+
+Optional coursework data can improve matching without exposing transcript text.
+
+```powershell
+divapply import-coursework path\to\transcript.json
+divapply coursework-summary
+```
+
+Supported formats: JSON, CSV, text, and PDF if `pypdf` is installed.
+
+## Safety
+
+- Real auto-apply requires confirmation.
+- Use `--dry-run` first on new sites.
+- Do not upload private files to git.
+- Review generated resumes before sending them.
+- Do not let the browser agent enter SSNs, bank info, payment details, ID uploads, or biometric verification.
+
+Privacy details: [docs/PRIVACY.md](docs/PRIVACY.md)
+
+## Common Commands
+
+```powershell
+divapply init
+divapply edit
+divapply doctor
+divapply selfcheck
+divapply run
+divapply run -w 4
+divapply status
+divapply dashboard
+divapply explain JOB_URL
+divapply export jobs --out jobs.csv
+divapply backup
+divapply ultimate JOB_URL_OR_TITLE_FRAGMENT
+divapply apply --dry-run
+divapply apply --yes
+divapply migrate
+```
+
+## Development
+
+```powershell
+git clone https://github.com/InnitDivine/DivApply.git
+cd DivApply
+.\install.ps1 -Dev
+python -m pytest -q
+```
+
+Release notes: [CHANGELOG.md](CHANGELOG.md)
+
+Publishing notes: [PUBLISHING.md](PUBLISHING.md)
+
+Operations notes: [docs/OPERATIONS.md](docs/OPERATIONS.md)
+
+AI assistance disclosure: [docs/AI_ASSISTANCE.md](docs/AI_ASSISTANCE.md)

divapply-0.4.4/PUBLISHING.md

@@ -0,0 +1,77 @@
+# Publishing DivApply to PyPI
+
+This repo is set up for PyPI Trusted Publishing through GitHub Actions. No PyPI API token is needed.
+
+## One-Time PyPI Setup
+
+Create or sign in to a PyPI account, then add a trusted publisher for DivApply.
+
+Use these values:
+
+```text
+PyPI project name: divapply
+Owner: InnitDivine
+Repository name: DivApply
+Workflow filename: publish.yml
+Environment name: pypi
+```
+
+If PyPI asks for the full workflow path, use:
+
+```text
+.github/workflows/publish.yml
+```
+
+## Release
+
+Before tagging, run the local checks:
+
+```bash
+python -m pytest -q
+ruff check .
+python -m build
+python -m twine check dist/*
+```
+
+Update the version in both files:
+
+```text
+pyproject.toml
+src/divapply/__init__.py
+```
+
+Add the same version section to:
+
+```text
+CHANGELOG.md
+```
+
+Commit the version change, then tag and push:
+
+```bash
+git tag v0.4.4
+git push origin main
+git push origin v0.4.4
+```
+
+The `Release` workflow will build the package, verify the tag matches `pyproject.toml`, `src/divapply/__init__.py`, and `CHANGELOG.md`, publish to PyPI, and create a GitHub Release with the built artifacts. After the workflow succeeds, users can install with:
+
+```bash
+pip install "divapply[full]"
+```
+
+Before the next PyPI release, users can install the latest `main` directly from GitHub:
+
+```bash
+pip install "divapply[full] @ git+https://github.com/InnitDivine/DivApply.git"
+```
+
+## Verify
+
+```bash
+python -m pip install --upgrade "divapply[full]"
+divapply --version
+divapply doctor
+```
+
+The workflow only runs from `v*` tags and verifies that the tag matches both version files plus the changelog before publishing.