divapply 0.4.2__tar.gz → 0.4.3__tar.gz

{divapply-0.4.2 → divapply-0.4.3}/.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.2 → divapply-0.4.3}/CHANGELOG.md

@@ -23,6 +23,14 @@ All notable changes to DivApply will be documented here.
 - Reworked the README around the simple pip-first install path.
 - Kept the GitHub clone installers as fallback/development options.
 
+## 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.
+
 ## Unreleased
 
 - Future work will continue under the DivApply branding.

{divapply-0.4.2 → divapply-0.4.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: divapply
-Version: 0.4.2
+Version: 0.4.3
 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
@@ -75,35 +75,62 @@ DivApply runs in stages:
 
 ## Install
 
+### Python Version
+
+Use Python 3.12 for the full DivApply setup.
+
+DivApply core supports Python 3.11+, but full job-board discovery uses `python-jobspy`, and JobSpy currently pins `numpy==1.26.3`. That NumPy pin can fail on newer Python releases such as Python 3.13 and Python 3.14. If you want JobSpy-backed discovery, use Python 3.11 or 3.12; Python 3.12 is recommended.
+
+Avoid Python 3.13/3.14 for the full setup until JobSpy updates its dependency pins.
+
+Windows example:
+
+```bat
+py -3.12 -m venv .venv
+.venv\Scripts\activate
+```
+
+macOS/Linux example:
+
+```bash
+python3.12 -m venv .venv
+source .venv/bin/activate
+```
+
 ### Quick Install
 
 Once DivApply is published to PyPI:
 
 ```bash
 pip install divapply
-pip install --no-deps python-jobspy && pip install pydantic tls-client requests markdownify regex
+pip install --no-deps python-jobspy
+pip install "numpy==1.26.3" "pandas>=2.1,<3.0" "markdownify>=0.13.1,<0.14.0" "regex>=2024.4.28,<2025.0.0" pydantic tls-client requests
 python -m playwright install chromium firefox
 divapply init              # one-time setup: resume, profile, preferences, API keys
 divapply doctor            # verify setup and show what's missing
 divapply run               # discover > enrich > score > tailor > cover letters
 divapply run -w 4          # same but parallel
-divapply apply             # autonomous browser-driven submission
+divapply apply --dry-run   # browser test without final submit
+divapply apply --yes       # confirmed autonomous browser-driven submission
 divapply apply -w 3        # parallel apply workers
-divapply apply --dry-run   # fill forms without submitting
+divapply selfcheck         # offline local sanity check
 ```
 
 Before the first PyPI release is published, install directly from GitHub:
 
 ```bash
 pip install git+https://github.com/InnitDivine/DivApply.git
-pip install --no-deps python-jobspy && pip install pydantic tls-client requests markdownify regex
+pip install --no-deps python-jobspy
+pip install "numpy==1.26.3" "pandas>=2.1,<3.0" "markdownify>=0.13.1,<0.14.0" "regex>=2024.4.28,<2025.0.0" pydantic tls-client requests
 python -m playwright install chromium firefox
 ```
 
-Why the second install command? `python-jobspy` pins an exact NumPy version in its metadata that can fight pip's resolver. Installing JobSpy with `--no-deps`, then installing its real runtime dependencies separately, avoids that resolver trap.
+Why the separate JobSpy install commands? `python-jobspy` pins an exact NumPy version in its metadata. Installing JobSpy with `--no-deps`, then installing the compatible runtime pins separately, avoids resolver conflicts and makes Python-version problems obvious.
 
 `divapply apply` also needs Node.js 18+ for `npx` and either the Codex CLI or Claude Code CLI.
 
+Privacy details live in [docs/PRIVACY.md](docs/PRIVACY.md).
+
 ### Clone Install
 
 Use this if you want a local checkout, development setup, or the all-in-one installer.
@@ -167,20 +194,23 @@ bash ./install.sh --recreate
 bash ./install.sh --skip-browsers
 bash ./install.sh --skip-jobspy
 bash ./install.sh --browsers all
-bash ./install.sh --python /path/to/python3.11
+bash ./install.sh --python /path/to/python3.12
 ```
 
+The installer accepts Python 3.11+ for core DivApply. If JobSpy is enabled, it requires Python 3.11 or 3.12 and will stop early on newer Python versions with a clear message.
+
 ### Publishing To PyPI
 
 This repo includes a GitHub Actions workflow for PyPI Trusted Publishing. See [PUBLISHING.md](PUBLISHING.md) for the one-time PyPI setup and release commands.
 
 ### Manual Local Install
 
-If you already have a working Python 3.11+ environment:
+If you already have a working Python 3.12 environment:
 
 ```powershell
 pip install ".[full]"
 pip install --no-deps python-jobspy
+pip install "numpy==1.26.3" "pandas>=2.1,<3.0" "markdownify>=0.13.1,<0.14.0" "regex>=2024.4.28,<2025.0.0"
 python -m playwright install chromium firefox
 ```
 
@@ -189,6 +219,7 @@ For editable development:
 ```powershell
 pip install -e ".[dev,full]"
 pip install --no-deps python-jobspy
+pip install "numpy==1.26.3" "pandas>=2.1,<3.0" "markdownify>=0.13.1,<0.14.0" "regex>=2024.4.28,<2025.0.0"
 python -m playwright install chromium firefox
 ```
 
@@ -227,9 +258,73 @@ divapply apply --dry-run
 divapply status
 divapply dashboard
 divapply import-coursework path\to\transcript.json
+divapply coursework-summary
+divapply export jobs --out jobs.csv
+divapply explain https://example.com/job
+divapply track screening https://example.com/job --follow-up 2026-05-15
+divapply followups
+divapply answers add "Years of Python?" "2 years."
+divapply selfcheck
 divapply migrate
 ```
 
+## Master Resume Workflow
+
+Treat `~/.divapply/resume.txt` as the master resume. Keep it broad, truthful, and complete enough to cover real work history, projects, skills, education, and certifications. DivApply never treats tailored resumes as new facts; each generated resume is a job-specific view of the master resume plus profile data and hidden coursework summaries.
+
+Recommended loop:
+
+1. Update `resume.txt` and `profile.json` with only verified facts.
+2. Run `divapply run score tailor --validation strict` for high-risk roles or `--validation normal` for daily use.
+3. Review generated resumes and reports in `~/.divapply/tailored_resumes/`.
+4. Convert/export only after factuality and coherence checks pass.
+
+Validation modes:
+
+- `strict`: banned wording, structure issues, fabrication, and judge failures block output.
+- `normal`: banned wording warns; fabrication and structure issues block output.
+- `lenient`: skips style strictness and LLM judge, but keeps core fabrication checks.
+- `none`: skips validation; use only for debugging.
+
+Tailoring rules:
+
+- Never invent jobs, employers, credentials, licenses, degrees, skills, coursework, tools, dates, or metrics.
+- Rephrase and emphasize only truthful material already in `resume.txt`, `profile.json`, or hidden coursework summaries.
+- Coursework can influence matching/tailoring decisions, but it is not copied into resumes unless it already belongs in the resume.
+
+## Scoring Transparency
+
+Scoring is hybrid: keyword hit-rate + local hashed embedding similarity + the existing LLM judgment. Default weights are 30% keyword, 30% embedding, 40% LLM.
+
+Scoring stores safe, human-readable fields:
+
+- `fit_score`
+- `llm_score`
+- `keyword_score`
+- `embedding_score`
+- `composite_score`
+- `score_breakdown`
+- `score_reasoning`
+- `matched_skills`
+- `missing_skills`
+- `keyword_hits`
+- `risk_flags`
+- `apply_or_skip_reason`
+
+Use `divapply explain JOB_URL` to view the breakdown for one job. Existing legacy rows show missing hybrid fields until you run `divapply rescore`. Tailoring reads score gaps as targets, but only addresses a gap when the master resume/profile already supports it.
+
+Status/export commands do not print full private resume, profile, transcript, or database text.
+
+Stage-specific LLM aliases are supported:
+
+```bash
+DIVAPPLY_LLM_SCORER=openai:gpt-5.4-mini
+DIVAPPLY_LLM_TAILOR=ollama:qwen2.5:14b
+DIVAPPLY_LLM_JUDGE=gemini:gemini-2.0-flash
+```
+
+Old `LLM_MODEL_SCORE`, `LLM_MODEL_TAILOR`, and `LLM_MODEL_COVER` variables still work.
+
 ## Configuration
 
 DivApply reads local user data from your app directory:
@@ -248,6 +343,7 @@ You can add coursework with:
 
 ```bash
 divapply import-coursework path\to\file.json
+divapply coursework-summary
 ```
 
 Supported import formats:
@@ -257,6 +353,87 @@ Supported import formats:
 - plain text
 - PDF transcripts if `pypdf` is installed
 
+`divapply coursework-summary` shows only row count, schools, subject areas, inferred skills, and import sources. It never dumps transcript text.
+
+## Search Filters
+
+`searches.yaml` supports safe filters:
+
+```yaml
+filters:
+  company_blacklist:
+    - "Example Staffing"
+  title_blacklist:
+    - "intern"
+  required_keywords:
+    - "python"
+  excluded_keywords:
+    - "clearance"
+  remote_preference: "remote"  # any, remote, hybrid, onsite
+```
+
+Older keys still work: `exclude_titles`, `title_blacklist`, `company_blacklist`, `required_keywords`, `excluded_keywords`, and `remote_preference`.
+
+## Export And Tracking
+
+Export safe job tracking fields:
+
+```bash
+divapply export jobs --out jobs.csv
+divapply export jobs --out jobs.json --format json
+```
+
+Exported columns: title, site, url, application_url, fit_score, apply_status, discovered_at, scored_at, tailored_at, applied_at, and a redacted apply_error snippet.
+
+Track lifecycle events after applying:
+
+```bash
+divapply track applied https://example.com/job
+divapply track screening https://example.com/job --follow-up 2026-05-15 --notes "Recruiter screen"
+divapply track interview https://example.com/job
+divapply track offer https://example.com/job
+divapply track rejection https://example.com/job
+divapply followups
+divapply analytics
+```
+
+Lifecycle data is append-only in `application_events`. The current state is mirrored to the jobs table for status/dashboard compatibility.
+
+## Answer Bank
+
+`~/.divapply/answers.yaml` stores reusable answers for employer form questions. It is local-only and ignored by git.
+
+```bash
+divapply answers add "How many years of Python experience do you have?" "2 years."
+divapply answers list
+divapply answers match "Years using Python?"
+```
+
+The apply agent receives the answer bank in its prompt and reuses close matches for differently worded questions. Answers must stay factual and supported by the profile/resume.
+
+## Auto-Apply Safety
+
+No real submissions are run unless you confirm them.
+
+```bash
+divapply apply --dry-run
+divapply apply --gen --url https://example.com/job
+divapply apply --mark-applied https://example.com/job
+divapply apply --mark-failed https://example.com/job --fail-reason "manual review"
+divapply apply --reset-failed
+divapply apply --yes
+```
+
+Use `--dry-run` first on new sites. `--gen --url ...` writes a prompt for manual review. `--yes` confirms real browser submission mode.
+
+## Offline Selfcheck
+
+```bash
+divapply selfcheck
+```
+
+Selfcheck verifies imports, Python version, JobSpy import, config paths, DB init, coursework count, and local directories. It does not call job boards, LLMs, browsers, apply agents, or external sites.
+
 ## Build
 
 ```bash