verifaied 0.34.2.dev92__tar.gz → 0.35.0.dev94__tar.gz

{verifaied-0.34.2.dev92 → verifaied-0.35.0.dev94}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: verifaied
-Version: 0.34.2.dev92
+Version: 0.35.0.dev94
 Summary: Find what's untested in your code — locally, no account required
 Project-URL: Homepage, https://pypi.org/project/verifaied/
 Author: Kyle Richards
@@ -34,12 +34,12 @@ Classifier: License :: OSI Approved :: MIT License
 Classifier: Topic :: Software Development :: Testing
 Requires-Python: >=3.10
 Requires-Dist: httpx>=0.27.0
+Requires-Dist: mcp<2.0.0,>=1.27
 Requires-Dist: rich>=13.7.0
 Requires-Dist: tomli>=2.0.1; python_version < '3.11'
 Requires-Dist: tomlkit>=0.13.0
 Requires-Dist: typer>=0.12.0
 Provides-Extra: agent
-Requires-Dist: mcp<2.0.0,>=1.27; extra == 'agent'
 Provides-Extra: audit
 Requires-Dist: playwright<2,>=1.49; extra == 'audit'
 Description-Content-Type: text/markdown
@@ -118,17 +118,22 @@ so `check` works as a CI gate.
 
 ## `verifaied upload` — sync to the app
 
-Mint an API token from the verifAIed app (Settings → Tokens; a free account is
-enough). The CLI ships pointing at the hosted API (`https://api.verifaied.app`);
-point it elsewhere via `VERIFAIED_API_URL` if you're running the backend locally
-or self-hosting:
+Log the CLI in once per machine (a free account is enough). It opens the
+browser; check the code matches your terminal and click Approve, and the CLI
+stores its token in `~/.config/verifaied/credentials.toml` (readable only by
+you). Nothing to copy or export:
 
 ```bash
-export VERIFAIED_API_TOKEN=vr_live_...
-# Only set this if you're not using the hosted API:
-export VERIFAIED_API_URL=http://localhost:8000   # local dev
+verifaied login            # verifaied login --check: am I logged in?
+verifaied setup claude     # optional: connect Claude Code (or: setup codex/cursor/gemini)
 ```
 
+CI has no browser: mint a token in the app (Settings → API tokens) and set it
+as `VERIFAIED_API_TOKEN`, which wins over a stored login. The CLI ships pointing
+at the hosted API (`https://api.verifaied.app`); point it elsewhere via
+`VERIFAIED_API_URL` (or `--api-url`) if you're running the backend locally or
+self-hosting — each API URL keeps its own login.
+
 The link printed after an upload opens the web app, worked out from the API
 URL (`api.verifaied.app` → `verifaied.app`, `localhost:8000` →
 `localhost:3000`). Set `VERIFAIED_WEB_URL` if yours lives somewhere else.
@@ -1314,7 +1319,7 @@ Do the following, in order:
 # 2. Verify the CLI is installed and configured
 
 - Run `verifaied --help`. If it exits non-zero, install it: `uv tool install verifaied` (preferred) or `pipx install verifaied`.
-- Check `echo $VERIFAIED_API_TOKEN`. If empty, stop and tell the user to mint one from the verifAIed app (Settings → Tokens) and export it: `export VERIFAIED_API_TOKEN=vr_live_...`. Do NOT invent a placeholder and do NOT proceed without it.
+- Check `echo $VERIFAIED_API_TOKEN`. If empty, stop and tell the user to mint one from the verifAIed app (Settings → API tokens) and export it: `export VERIFAIED_API_TOKEN=vr_live_...`. Do NOT invent a placeholder and do NOT proceed without it.
 
 # 3. Write the loop into the agent-instructions file
 

{verifaied-0.34.2.dev92 → verifaied-0.35.0.dev94}/README.md

@@ -72,17 +72,22 @@ so `check` works as a CI gate.
 
 ## `verifaied upload` — sync to the app
 
-Mint an API token from the verifAIed app (Settings → Tokens; a free account is
-enough). The CLI ships pointing at the hosted API (`https://api.verifaied.app`);
-point it elsewhere via `VERIFAIED_API_URL` if you're running the backend locally
-or self-hosting:
+Log the CLI in once per machine (a free account is enough). It opens the
+browser; check the code matches your terminal and click Approve, and the CLI
+stores its token in `~/.config/verifaied/credentials.toml` (readable only by
+you). Nothing to copy or export:
 
 ```bash
-export VERIFAIED_API_TOKEN=vr_live_...
-# Only set this if you're not using the hosted API:
-export VERIFAIED_API_URL=http://localhost:8000   # local dev
+verifaied login            # verifaied login --check: am I logged in?
+verifaied setup claude     # optional: connect Claude Code (or: setup codex/cursor/gemini)
 ```
 
+CI has no browser: mint a token in the app (Settings → API tokens) and set it
+as `VERIFAIED_API_TOKEN`, which wins over a stored login. The CLI ships pointing
+at the hosted API (`https://api.verifaied.app`); point it elsewhere via
+`VERIFAIED_API_URL` (or `--api-url`) if you're running the backend locally or
+self-hosting — each API URL keeps its own login.
+
 The link printed after an upload opens the web app, worked out from the API
 URL (`api.verifaied.app` → `verifaied.app`, `localhost:8000` →
 `localhost:3000`). Set `VERIFAIED_WEB_URL` if yours lives somewhere else.
@@ -1268,7 +1273,7 @@ Do the following, in order:
 # 2. Verify the CLI is installed and configured
 
 - Run `verifaied --help`. If it exits non-zero, install it: `uv tool install verifaied` (preferred) or `pipx install verifaied`.
-- Check `echo $VERIFAIED_API_TOKEN`. If empty, stop and tell the user to mint one from the verifAIed app (Settings → Tokens) and export it: `export VERIFAIED_API_TOKEN=vr_live_...`. Do NOT invent a placeholder and do NOT proceed without it.
+- Check `echo $VERIFAIED_API_TOKEN`. If empty, stop and tell the user to mint one from the verifAIed app (Settings → API tokens) and export it: `export VERIFAIED_API_TOKEN=vr_live_...`. Do NOT invent a placeholder and do NOT proceed without it.
 
 # 3. Write the loop into the agent-instructions file
 

{verifaied-0.34.2.dev92 → verifaied-0.35.0.dev94}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "verifaied"
-version = "0.34.2.dev92"
+version = "0.35.0.dev94"
 description = "Find what's untested in your code — locally, no account required"
 readme = "README.md"
 requires-python = ">=3.10"
@@ -26,6 +26,13 @@ dependencies = [
     # and a round-trip through a plain TOML dumper would hand it back with
     # every comment and every bit of ordering gone.
     "tomlkit>=0.13.0",
+    # `verifaied test mcp` serves the recorder to a coding agent over MCP.
+    # A dependency rather than an extra: the recorder is how an agent
+    # proves a change in a browser, and an install that silently lacked it
+    # registered a server that died at start-up. Pinned to the range the
+    # backend's own MCP server is built against, so the two halves of the
+    # product speak the same protocol version.
+    "mcp>=1.27,<2.0.0",
 ]
 
 [project.optional-dependencies]
@@ -33,12 +40,9 @@ dependencies = [
 # command that needs one, and a ~300MB browser download has no business
 # being a dependency of `verifaied check`.
 audit = ["playwright>=1.49,<2"]
-# `verifaied test mcp` serves the recorder to a coding agent over MCP.
-# Optional for `audit`'s reason: it is the one command that needs a
-# protocol server, and nobody running `verifaied check` should pay for
-# one. Pinned to the range the backend's own MCP server is built against,
-# so the two halves of the product speak the same protocol version.
-agent = ["mcp>=1.27,<2.0.0"]
+# Kept, empty, so `verifaied[agent]` in an existing install command or
+# Makefile still resolves; the MCP library is now a plain dependency.
+agent = []
 
 [project.scripts]
 verifaied = "verifaied.cli:app"
@@ -58,10 +62,6 @@ dev = [
     "pytest>=8.0.0",
     "pytest-httpx>=0.30.0",
     "ruff>=0.8.0",
-    # `verifaied test mcp` is an optional extra at install time and a
-    # tested one here: the suite drives the server's tool functions
-    # directly, so the library has to be present when the suite runs.
-    "mcp>=1.27,<2.0.0",
 ]
 
 [tool.pytest.ini_options]

{verifaied-0.34.2.dev92 → verifaied-0.35.0.dev94}/src/verifaied/agent_mcp.py

@@ -104,11 +104,18 @@ from verifaied.testcmd import (
 )
 from verifaied.uploader import detect_branch
 
-INSTALL_HINT = (
-    "[red]VerifAIed error[/red]: `verifaied test mcp` needs the MCP server "
-    "library, which is an optional extra.\n"
-    r"  pip install 'verifaied\[agent]'      # or: "
-    r"uv tool install 'verifaied\[agent]'"
+# Every tool ``build_server`` registers, by name. The stand-in server a
+# recorder that cannot start serves (``build_unavailable_server``) answers
+# to the same names, so an agent that calls one learns why instead of
+# finding the tool missing.
+TOOL_NAMES = (
+    "list_tests",
+    "start_recording",
+    "run_steps",
+    "read_page",
+    "delete_step",
+    "finish_recording",
+    "cancel_recording",
 )
 
 # How long a settle is waited for. Per step, and capped per call, exactly
@@ -1148,11 +1155,9 @@ class AgentRecorderServer:
 def build_server(recorder: AgentRecorderServer) -> Any:
     """The FastMCP server, with one tool per thing an agent can do.
 
-    ``FastMCP`` is imported **here** rather than at module scope because
-    the MCP library is an optional extra: at module scope an install
-    without it would fail to load ``verifaied.cli`` at all and take every
-    other command down with it. The same exception
-    :func:`verifaied.audit._load_playwright` takes, for the same reason.
+    ``FastMCP`` is imported **here** rather than at module scope so that
+    every other command — ``check``, ``upload`` — starts without paying
+    for the MCP library's import.
     """
     from mcp.server.fastmcp import FastMCP
 
@@ -1308,9 +1313,7 @@ def run_test_mcp(
     be able to get wrong. Children are kept off fd 1 by
     :func:`quiet_process` and :func:`quiet_shell` for the same reason.
 
-    Returns the process exit code. ``1`` when the MCP library is not
-    installed, which is the one refusal this command can make before it
-    has done anything.
+    Returns the process exit code.
     """
     console = Console(stderr=True)
     err_console = Console(stderr=True)
@@ -1328,11 +1331,7 @@ def run_test_mcp(
         console=console,
         err_console=err_console,
     )
-    try:
-        server = build_server(recorder)
-    except ImportError:
-        err_console.print(INSTALL_HINT)
-        return 1
+    server = build_server(recorder)
     # Both ends of "this process is going away". atexit covers a clean
     # return and an uncaught exception; SIGTERM does not run atexit on its
     # own, and SIGTERM is how a supervisor stops a stdio server.
@@ -1342,6 +1341,38 @@ def run_test_mcp(
     return 0
 
 
+def build_unavailable_server(reason: str) -> Any:
+    """A recorder that could not start, still answering on stdio.
+
+    Exiting would leave the agent with nothing but "failed to connect" and
+    no reason. Instead every tool the real server has answers with
+    ``reason`` — say, "not logged in — run `verifaied login`" — so the
+    agent can tell the user exactly what to do. Extra arguments a call
+    carries are ignored."""
+    from mcp.server.fastmcp import FastMCP
+
+    message = (
+        f"verifaied-recorder is not ready: {reason}. Fix that, then reconnect "
+        "this MCP server (in Claude Code: /mcp, then reconnect "
+        "verifaied-recorder)."
+    )
+    mcp = FastMCP("verifaied-recorder", instructions=message)
+    for name in TOOL_NAMES:
+
+        async def unavailable() -> str:
+            return message
+
+        mcp.tool(name=name, description=message)(unavailable)
+    return mcp
+
+
+def run_unavailable_mcp(reason: str) -> int:
+    """Serve :func:`build_unavailable_server` until the session ends."""
+    Console(stderr=True).print(f"[red]VerifAIed error[/red]: {reason}")
+    build_unavailable_server(reason).run("stdio")
+    return 0
+
+
 def _install_termination_handler(recorder: AgentRecorderServer) -> None:
     """Close the browser on SIGTERM, then let the default handler run.
 
@@ -1363,7 +1394,9 @@ def _install_termination_handler(recorder: AgentRecorderServer) -> None:
 __all__ = [
     "AgentRecorderServer",
     "AgentRecording",
-    "INSTALL_HINT",
+    "TOOL_NAMES",
     "build_server",
+    "build_unavailable_server",
     "run_test_mcp",
+    "run_unavailable_mcp",
 ]