atsfill 0.0.3.dev5__tar.gz → 0.0.3.dev7__tar.gz

{atsfill-0.0.3.dev5 → atsfill-0.0.3.dev7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: atsfill
-Version: 0.0.3.dev5
+Version: 0.0.3.dev7
 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
@@ -52,6 +52,10 @@ It is built for agents with a shell: every command prints one JSON document and
 
 ## Supported hiring systems
 
+<!-- badges -->
+![ashby: send verified 2026-10-19](https://img.shields.io/badge/ashby-send%20verified%202026--10--19-9ece6a) ![greenhouse: unverified](https://img.shields.io/badge/greenhouse-unverified-565f89) ![teamtailor: unverified](https://img.shields.io/badge/teamtailor-unverified-565f89) ![wttj: unverified](https://img.shields.io/badge/wttj-unverified-565f89)
+<!-- /badges -->
+
 | System | Account needed | `read` without a browser |
 | --- | --- | --- |
 | Ashby | no | yes |

{atsfill-0.0.3.dev5 → atsfill-0.0.3.dev7}/README.md

@@ -28,6 +28,10 @@ It is built for agents with a shell: every command prints one JSON document and
 
 ## Supported hiring systems
 
+<!-- badges -->
+![ashby: send verified 2026-10-19](https://img.shields.io/badge/ashby-send%20verified%202026--10--19-9ece6a) ![greenhouse: unverified](https://img.shields.io/badge/greenhouse-unverified-565f89) ![teamtailor: unverified](https://img.shields.io/badge/teamtailor-unverified-565f89) ![wttj: unverified](https://img.shields.io/badge/wttj-unverified-565f89)
+<!-- /badges -->
+
 | System | Account needed | `read` without a browser |
 | --- | --- | --- |
 | Ashby | no | yes |

{atsfill-0.0.3.dev5 → atsfill-0.0.3.dev7}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "atsfill"
-version = "0.0.3.dev5"
+version = "0.0.3.dev7"
 description = "Read, dry-run and submit job application forms on hiring systems: Ashby, Greenhouse, Teamtailor, Welcome to the Jungle."
 readme = "README.md"
 license = "MIT"

{atsfill-0.0.3.dev5 → atsfill-0.0.3.dev7}/pyproject.toml.orig

@@ -1,6 +1,6 @@
 [project]
 name = "atsfill"
-version = "0.0.3.dev5"
+version = "0.0.3.dev7"
 description = "Read, dry-run and submit job application forms on hiring systems: Ashby, Greenhouse, Teamtailor, Welcome to the Jungle."
 readme = "README.md"
 license = "MIT"

{atsfill-0.0.3.dev5 → atsfill-0.0.3.dev7}/src/atsfill/adapters/ashby.py

@@ -1,12 +1,14 @@
 """Ashby (`jobs.ashbyhq.com`, and career pages embedding it), as docs/adapters/ashby.md observes.
 
-Every change posts `ApiSetFormValue`, whose response holds the form as Ashby will receive it:
-that is the read-back, kept per form since a survey answer returns the survey alone.
+Every change posts a mutation whose response holds the form as Ashby will receive it: that is
+the read-back, kept per form since a survey answer returns the survey alone.
 """
 
 import json
 import time
 import urllib.request
+from collections.abc import Callable
+from functools import partial
 from typing import Any
 from urllib.parse import parse_qs, urlsplit
 
@@ -31,6 +33,7 @@ TYPES = {
     "String": FieldType.TEXT,
     "Email": FieldType.TEXT,
     "LongText": FieldType.TEXT,
+    "Url": FieldType.TEXT,
     "Date": FieldType.DATE,
     "Number": FieldType.TEXT,
     "Phone": FieldType.PHONE,
@@ -42,6 +45,7 @@ TYPES = {
 }
 SETTLE_S = 1.5
 READ_BACK_TIMEOUT_S = 30
+SAVE_TIMEOUT_MS = 30_000
 SUBMIT_TIMEOUT_MS = 90_000
 
 
@@ -70,7 +74,7 @@ class Ashby:
 
     def __init__(self) -> None:
         self._forms: list[dict[str, Any]] = []  # the application form, then each survey
-        self._pending = 0
+        self._pending: set[Any] = set()  # GraphQL requests in flight, since `read_form`
         self._last_change = 0.0
         self._hosted: str | None = None  # the jobs.ashbyhq.com posting a custom domain embeds
 
@@ -132,6 +136,7 @@ class Ashby:
         return [self._field(e) for e in self._entries()]
 
     def fill(self, page: Page, answers: dict[str, Answer]) -> None:
+        """One save at a time: saves in flight together overwrite each other at Ashby."""
         fields = {e["field"]["path"]: self._field(e) for e in self._entries()}
         for field_id, answer in answers.items():
             entry = page.locator(f'[data-field-path="{field_id}"]')
@@ -140,30 +145,49 @@ class Ashby:
                 case FieldType.TEXT | FieldType.DATE | FieldType.PHONE, str():
                     box = entry.locator("input, textarea").first
                     box.fill(answer)
-                    box.blur()
+                    self._saved(page, box.blur)
+                case FieldType.CHOICE, str() if entry.locator("input[role=combobox]").count():
+                    entry.locator("input[role=combobox]").fill(answer)
+                    option = page.get_by_role("option", name=answer, exact=True)
+                    self._saved(page, option.click)
                 case FieldType.CHOICE, str():
-                    entry.get_by_text(answer, exact=True).click()
+                    self._saved(page, entry.get_by_text(answer, exact=True).click)
                 case FieldType.MULTI_CHOICE, list():
                     for value in answer:
-                        entry.get_by_text(value, exact=True).click()
+                        self._saved(page, entry.get_by_text(value, exact=True).click)
                 case FieldType.TYPEAHEAD, str():
-                    box = entry.locator("input[role=combobox]")
-                    box.fill(answer)
-                    page.get_by_role("option").filter(has_text=answer).first.click()
+                    entry.locator("input[role=combobox]").fill(answer)
+                    option = page.get_by_role("option").filter(has_text=answer).first
+                    self._saved(page, option.click)
                 case FieldType.FILE, str():
-                    entry.locator("input[type=file]").set_input_files(answer)
+                    upload = entry.locator("input[type=file]")
+                    self._saved(page, partial(upload.set_input_files, answer))
                 case kind, _:
                     raise Unsupported(
                         f"form_shape: cannot fill {field_id}, a {kind}, with {answer!r}"
                     )
         self._answered = list(answers)
 
+    def _saved(self, page: Page, change: Callable[[], None]) -> None:
+        """Makes the change, then waits for its save and any other request it set off. A
+        change Ashby does not save shows in the read-back."""
+        try:
+            with page.expect_response(
+                lambda r: _op(r).startswith("ApiSetFormValue"), timeout=SAVE_TIMEOUT_MS
+            ):
+                change()
+        except Timeout:
+            return
+        deadline = time.monotonic() + SAVE_TIMEOUT_MS / 1000
+        while self._pending and time.monotonic() < deadline:
+            page.wait_for_timeout(100)
+
     def read_back(self, page: Page) -> dict[str, Answer]:
         """Ashby's last returned form, once every answer is held and no request is in flight."""
         deadline = time.monotonic() + READ_BACK_TIMEOUT_S
         while time.monotonic() < deadline:
             values = self._values()
-            quiet = self._pending == 0 and time.monotonic() - self._last_change > SETTLE_S
+            quiet = not self._pending and time.monotonic() - self._last_change > SETTLE_S
             if quiet and all(values.get(i) is not None for i in self._answered):
                 break
             page.wait_for_timeout(250)
@@ -248,15 +272,18 @@ class Ashby:
 
     def _on_request(self, request: Any) -> None:
         if "/api/non-user-graphql" in request.url:
-            self._pending += 1
+            self._pending.add(request)
 
     def _on_finished(self, request: Any) -> None:
         if "/api/non-user-graphql" in request.url:
-            self._pending -= 1
+            self._pending.discard(request)
             self._last_change = time.monotonic()
 
     def _on_response(self, response: Response) -> None:
-        if _op(response) == "ApiSetFormValue" and response.ok:
-            render = response.json()["data"]["setFormValue"]
-            if render:
+        """Any response holding a form render: a value goes to `ApiSetFormValue`, a file to
+        `ApiSetFormValueToFile` once its upload ends, after saves made later."""
+        if not _op(response).startswith("ApiSetFormValue") or not response.ok:
+            return
+        for render in (response.json().get("data") or {}).values():
+            if isinstance(render, dict) and "sections" in render:
                 self._replace(render)

{atsfill-0.0.3.dev5 → atsfill-0.0.3.dev7}/src/atsfill/core/commands.py

@@ -30,12 +30,14 @@ def _login_required(url: str, adapter: Adapter) -> Result:
 
 @contextmanager
 def _opened(
-    data: Path, url: str, sessions: Sessions | None
+    data: Path, url: str, sessions: Sessions | None, detected: list[str]
 ) -> Generator[tuple[Page, Adapter] | Result]:
     """The loaded page and the adapter that claims it by its URL, else by its page; or the
     result that ends the command first. An adapter that needs an account gets its session,
-    and only that adapter's (ADR 0007)."""
+    and only that adapter's (ADR 0007). The adapter's name goes in `detected` once known."""
     adapter = _detect(url)
+    if adapter:
+        detected.append(adapter.name)
     session = None
     if isinstance(adapter, NeedsAccount):
         session = (sessions or {}).get(adapter.name) or accounts.session_file(data, adapter.name)
@@ -44,7 +46,8 @@ def _opened(
             return
     with open_page(data, session) as page:
         page.goto(url)
-        adapter = adapter or _detect(url, page)
+        if adapter is None and (adapter := _detect(url, page)):
+            detected.append(adapter.name)
         if adapter is None:
             yield _no_adapter(url)
         elif isinstance(adapter, NeedsAccount) and not (
@@ -77,16 +80,18 @@ def _stops(result: Result) -> Generator[None]:
         result.status, result.reason = Status.BLOCKED, f"covered: {e}"
 
 
-def _in_budget(url: str, command: Callable[[], Result]) -> Result:
+def _in_budget(url: str, command: Callable[[list[str]], Result]) -> Result:
     """Runs a command to a status whatever happens: past the click it reports `unknown` itself,
-    before it an error the adapter did not expect means the page is not one it handles."""
+    before it an error the adapter did not expect means the page is not one it handles. The
+    result keeps the adapter detected before the stop."""
+    detected: list[str] = []
     try:
-        return command()
+        return command(detected)
     except OutOfTime as e:
-        return Result(Status.BLOCKED, url, reason=f"time_budget: {e}")
+        return Result(Status.BLOCKED, url, (detected or [None])[-1], f"time_budget: {e}")
     except Exception as e:
         reason = f"adapter_error: {type(e).__name__}: {e}"
-        return Result(Status.UNSUPPORTED, url, reason=reason)
+        return Result(Status.UNSUPPORTED, url, (detected or [None])[-1], reason)
 
 
 def _fill(page: Page, adapter: Adapter, url: str, answers: dict[str, Answer]) -> Result:
@@ -104,8 +109,8 @@ def _fill(page: Page, adapter: Adapter, url: str, answers: dict[str, Answer]) ->
     return result
 
 
-def _read_page(data: Path, url: str, sessions: Sessions | None) -> Result:
-    with _opened(data, url, sessions) as opened:
+def _read_page(data: Path, url: str, sessions: Sessions | None, detected: list[str]) -> Result:
+    with _opened(data, url, sessions, detected) as opened:
         if isinstance(opened, Result):
             return opened
         page, adapter = opened
@@ -122,8 +127,9 @@ def _form_command(
     sessions: Sessions | None,
     send: bool,
     resend: bool,
+    detected: list[str],
 ) -> Result:
-    with _opened(data, url, sessions) as opened:
+    with _opened(data, url, sessions, detected) as opened:
         if isinstance(opened, Result):
             return opened
         page, adapter = opened
@@ -165,7 +171,7 @@ def read(url: str, *, data_dir: Path | None = None, sessions: Sessions | None =
             result.fields = fields
             return result
     data = paths.data_dir(data_dir)
-    return _in_budget(url, lambda: _read_page(data, url, sessions))
+    return _in_budget(url, lambda seen: _read_page(data, url, sessions, seen))
 
 
 def fill(
@@ -177,7 +183,7 @@ def fill(
 ) -> Result:
     data = paths.data_dir(data_dir)
     return _in_budget(
-        url, lambda: _form_command(data, url, answers, sessions, send=False, resend=False)
+        url, lambda seen: _form_command(data, url, answers, sessions, False, False, seen)
     )
 
 
@@ -191,13 +197,16 @@ def send(
 ) -> Result:
     data = paths.data_dir(data_dir)
     return _in_budget(
-        url, lambda: _form_command(data, url, answers, sessions, send=True, resend=resend)
+        url, lambda seen: _form_command(data, url, answers, sessions, True, resend, seen)
     )
 
 
 def _unverified(adapter: str) -> str | None:
-    """The warning a send carries when no send through the adapter was verified (ADR 0012)."""
+    """The warning a send carries when no send through the adapter was verified, or the last
+    verified one fails now (ADR 0012)."""
     system = registry.for_adapter(adapter)
+    if system and system.send_broken:
+        return f"send_broken: {_broken(system)}"
     if system and system.send_verified:
         return None
     state = system.state if system else None
@@ -223,16 +232,26 @@ def status(*, data_dir: Path | None = None) -> StatusReport:
     )
 
 
+def _broken(system: registry.System) -> str:
+    broken, last = system.send_broken, system.send_verified
+    assert broken
+    since = f"send broken since {broken.date} ({broken.version}), {broken.reason}"
+    return since + (f"; last verified {last.date} ({last.version})" if last else "")
+
+
 def _adapter_state(adapter: Adapter, data: Path) -> AdapterState:
     system = registry.for_adapter(adapter.name)
     verified = system.state if system else None
+    v = getattr(system, verified) if system and verified else None
     return AdapterState(
         adapter.name,
         submit_enabled=paths.submit_enabled(adapter.name),
         side_effects=adapter.side_effects,
         side_effects_acknowledged=paths.acknowledged(adapter.name),
         verified=verified,
-        verified_version=getattr(system, verified).version if system and verified else None,
+        verified_version=v.version if v else None,
+        verified_release=registry.release(v.version, version("atsfill")) if v else None,
+        send_broken=_broken(system) if system and system.send_broken else None,
         session=_session_state(adapter, data),
     )
 

{atsfill-0.0.3.dev5 → atsfill-0.0.3.dev7}/src/atsfill/core/registry.py

@@ -12,13 +12,28 @@ HOSTING = ("hosted", "embedded")
 VENDORS = ("DataDome", "Cloudflare", "Akamai", "PerimeterX", "unknown")
 STEPS = ("posting", "form", "upload")
 STATES = ("mapped", "dry_run_verified", "send_verified")
+CAUSES = ("system", "code", "unknown")
+RELEASES = ("this_release", "older", "newer")
 
 
 @dataclass(frozen=True)
 class Verification:
+    date: date
+    version: str  # the release, compared with the installed one
+    by: str
+    commit: str | None = None  # the exact code
+
+
+@dataclass(frozen=True)
+class Broken:
+    """A send that worked fails now (ADR 0012); `reason` names fields and steps, never postings."""
+
     date: date
     version: str
+    commit: str
     by: str
+    reason: str
+    cause: str = "unknown"
 
 
 @dataclass(frozen=True)
@@ -43,7 +58,8 @@ class System:
     block: Block | None = None
     mapped: Verification | None = None
     dry_run_verified: Verification | None = None
-    send_verified: Verification | None = None
+    send_verified: Verification | None = None  # the last known good, kept through a break
+    send_broken: Broken | None = None
 
     @property
     def state(self) -> str | None:
@@ -70,6 +86,10 @@ def _system(source: str, entry: dict) -> System:
         _one_of(source, "block.step", block.get("step"), STEPS)
         block = Block(**block)
     states = {s: Verification(**entry[s]) for s in STATES if s in entry}
+    broken = entry.get("send_broken")
+    if broken is not None:
+        _one_of(source, "send_broken.cause", broken.get("cause", "unknown"), CAUSES)
+        broken = Broken(**broken)
     return System(
         source,
         entry["kind"],
@@ -79,6 +99,7 @@ def _system(source: str, entry: dict) -> System:
         entry.get("share"),
         block,
         **states,
+        send_broken=broken,
     )
 
 
@@ -91,20 +112,36 @@ def systems() -> dict[str, System]:
     return parse(files("atsfill").joinpath("registry.toml").read_text())
 
 
-def with_state(text: str, source: str, state: str, v: Verification) -> str:
-    """The registry file's text with `state` of `source` set to `v`, the rest untouched."""
+def _toml(value: object) -> str:
+    return str(value) if isinstance(value, date) else f'"{value}"'
+
+
+def with_state(text: str, source: str, key: str, value: Verification | Broken) -> str:
+    """The registry file's text with `key` of `source` set to `value`, the rest untouched.
+    Writing `send_verified` ends a `send_broken`."""
     lines = text.splitlines()
     start = lines.index(f"[{source}]")
     end = next((i for i in range(start + 1, len(lines)) if lines[i].startswith("[")), len(lines))
     while lines[end - 1] == "":
         end -= 1
-    entry = f'{state} = {{ date = {v.date}, version = "{v.version}", by = "{v.by}" }}'
-    at = next((i for i in range(start, end) if lines[i].startswith(f"{state} =")), None)
-    if at is None:
-        lines.insert(end, entry)
-    else:
-        lines[at] = entry
-    return "\n".join(lines) + "\n"
+    gone = {key, "send_broken"} if key == "send_verified" else {key}
+    entry = lines[start:end]
+    at = next((i for i, x in enumerate(entry) if x.split(" =")[0] in gone), len(entry))
+    entry = [x for x in entry if x.split(" =")[0] not in gone]
+    pairs = ", ".join(
+        f"{f.name} = {_toml(getattr(value, f.name))}"
+        for f in fields(value)
+        if getattr(value, f.name) is not None
+    )
+    entry.insert(min(at, len(entry)), f"{key} = {{ {pairs} }}")
+    return "\n".join(lines[:start] + entry + lines[end:]) + "\n"
+
+
+def release(verified: str, installed: str) -> str:
+    """Whether a verified release is the installed one, `older` or `newer`."""
+    as_tuple = lambda v: tuple(int(n) for n in v.split("+")[0].split("."))  # noqa: E731
+    a, b = as_tuple(verified), as_tuple(installed)
+    return "this_release" if a == b else "older" if a < b else "newer"
 
 
 def for_adapter(name: str) -> System | None:
@@ -118,7 +155,7 @@ def _backlog_key(s: System) -> tuple:
 def _row(s: System) -> str:
     share = f"{s.share:.1%}" if s.share is not None else ""
     block = f"{s.block.vendor} at {s.block.step}" if s.block else ""
-    state = s.state or ""
+    state = "send_broken" if s.send_broken else s.state or ""
     if s.adapter:
         state = f"[{state}]({s.adapter}.md)" if state else f"[adapter]({s.adapter}.md)"
     cells = [s.source, s.kind, share, s.account, ", ".join(s.hosting), block, state]
@@ -151,3 +188,28 @@ def backlog(registry: dict[str, System] | None = None) -> str:
         text += ["", "Aggregators and company-built forms, counted and not adapted:", "", head]
         text += map(_row, others)
     return "\n".join(text) + "\n"
+
+
+BADGES = ("<!-- badges -->", "<!-- /badges -->")
+COLORS = {"send_verified": "9ece6a", "dry_run_verified": "7aa2f7", "mapped": "a9b1d6"}
+
+
+def _badge(s: System) -> str:
+    if s.send_broken:
+        message, color = f"send broken {s.send_broken.date}", "f7768e"
+    elif s.state:
+        v: Verification = getattr(s, s.state)
+        message, color = f"{s.state.replace('_', ' ')} {v.date}", COLORS[s.state]
+    else:
+        message, color = "unverified", "565f89"
+    escape = lambda t: t.replace("-", "--").replace("_", "__").replace(" ", "%20")  # noqa: E731
+    url = f"https://img.shields.io/badge/{escape(s.adapter or s.source)}-{escape(message)}-{color}"
+    return f"![{s.adapter}: {message}]({url})"
+
+
+def with_badges(readme: str, registry: dict[str, System] | None = None) -> str:
+    """The README with one badge per adapter between its badge markers."""
+    registry = systems() if registry is None else registry
+    start, end = readme.index(BADGES[0]) + len(BADGES[0]), readme.index(BADGES[1])
+    badges = " ".join(_badge(s) for s in sorted(registry.values(), key=_backlog_key) if s.adapter)
+    return f"{readme[:start]}\n{badges}\n{readme[end:]}"

{atsfill-0.0.3.dev5 → atsfill-0.0.3.dev7}/src/atsfill/core/results.py

@@ -72,6 +72,8 @@ class AdapterState:
     side_effects_acknowledged: bool
     verified: str | None = None  # mapped | dry_run_verified | send_verified (ADR 0012)
     verified_version: str | None = None
+    verified_release: str | None = None  # this_release | older | newer than the installed one
+    send_broken: str | None = None  # since when and why, with the last verified send
     session: str | None = None  # signed_in | signed_out | missing, for a system with accounts
 
 

{atsfill-0.0.3.dev5 → atsfill-0.0.3.dev7}/src/atsfill/registry.toml

@@ -8,32 +8,34 @@
 # adapter   the adapter's name, when there is one
 # block     vendor, signal, step (posting | form | upload), date, version, camoufox, browser
 # mapped, dry_run_verified, send_verified
-#           date, version, by; only the user sets send_verified
+#           date, version (the release), commit (the exact code), by; only the user sets
+#           send_verified
+# send_broken
+#           date, version, commit, by, cause (system | code | unknown), reason: a send that
+#           worked fails now; send_verified stays as the last known good
 
 [ashby]
 kind = "ats"
 account = "none"
 hosting = ["hosted", "embedded"]
 adapter = "ashby"
-send_verified = { date = 2026-10-18, version = "0.0.2", by = "shbernal" }
+send_verified = { date = 2026-10-19, version = "0.0.2", by = "shbernal", commit = "7622376" }
+dry_run_verified = { date = 2026-10-19, version = "0.0.2", by = "gate", commit = "c230c5e" }
 
 [teamtailor]
 kind = "ats"
 account = "none"
 hosting = ["hosted"]
 adapter = "teamtailor"
-send_verified = { date = 2026-10-18, version = "0.0.2", by = "shbernal" }
 
 [greenhouse]
 kind = "ats"
 account = "none"
 hosting = ["hosted", "embedded"]
 adapter = "greenhouse"
-send_verified = { date = 2026-10-18, version = "0.0.2", by = "shbernal" }
 
 [wttj]
 kind = "board"
 account = "to_send"
 hosting = ["hosted"]
 adapter = "wttj"
-send_verified = { date = 2026-10-18, version = "0.0.2", by = "shbernal" }