atsfill 0.0.3.dev3__tar.gz → 0.0.3.dev5__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: atsfill
-Version: 0.0.3.dev3
+Version: 0.0.3.dev5
 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
@@ -124,7 +124,8 @@ Every push to `main` that passes CI is also published as a dev release; `uvx --p
    ```
 
 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 and whether it is allowed to submit.
+`atsfill status` lists each system's side effects, whether it is allowed to submit, and how far atsfill has verified it: [the systems](docs/adapters/README.md).
+A `send` through an adapter no send was verified on goes ahead with a `warning`.
 
 ## How it works
 
@@ -147,7 +148,7 @@ The exit code is 0 for `ready` and `submitted`, 1 otherwise, 2 for a usage error
 ## More
 
 - [Architecture decisions](docs/adr/README.md): the contract, the submit gate, the browser, sessions.
-- [Hiring systems](docs/adapters/): each system's form as observed.
+- [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/

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

@@ -100,7 +100,8 @@ Every push to `main` that passes CI is also published as a dev release; `uvx --p
    ```
 
 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 and whether it is allowed to submit.
+`atsfill status` lists each system's side effects, whether it is allowed to submit, and how far atsfill has verified it: [the systems](docs/adapters/README.md).
+A `send` through an adapter no send was verified on goes ahead with a `warning`.
 
 ## How it works
 
@@ -123,7 +124,7 @@ The exit code is 0 for `ready` and `submitted`, 1 otherwise, 2 for a usage error
 ## More
 
 - [Architecture decisions](docs/adr/README.md): the contract, the submit gate, the browser, sessions.
-- [Hiring systems](docs/adapters/): each system's form as observed.
+- [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/

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

@@ -1,6 +1,6 @@
 [project]
 name = "atsfill"
-version = "0.0.3.dev3"
+version = "0.0.3.dev5"
 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.dev3 → atsfill-0.0.3.dev5}/pyproject.toml.orig

@@ -1,6 +1,6 @@
 [project]
 name = "atsfill"
-version = "0.0.3.dev3"
+version = "0.0.3.dev5"
 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.dev3 → atsfill-0.0.3.dev5}/src/atsfill/cli.py

@@ -103,7 +103,8 @@ def run(args: argparse.Namespace) -> int:
         case "status":
             report = core.status(data_dir=args.data_dir)
             emit(report)
-            return 1 if any(a.session == "signed_out" for a in report.adapters) else 0
+            signed_out = any(a.session == "signed_out" for a in report.adapters)
+            return 1 if signed_out or report.browser != report.browser_pinned else 0
         case "install-browser":
             return browser.install()
         case "login":

{atsfill-0.0.3.dev3 → atsfill-0.0.3.dev5}/src/atsfill/core/browser.py

@@ -22,6 +22,7 @@ from playwright.sync_api import Error as BrowserError
 from playwright.sync_api import TimeoutError as Timeout
 
 __all__ = [
+    "BUILD",
     "BrowserError",
     "Covered",
     "Locator",
@@ -43,6 +44,7 @@ __all__ = [
 MIN_SCREEN_HEIGHT = 1050  # leaves the window the 900px Greenhouse and Teamtailor need
 HOST_OS = {"Linux": "linux", "Darwin": "macos", "Windows": "windows"}[platform.system()]
 BUDGET = 180.0  # seconds per command, lock wait included
+BUILD = "156.0.1-beta.36"  # the Camoufox browser build, pinned so results compare across machines
 
 
 class OutOfTime(Exception):
@@ -62,8 +64,8 @@ def version() -> str:
 
 
 def install() -> int:
-    """Fetches the browser build the pinned camoufox release pairs with."""
-    return subprocess.call([sys.executable, "-m", "camoufox", "fetch"])
+    """Fetches the pinned browser build."""
+    return subprocess.call([sys.executable, "-m", "camoufox", "fetch", f"official/{BUILD}"])
 
 
 def identity(data_dir: Path) -> dict:

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

@@ -4,7 +4,7 @@ from importlib.metadata import version
 from pathlib import Path
 
 from atsfill.adapters import ADAPTERS
-from atsfill.core import accounts, attempts, browser, matching, paths
+from atsfill.core import accounts, attempts, browser, matching, paths, registry
 from atsfill.core.adapter import Adapter, Blocked, NeedsAccount, Unsupported
 from atsfill.core.browser import Covered, OutOfTime, Page, open_page
 from atsfill.core.results import (
@@ -138,6 +138,7 @@ def _form_command(
         result = _fill(page, adapter, url, answers)
         if not send or result.status is not Status.READY:
             return result
+        result.warning = _unverified(adapter.name)
         attempts.record(data, posting, attempts.PENDING, url=url)
         try:
             result.evidence = adapter.submit(page)
@@ -194,6 +195,15 @@ def send(
     )
 
 
+def _unverified(adapter: str) -> str | None:
+    """The warning a send carries when no send through the adapter was verified (ADR 0012)."""
+    system = registry.for_adapter(adapter)
+    if system and system.send_verified:
+        return None
+    state = system.state if system else None
+    return f"not_send_verified: {adapter} is {state or 'not in the registry'}"
+
+
 def _session_state(adapter: Adapter, data: Path) -> str | None:
     if not isinstance(adapter, NeedsAccount):
         return None
@@ -208,16 +218,22 @@ def status(*, data_dir: Path | None = None) -> StatusReport:
         data_dir=data,
         config=paths.config_file(),
         browser=browser.version(),
-        adapters=[
-            AdapterState(
-                a.name,
-                submit_enabled=paths.submit_enabled(a.name),
-                side_effects=a.side_effects,
-                side_effects_acknowledged=paths.acknowledged(a.name),
-                session=_session_state(a, data),
-            )
-            for a in ADAPTERS
-        ],
+        browser_pinned=browser.BUILD,
+        adapters=[_adapter_state(a, data) for a in ADAPTERS],
+    )
+
+
+def _adapter_state(adapter: Adapter, data: Path) -> AdapterState:
+    system = registry.for_adapter(adapter.name)
+    verified = system.state if system 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,
+        session=_session_state(adapter, data),
     )
 
 

atsfill-0.0.3.dev5/src/atsfill/core/registry.py

@@ -0,0 +1,153 @@
+"""The committed registry of hiring systems (ADR 0012)."""
+
+import tomllib
+from dataclasses import dataclass, fields
+from datetime import date
+from functools import cache
+from importlib.resources import files
+
+KINDS = ("ats", "board", "aggregator", "custom")
+ACCOUNTS = ("none", "to_send", "to_read")  # also the backlog order (ADR 0013)
+HOSTING = ("hosted", "embedded")
+VENDORS = ("DataDome", "Cloudflare", "Akamai", "PerimeterX", "unknown")
+STEPS = ("posting", "form", "upload")
+STATES = ("mapped", "dry_run_verified", "send_verified")
+
+
+@dataclass(frozen=True)
+class Verification:
+    date: date
+    version: str
+    by: str
+
+
+@dataclass(frozen=True)
+class Block:
+    vendor: str
+    signal: str
+    step: str
+    date: date
+    version: str
+    camoufox: str
+    browser: str
+
+
+@dataclass(frozen=True)
+class System:
+    source: str
+    kind: str
+    account: str
+    hosting: tuple[str, ...]
+    adapter: str | None = None
+    share: float | None = None
+    block: Block | None = None
+    mapped: Verification | None = None
+    dry_run_verified: Verification | None = None
+    send_verified: Verification | None = None
+
+    @property
+    def state(self) -> str | None:
+        """The furthest state reached; each one implies the ones before it."""
+        return next((s for s in reversed(STATES) if getattr(self, s)), None)
+
+
+def _one_of(source: str, key: str, value: object, allowed: tuple[str, ...]) -> None:
+    if value not in allowed:
+        raise ValueError(f"{source}: {key} = {value!r}, expected one of {', '.join(allowed)}")
+
+
+def _system(source: str, entry: dict) -> System:
+    known = {f.name for f in fields(System)} - {"source"}
+    if unknown := entry.keys() - known:
+        raise ValueError(f"{source}: unknown keys {', '.join(sorted(unknown))}")
+    _one_of(source, "kind", entry.get("kind"), KINDS)
+    _one_of(source, "account", entry.get("account"), ACCOUNTS)
+    for h in entry.get("hosting", []):
+        _one_of(source, "hosting", h, HOSTING)
+    block = entry.get("block")
+    if block is not None:
+        _one_of(source, "block.vendor", block.get("vendor"), VENDORS)
+        _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}
+    return System(
+        source,
+        entry["kind"],
+        entry["account"],
+        tuple(entry.get("hosting", [])),
+        entry.get("adapter"),
+        entry.get("share"),
+        block,
+        **states,
+    )
+
+
+def parse(text: str) -> dict[str, System]:
+    return {source: _system(source, entry) for source, entry in tomllib.loads(text).items()}
+
+
+@cache
+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."""
+    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"
+
+
+def for_adapter(name: str) -> System | None:
+    return next((s for s in systems().values() if s.adapter == name), None)
+
+
+def _backlog_key(s: System) -> tuple:
+    return (s.block is not None, ACCOUNTS.index(s.account), -(s.share or 0), s.source)
+
+
+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 ""
+    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]
+    return "| " + " | ".join(cells) + " |"
+
+
+def backlog(registry: dict[str, System] | None = None) -> str:
+    """`docs/adapters/README.md`: the systems in backlog order (ADR 0013)."""
+    registry = systems() if registry is None else registry
+    head = "| Source | Kind | Share | Account | Hosting | Block | State |\n" + "|---" * 7 + "|"
+    adapters = sorted(
+        (s for s in registry.values() if s.kind in ("ats", "board")), key=_backlog_key
+    )
+    others = sorted(
+        (s for s in registry.values() if s.kind not in ("ats", "board")), key=_backlog_key
+    )
+    text = [
+        "# Hiring systems",
+        "",
+        "Generated from [src/atsfill/registry.toml](../../src/atsfill/registry.toml) by"
+        " `uv run scripts/backlog.py`. The registry is described in"
+        " [ADR 0012](../adr/0012-systems-registry.md), the order in"
+        " [ADR 0013](../adr/0013-survey-and-adapter-rounds.md): no account first, blocked last,"
+        " then by share of postings.",
+        "",
+        head,
+        *map(_row, adapters),
+    ]
+    if others:
+        text += ["", "Aggregators and company-built forms, counted and not adapted:", "", head]
+        text += map(_row, others)
+    return "\n".join(text) + "\n"

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

@@ -61,6 +61,7 @@ class Result:
     checks: list[Check] = field(default_factory=list)
     side_effects: list[SideEffect] = field(default_factory=list)
     evidence: str | None = None
+    warning: str | None = None  # `code: detail`, on a send that went ahead anyway
 
 
 @dataclass
@@ -69,6 +70,8 @@ class AdapterState:
     submit_enabled: bool
     side_effects: list[SideEffect]
     side_effects_acknowledged: bool
+    verified: str | None = None  # mapped | dry_run_verified | send_verified (ADR 0012)
+    verified_version: str | None = None
     session: str | None = None  # signed_in | signed_out | missing, for a system with accounts
 
 
@@ -77,7 +80,8 @@ class StatusReport:
     version: str
     data_dir: Path
     config: Path
-    browser: str
+    browser: str  # the installed build
+    browser_pinned: str
     adapters: list[AdapterState]
 
 

atsfill-0.0.3.dev5/src/atsfill/registry.toml

@@ -0,0 +1,39 @@
+# The hiring systems atsfill has mapped (ADR 0012), one table per freehire `source`.
+# `docs/adapters/README.md` is generated from this file: `uv run scripts/backlog.py`.
+#
+# kind      ats | board | aggregator | custom
+# share     fraction of freehire's postings, worldwide, from its `source` facet
+# account   none | to_send | to_read
+# hosting   hosted, embedded: where the form is found
+# 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
+
+[ashby]
+kind = "ats"
+account = "none"
+hosting = ["hosted", "embedded"]
+adapter = "ashby"
+send_verified = { date = 2026-10-18, version = "0.0.2", by = "shbernal" }
+
+[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" }