atsfill 0.0.4.dev126__tar.gz → 0.0.4.dev128__tar.gz

{atsfill-0.0.4.dev126 → atsfill-0.0.4.dev128}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: atsfill
-Version: 0.0.4.dev126
+Version: 0.0.4.dev128
 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
@@ -137,7 +137,7 @@ A dry run or a `send` through an adapter no send was verified on carries a `warn
 
 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.
-Where a system's sign-up allows it, `atsfill login <adapter> --create --email <address>` (with `--name` where the sign-up asks the user's name) 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'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`.
 
 ## How it works
 

{atsfill-0.0.4.dev126 → atsfill-0.0.4.dev128}/README.md

@@ -109,7 +109,7 @@ A dry run or a `send` through an adapter no send was verified on carries a `warn
 
 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.
-Where a system's sign-up allows it, `atsfill login <adapter> --create --email <address>` (with `--name` where the sign-up asks the user's name) 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'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`.
 
 ## How it works
 

{atsfill-0.0.4.dev126 → atsfill-0.0.4.dev128}/pyproject.toml

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

@@ -1,6 +1,6 @@
 [project]
 name = "atsfill"
-version = "0.0.4.dev126"
+version = "0.0.4.dev128"
 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.4.dev126 → atsfill-0.0.4.dev128}/src/atsfill/adapters/hrmdirect.py

@@ -13,7 +13,15 @@ import urllib.parse
 from typing import Any
 from urllib.parse import parse_qs, urlsplit
 
-from atsfill.core.adapter import Blocked, Gap, NotTaken, Refused, Unsupported, known_gap
+from atsfill.core.adapter import (
+    Blocked,
+    Gap,
+    NotTaken,
+    Refused,
+    SignUpDetails,
+    Unsupported,
+    known_gap,
+)
 from atsfill.core.browser import Locator, Page, Request, Timeout
 from atsfill.core.results import Answer, Field, FieldType, SideEffect
 
@@ -88,8 +96,8 @@ _FIELDS = """form => [...form.querySelectorAll('.form-field')].flatMap(f => {
 class HRMDirect:
     name = "hrmdirect"
     per_employer = True
-    asks_name = True
-    known_gaps = {"screening_first": Gap.FLOW, "sign_up_phone": Gap.FLOW}
+    asks = {"name"}
+    known_gaps = {"screening_first": Gap.FLOW}
     side_effects = [
         SideEffect(
             "sign_up", "employer", "the account is the employer's candidate, emailed a link"
@@ -174,27 +182,30 @@ class HRMDirect:
         except Timeout:
             raise Refused("wrong_password") from None
 
-    def sign_up(self, page: Page, email: str, password: str, name: str | None) -> None:
+    def sign_up(self, page: Page, email: str, password: str, details: SignUpDetails) -> None:
         """Fills the apply page's first step, which creates the account signed in and sets no
-        password: the email that follows holds a link to set one, `blocked: email_link`."""
+        password: the email that follows holds a link to set one, `blocked: email_link`. The
+        mobile phone is given only where the org requires it; a missing one is refused before
+        anything is sent."""
         _to_apply(page)
         if not page.locator(IDENTITY).is_visible():
             raise Unsupported(
                 known_gap(self, "screening_first", "the form's first page comes before sign-up")
             )
         phone = page.locator(f"{IDENTITY} .form-group:has(input.mobile-number)")
-        if phone.count() and not phone.locator(".common-option-label").count():
-            raise Unsupported(
-                known_gap(self, "sign_up_phone", "the sign-up step requires a mobile phone")
-            )
+        phone_asked = phone.count() and not phone.locator(".common-option-label").count()
+        if phone_asked and not details.phone:
+            raise Refused("sign_up_details: no phone")
         if page.locator(RECAPTCHA).count():
             raise Blocked("captcha: a reCAPTCHA box keeps the sign-up's Continue disabled")
-        first, _, last = (name or "").strip().partition(" ")
+        first, _, last = (details.name or "").strip().partition(" ")
         form = page.locator(IDENTITY)
         form.locator("input.first-name").fill(first)
         form.locator("input.last-name").fill(last or first)
         form.locator("input.email").fill(email)
         form.locator("input.email-confirm").fill(email)
+        if phone_asked:
+            form.locator("input.mobile-number").fill(details.phone or "")
         for group in form.locator(".radio-group:has(input[required])").all():
             group.locator("label:has(input[value=false])").click()  # declines, the least given
         form.locator("button.submit-button").click()

{atsfill-0.0.4.dev126 → atsfill-0.0.4.dev128}/src/atsfill/adapters/join.py

@@ -13,7 +13,15 @@ from typing import Any
 from urllib.parse import urlsplit
 
 from atsfill.core import browser
-from atsfill.core.adapter import Blocked, Gap, NotTaken, Refused, Unsupported, known_gap
+from atsfill.core.adapter import (
+    Blocked,
+    Gap,
+    NotTaken,
+    Refused,
+    SignUpDetails,
+    Unsupported,
+    known_gap,
+)
 from atsfill.core.browser import Locator, Page, Request, Response, Timeout
 from atsfill.core.results import Answer, Field, FieldType, SideEffect
 
@@ -66,7 +74,7 @@ _REVIEW = """() => [...document.querySelectorAll("a > div")].map(div => {
 class Join:
     name = "join"
     per_employer = False
-    asks_name = True  # the account's first and last name
+    asks = {"name"}  # the account's first and last name
     known_gaps = {"profile_incomplete": Gap.FLOW}
     side_effects = [
         SideEffect("sign_up", "hiring_system", "login --create creates the candidate account"),
@@ -110,10 +118,10 @@ class Join:
         if urlsplit(page.url).path == UNVERIFIED:
             raise Blocked("email_link: the account is not confirmed")
 
-    def sign_up(self, page: Page, email: str, password: str, name: str | None) -> None:
+    def sign_up(self, page: Page, email: str, password: str, details: SignUpDetails) -> None:
         """Creates the account, signed in, then waits for its confirmation link: until it is
         clicked the wizard does not open."""
-        first, _, last = (name or "").strip().rpartition(" ")
+        first, _, last = (details.name or "").strip().rpartition(" ")
         if not first or not last:
             raise Unsupported("unhandled_rendering: the sign-up asks a first and a last name")
         if _email_step(page, email):

{atsfill-0.0.4.dev126 → atsfill-0.0.4.dev128}/src/atsfill/adapters/successfactors.py

@@ -13,7 +13,15 @@ from pathlib import Path
 from typing import Any
 from urllib.parse import urlsplit
 
-from atsfill.core.adapter import Blocked, Gap, NotTaken, Refused, Unsupported, known_gap
+from atsfill.core.adapter import (
+    Blocked,
+    Gap,
+    NotTaken,
+    Refused,
+    SignUpDetails,
+    Unsupported,
+    known_gap,
+)
 from atsfill.core.browser import Locator, Page, Request, Timeout
 from atsfill.core.results import Answer, Field, FieldType, SideEffect
 
@@ -26,6 +34,8 @@ SIGNED_IN = re.compile(r"\bsignOut|\blogout\b|_logout", re.IGNORECASE)
 FIELDS = (Path(__file__).with_suffix(".js")).read_text()
 # What the candidate pages show once loaded
 SIGN_IN = "#username"
+COUNTRY = "fbclc_country"  # its options' values are ISO 3166 alpha-2 codes
+PHONE, CALLING_CODE = "#fbclc_phoneNumber", "#fbclc_ituCode"  # `CA`: `Canada (+1)`
 SIGN_UP = "#fbclc_userName"
 QUICK_APPLY = "#fbqa_apply"
 FORM = ".RCMFormField"
@@ -78,10 +88,26 @@ def _company(request: Request) -> list[tuple[str, str]]:
     )
 
 
+def _calling_code(select: Locator, details: SignUpDetails) -> tuple[str, str]:
+    """The calling code's option for the E.164 phone, the one of `country` among the countries
+    sharing it, and the national number that follows the code."""
+    options = select.evaluate("s => [...s.options].map(o => [o.value, o.textContent])")
+    phone = (details.phone or "").removeprefix("+")
+    codes = [
+        (len(m[1]), value == details.country, value)
+        for value, text in options
+        if (m := re.search(r"\(\+(\d+)\)", text)) and phone.startswith(m[1])
+    ]
+    if not codes:
+        raise Unsupported(f"unhandled_rendering: the sign-up offers no calling code for {phone}")
+    length, _, value = max(codes, key=lambda c: c[:2])  # the first of the best
+    return value, phone[length:]
+
+
 class SuccessFactors:
     name = "successfactors"
     per_employer = True
-    asks_name = True
+    asks = {"name"}
     known_gaps = {"quick_apply_sign_up": Gap.FLOW, "sign_up_fields": Gap.FLOW}
     side_effects = [
         SideEffect("sign_up", "employer", "the account is created in the employer's tenant"),
@@ -137,7 +163,11 @@ class SuccessFactors:
                 raise Blocked(f"email_link: {message}") from None
             raise Refused(f"wrong_password: {message}") from None
 
-    def sign_up(self, page: Page, email: str, password: str, name: str | None) -> None:
+    def sign_up(self, page: Page, email: str, password: str, details: SignUpDetails) -> None:
+        """Creates the account from the career site's sign-up: the name, the country of
+        residence from `country` (the list's first without it), and the phone where the site
+        requires one, its calling code picked from the number; a missing phone is refused
+        before anything is sent."""
         self._candidate(page)
         if page.locator(SIGN_IN).count():
             page.locator(REGISTER).first.click()
@@ -152,7 +182,10 @@ class SuccessFactors:
                 ) from None
             register.first.click()
         page.locator(SIGN_UP).wait_for(timeout=LANDING_TIMEOUT_MS)
-        first, _, last = (name or "").strip().partition(" ")
+        phone_asked = page.locator(f"{PHONE}[aria-required=true]:visible").count() > 0
+        if phone_asked and not details.phone:
+            raise Refused("sign_up_details: no phone")
+        first, _, last = (details.name or "").strip().partition(" ")
         for selector, value in [
             (SIGN_UP, email),
             ("#fbclc_emailConf", email),
@@ -162,10 +195,17 @@ class SuccessFactors:
             ("#fbclc_lName", last or first),
         ]:
             page.fill(selector, value)
-        for select in page.locator("select:visible").all():  # the country, a phone code
+        if phone_asked and details.phone:
+            code, national = _calling_code(page.locator(CALLING_CODE), details)
+            page.locator(CALLING_CODE).select_option(code)
+            page.fill(PHONE, national)
+        for select in page.locator("select:visible").all():  # the country, any other
             if not select.input_value():
                 values = select.evaluate("s => [...s.options].map(o => o.value).filter(v => v)")
-                select.select_option(values[0])
+                wanted = details.country if select.get_attribute("id") == COUNTRY else None
+                if wanted and wanted not in values:
+                    raise Unsupported(f"unhandled_rendering: the sign-up's countries lack {wanted}")
+                select.select_option(wanted or values[0])
         if page.locator(PRIVACY).count():
             page.locator(PRIVACY).click()
             dialog = page.locator("[role=dialog]:visible").last
@@ -193,6 +233,8 @@ class SuccessFactors:
         if page.locator(f"{SIGN_IN}:visible").count():  # created, signed out
             self.sign_in(page, email, password)
             return
+        if self.signed_in(page.request, None):  # created, back on the career site
+            return
         raise Unsupported(f"unhandled_rendering: the sign-up led to {urlsplit(page.url).path}")
 
     def browser_read(self, page: Page) -> list[Field]:

{atsfill-0.0.4.dev126 → atsfill-0.0.4.dev128}/src/atsfill/adapters/taleo.py

@@ -15,7 +15,7 @@ from dataclasses import dataclass
 from typing import Any
 from urllib.parse import parse_qs, quote, urlsplit
 
-from atsfill.core.adapter import Blocked, Gap, NotTaken, Refused, Unsupported
+from atsfill.core.adapter import Blocked, Gap, NotTaken, Refused, SignUpDetails, Unsupported
 from atsfill.core.browser import Page, Request, Timeout
 from atsfill.core.results import Answer, AnyOf, Field, FieldType, Is, OptionSet, SideEffect
 
@@ -209,7 +209,7 @@ def posting(url: str) -> Posting | None:
 class Taleo:
     name = "taleo"
     per_employer = True
-    asks_name = False
+    asks: set[str] = set()
     known_gaps = {LOCATION_GAP: Gap.RENDERING, DATE_PICKER_GAP: Gap.RENDERING}
     side_effects = [
         SideEffect("sign_up", "employer", "the account is created in the employer's zone"),
@@ -264,7 +264,7 @@ class Taleo:
         page.locator(f"#{FORM_ID}-login-defaultCmd").click()
         _left_sign_in(page)
 
-    def sign_up(self, page: Page, email: str, password: str, name: str | None) -> None:
+    def sign_up(self, page: Page, email: str, password: str, details: SignUpDetails) -> None:
         page.locator(f"#{FORM_ID}-login-register").click()
         page.wait_for_load_state()
         accept = page.locator(f"#{FORM_ID}-StatementBeforeAuthentificationContent-ContinueButton")

{atsfill-0.0.4.dev126 → atsfill-0.0.4.dev128}/src/atsfill/adapters/ukg.py

@@ -13,7 +13,7 @@ from dataclasses import dataclass
 from typing import Any
 from urllib.parse import parse_qs, quote, urlsplit
 
-from atsfill.core.adapter import Blocked, Gap, NotTaken, Refused, Unsupported
+from atsfill.core.adapter import Blocked, Gap, NotTaken, Refused, SignUpDetails, Unsupported
 from atsfill.core.browser import Locator, Page, Request, Timeout
 from atsfill.core.results import Answer, Field, FieldType, Is, OptionSet, SideEffect
 
@@ -36,7 +36,6 @@ YES_NO = ["Yes", "No"]
 DATE_SHOWN = re.compile(r"(\d\d)/(\d\d)/(\d{4})")
 COUNTRY, STATE = "Country", "State"
 DAYS, DOCUMENTS = "availability_days", "documents"
-PHONE_GAP = "sign_up_phone"
 
 # Auth0's error codes on the sign-in and sign-up pages, by what atsfill raises
 ERRORS = [
@@ -218,8 +217,8 @@ def board(url: str) -> Board | None:
 class UKG:
     name = "ukg"
     per_employer = True
-    asks_name = True
-    known_gaps = {PHONE_GAP: Gap.FLOW}
+    asks = {"name", "phone"}  # the phone only some tenants require, asked before the sign-up
+    known_gaps: dict[str, Gap] = {}
     side_effects = [
         SideEffect("sign_up", "employer", "the account is created in the employer's tenant"),
         SideEffect("upload", "hiring_system", "a document is stored in the account's documents"),
@@ -275,7 +274,7 @@ class UKG:
         if "/AuthCode/Register" in page.url:
             raise Unsupported("unhandled_rendering: the tenant asks the account's name")
 
-    def sign_up(self, page: Page, email: str, password: str, name: str | None) -> None:
+    def sign_up(self, page: Page, email: str, password: str, details: SignUpDetails) -> None:
         page.locator("a[href*='/u/signup']").first.click()
         page.locator("input#email").wait_for(timeout=FORM_TIMEOUT_MS)
         page.locator("input#email").fill(email)
@@ -284,7 +283,7 @@ class UKG:
         _left_sign_in(page)
         if "/AuthCode/Register" not in page.url:
             return
-        _register(page, name or "")
+        _register(page, details)
 
     def browser_read(self, page: Page) -> list[Field]:
         found = board(page.url)
@@ -397,26 +396,33 @@ def _left_sign_in(page: Page) -> None:
     raise Unsupported("unhandled_rendering: the sign-in page answered nothing")
 
 
-def _register(page: Page, name: str) -> None:
-    """The tenant's own step after the sign-up: the name, and the privacy policy's box on some
-    tenants; the box for text messages is left. Its inputs take typed keys only: a filled value
+def _register(page: Page, details: SignUpDetails) -> None:
+    """The tenant's own step after the sign-up: the name, the phone where the tenant requires
+    it, and the privacy policy's box on some tenants; the optional consents (text messages, AI
+    scoring, ticked by default) are declined. Its inputs take typed keys only: a filled value
     leaves Create account disabled."""
     page.locator("input[name=firstName]").wait_for(timeout=FORM_TIMEOUT_MS)
     page.wait_for_load_state("networkidle")
+    first, _, last = (details.name or "").strip().partition(" ")
+    values = [("firstName", first), ("lastName", last or first)]
     if page.locator("ukg-input[name=phoneNumber][required=true]").count():
-        raise Unsupported(f"{Gap.FLOW}: {PHONE_GAP}: the tenant's sign-up asks a phone number")
-    first, _, last = name.strip().partition(" ")
-    for field, value in (("firstName", first), ("lastName", last or first)):
+        values.append(("phoneNumber", details.phone or ""))
+    for field, value in values:
         page.locator(f"input[name={field}]").click()
         page.locator(f"input[name={field}]").press_sequentially(value)
-    privacy = page.locator("ukg-checkbox[data-automation*=privacy]:visible")
-    for box in privacy.all():
-        if box.get_attribute("aria-checked") != "true":
+    for box in page.locator("ukg-checkbox[data-automation*=-checkbox]:visible").all():
+        wanted = "privacy" in (box.get_attribute("data-automation") or "")
+        if _ticked(box) != wanted:
             box.click()
     page.get_by_role("button", name="Create account").click()
     page.wait_for_url(lambda u: "/AuthCode/Register" not in u, timeout=FORM_TIMEOUT_MS)
 
 
+def _ticked(box: Locator) -> bool:
+    """A `ukg-checkbox`'s state: `aria-checked` once clicked, `checked` as the page set it."""
+    return "true" in (box.get_attribute("aria-checked"), box.get_attribute("checked"))
+
+
 def _field(raw: dict[str, Any], states: dict[str, list[str]] | None) -> Field:
     kind, field_id = raw["kind"], raw["id"]
     label = raw["label"] or field_id

{atsfill-0.0.4.dev126 → atsfill-0.0.4.dev128}/src/atsfill/adapters/workday.py

@@ -17,7 +17,15 @@ from typing import Any
 from urllib.parse import urlsplit
 
 from atsfill.core import matching
-from atsfill.core.adapter import Blocked, Gap, NotTaken, Refused, Unsupported, known_gap
+from atsfill.core.adapter import (
+    Blocked,
+    Gap,
+    NotTaken,
+    Refused,
+    SignUpDetails,
+    Unsupported,
+    known_gap,
+)
 from atsfill.core.browser import Locator, Page, PageRequest, Request, Response, Timeout
 from atsfill.core.results import Answer, AnyOf, Condition, Field, FieldType, Is, SideEffect
 
@@ -187,7 +195,7 @@ def _profile_hosts(request: Request, scope: str | None) -> list[str]:
 class Workday:
     name = "workday"
     per_employer = True
-    asks_name = False
+    asks: set[str] = set()
     known_gaps = {
         "experience_entries": Gap.FLOW,
         "long_wizard": Gap.FLOW,
@@ -244,7 +252,7 @@ class Workday:
         _email_form(page)
         _submit(page, "signInSubmitButton", email, password)
 
-    def sign_up(self, page: Page, email: str, password: str, name: str | None) -> None:
+    def sign_up(self, page: Page, email: str, password: str, details: SignUpDetails) -> None:
         _email_form(page)
         page.locator("[data-automation-id=createAccountLink]").click()
         page.locator("[data-automation-id=verifyPassword]").fill(password)

{atsfill-0.0.4.dev126 → atsfill-0.0.4.dev128}/src/atsfill/adapters/wttj.py

@@ -12,7 +12,7 @@ from typing import Any
 from urllib.parse import urlsplit
 
 from atsfill.core import browser, matching
-from atsfill.core.adapter import Blocked, Gap, NotTaken, Refused, Unsupported
+from atsfill.core.adapter import Blocked, Gap, NotTaken, Refused, SignUpDetails, Unsupported
 from atsfill.core.browser import Locator, Page, PageRequest, Request, Response, Timeout
 from atsfill.core.results import Answer, Field, FieldType, SideEffect
 
@@ -64,7 +64,7 @@ _READ_BACK = """(form, ids) => Object.fromEntries(ids.map(id => {
 class WelcomeToTheJungle:
     name = "wttj"
     per_employer = False
-    asks_name = True  # the profile's first name
+    asks = {"name"}  # the profile's first name
     known_gaps: dict[str, Gap] = {}
     side_effects = [
         SideEffect("sign_up", "hiring_system", "login --create creates the account"),
@@ -98,11 +98,11 @@ class WelcomeToTheJungle:
     def sign_in(self, page: Page, email: str, password: str) -> None:
         _account_form(page, "sign-in-form", {"email": email, "password": password}, "/sessions")
 
-    def sign_up(self, page: Page, email: str, password: str, name: str | None) -> None:
+    def sign_up(self, page: Page, email: str, password: str, details: SignUpDetails) -> None:
         """Creates the account, signed in, then waits for its confirmation link: clicking it
         signs every session out."""
         page.goto(SIGN_UP)
-        values = {"firstname": name or "", "email": email, "password": password}
+        values = {"firstname": details.name or "", "email": email, "password": password}
         _account_form(page, "sign-up-form", values, "/registrations")
         raise Blocked("email_link: the sign-up sent a confirmation link")
 

{atsfill-0.0.4.dev126 → atsfill-0.0.4.dev128}/src/atsfill/cli.py

@@ -7,7 +7,7 @@ from pathlib import Path
 from atsfill import core
 from atsfill.adapters import adapters
 from atsfill.core import browser, paths
-from atsfill.core.adapter import NeedsAccount
+from atsfill.core.adapter import NeedsAccount, SignUpDetails
 from atsfill.core.results import Result, SessionReport, Status, StatusReport
 
 OK = {Status.READY, Status.SUBMITTED}
@@ -105,7 +105,11 @@ def parser() -> argparse.ArgumentParser:
         action="store_true",
         help="create the account with --email and a password atsfill generates and stores",
     )
-    login.add_argument("--name", help="the user's name, for a sign-up that asks it")
+    login.add_argument(
+        "--details",
+        type=details_file,
+        help="a JSON file of the user's sign-up details (name, phone, address), for --create",
+    )
     for name in ("read", "fill", "send", "status", "login", "logout"):
         sub.choices[name].add_argument(
             "-v", "--verbose", action="store_true", help="the whole result, every key, indented"
@@ -123,6 +127,13 @@ def answers_file(path: str) -> dict:
     return answers
 
 
+def details_file(path: str) -> SignUpDetails:
+    try:
+        return SignUpDetails.parse(json.loads(Path(path).read_text()))
+    except (OSError, ValueError) as e:
+        raise argparse.ArgumentTypeError(str(e)) from e
+
+
 def run(args: argparse.Namespace) -> int:
     try:
         paths.config(getattr(args, "user", paths.DEFAULT_USER))
@@ -171,7 +182,7 @@ def run(args: argparse.Namespace) -> int:
                         password=password,
                         window=args.window,
                         create=args.create,
-                        name=args.name,
+                        details=args.details,
                         **where,
                     )
             except ValueError as e:

{atsfill-0.0.4.dev126 → atsfill-0.0.4.dev128}/src/atsfill/core/accounts.py

@@ -6,7 +6,13 @@ import time
 from pathlib import Path
 
 from atsfill.core import browser
-from atsfill.core.adapter import CreatesAccount, NeedsAccount, SignsIn, Unsupported
+from atsfill.core.adapter import (
+    CreatesAccount,
+    NeedsAccount,
+    SignsIn,
+    SignUpDetails,
+    Unsupported,
+)
 from atsfill.core.browser import Page
 from atsfill.core.passwords import account_key
 
@@ -53,17 +59,16 @@ def sign_in(
     address: str,
     password: str,
     session: Path,
-    create: bool = False,
-    name: str | None = None,
+    details: SignUpDetails | None = None,
 ) -> None:
-    """Signs in, or creates the account (with the user's `name` where it asks one), from the
+    """Signs in, or creates the account from the user's sign-up `details` when given, from the
     system's login page and stores the session.
     Raises what the adapter raises, without the password in it."""
     page.goto(adapter.login_url(scope))
     try:
-        if create:
+        if details is not None:
             assert isinstance(adapter, CreatesAccount)
-            adapter.sign_up(page, address, password, name)
+            adapter.sign_up(page, address, password, details)
         else:
             adapter.sign_in(page, address, password)
     except Exception as e:

{atsfill-0.0.4.dev126 → atsfill-0.0.4.dev128}/src/atsfill/core/adapter.py

@@ -1,5 +1,7 @@
+import re
+from dataclasses import dataclass, fields
 from enum import StrEnum
-from typing import Protocol, runtime_checkable
+from typing import Protocol, Self, runtime_checkable
 
 from atsfill.core.browser import Page, Request
 from atsfill.core.results import Answer, Field, SideEffect
@@ -123,16 +125,61 @@ class SignsIn(NeedsAccount, Protocol):
         ...
 
 
+ADDRESS = ("street", "city", "state", "zip", "country")
+PHONE = re.compile(r"\+[1-9][0-9]{6,14}")  # E.164
+COUNTRY = re.compile(r"[A-Z]{2}")  # ISO 3166 alpha-2
+
+
+@dataclass(frozen=True)
+class SignUpDetails:
+    """What a sign-up asks of the user besides the email and the password, from the file
+    `login --create --details` takes (ADR 0015). atsfill stores none of it."""
+
+    name: str | None = None
+    phone: str | None = None
+    street: str | None = None
+    city: str | None = None
+    state: str | None = None
+    zip: str | None = None
+    country: str | None = None
+
+    @classmethod
+    def parse(cls, data: object) -> Self:
+        """From `{"name", "phone", "address": {"street", "city", "state", "zip", "country"}}`,
+        every key optional. Raises `ValueError` naming what is wrong."""
+        if not isinstance(data, dict):
+            raise ValueError("sign-up details: expected a JSON object")
+        address = data.get("address", {})
+        if not isinstance(address, dict):
+            raise ValueError("sign-up details: address: expected a JSON object")
+        if unknown := (data.keys() - {"name", "phone", "address"}) | (address.keys() - {*ADDRESS}):
+            raise ValueError(f"sign-up details: unknown keys {', '.join(sorted(unknown))}")
+        flat = {k: v for k, v in data.items() if k != "address"} | address
+        for key, value in flat.items():
+            if not isinstance(value, str) or not value.strip():
+                raise ValueError(f"sign-up details: {key}: expected a non-empty string")
+        if "phone" in flat and not PHONE.fullmatch(flat["phone"]):
+            raise ValueError("sign-up details: phone: expected E.164, as +15551234567")
+        if "country" in flat and not COUNTRY.fullmatch(flat["country"]):
+            raise ValueError("sign-up details: country: expected ISO 3166 alpha-2, as US")
+        return cls(**flat)
+
+    def missing(self, asks: set[str]) -> list[str]:
+        """The details `asks` names that these lack, in the file's order."""
+        return [f.name for f in fields(self) if f.name in asks and getattr(self, f.name) is None]
+
+
 @runtime_checkable
 class CreatesAccount(SignsIn, Protocol):
     """An adapter atsfill can create an account through, where the system's sign-up allows it.
     Account creation is a side effect it declares (ADR 0008)."""
 
-    asks_name: bool  # the sign-up asks the user's name
+    asks: set[str]  # the `SignUpDetails` fields its sign-up requires
 
-    def sign_up(self, page: Page, email: str, password: str, name: str | None) -> None:
+    def sign_up(self, page: Page, email: str, password: str, details: SignUpDetails) -> None:
         """Creates the account from the page `login_url` loaded, signed in once it returns.
-        Raises as `sign_in` does; `Refused` names the rule a `password_rule` page showed."""
+        Raises as `sign_in` does; `Refused` names the rule a `password_rule` page showed. The
+        details in `asks` are given; optional consents the sign-up offers stay declined."""
         ...
 
 

{atsfill-0.0.4.dev126 → atsfill-0.0.4.dev128}/src/atsfill/core/commands.py

@@ -25,6 +25,7 @@ from atsfill.core.adapter import (
     ReadsByRequest,
     Refused,
     SignsIn,
+    SignUpDetails,
     Unsupported,
 )
 from atsfill.core.browser import OutOfTime, Overlaid, Page, open_page
@@ -62,7 +63,7 @@ def _login_required(url: str, adapter: NeedsAccount, user: str) -> Result:
 
 type Credentials = tuple[str, str]  # email, password
 # Refusals the page states before any account exists: the generated password goes.
-NO_ACCOUNT = {"email_in_use", "email_domain_rejected", "password_rule"}
+NO_ACCOUNT = {"email_in_use", "email_domain_rejected", "password_rule", "sign_up_details"}
 
 
 def _email_link(reason: str | None, email: str, command: str) -> str | None:
@@ -481,7 +482,7 @@ def login(
     password: str | None = None,
     window: bool = False,
     create: bool = False,
-    name: str | None = None,
+    details: SignUpDetails | None = None,
     data_dir: Path | None = None,
 ) -> SessionReport:
     """Signs in with the account's password source, headless, and stores the session; without
@@ -489,7 +490,7 @@ def login(
 
     `email` is remembered for the account; `password` is used for this sign-in only. `create`
     creates the account with a password atsfill generates and stores first (a side effect),
-    giving `name` where the sign-up asks it; with a password already stored, the account may
+    giving the sign-up the user's `details`; with a password already stored, the account may
     exist, so it signs in with that password and keeps the account's email instead."""
     account, data = _account(adapter), paths.data_dir(data_dir)
     scope = _scope(account, url)
@@ -498,6 +499,8 @@ def login(
     report = SessionReport(user, adapter, scope, "missing", session)
     if create and not email:
         raise ValueError("creating an account needs --email")
+    if details and not create:
+        raise ValueError("--details goes with --create")
     try:
         kept = create and passwords.stored(mine, adapter, scope) is not None
     except passwords.PasswordError as e:
@@ -507,7 +510,7 @@ def login(
         accounts.remember(mine, adapter, scope, email)
     if create and not kept:
         assert email
-        return _create(report, account, url, mine, (email, name), data)
+        return _create(report, account, url, mine, email, details or SignUpDetails(), data)
     if kept:
         report.password = "kept"
     if password and not (isinstance(account, SignsIn) and accounts.email(mine, adapter, scope)):
@@ -539,25 +542,28 @@ def _create(
     account: NeedsAccount,
     url: str | None,
     mine: Path,
-    who: tuple[str, str | None],
+    email: str,
+    details: SignUpDetails,
     data: Path,
 ) -> SessionReport:
-    """Creates the account: the generated password is stored before the click, and deleted
-    only on a refusal the page states before any account exists."""
+    """Creates the account: refused before the browser opens when `details` lack one the
+    sign-up asks; the generated password is stored before the click, and deleted only on a
+    refusal the page states before any account exists."""
     if not isinstance(account, CreatesAccount):
         report.status = Status.UNSUPPORTED
         report.reason = f"no_sign_up: atsfill cannot create a {account.name} account"
         return report
-    email, name = who
-    if account.asks_name and not name:
-        raise ValueError(f"creating a {account.name} account needs --name")
+    if missing := details.missing(account.asks):
+        report.status = Status.REFUSED
+        report.reason = f"sign_up_details: no {', '.join(missing)}"
+        return report
     password = passwords.generate()
     try:
         passwords.store(mine, account.name, report.scope, password)
     except passwords.PasswordError as e:
         report.status, report.reason = Status.BLOCKED, f"password_source: {e}"
         return report
-    result = _headless(data, account, report.scope, (email, password), report.path, True, name)
+    result = _headless(data, account, report.scope, (email, password), report.path, details)
     command = login_command(account.name, report.user, url)
     report.status, report.reason = result.status, _email_link(result.reason, email, command)
     report.password = "stored"
@@ -575,8 +581,7 @@ def _headless(
     scope: str | None,
     credentials: Credentials,
     session: Path,
-    create: bool = False,
-    name: str | None = None,
+    details: SignUpDetails | None = None,
 ) -> Result:
     """Signs in, or creates the account, through the adapter: `ready` once the session is
     stored."""
@@ -586,7 +591,7 @@ def _headless(
     def run(_: list[str]) -> Result:
         result = Result(Status.READY, url, account.name)
         with open_page(data, None) as page, _stops(result):
-            accounts.sign_in(page, account, scope, *credentials, session, create, name)
+            accounts.sign_in(page, account, scope, *credentials, session, details)
         return result
 
     return _in_budget(url, run)

{atsfill-0.0.4.dev126 → atsfill-0.0.4.dev128}/src/atsfill/registry.toml

@@ -96,7 +96,7 @@ share = 0.0350
 account = "to_read"
 hosting = ["hosted"]
 adapter = "successfactors"
-unsupported = { date = 2026-10-26, version = "0.0.3", commit = "0d8baea", by = "agent", reason = "quick_apply_sign_up: a Quick Apply page creates the account and sends the application in one submit, its sign-in offering no sign-up; sign_up_fields: a sign-up asking a phone number" }
+unsupported = { date = 2026-10-26, version = "0.0.3", commit = "0d8baea", by = "agent", reason = "quick_apply_sign_up: a Quick Apply page creates the account and sends the application in one submit, its sign-in offering no sign-up; sign_up_fields: a sign-up asking who may see the profile" }
 mapped = { date = 2026-10-20, version = "0.0.2", by = "agent", commit = "7934b25" }
 
 [ukg]
@@ -106,7 +106,7 @@ account = "to_read"
 hosting = ["hosted"]
 adapter = "ukg"
 mapped = { date = 2026-10-20, version = "0.0.2", by = "agent", commit = "7934b25" }
-unsupported = { date = 2026-10-26, version = "0.0.3", commit = "a60a17d", by = "agent", reason = "unsupported_flow: sign_up_phone: the tenant's details step after the sign-up requires a phone number, which login does not take (10 of 17 tenants)" }
+unsupported = { date = 2026-10-26, version = "0.0.3", commit = "a60a17d", by = "agent", reason = "unhandled on the forms the sign-up now reaches, 3 of 8 tenants ready: no gender decline box to tick (3), a State whose condition names no Country (1), a numeric answer read back differently (1)" }
 
 [paycom]
 kind = "ats"
@@ -306,7 +306,7 @@ share = 0.0059
 account = "to_read"
 hosting = ["hosted"]
 mapped = { date = 2026-10-20, version = "0.0.2", by = "agent", commit = "7934b25" }
-unsupported = { date = 2026-10-26, version = "0.0.3", commit = "211fe03", by = "agent", reason = "unsupported_flow: screening_first: the form's first page comes before the sign-up step (4 of 14 orgs); sign_up_phone: the sign-up step requires a mobile phone, which login does not take (1 of 17); a reCAPTCHA box on the sign-up step (1 of 17); 3 orgs signed in, under the 5 dry runs the gate needs" }
+unsupported = { date = 2026-10-26, version = "0.0.3", commit = "211fe03", by = "agent", reason = "unsupported_flow: screening_first: the form's first page comes before the sign-up step (4 of 14 orgs); a reCAPTCHA box on the sign-up step (1 of 17); 3 orgs signed in, under the 5 dry runs the gate needs" }
 
 [applicantpro]
 kind = "ats"