atsfill 0.0.3.dev16__tar.gz → 0.0.4__tar.gz

atsfill-0.0.4/PKG-INFO

@@ -0,0 +1,206 @@
+Metadata-Version: 2.4
+Name: atsfill
+Version: 0.0.4
+Summary: Read, dry-run and submit job application forms on hiring systems: Ashby, Greenhouse, Teamtailor, Welcome to the Jungle.
+Keywords: job-applications,ats,ashby,greenhouse,teamtailor,ai-agents,cli
+Author: shbernal
+License-Expression: MIT
+License-File: LICENSE
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Office/Business
+Classifier: Typing :: Typed
+Requires-Dist: camoufox==0.5.8
+Requires-Dist: filelock==4.1.1
+Requires-Dist: keyring==25.7.0
+Requires-Dist: packaging==26.3
+Requires-Dist: posthog==7.78.0
+Requires-Python: >=3.14
+Project-URL: Homepage, https://github.com/shbernal/atsfill
+Project-URL: Repository, https://github.com/shbernal/atsfill
+Project-URL: Issues, https://github.com/shbernal/atsfill/issues
+Description-Content-Type: text/markdown
+
+<div align="center">
+
+# atsfill
+
+Let your agent apply for you. One CLI for every hiring system.
+
+[![PyPI][pypi-badge]][pypi]
+[![Python][python-badge]][pypi]
+[![CI][ci-badge]][ci]
+[![License][license-badge]][license]
+
+---
+
+[Install](#install) • [Quickstart](#quickstart) • [How it works](#how-it-works) • [Docs](docs/adr/README.md)
+
+---
+
+</div>
+
+atsfill reads the application form behind a job posting, fills it with your answers, and checks what the hiring system will receive before anything is sent.
+It is built for agents with a shell: every command prints one JSON document and exits with a code a script can branch on.
+
+- `read` lists a form's fields with their ids, types, options and whether they are required.
+- `fill` is a dry run: it fills the form, reads it back field by field, and never submits.
+- `send` fills again and submits only when every answer reads back as given.
+- Submitting is off until you enable it per hiring system, in a config file the agent does not write.
+- A posting already sent is refused unless you pass `--resend`.
+
+## Supported hiring systems
+
+<!-- run-history -->
+[![oracle run history](https://shbernal.github.io/atsfill/run-history/oracle.svg)](https://shbernal.github.io/atsfill/run-history/)
+[![smartrecruiters run history](https://shbernal.github.io/atsfill/run-history/smartrecruiters.svg)](https://shbernal.github.io/atsfill/run-history/)
+[![greenhouse run history](https://shbernal.github.io/atsfill/run-history/greenhouse.svg)](https://shbernal.github.io/atsfill/run-history/)
+[![manatal run history](https://shbernal.github.io/atsfill/run-history/manatal.svg)](https://shbernal.github.io/atsfill/run-history/)
+[![paylocity run history](https://shbernal.github.io/atsfill/run-history/paylocity.svg)](https://shbernal.github.io/atsfill/run-history/)
+[![dayforce run history](https://shbernal.github.io/atsfill/run-history/dayforce.svg)](https://shbernal.github.io/atsfill/run-history/)
+[![workable run history](https://shbernal.github.io/atsfill/run-history/workable.svg)](https://shbernal.github.io/atsfill/run-history/)
+[![ashby run history](https://shbernal.github.io/atsfill/run-history/ashby.svg)](https://shbernal.github.io/atsfill/run-history/)
+[![bamboohr run history](https://shbernal.github.io/atsfill/run-history/bamboohr.svg)](https://shbernal.github.io/atsfill/run-history/)
+[![teamtailor run history](https://shbernal.github.io/atsfill/run-history/teamtailor.svg)](https://shbernal.github.io/atsfill/run-history/)
+[![jazzhr run history](https://shbernal.github.io/atsfill/run-history/jazzhr.svg)](https://shbernal.github.io/atsfill/run-history/)
+[![lever run history](https://shbernal.github.io/atsfill/run-history/lever.svg)](https://shbernal.github.io/atsfill/run-history/)
+[![hireology run history](https://shbernal.github.io/atsfill/run-history/hireology.svg)](https://shbernal.github.io/atsfill/run-history/)
+[![paycor run history](https://shbernal.github.io/atsfill/run-history/paycor.svg)](https://shbernal.github.io/atsfill/run-history/)
+[![zohorecruit run history](https://shbernal.github.io/atsfill/run-history/zohorecruit.svg)](https://shbernal.github.io/atsfill/run-history/)
+[![phenom run history](https://shbernal.github.io/atsfill/run-history/phenom.svg)](https://shbernal.github.io/atsfill/run-history/)
+[![breezy run history](https://shbernal.github.io/atsfill/run-history/breezy.svg)](https://shbernal.github.io/atsfill/run-history/)
+[![recruitee run history](https://shbernal.github.io/atsfill/run-history/recruitee.svg)](https://shbernal.github.io/atsfill/run-history/)
+[![rippling run history](https://shbernal.github.io/atsfill/run-history/rippling.svg)](https://shbernal.github.io/atsfill/run-history/)
+[![personio run history](https://shbernal.github.io/atsfill/run-history/personio.svg)](https://shbernal.github.io/atsfill/run-history/)
+[![eightfold run history](https://shbernal.github.io/atsfill/run-history/eightfold.svg)](https://shbernal.github.io/atsfill/run-history/)
+[![pinpoint run history](https://shbernal.github.io/atsfill/run-history/pinpoint.svg)](https://shbernal.github.io/atsfill/run-history/)
+[![hiringthing run history](https://shbernal.github.io/atsfill/run-history/hiringthing.svg)](https://shbernal.github.io/atsfill/run-history/)
+[![recruiterflow run history](https://shbernal.github.io/atsfill/run-history/recruiterflow.svg)](https://shbernal.github.io/atsfill/run-history/)
+[![jobaffinity run history](https://shbernal.github.io/atsfill/run-history/jobaffinity.svg)](https://shbernal.github.io/atsfill/run-history/)
+[![welcomekit run history](https://shbernal.github.io/atsfill/run-history/welcomekit.svg)](https://shbernal.github.io/atsfill/run-history/)
+[![join run history](https://shbernal.github.io/atsfill/run-history/join.svg)](https://shbernal.github.io/atsfill/run-history/)
+[![workatastartup run history](https://shbernal.github.io/atsfill/run-history/workatastartup.svg)](https://shbernal.github.io/atsfill/run-history/)
+[![wttj run history](https://shbernal.github.io/atsfill/run-history/wttj.svg)](https://shbernal.github.io/atsfill/run-history/)
+[![workday run history](https://shbernal.github.io/atsfill/run-history/workday.svg)](https://shbernal.github.io/atsfill/run-history/)
+[![successfactors run history](https://shbernal.github.io/atsfill/run-history/successfactors.svg)](https://shbernal.github.io/atsfill/run-history/)
+[![isolvedhire run history](https://shbernal.github.io/atsfill/run-history/isolvedhire.svg)](https://shbernal.github.io/atsfill/run-history/)
+[![jobstreet run history](https://shbernal.github.io/atsfill/run-history/jobstreet.svg)](https://shbernal.github.io/atsfill/run-history/)
+[![gupy run history](https://shbernal.github.io/atsfill/run-history/gupy.svg)](https://shbernal.github.io/atsfill/run-history/)
+[![ukg run history](https://shbernal.github.io/atsfill/run-history/ukg.svg)](https://shbernal.github.io/atsfill/run-history/)
+[![adpmyjobs run history](https://shbernal.github.io/atsfill/run-history/adpmyjobs.svg)](https://shbernal.github.io/atsfill/run-history/)
+<!-- /run-history -->
+
+Each line is a hiring system atsfill has an adapter for, and its [run history](https://shbernal.github.io/atsfill/run-history/): the last 30 days of runs, green when a form filled or an application went through, red when it failed.
+[The systems](docs/adapters/README.md) lists which ones need an account, to read the form or only to send it.
+Any other system returns `unsupported`, so the consumer can fall back to driving a browser itself.
+
+## Why atsfill?
+
+An agent applying through a generic browser carries each system's quirks as prose, rereads it every run, and checks the form before submitting only because an instruction says so.
+atsfill moves the quirks into one adapter per system and makes the check code: a `send` whose read-back differs from the answers is refused.
+
+| | Generic browser agent | atsfill |
+| --- | --- | --- |
+| System quirks | prose in the prompt | an adapter per system |
+| Check before submit | an instruction | the read-back must match |
+| Permission to submit | whatever the agent decides | a config file, per system |
+| Double send | possible | refused without `--resend` |
+| Output | page snapshots | one JSON result |
+
+## Install
+
+atsfill runs on Linux, macOS and Windows with Python 3.14, which `uvx` fetches if needed.
+
+```sh
+uvx atsfill install-browser
+```
+
+This downloads the Camoufox browser build atsfill is pinned to: 1.3 GB, about 2.5 GB once unpacked.
+
+Every push to `main` that passes CI is also published as a dev release; `uvx --prerelease allow atsfill` runs the newest.
+
+## Quickstart
+
+1. List the form's fields:
+
+   ```sh
+   uvx atsfill read https://job-boards.greenhouse.io/acme/jobs/1234
+   ```
+
+2. Write your answers to `answers.json`, keyed by field id. Files take an absolute path:
+
+   ```json
+   {
+     "first_name": "Ada",
+     "last_name": "Lovelace",
+     "email": "ada@example.com",
+     "resume": "/home/ada/resume.pdf"
+   }
+   ```
+
+3. Dry-run the fill. It ends `ready` when every answer reads back as given:
+
+   ```sh
+   uvx atsfill fill https://job-boards.greenhouse.io/acme/jobs/1234 --answers answers.json
+   ```
+
+4. Allow the system to submit in `~/.config/atsfill/config.toml`:
+
+   ```toml
+   submit-allowed = ["greenhouse"]
+   ```
+
+5. Send. A `submitted` result carries the evidence of the send:
+
+   ```sh
+   uvx atsfill send https://job-boards.greenhouse.io/acme/jobs/1234 --answers answers.json
+   ```
+
+A dry run is not invisible: some systems save answers or the resume as they are typed.
+`atsfill status` lists each system's side effects, whether it is allowed to submit, and its scope: [the systems](docs/adapters/README.md).
+
+One home can send for more than one user: `--user <name>` gives each their own sessions, double-send guard and `[users.<name>]` section in the config file ([ADR 0015](docs/adr/0015-users-and-accounts.md)).
+Given an account's email (`atsfill login <adapter> --email`) and a password source (a `[password-commands]` entry such as `rbw get example.com {email}`, or `--password -` on stdin), atsfill signs in by itself, and again whenever a form command finds the session signed out.
+When a system emails an OTP, on a sign-in, a sign-up or a form, atsfill gets it from the user's `[otp-commands]` entry, a command that reads the mailbox (`{email}` and `{since}` are filled in), and types it in; without one the command ends `blocked: no_otp_command`.
+Where a system's sign-up allows it, `atsfill login <adapter> --create --email <address>` (with `--details <file.json>` where the sign-up asks the user's name, phone or address) creates the account with a password atsfill generates and keeps in the system's secret store, never printed; creating an account is a side effect, never part of `fill` or `send`.
+Where a system applies only from a complete account profile, `atsfill profile <adapter>` reads its profile form and `atsfill profile <adapter> --answers <file.json>` saves it, step by step, skipping the steps that already match; a form command that meets an incomplete profile ends `blocked: profile_incomplete`, naming that command. Saving a profile is a side effect, never part of `fill` or `send` ([ADR 0017](docs/adr/0017-account-profiles.md)).
+
+## How it works
+
+```mermaid
+flowchart LR
+    CLI[atsfill CLI] --> Core
+    Core -->|detect, read, fill, read back, submit| Adapter[adapter for the system]
+    Adapter --> Browser[headless Camoufox]
+    Core --> SubmitGate{read-back matches,<br>submit enabled,<br>not already sent}
+    SubmitGate -->|yes| Submit[submit]
+    SubmitGate -->|no| Refused[refused]
+```
+
+Each command launches its own headless Camoufox, a Firefox build patched to hide automation, with a fresh context and one saved device identity.
+The core owns every rule about when a send is allowed; an adapter only knows its system's page.
+
+Every result has a `status` (`ready`, `refused`, `submitted`, `blocked`, `unknown`, `unsupported`) and, when it is not clean, a `reason` code.
+The exit code is 0 for `ready` and `submitted`, 1 otherwise, 2 for a usage error.
+
+Each `read`, `fill` and `send` sends one anonymous event (the system, the command, the status, a hash of the posting, never answers or URLs); `atsfill report` sends a failed run's URL and page, scrubbed of your answers, when you ask: [what is sent and how to turn it off](docs/telemetry.md).
+
+## More
+
+- [Architecture decisions](docs/adr/README.md): the contract, the submit gate, the browser, sessions.
+- [Hiring systems](docs/adapters/README.md): every system mapped so far, in backlog order, and each one's form as observed.
+- `atsfill --help` for every command and option.
+
+[pypi]: https://pypi.org/project/atsfill/
+[pypi-badge]: https://img.shields.io/pypi/v/atsfill?style=for-the-badge&color=7aa2f7&logo=pypi&logoColor=white
+[python-badge]: https://img.shields.io/pypi/pyversions/atsfill?style=for-the-badge&color=9ece6a&logo=python&logoColor=white
+[ci]: https://github.com/shbernal/atsfill/actions/workflows/ci.yml
+[ci-badge]: https://img.shields.io/github/actions/workflow/status/shbernal/atsfill/ci.yml?branch=main&style=for-the-badge&color=bb9af7&logo=githubactions&logoColor=white
+[license]: LICENSE
+[license-badge]: https://img.shields.io/github/license/shbernal/atsfill?style=for-the-badge&color=e0af68

atsfill-0.0.4/README.md

@@ -0,0 +1,177 @@
+<div align="center">
+
+# atsfill
+
+Let your agent apply for you. One CLI for every hiring system.
+
+[![PyPI][pypi-badge]][pypi]
+[![Python][python-badge]][pypi]
+[![CI][ci-badge]][ci]
+[![License][license-badge]][license]
+
+---
+
+[Install](#install) • [Quickstart](#quickstart) • [How it works](#how-it-works) • [Docs](docs/adr/README.md)
+
+---
+
+</div>
+
+atsfill reads the application form behind a job posting, fills it with your answers, and checks what the hiring system will receive before anything is sent.
+It is built for agents with a shell: every command prints one JSON document and exits with a code a script can branch on.
+
+- `read` lists a form's fields with their ids, types, options and whether they are required.
+- `fill` is a dry run: it fills the form, reads it back field by field, and never submits.
+- `send` fills again and submits only when every answer reads back as given.
+- Submitting is off until you enable it per hiring system, in a config file the agent does not write.
+- A posting already sent is refused unless you pass `--resend`.
+
+## Supported hiring systems
+
+<!-- run-history -->
+[![oracle run history](https://shbernal.github.io/atsfill/run-history/oracle.svg)](https://shbernal.github.io/atsfill/run-history/)
+[![smartrecruiters run history](https://shbernal.github.io/atsfill/run-history/smartrecruiters.svg)](https://shbernal.github.io/atsfill/run-history/)
+[![greenhouse run history](https://shbernal.github.io/atsfill/run-history/greenhouse.svg)](https://shbernal.github.io/atsfill/run-history/)
+[![manatal run history](https://shbernal.github.io/atsfill/run-history/manatal.svg)](https://shbernal.github.io/atsfill/run-history/)
+[![paylocity run history](https://shbernal.github.io/atsfill/run-history/paylocity.svg)](https://shbernal.github.io/atsfill/run-history/)
+[![dayforce run history](https://shbernal.github.io/atsfill/run-history/dayforce.svg)](https://shbernal.github.io/atsfill/run-history/)
+[![workable run history](https://shbernal.github.io/atsfill/run-history/workable.svg)](https://shbernal.github.io/atsfill/run-history/)
+[![ashby run history](https://shbernal.github.io/atsfill/run-history/ashby.svg)](https://shbernal.github.io/atsfill/run-history/)
+[![bamboohr run history](https://shbernal.github.io/atsfill/run-history/bamboohr.svg)](https://shbernal.github.io/atsfill/run-history/)
+[![teamtailor run history](https://shbernal.github.io/atsfill/run-history/teamtailor.svg)](https://shbernal.github.io/atsfill/run-history/)
+[![jazzhr run history](https://shbernal.github.io/atsfill/run-history/jazzhr.svg)](https://shbernal.github.io/atsfill/run-history/)
+[![lever run history](https://shbernal.github.io/atsfill/run-history/lever.svg)](https://shbernal.github.io/atsfill/run-history/)
+[![hireology run history](https://shbernal.github.io/atsfill/run-history/hireology.svg)](https://shbernal.github.io/atsfill/run-history/)
+[![paycor run history](https://shbernal.github.io/atsfill/run-history/paycor.svg)](https://shbernal.github.io/atsfill/run-history/)
+[![zohorecruit run history](https://shbernal.github.io/atsfill/run-history/zohorecruit.svg)](https://shbernal.github.io/atsfill/run-history/)
+[![phenom run history](https://shbernal.github.io/atsfill/run-history/phenom.svg)](https://shbernal.github.io/atsfill/run-history/)
+[![breezy run history](https://shbernal.github.io/atsfill/run-history/breezy.svg)](https://shbernal.github.io/atsfill/run-history/)
+[![recruitee run history](https://shbernal.github.io/atsfill/run-history/recruitee.svg)](https://shbernal.github.io/atsfill/run-history/)
+[![rippling run history](https://shbernal.github.io/atsfill/run-history/rippling.svg)](https://shbernal.github.io/atsfill/run-history/)
+[![personio run history](https://shbernal.github.io/atsfill/run-history/personio.svg)](https://shbernal.github.io/atsfill/run-history/)
+[![eightfold run history](https://shbernal.github.io/atsfill/run-history/eightfold.svg)](https://shbernal.github.io/atsfill/run-history/)
+[![pinpoint run history](https://shbernal.github.io/atsfill/run-history/pinpoint.svg)](https://shbernal.github.io/atsfill/run-history/)
+[![hiringthing run history](https://shbernal.github.io/atsfill/run-history/hiringthing.svg)](https://shbernal.github.io/atsfill/run-history/)
+[![recruiterflow run history](https://shbernal.github.io/atsfill/run-history/recruiterflow.svg)](https://shbernal.github.io/atsfill/run-history/)
+[![jobaffinity run history](https://shbernal.github.io/atsfill/run-history/jobaffinity.svg)](https://shbernal.github.io/atsfill/run-history/)
+[![welcomekit run history](https://shbernal.github.io/atsfill/run-history/welcomekit.svg)](https://shbernal.github.io/atsfill/run-history/)
+[![join run history](https://shbernal.github.io/atsfill/run-history/join.svg)](https://shbernal.github.io/atsfill/run-history/)
+[![workatastartup run history](https://shbernal.github.io/atsfill/run-history/workatastartup.svg)](https://shbernal.github.io/atsfill/run-history/)
+[![wttj run history](https://shbernal.github.io/atsfill/run-history/wttj.svg)](https://shbernal.github.io/atsfill/run-history/)
+[![workday run history](https://shbernal.github.io/atsfill/run-history/workday.svg)](https://shbernal.github.io/atsfill/run-history/)
+[![successfactors run history](https://shbernal.github.io/atsfill/run-history/successfactors.svg)](https://shbernal.github.io/atsfill/run-history/)
+[![isolvedhire run history](https://shbernal.github.io/atsfill/run-history/isolvedhire.svg)](https://shbernal.github.io/atsfill/run-history/)
+[![jobstreet run history](https://shbernal.github.io/atsfill/run-history/jobstreet.svg)](https://shbernal.github.io/atsfill/run-history/)
+[![gupy run history](https://shbernal.github.io/atsfill/run-history/gupy.svg)](https://shbernal.github.io/atsfill/run-history/)
+[![ukg run history](https://shbernal.github.io/atsfill/run-history/ukg.svg)](https://shbernal.github.io/atsfill/run-history/)
+[![adpmyjobs run history](https://shbernal.github.io/atsfill/run-history/adpmyjobs.svg)](https://shbernal.github.io/atsfill/run-history/)
+<!-- /run-history -->
+
+Each line is a hiring system atsfill has an adapter for, and its [run history](https://shbernal.github.io/atsfill/run-history/): the last 30 days of runs, green when a form filled or an application went through, red when it failed.
+[The systems](docs/adapters/README.md) lists which ones need an account, to read the form or only to send it.
+Any other system returns `unsupported`, so the consumer can fall back to driving a browser itself.
+
+## Why atsfill?
+
+An agent applying through a generic browser carries each system's quirks as prose, rereads it every run, and checks the form before submitting only because an instruction says so.
+atsfill moves the quirks into one adapter per system and makes the check code: a `send` whose read-back differs from the answers is refused.
+
+| | Generic browser agent | atsfill |
+| --- | --- | --- |
+| System quirks | prose in the prompt | an adapter per system |
+| Check before submit | an instruction | the read-back must match |
+| Permission to submit | whatever the agent decides | a config file, per system |
+| Double send | possible | refused without `--resend` |
+| Output | page snapshots | one JSON result |
+
+## Install
+
+atsfill runs on Linux, macOS and Windows with Python 3.14, which `uvx` fetches if needed.
+
+```sh
+uvx atsfill install-browser
+```
+
+This downloads the Camoufox browser build atsfill is pinned to: 1.3 GB, about 2.5 GB once unpacked.
+
+Every push to `main` that passes CI is also published as a dev release; `uvx --prerelease allow atsfill` runs the newest.
+
+## Quickstart
+
+1. List the form's fields:
+
+   ```sh
+   uvx atsfill read https://job-boards.greenhouse.io/acme/jobs/1234
+   ```
+
+2. Write your answers to `answers.json`, keyed by field id. Files take an absolute path:
+
+   ```json
+   {
+     "first_name": "Ada",
+     "last_name": "Lovelace",
+     "email": "ada@example.com",
+     "resume": "/home/ada/resume.pdf"
+   }
+   ```
+
+3. Dry-run the fill. It ends `ready` when every answer reads back as given:
+
+   ```sh
+   uvx atsfill fill https://job-boards.greenhouse.io/acme/jobs/1234 --answers answers.json
+   ```
+
+4. Allow the system to submit in `~/.config/atsfill/config.toml`:
+
+   ```toml
+   submit-allowed = ["greenhouse"]
+   ```
+
+5. Send. A `submitted` result carries the evidence of the send:
+
+   ```sh
+   uvx atsfill send https://job-boards.greenhouse.io/acme/jobs/1234 --answers answers.json
+   ```
+
+A dry run is not invisible: some systems save answers or the resume as they are typed.
+`atsfill status` lists each system's side effects, whether it is allowed to submit, and its scope: [the systems](docs/adapters/README.md).
+
+One home can send for more than one user: `--user <name>` gives each their own sessions, double-send guard and `[users.<name>]` section in the config file ([ADR 0015](docs/adr/0015-users-and-accounts.md)).
+Given an account's email (`atsfill login <adapter> --email`) and a password source (a `[password-commands]` entry such as `rbw get example.com {email}`, or `--password -` on stdin), atsfill signs in by itself, and again whenever a form command finds the session signed out.
+When a system emails an OTP, on a sign-in, a sign-up or a form, atsfill gets it from the user's `[otp-commands]` entry, a command that reads the mailbox (`{email}` and `{since}` are filled in), and types it in; without one the command ends `blocked: no_otp_command`.
+Where a system's sign-up allows it, `atsfill login <adapter> --create --email <address>` (with `--details <file.json>` where the sign-up asks the user's name, phone or address) creates the account with a password atsfill generates and keeps in the system's secret store, never printed; creating an account is a side effect, never part of `fill` or `send`.
+Where a system applies only from a complete account profile, `atsfill profile <adapter>` reads its profile form and `atsfill profile <adapter> --answers <file.json>` saves it, step by step, skipping the steps that already match; a form command that meets an incomplete profile ends `blocked: profile_incomplete`, naming that command. Saving a profile is a side effect, never part of `fill` or `send` ([ADR 0017](docs/adr/0017-account-profiles.md)).
+
+## How it works
+
+```mermaid
+flowchart LR
+    CLI[atsfill CLI] --> Core
+    Core -->|detect, read, fill, read back, submit| Adapter[adapter for the system]
+    Adapter --> Browser[headless Camoufox]
+    Core --> SubmitGate{read-back matches,<br>submit enabled,<br>not already sent}
+    SubmitGate -->|yes| Submit[submit]
+    SubmitGate -->|no| Refused[refused]
+```
+
+Each command launches its own headless Camoufox, a Firefox build patched to hide automation, with a fresh context and one saved device identity.
+The core owns every rule about when a send is allowed; an adapter only knows its system's page.
+
+Every result has a `status` (`ready`, `refused`, `submitted`, `blocked`, `unknown`, `unsupported`) and, when it is not clean, a `reason` code.
+The exit code is 0 for `ready` and `submitted`, 1 otherwise, 2 for a usage error.
+
+Each `read`, `fill` and `send` sends one anonymous event (the system, the command, the status, a hash of the posting, never answers or URLs); `atsfill report` sends a failed run's URL and page, scrubbed of your answers, when you ask: [what is sent and how to turn it off](docs/telemetry.md).
+
+## More
+
+- [Architecture decisions](docs/adr/README.md): the contract, the submit gate, the browser, sessions.
+- [Hiring systems](docs/adapters/README.md): every system mapped so far, in backlog order, and each one's form as observed.
+- `atsfill --help` for every command and option.
+
+[pypi]: https://pypi.org/project/atsfill/
+[pypi-badge]: https://img.shields.io/pypi/v/atsfill?style=for-the-badge&color=7aa2f7&logo=pypi&logoColor=white
+[python-badge]: https://img.shields.io/pypi/pyversions/atsfill?style=for-the-badge&color=9ece6a&logo=python&logoColor=white
+[ci]: https://github.com/shbernal/atsfill/actions/workflows/ci.yml
+[ci-badge]: https://img.shields.io/github/actions/workflow/status/shbernal/atsfill/ci.yml?branch=main&style=for-the-badge&color=bb9af7&logo=githubactions&logoColor=white
+[license]: LICENSE
+[license-badge]: https://img.shields.io/github/license/shbernal/atsfill?style=for-the-badge&color=e0af68

{atsfill-0.0.3.dev16 → atsfill-0.0.4}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "atsfill"
-version = "0.0.3.dev16"
+version = "0.0.4"
 description = "Read, dry-run and submit job application forms on hiring systems: Ashby, Greenhouse, Teamtailor, Welcome to the Jungle."
 readme = "README.md"
 license = "MIT"
@@ -20,13 +20,20 @@ classifiers = [
     "Environment :: Console",
     "Intended Audience :: End Users/Desktop",
     "Operating System :: MacOS",
+    "Operating System :: Microsoft :: Windows",
     "Operating System :: POSIX :: Linux",
     "Programming Language :: Python :: 3",
     "Programming Language :: Python :: 3.14",
     "Topic :: Office/Business",
     "Typing :: Typed",
 ]
-dependencies = ["camoufox==0.5.8"]
+dependencies = [
+    "camoufox==0.5.8",
+    "filelock==4.1.1",
+    "keyring==25.7.0",
+    "packaging==26.3",
+    "posthog==7.78.0",
+]
 
 [[project.authors]]
 name = "shbernal"
@@ -44,6 +51,8 @@ requires = ["uv_build>=0.13.0,<0.14.0"]
 build-backend = "uv_build"
 
 [dependency-groups]
+docs = ["zensical==0.0.73"]
+commit-check = ["commit-check==2.19.0"]
 dev = [
     "pytest>=9.1.1",
     "pytest-xdist>=3.8.0",
@@ -67,8 +76,6 @@ select = [
 
 [tool.pytest.ini_options]
 testpaths = ["tests"]
-markers = ["live: drives a real hiring system page with data from .env and .tmp/; opt-in with -m live"]
-addopts = "-m 'not live' -n 8"
 
 [[tool.uv.index]]
 name = "testpypi"

{atsfill-0.0.3.dev16 → atsfill-0.0.4}/pyproject.toml.orig

@@ -1,6 +1,6 @@
 [project]
 name = "atsfill"
-version = "0.0.3.dev16"
+version = "0.0.4"
 description = "Read, dry-run and submit job application forms on hiring systems: Ashby, Greenhouse, Teamtailor, Welcome to the Jungle."
 readme = "README.md"
 license = "MIT"
@@ -13,6 +13,7 @@ classifiers = [
     "Environment :: Console",
     "Intended Audience :: End Users/Desktop",
     "Operating System :: MacOS",
+    "Operating System :: Microsoft :: Windows",
     "Operating System :: POSIX :: Linux",
     "Programming Language :: Python :: 3",
     "Programming Language :: Python :: 3.14",
@@ -21,6 +22,10 @@ classifiers = [
 ]
 dependencies = [
     "camoufox==0.5.8",
+    "filelock==4.1.1",
+    "keyring==25.7.0",
+    "packaging==26.3",
+    "posthog==7.78.0",
 ]
 
 [project.urls]
@@ -36,6 +41,12 @@ requires = ["uv_build>=0.13.0,<0.14.0"]
 build-backend = "uv_build"
 
 [dependency-groups]
+docs = [
+    "zensical==0.0.73",
+]
+commit-check = [
+    "commit-check==2.19.0",
+]
 dev = [
     "pytest>=9.1.1",
     "pytest-xdist>=3.8.0",
@@ -52,10 +63,6 @@ select = ["E", "F", "I", "UP", "B", "SIM"]
 
 [tool.pytest.ini_options]
 testpaths = ["tests"]
-markers = [
-    "live: drives a real hiring system page with data from .env and .tmp/; opt-in with -m live",
-]
-addopts = "-m 'not live' -n 8"
 
 [[tool.uv.index]]
 name = "testpypi"

atsfill-0.0.4/src/atsfill/adapters/__init__.py

@@ -0,0 +1,84 @@
+from atsfill.adapters.adpmyjobs import ADPMyJobs
+from atsfill.adapters.ashby import Ashby
+from atsfill.adapters.bamboohr import BambooHR
+from atsfill.adapters.breezy import Breezy
+from atsfill.adapters.dayforce import Dayforce
+from atsfill.adapters.eightfold import Eightfold
+from atsfill.adapters.greenhouse import Greenhouse
+from atsfill.adapters.gupy import Gupy
+from atsfill.adapters.hireology import Hireology
+from atsfill.adapters.hiringthing import HiringThing
+from atsfill.adapters.isolvedhire import IsolvedHire
+from atsfill.adapters.jazzhr import JazzHR
+from atsfill.adapters.jobaffinity import JobAffinity
+from atsfill.adapters.jobstreet import Jobstreet
+from atsfill.adapters.join import Join
+from atsfill.adapters.lever import Lever
+from atsfill.adapters.manatal import Manatal
+from atsfill.adapters.oracle import Oracle
+from atsfill.adapters.paycor import Paycor
+from atsfill.adapters.paylocity import Paylocity
+from atsfill.adapters.personio import Personio
+from atsfill.adapters.phenom import Phenom
+from atsfill.adapters.pinpoint import Pinpoint
+from atsfill.adapters.recruitee import Recruitee
+from atsfill.adapters.recruiterflow import Recruiterflow
+from atsfill.adapters.rippling import Rippling
+from atsfill.adapters.smartrecruiters import SmartRecruiters
+from atsfill.adapters.successfactors import SuccessFactors
+from atsfill.adapters.teamtailor import Teamtailor
+from atsfill.adapters.ukg import UKG
+from atsfill.adapters.welcomekit import WelcomeKit
+from atsfill.adapters.workable import Workable
+from atsfill.adapters.workatastartup import WorkAtAStartup
+from atsfill.adapters.workday import Workday
+from atsfill.adapters.wttj import WelcomeToTheJungle
+from atsfill.adapters.zohorecruit import ZohoRecruit
+from atsfill.core.adapter import Adapter, Filtered
+
+
+def adapters() -> list[Adapter]:
+    """One fresh instance of each adapter: a command's adapters never see another posting."""
+    return [
+        Ashby(),
+        Teamtailor(),
+        Greenhouse(),
+        WelcomeToTheJungle(),
+        WorkAtAStartup(),
+        Join(),
+        JobAffinity(),
+        WelcomeKit(),
+        SmartRecruiters(),
+        Oracle(),
+        Manatal(),
+        Paylocity(),
+        Workable(),
+        Hireology(),
+        Paycor(),
+        JazzHR(),
+        Lever(),
+        Dayforce(),
+        Recruitee(),
+        Recruiterflow(),
+        Breezy(),
+        BambooHR(),
+        ZohoRecruit(),
+        Personio(),
+        Rippling(),
+        Pinpoint(),
+        HiringThing(),
+        Eightfold(),
+        Workday(),
+        Gupy(),
+        UKG(),
+        IsolvedHire(),
+        Jobstreet(),
+        ADPMyJobs(),
+        SuccessFactors(),  # it claims a career site's job path on any host
+        Phenom(),  # last: it claims a URL by its path alone
+    ]
+
+
+def filters() -> list[str]:
+    """The cosmetic filters of each adapter whose system's banner the blocker's lists miss."""
+    return [line for a in adapters() if isinstance(a, Filtered) for line in a.filters]