walla-cli 0.1.3__tar.gz → 0.1.5__tar.gz

{walla_cli-0.1.3 → walla_cli-0.1.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: walla-cli
-Version: 0.1.3
+Version: 0.1.5
 Summary: Wallapop.es CLI - look · offer · talk for humans and agents
 Project-URL: Homepage, https://github.com/berendgort/wallapop-cli
 Project-URL: Repository, https://github.com/berendgort/wallapop-cli
@@ -71,19 +71,23 @@ The agent runs `walla` — ranks listings **GRAB / LOOK / PASS**, links you the
 item, asks before sending, then talks and offers on your behalf:
 
 ```bash
-walla setup --lat 41.39 --lon 2.17 --km 30 --label Barcelona --budget 400
+walla setup --lat 41.39 --lon 2.17 --km 30 --label Barcelona \
+  --budget 400 --aggression fair --must "kite cabrinha"
 walla search "tabla kite Cabrinha" --max 40 --json
 # agent: GRAB · Cabrinha Moto 10m · €320 · 4 km
 #        https://es.wallapop.com/item/...
 
+walla search "…" --export md,csv,html,pdf --out ./shortlist --json
+# or later: walla export --format md,csv,html,pdf --out ./shortlist --json
+
 walla login                         # paste session cookie once
-walla say <id> "Hola, ¿sigue disponible? Puedo pasar hoy." --yes
-walla offer <id> --eur 280 --yes    # prints total; needs your confirm
-walla inbox --json                  # catch the reply
+walla negotiate <id> --json         # draft only; you approve text + EUR
+walla say <id> "…" --yes            # only after you approve
+walla offer <id> --eur 280 --yes    # only after you approve; never pays
 ```
 
-That is the product: a Cursor agent that can **look, talk, and offer** on
-Wallapop without opening the website for every step.
+That is the product: a Cursor agent that can **look, draft, talk, and offer**
+up to the point of payment. You finish pay/meet in the Wallapop app.
 
 **Quality bar (enforced in CI):**
 
@@ -116,7 +120,9 @@ Link listings as `https://es.wallapop.com/item/<web_slug>`. Verdicts:
 3. If no session: ask the human to run `walla login` and paste
    `__Secure-next-auth.session-token` from es.wallapop.com (Cookie-Editor).
    Agents may pass it non-interactively: `walla login --cookie '<value>' --json`.
-4. Do the ask with `walla … --json` and narrate in prose.
+4. `walla instruct --json` — read `mandate` + `hitl`. If `mandate.budget` is
+   null, ask once for budget / aggression / must words, then `walla setup …`.
+5. Do the ask with `walla … --json` and narrate in prose.
 
 Optional MCP:
 
@@ -132,15 +138,31 @@ Optional MCP:
 
 | Ask | Command |
 |-----|---------|
+| Mandate | `walla setup --budget 400 --aggression fair --must "kite"` |
 | Look | `walla search "tabla kite" --max 40 --json` then `walla item <id> --json` |
+| Draft | `walla negotiate <id> --json` (win-win Spanish draft; never sends) |
 | Talk | `walla inbox --json` · `walla thread <id> --json` · `walla say <id> "…" --yes` |
 | Offer | `walla offer <id> --eur 180 --yes` |
 
+### HITL (ask once per decision)
+
+| Step | Agent alone | Ask human |
+|------|-------------|-----------|
+| Search inside mandate | yes | if query vague or budget unset |
+| Shortlist | show ranked Wallapop rows with markdown item links | if more than one GRAB, pick the id |
+| Negotiate draft | yes | approve Spanish text |
+| `say --yes` | never | yes to that exact text |
+| `offer --yes` | never; refuse if EUR > budget | yes to that exact EUR |
+| Pay / buy / reserve | **never** | human finishes in the Wallapop app |
+
 Rules:
 
-- Reads are safe. `say` / `offer` need `--yes` / `confirm=true`. Name listing + euros.
+- Reads and negotiate drafts are safe. `say` / `offer` need `--yes`.
+- `--yes` means send chat or price offer only. It never completes a purchase.
 - If they only asked to look, do not send.
-- Ambiguous match: ask once with candidates.
+- Ambiguous match or multiple GRABs: ask once with candidates.
+- Always present Wallapop shortlists ranked best-first with a markdown link on every item URL.
+- Default search is all of Spain. Shipping counts anywhere. Use `walla search --local` only when the human asked for nearby or pickup.
 - In-person offers outside pickup radius: refuse.
 - Envelope: `ok`, `api_version`, `data` or `error` / `error_type` / `retryable`.
 
@@ -165,6 +187,7 @@ walla doctor --json
 | `walla search` / `item` / `categories` | Look |
 | `walla watch add\|list\|check` | Local saved searches |
 | `walla login` / `logout` / `whoami` | Session (paste cookie; optional `--password`) |
+| `walla negotiate` | Win-win Spanish draft (never sends) |
 | `walla inbox` / `thread` / `say` | Talk |
 | `walla offer` | Offer (prints total, needs `--yes`) |
 | `walla fav list\|add\|rm` | Favorites |

{walla_cli-0.1.3 → walla_cli-0.1.5}/README.md

@@ -27,19 +27,23 @@ The agent runs `walla` — ranks listings **GRAB / LOOK / PASS**, links you the
 item, asks before sending, then talks and offers on your behalf:
 
 ```bash
-walla setup --lat 41.39 --lon 2.17 --km 30 --label Barcelona --budget 400
+walla setup --lat 41.39 --lon 2.17 --km 30 --label Barcelona \
+  --budget 400 --aggression fair --must "kite cabrinha"
 walla search "tabla kite Cabrinha" --max 40 --json
 # agent: GRAB · Cabrinha Moto 10m · €320 · 4 km
 #        https://es.wallapop.com/item/...
 
+walla search "…" --export md,csv,html,pdf --out ./shortlist --json
+# or later: walla export --format md,csv,html,pdf --out ./shortlist --json
+
 walla login                         # paste session cookie once
-walla say <id> "Hola, ¿sigue disponible? Puedo pasar hoy." --yes
-walla offer <id> --eur 280 --yes    # prints total; needs your confirm
-walla inbox --json                  # catch the reply
+walla negotiate <id> --json         # draft only; you approve text + EUR
+walla say <id> "…" --yes            # only after you approve
+walla offer <id> --eur 280 --yes    # only after you approve; never pays
 ```
 
-That is the product: a Cursor agent that can **look, talk, and offer** on
-Wallapop without opening the website for every step.
+That is the product: a Cursor agent that can **look, draft, talk, and offer**
+up to the point of payment. You finish pay/meet in the Wallapop app.
 
 **Quality bar (enforced in CI):**
 
@@ -72,7 +76,9 @@ Link listings as `https://es.wallapop.com/item/<web_slug>`. Verdicts:
 3. If no session: ask the human to run `walla login` and paste
    `__Secure-next-auth.session-token` from es.wallapop.com (Cookie-Editor).
    Agents may pass it non-interactively: `walla login --cookie '<value>' --json`.
-4. Do the ask with `walla … --json` and narrate in prose.
+4. `walla instruct --json` — read `mandate` + `hitl`. If `mandate.budget` is
+   null, ask once for budget / aggression / must words, then `walla setup …`.
+5. Do the ask with `walla … --json` and narrate in prose.
 
 Optional MCP:
 
@@ -88,15 +94,31 @@ Optional MCP:
 
 | Ask | Command |
 |-----|---------|
+| Mandate | `walla setup --budget 400 --aggression fair --must "kite"` |
 | Look | `walla search "tabla kite" --max 40 --json` then `walla item <id> --json` |
+| Draft | `walla negotiate <id> --json` (win-win Spanish draft; never sends) |
 | Talk | `walla inbox --json` · `walla thread <id> --json` · `walla say <id> "…" --yes` |
 | Offer | `walla offer <id> --eur 180 --yes` |
 
+### HITL (ask once per decision)
+
+| Step | Agent alone | Ask human |
+|------|-------------|-----------|
+| Search inside mandate | yes | if query vague or budget unset |
+| Shortlist | show ranked Wallapop rows with markdown item links | if more than one GRAB, pick the id |
+| Negotiate draft | yes | approve Spanish text |
+| `say --yes` | never | yes to that exact text |
+| `offer --yes` | never; refuse if EUR > budget | yes to that exact EUR |
+| Pay / buy / reserve | **never** | human finishes in the Wallapop app |
+
 Rules:
 
-- Reads are safe. `say` / `offer` need `--yes` / `confirm=true`. Name listing + euros.
+- Reads and negotiate drafts are safe. `say` / `offer` need `--yes`.
+- `--yes` means send chat or price offer only. It never completes a purchase.
 - If they only asked to look, do not send.
-- Ambiguous match: ask once with candidates.
+- Ambiguous match or multiple GRABs: ask once with candidates.
+- Always present Wallapop shortlists ranked best-first with a markdown link on every item URL.
+- Default search is all of Spain. Shipping counts anywhere. Use `walla search --local` only when the human asked for nearby or pickup.
 - In-person offers outside pickup radius: refuse.
 - Envelope: `ok`, `api_version`, `data` or `error` / `error_type` / `retryable`.
 
@@ -121,6 +143,7 @@ walla doctor --json
 | `walla search` / `item` / `categories` | Look |
 | `walla watch add\|list\|check` | Local saved searches |
 | `walla login` / `logout` / `whoami` | Session (paste cookie; optional `--password`) |
+| `walla negotiate` | Win-win Spanish draft (never sends) |
 | `walla inbox` / `thread` / `say` | Talk |
 | `walla offer` | Offer (prints total, needs `--yes`) |
 | `walla fav list\|add\|rm` | Favorites |

{walla_cli-0.1.3 → walla_cli-0.1.5}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "walla-cli"
-version = "0.1.3"
+version = "0.1.5"
 description = "Wallapop.es CLI - look · offer · talk for humans and agents"
 authors = [{ name = "Dr. Berend Gort", email = "berend.gort@gmail.com" }]
 readme = "README.md"

walla_cli-0.1.5/scripts/dogfood_run.py

@@ -0,0 +1,345 @@
+#!/usr/bin/env python3
+"""Run one dogfood scenario. Usage: dogfood_run.py <scenario_id>"""
+
+from __future__ import annotations
+
+import json
+import os
+import subprocess
+import sys
+import time
+from pathlib import Path
+
+ROOT = Path(__file__).resolve().parents[1]
+WALLA = ROOT / ".venv" / "bin" / "walla"
+OUT_ROOT = Path("/tmp/walla-dogfood")
+
+
+def run(cmd: list[str], env: dict[str, str]) -> dict:
+    t0 = time.perf_counter()
+    proc = subprocess.run(
+        cmd,
+        cwd=str(ROOT),
+        env=env,
+        capture_output=True,
+        text=True,
+        timeout=120,
+    )
+    ms = int((time.perf_counter() - t0) * 1000)
+    stdout = proc.stdout.strip()
+    payload = None
+    if "{" in stdout:
+        try:
+            payload = json.loads(stdout[stdout.find("{") :])
+        except json.JSONDecodeError:
+            payload = None
+    return {
+        "cmd": cmd,
+        "exit": proc.returncode,
+        "elapsed_ms": ms,
+        "stdout_head": stdout[:800],
+        "stderr_head": (proc.stderr or "")[:200],
+        "payload": payload,
+    }
+
+
+def base_env(scenario: str) -> dict[str, str]:
+    cfg = OUT_ROOT / scenario / "config"
+    cfg.mkdir(parents=True, exist_ok=True)
+    env = os.environ.copy()
+    env["WALLA_CONFIG_DIR"] = str(cfg)
+    env["PATH"] = f"{ROOT / '.venv' / 'bin'}:{env.get('PATH', '')}"
+    env.pop("VIRTUAL_ENV", None)
+    return env
+
+
+def scenario_fresh() -> dict:
+    env = base_env("fresh")
+    commands = [
+        run([str(WALLA), "doctor", "--json"], env),
+        run([str(WALLA), "search", "tabla", "--max", "3", "--json"], env),
+        run([str(WALLA), "instruct", "--json"], env),
+    ]
+    search = commands[1]
+    intake = bool(
+        search.get("payload")
+        and search["payload"].get("data", search["payload"]).get("ready") is False
+    ) or "intake" in (search.get("stdout_head") or "")
+    ok = commands[0]["exit"] == 0 and commands[2]["exit"] == 0 and not any(
+        "Traceback" in (c.get("stderr_head") or "") for c in commands
+    )
+    return {
+        "id": "fresh",
+        "ok": ok,
+        "commands": commands,
+        "unclear": "" if intake or ok else "expected intake when no profile",
+        "extra_steps": 0,
+        "notes": {"intake_or_ready_false": intake},
+    }
+
+
+def scenario_mandate() -> dict:
+    env = base_env("mandate")
+    out = OUT_ROOT / "mandate" / "export"
+    out.mkdir(parents=True, exist_ok=True)
+    commands = [
+        run(
+            [
+                str(WALLA),
+                "setup",
+                "--lat",
+                "41.39",
+                "--lon",
+                "2.17",
+                "--budget",
+                "400",
+                "--aggression",
+                "fair",
+                "--must",
+                "kite",
+                "--json",
+            ],
+            env,
+        ),
+        run(
+            [
+                str(WALLA),
+                "search",
+                "tabla kite",
+                "--max",
+                "5",
+                "--json",
+                "--export",
+                "md,csv,html,pdf",
+                "--out",
+                str(out),
+            ],
+            env,
+        ),
+    ]
+    search = commands[1].get("payload") or {}
+    data = search.get("data", search)
+    listings = data.get("listings") or []
+    files_ok = all(
+        (out / f"walla-shortlist.{ext}").is_file() for ext in ("md", "csv", "html", "pdf")
+    )
+    urls_ok = all(
+        str(r.get("url", "")).startswith("https://es.wallapop.com/item/") for r in listings
+    ) if listings else False
+    fit_has_budget = False
+    if files_ok:
+        md = (out / "walla-shortlist.md").read_text(encoding="utf-8")
+        fit_has_budget = "400" in md or "budget" in md.lower()
+    ok = (
+        commands[0]["exit"] == 0
+        and commands[1]["exit"] == 0
+        and "hitl" in data
+        and files_ok
+        and urls_ok
+        and fit_has_budget
+    )
+    return {
+        "id": "mandate",
+        "ok": ok,
+        "commands": commands,
+        "unclear": "" if ok else "mandate/export checks failed",
+        "extra_steps": 0,
+        "notes": {
+            "files_ok": files_ok,
+            "urls_ok": urls_ok,
+            "fit_has_budget": fit_has_budget,
+            "grabs": (data.get("hitl") or {}).get("grabs"),
+        },
+    }
+
+
+def scenario_draft() -> dict:
+    env = base_env("draft")
+    commands = [
+        run(
+            [
+                str(WALLA),
+                "setup",
+                "--lat",
+                "41.39",
+                "--lon",
+                "2.17",
+                "--budget",
+                "400",
+                "--aggression",
+                "fair",
+                "--json",
+            ],
+            env,
+        ),
+        run([str(WALLA), "search", "tabla kite", "--max", "5", "--json"], env),
+    ]
+    data = (commands[1].get("payload") or {}).get("data") or commands[1].get("payload") or {}
+    listings = data.get("listings") or []
+    grabs = [L for L in listings if L.get("verdict") == "GRAB"]
+    pick = (grabs or listings or [None])[0]
+    if not pick:
+        return {
+            "id": "draft",
+            "ok": False,
+            "commands": commands,
+            "unclear": "no listings to negotiate",
+            "extra_steps": 0,
+        }
+    commands.append(
+        run([str(WALLA), "negotiate", str(pick["id"]), "--json"], env)
+    )
+    neg = (commands[-1].get("payload") or {}).get("data") or commands[-1].get("payload") or {}
+    opening = str(neg.get("opening") or "")
+    hint = str(neg.get("hint") or "")
+    offer = neg.get("offer_eur")
+    ok = (
+        commands[-1]["exit"] == 0
+        and "¿Sigue disponible?" in opening
+        and offer is not None
+        and float(offer) <= 400
+        and ("never" in hint.lower() or "pay" in hint.lower())
+    )
+    return {
+        "id": "draft",
+        "ok": ok,
+        "commands": commands,
+        "unclear": "" if ok else "negotiate draft missing fields",
+        "extra_steps": 0,
+        "notes": {"offer_eur": offer, "opening_head": opening[:80]},
+    }
+
+
+def scenario_gates() -> dict:
+    env = base_env("gates")
+    # no budget negotiate
+    commands = [
+        run(
+            [str(WALLA), "setup", "--lat", "41.39", "--lon", "2.17", "--json"],
+            env,
+        ),
+        run([str(WALLA), "search", "tabla", "--max", "1", "--json"], env),
+    ]
+    data = (commands[1].get("payload") or {}).get("data") or commands[1].get("payload") or {}
+    listings = data.get("listings") or []
+    item_id = listings[0]["id"] if listings else "missing"
+    commands.append(run([str(WALLA), "negotiate", item_id, "--json"], env))
+    no_budget = commands[-1]["exit"] != 0 or "set_budget" in (
+        commands[-1].get("stdout_head") or ""
+    ) + (commands[-1].get("stderr_head") or "")
+    # with budget: offer without --yes
+    env2 = base_env("gates-budget")
+    commands.append(
+        run(
+            [
+                str(WALLA),
+                "setup",
+                "--lat",
+                "41.39",
+                "--lon",
+                "2.17",
+                "--budget",
+                "100",
+                "--json",
+            ],
+            env2,
+        )
+    )
+    commands.append(run([str(WALLA), "search", "tabla", "--max", "1", "--json"], env2))
+    data2 = (commands[-1].get("payload") or {}).get("data") or commands[-1].get("payload") or {}
+    listings2 = data2.get("listings") or []
+    item2 = listings2[0]["id"] if listings2 else item_id
+    commands.append(
+        run([str(WALLA), "offer", item2, "--eur", "99999", "--json"], env2)
+    )
+    offer_payload = (commands[-1].get("payload") or {}).get("data") or commands[-1].get(
+        "payload"
+    ) or {}
+    needs_confirm = bool(offer_payload.get("needs_confirm")) or commands[-1]["exit"] != 0
+    # refuse over budget with --yes would send - don't use --yes for over budget check via negotiate
+    ok = no_budget and needs_confirm
+    return {
+        "id": "gates",
+        "ok": ok,
+        "commands": commands,
+        "unclear": "" if ok else "HITL gates not clear",
+        "extra_steps": 0,
+        "notes": {"no_budget": no_budget, "needs_confirm": needs_confirm},
+    }
+
+
+def scenario_auth() -> dict:
+    env = base_env("auth")
+    commands = [
+        run([str(WALLA), "login", "--json"], env),
+        run([str(WALLA), "whoami", "--json"], env),
+    ]
+    texts = " ".join(
+        (c.get("stdout_head") or "") + (c.get("stderr_head") or "") for c in commands
+    )
+    names_next = "login" in texts.lower() or "--cookie" in texts.lower()
+    no_tb = "Traceback" not in texts
+    ok = commands[0]["exit"] != 0 and commands[1]["exit"] != 0 and names_next and no_tb
+    return {
+        "id": "auth",
+        "ok": ok,
+        "commands": commands,
+        "unclear": "" if ok else "auth errors unclear",
+        "extra_steps": 0,
+    }
+
+
+def scenario_help() -> dict:
+    env = base_env("help")
+    commands = [
+        run([str(WALLA)], env),
+        run([str(WALLA), "negotiate", "--help"], env),
+        run([str(WALLA), "export", "--help"], env),
+    ]
+    text = " ".join(c.get("stdout_head") or "" for c in commands).lower()
+    ok = (
+        "kite" in text
+        and ("pipx" in text or "walla-cli" in text)
+        and "pdf" in text
+        and "negotiate" in text
+    )
+    return {
+        "id": "help",
+        "ok": ok,
+        "commands": commands,
+        "unclear": "" if ok else "banner missing kite example, install, or pdf export",
+        "extra_steps": 0,
+    }
+
+
+SCENARIOS = {
+    "fresh": scenario_fresh,
+    "mandate": scenario_mandate,
+    "draft": scenario_draft,
+    "gates": scenario_gates,
+    "auth": scenario_auth,
+    "help": scenario_help,
+}
+
+
+def main() -> int:
+    if len(sys.argv) != 2 or sys.argv[1] not in SCENARIOS:
+        print("usage: dogfood_run.py <" + "|".join(SCENARIOS) + ">", file=sys.stderr)
+        return 2
+    sid = sys.argv[1]
+    OUT_ROOT.mkdir(parents=True, exist_ok=True)
+    result = SCENARIOS[sid]()
+    # strip bulky payloads for disk
+    for c in result.get("commands") or []:
+        if isinstance(c.get("payload"), dict):
+            c["payload_ok"] = c["payload"].get("ok")
+            c["payload_keys"] = list((c["payload"].get("data") or c["payload"]).keys())[:12]
+            c.pop("payload", None)
+    path = OUT_ROOT / f"{sid}.json"
+    path.write_text(json.dumps(result, indent=2), encoding="utf-8")
+    print(json.dumps({"wrote": str(path), "ok": result["ok"]}))
+    return 0 if result["ok"] else 1
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

walla_cli-0.1.5/skills/walla/SKILL.md

@@ -0,0 +1,42 @@
+---
+name: walla
+description: >
+  When the user pastes github.com/berendgort/wallapop-cli, wants Wallapop.es
+  search, inbox, offers, or chat: install walla, run doctor, have the human
+  walla login (paste session cookie), then look / negotiate / talk with
+  walla … --json. Never scrape HTML. Never print cookies or tokens. Never pay.
+license: MIT
+---
+
+# walla — agent skill (follow exactly)
+
+## Bootstrap
+
+```bash
+pipx install 'walla-cli[mcp]'   # PyPI: https://pypi.org/project/walla-cli/
+walla doctor --json
+# If auth.session is false: ask human to run `walla login` and paste cookie
+walla instruct --json           # read mandate + hitl.ladder + present
+```
+
+If `mandate.budget` is null, ask once:
+
+```bash
+walla setup --lat 41.39 --lon 2.17 --km 30 --budget 400 \
+  --aggression fair --must "kite cabrinha" --json
+```
+
+## Loop (efficient HITL)
+
+1. Search Spain-wide inside budget: `walla search "…" --json`
+   Distance only if the human asked nearby or pickup: add `--local`.
+   Optional shortlist share: `--export md,csv,html,pdf --out ./shortlist`
+2. **Present Wallapop results** from `data.shortlist` (already ranked best-first):
+   say they are on wallapop.es, number them 1…N, and put a markdown link on
+   every `https://es.wallapop.com/item/…` URL. Never summarize without links.
+3. One GRAB → `walla negotiate <id> --json`. Several GRABs → ask human to pick an id.
+4. Show opening + offer_eur + walk_away. Human approves text and EUR.
+5. Only then: `walla say … --yes` or `walla offer … --eur N --yes`
+6. **Stop.** Human pays or meets in the Wallapop app. `--yes` never means buy.
+
+Reads and negotiate drafts are safe. Sends need confirm.

{walla_cli-0.1.3 → walla_cli-0.1.5}/tests/test_edges.py

@@ -68,7 +68,8 @@ def test_verdict_distance_pass(tmp_path: Path, monkeypatch: pytest.MonkeyPatch)
         user_allows_shipping=False,
         location=ListingLocation(latitude=40.4, longitude=-3.7),
     )
-    assert score_listing(far, p) == "PASS"
+    assert score_listing(far, p) == "GRAB"
+    assert score_listing(far, p, local=True) == "PASS"
 
 
 def test_cookie_bare_token(tmp_path: Path) -> None:

walla_cli-0.1.5/tests/test_export.py

@@ -0,0 +1,55 @@
+"""Shortlist export unit tests."""
+
+from __future__ import annotations
+
+from pathlib import Path
+
+from walla.hunter.export import fit_line, write_exports
+from walla.models.profile import Profile
+
+
+def _row() -> dict:
+    return {
+        "id": "abc",
+        "title": "Tabla kite Cabrinha 10m",
+        "description": "cabrinha kite",
+        "price": {"amount": 320.0, "currency": "EUR"},
+        "web_slug": "tabla-kite",
+        "url": "https://es.wallapop.com/item/tabla-kite-cabrinha",
+        "verdict": "GRAB",
+        "location": {"latitude": 41.39, "longitude": 2.17},
+        "user_allows_shipping": False,
+        "shippable": False,
+    }
+
+
+def test_write_all_formats(tmp_path: Path) -> None:
+    profile = Profile(
+        lat=41.39, lon=2.17, km=30, budget=400, must_match=["kite"]
+    )
+    written = write_exports(
+        [_row()],
+        profile,
+        formats=["md", "csv", "html", "pdf"],
+        out_dir=tmp_path,
+        keywords="tabla kite",
+    )
+    assert set(written) == {"md", "csv", "html", "pdf"}
+    md = (tmp_path / "walla-shortlist.md").read_text(encoding="utf-8")
+    assert "https://es.wallapop.com/item/" in md
+    assert "400" in md or "budget" in md.lower() or "under" in md
+    csv = (tmp_path / "walla-shortlist.csv").read_text(encoding="utf-8")
+    assert "title,price_eur,verdict,url,fit" in csv
+    html = (tmp_path / "walla-shortlist.html").read_text(encoding="utf-8")
+    assert "<a href='https://es.wallapop.com/item/" in html
+    pdf = (tmp_path / "walla-shortlist.pdf").read_bytes()
+    assert pdf.startswith(b"%PDF")
+    assert b"es.wallapop.com" in pdf
+
+
+def test_fit_mentions_budget() -> None:
+    profile = Profile(lat=41.39, lon=2.17, km=30, budget=400, must_match=["kite"])
+    fit = fit_line(_row(), profile)
+    assert "400" in fit
+    assert "GRAB" in fit
+    assert "kite" in fit.lower()