sv-cli 0.4.0__tar.gz → 0.6.0__tar.gz

{sv_cli-0.4.0 → sv_cli-0.6.0}/AGENT.md

@@ -64,7 +64,7 @@ All 16 available tools. Use exact command names — aliases are human shortcuts.
 | `ranklens` | — | `rank` | `--entity` `--url` | No |
 | `seo-image` | `image` | `generate` | `--keyword` | No |
 | `seogpt` | `seo-gpt` | `generate` | `--keyword` `--type` | No |
-| `seogpt2` | `seo-gpt2` | `create-task` | `--topic` *(`--keyword`/`--kw` is a separate, optional field)* | Yes |
+| `prose` | `seogpt2`, `seo-gpt2` | `create-task` | `--topic` *(`--keyword`/`--kw` is a separate, optional field)* | Yes |
 | `seogpt-compare` | `compare` | `create-task` | `--url` `--keyword` | Yes |
 | `seo-mapping` | `mapping` | `create-task` | `--url` `--keyword` | Yes |
 | `topical-authority` | `topical` | `topics` | `--keyword` | No |
@@ -84,10 +84,10 @@ preliminary-audit:    analyze, raw
 ranklens:             rank, competitors, raw
 seo-image:            generate, raw
 seogpt:               generate, raw
-seogpt2:              create-task, get-task-status, get-result, raw
+prose:                create-task, get-task-status, get-result, raw
 seogpt-compare:       create-task, get-task-status, get-result, raw
 seo-mapping:          create-task, get-task-status, get-result, raw
-topical-authority:    topics, content, raw
+topical-authority:    topics, raw
 top-competitors:      analyze, raw
 marketplace-services: search, raw
 content-quality:      analyze, raw
@@ -118,11 +118,11 @@ sv seogpt engines
 sv image types
 sv image themes
 sv image themes --search wild
-sv seogpt2 types
-sv seogpt2 lengths
-sv seogpt2 languages
-sv seogpt2 tones
-sv seogpt2 engines
+sv prose types
+sv prose lengths
+sv prose languages
+sv prose tones
+sv prose engines
 sv geo-audit types
 sv geo-audit languages
 sv seo-mapping types
@@ -190,7 +190,7 @@ Parse: `response["data"]["text"]`
 ```
 Parse: `response["data"]` — array of objects
 
-**Async task created** (`geo-audit create-task`, `seogpt2 create-task`, `seogpt-compare create-task`, `seo-mapping create-task`):
+**Async task created** (`geo-audit create-task`, `prose create-task`, `seogpt-compare create-task`, `seo-mapping create-task`):
 ```json
 { "data": { "task_id": "wFEGe...", "status": "pending", "stage": "queued", "percent_complete": 1 } }
 ```
@@ -247,7 +247,7 @@ sv geo-audit get-task-status --task-id TASK_ID --format json
 sv geo-audit get-result --task-id TASK_ID --format json
 ```
 
-Same for `seogpt2`, `seogpt-compare`, `seo-mapping` — replace `geo-audit` with the tool name.
+Same for `prose`, `seogpt-compare`, `seo-mapping` — replace `geo-audit` with the tool name.
 
 ---
 
@@ -255,17 +255,17 @@ Same for `seogpt2`, `seogpt-compare`, `seo-mapping` — replace `geo-audit` with
 
 These differ from the standard pattern — get them wrong and the call fails.
 
-### seogpt2 — `--topic` maps to `Topic` (required), `--keyword`/`--kw` is a separate field
+### prose — `--topic` maps to `Topic` (required), `--keyword`/`--kw` is a separate field
 
 ```bash
 # CORRECT — --topic sends value as the required "Topic" API field
-sv seogpt2 create-task --topic "White Label SEO for Agencies" --type on-page-blog-article --wait --strict --no-fuzzy --non-interactive --format json
+sv prose create-task --topic "White Label SEO for Agencies" --type on-page-blog-article --wait --strict --no-fuzzy --non-interactive --format json
 
 # --title is an alias for --topic (same field)
-sv seogpt2 create-task --title "White Label SEO for Agencies" --type on-page-blog-article --wait --strict --no-fuzzy --non-interactive --format json
+sv prose create-task --title "White Label SEO for Agencies" --type on-page-blog-article --wait --strict --no-fuzzy --non-interactive --format json
 
 # --keyword/--kw maps to the separate, optional KW field — it does NOT set Topic
-sv seogpt2 create-task --topic "White Label SEO for Agencies" --keyword "white label seo" --type on-page-blog-article --wait --strict --no-fuzzy --non-interactive --format json
+sv prose create-task --topic "White Label SEO for Agencies" --keyword "white label seo" --type on-page-blog-article --wait --strict --no-fuzzy --non-interactive --format json
 ```
 
 ### better-keywords `filter` — requires `data` array from prior `research` call
@@ -319,7 +319,7 @@ sv task status TASK_ID --tool geo-audit --format json
 |---|---|---|
 | `Could not resolve --type "X" in strict mode` | Value is not a valid slug or ID | Run `sv options TOOL type` → use `id` or `slug` column |
 | `Could not resolve --type "X"` (no strict) | No match found at any level | Run `sv options TOOL type --search X` to find closest match |
-| `Topic is required` | seogpt2 called without `--topic` | Add `--topic "your topic"` |
+| `Topic is required` | prose called without `--topic` | Add `--topic "your topic"` |
 | `task_id is invalid` | Task has expired on the server | Create a new task |
 | `No local tool mapping found for task` | Task not in `~/.sv/tasks.json` | Add `--tool TOOL_NAME` explicitly |
 | `API authentication failed: HTTP 401` | Bad or missing API key | Check `SV_API_KEY` environment variable |
@@ -381,7 +381,7 @@ sv preliminary-audit analyze --url https://example.com --strict --no-fuzzy --non
 sv ranklens rank --entity "white label seo" --url https://example.com --strict --no-fuzzy --non-interactive --format json
 sv seo-image generate --keyword "white label seo" --type 33 --strict --no-fuzzy --non-interactive --format json
 sv seogpt generate --keyword "white label seo" --type 18 --strict --no-fuzzy --non-interactive --format json
-sv seogpt2 create-task --topic "White Label SEO for Agencies" --type 0 --wait --strict --no-fuzzy --non-interactive --format json
+sv prose create-task --topic "White Label SEO for Agencies" --type 0 --wait --strict --no-fuzzy --non-interactive --format json
 sv seogpt-compare create-task --url https://example.com --keyword "white label seo" --wait --strict --no-fuzzy --non-interactive --format json
 sv seo-mapping create-task --url https://example.com --keyword "white label seo" --wait --strict --no-fuzzy --non-interactive --format json
 sv topical-authority topics --keyword "white label seo" --strict --no-fuzzy --non-interactive --format json
@@ -394,4 +394,4 @@ Common enum IDs (verify with `sv options` — these are from live API at time of
 - `seogpt --type 18` = Meta Description
 - `seogpt --type 8` = Page Title
 - `seo-image --type 33` = Blog Header Image
-- `seogpt2 --type 0` = On-Page Blog Article
+- `prose --type 0` = On-Page Blog Article

{sv_cli-0.4.0 → sv_cli-0.6.0}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.4
+Metadata-Version: 2.5
 Name: sv-cli
-Version: 0.4.0
+Version: 0.6.0
 Summary: Open-source, definition-driven command-line client for SV AI API tools.
 Project-URL: Homepage, https://github.com/seovendorco/sv-cli
 Project-URL: Issues, https://github.com/seovendorco/sv-cli/issues
@@ -163,7 +163,7 @@ sv title --keyword "white label seo" --url https://example.com
 | `ranklens` | | `ranklens` |
 | `seo-image` | `image` | `seo-image` |
 | `seogpt` | `seo-gpt` | `seogpt` |
-| `seogpt2` | `seo-gpt2` | `seogpt2` |
+| `prose` | `seogpt2`, `seo-gpt2` | `seogpt2` |
 | `seogpt-compare` | `compare` | `seogptcompare` |
 | `seo-mapping` | `mapping` | `seogptmapping` |
 | `topical-authority` | `topical` | `topical-authority` |
@@ -252,13 +252,13 @@ sv task status TASK_ID --tool geo-audit
 sv task result TASK_ID --tool geo-audit
 ```
 
-`seogpt2` is another async tool. Its required field is `Topic` (a title or subject), mapped via `--topic` (`--title` is an alias for the same field). `--keyword`/`--kw` is a separate, optional field for additional keywords — it does not set the topic:
+`prose` (formerly `seogpt2`) is another async tool. Its required field is `Topic` (a title or subject), mapped via `--topic` (`--title` is an alias for the same field). `--keyword`/`--kw` is a separate, optional field for additional keywords — it does not set the topic:
 
 ```bash
-sv seogpt2 create-task --topic "White Label SEO for Agencies" --type on-page-blog-article --wait
+sv prose create-task --topic "White Label SEO for Agencies" --type on-page-blog-article --wait
 ```
 
-See available types with `sv seogpt2 types`, lengths with `sv seogpt2 lengths`, engines with `sv seogpt2 engines`.
+See available types with `sv prose types`, lengths with `sv prose lengths`, engines with `sv prose engines`.
 
 Manual 3-step flow (without `--wait`):
 

{sv_cli-0.4.0 → sv_cli-0.6.0}/README.md

@@ -128,7 +128,7 @@ sv title --keyword "white label seo" --url https://example.com
 | `ranklens` | | `ranklens` |
 | `seo-image` | `image` | `seo-image` |
 | `seogpt` | `seo-gpt` | `seogpt` |
-| `seogpt2` | `seo-gpt2` | `seogpt2` |
+| `prose` | `seogpt2`, `seo-gpt2` | `seogpt2` |
 | `seogpt-compare` | `compare` | `seogptcompare` |
 | `seo-mapping` | `mapping` | `seogptmapping` |
 | `topical-authority` | `topical` | `topical-authority` |
@@ -217,13 +217,13 @@ sv task status TASK_ID --tool geo-audit
 sv task result TASK_ID --tool geo-audit
 ```
 
-`seogpt2` is another async tool. Its required field is `Topic` (a title or subject), mapped via `--topic` (`--title` is an alias for the same field). `--keyword`/`--kw` is a separate, optional field for additional keywords — it does not set the topic:
+`prose` (formerly `seogpt2`) is another async tool. Its required field is `Topic` (a title or subject), mapped via `--topic` (`--title` is an alias for the same field). `--keyword`/`--kw` is a separate, optional field for additional keywords — it does not set the topic:
 
 ```bash
-sv seogpt2 create-task --topic "White Label SEO for Agencies" --type on-page-blog-article --wait
+sv prose create-task --topic "White Label SEO for Agencies" --type on-page-blog-article --wait
 ```
 
-See available types with `sv seogpt2 types`, lengths with `sv seogpt2 lengths`, engines with `sv seogpt2 engines`.
+See available types with `sv prose types`, lengths with `sv prose lengths`, engines with `sv prose engines`.
 
 Manual 3-step flow (without `--wait`):
 

{sv_cli-0.4.0 → sv_cli-0.6.0}/docs/commands.md

@@ -24,7 +24,7 @@ sv preliminary-audit run --url https://example.com
 sv ranklens analyze --brand "SV" --keyword "white label seo"
 sv seo-image generate --keyword "white label seo" --type blog-header
 sv seogpt generate --type meta-description --keyword "white label seo"
-sv seogpt2 article --keyword "white label seo" --wait
+sv prose article --keyword "white label seo" --wait
 sv seogpt-compare run --url https://example.com --keyword "white label seo"
 sv seo-mapping run --url https://example.com --keywords "seo agency" --wait
 sv topical-authority generate --keyword "local seo"

{sv_cli-0.4.0 → sv_cli-0.6.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "sv-cli"
-version = "0.4.0"
+version = "0.6.0"
 description = "Open-source, definition-driven command-line client for SV AI API tools."
 readme = "README.md"
 requires-python = ">=3.10"

{sv_cli-0.4.0 → sv_cli-0.6.0}/src/sv_cli/__init__.py

@@ -1,3 +1,3 @@
 """SV CLI package."""
 
-__version__ = "0.3.0"
+__version__ = "0.6.0"

{sv_cli-0.4.0 → sv_cli-0.6.0}/src/sv_cli/adapters.py

@@ -184,9 +184,15 @@ TOOL_ADAPTERS: dict[str, ToolAdapter] = {
         },
     ),
     "seogpt2": ToolAdapter(
+        # "Prose" is the current product name; seogpt2 is the original one, kept
+        # working as an alias so existing scripts don't break. canonical stays
+        # "seogpt2" deliberately - it's what the live API root still keys this
+        # tool under, and keeping it means the CLI works whether or not the
+        # /api/prose/ alias folder is deployed yet. Flip it to "prose" only when
+        # /api/seogpt2/ is actually retired.
         canonical="seogpt2",
-        command="seogpt2",
-        aliases=("seo-gpt2",),
+        command="prose",
+        aliases=("seogpt2", "seo-gpt2"),
         default_action="create-task",
         actions=("create-task", "get-task-status", "get-result", "raw"),
         field_aliases={
@@ -242,7 +248,7 @@ TOOL_ADAPTERS: dict[str, ToolAdapter] = {
         command="topical-authority",
         aliases=("topical",),
         default_action="topics",
-        actions=("topics", "content", "raw"),
+        actions=("topics", "raw"),
         field_aliases=COMMON_FIELD_ALIASES,
         option_aliases={
             "modes": ("topicmode", "topic_mode", "mode", "modes"),

{sv_cli-0.4.0 → sv_cli-0.6.0}/src/sv_cli/api_client.py

@@ -24,9 +24,13 @@ class APIResponse:
 
 
 class APIClient:
-    def __init__(self, *, debug: bool = False, console: Console | None = None) -> None:
+    def __init__(self, *, debug: bool = False, console: Console | None = None, client_type: str | None = None) -> None:
         self.debug = debug
         self.console = console or Console(stderr=True)
+        # Identifies this process to the SV API as "cli" or "mcp" (X-SV-Client header)
+        # for usage tracking. None means the caller didn't specify one - the header is
+        # simply omitted, and the API buckets the call as generic "api" usage.
+        self.client_type = client_type
 
     def request_tool(
         self,
@@ -42,6 +46,7 @@ class APIClient:
             final_payload["k"] = api_key
 
         method = method.upper()
+        headers = {"X-SV-Client": self.client_type} if self.client_type else None
         if self.debug:
             parsed = urlparse(endpoint)
             shown_path = parsed.path or endpoint
@@ -50,7 +55,7 @@ class APIClient:
 
         started = time.perf_counter()
         try:
-            with httpx.Client(timeout=timeout, follow_redirects=True) as client:
+            with httpx.Client(timeout=timeout, follow_redirects=True, headers=headers) as client:
                 if method == "GET":
                     response = client.get(endpoint, params=final_payload)
                 elif method in {"POST", "PUT", "PATCH"}:

{sv_cli-0.4.0 → sv_cli-0.6.0}/src/sv_cli/executor.py

@@ -120,6 +120,7 @@ def execute_tool(
     raw_payload: dict[str, Any] | None = None,
     method: str = "POST",
     console: Console | None = None,
+    client_type: str | None = None,
 ) -> Any:
     console = console or Console()
     definitions = DefinitionsManager(runtime.base_url)
@@ -149,7 +150,7 @@ def execute_tool(
             non_interactive=runtime.non_interactive,
         )
 
-    client = APIClient(debug=runtime.debug, console=Console(stderr=True))
+    client = APIClient(debug=runtime.debug, console=Console(stderr=True), client_type=client_type)
     response = client.request_tool(endpoint=str(endpoint), payload=payload, api_key=api_key, method=method)
     data = response.data
 

{sv_cli-0.4.0 → sv_cli-0.6.0}/src/sv_cli/main.py

@@ -228,6 +228,7 @@ def run_tool_action(
             wait_options=wait_options,
             method=method,
             console=console,
+            client_type="cli",
         )
     except Exception as exc:  # noqa: BLE001
         fail(exc)
@@ -597,7 +598,16 @@ def raw_call(
         runtime = runtime_from_ctx(ctx)
         # Raw calls intentionally bypass fuzzy matching. Users can pass exact API payloads.
         runtime.no_fuzzy = True
-        execute_tool(tool_name=tool, action=None, params={}, runtime=runtime, raw_payload=payload, method=method, console=console)
+        execute_tool(
+            tool_name=tool,
+            action=None,
+            params={},
+            runtime=runtime,
+            raw_payload=payload,
+            method=method,
+            console=console,
+            client_type="cli",
+        )
     except Exception as exc:  # noqa: BLE001
         fail(exc)
 
@@ -617,7 +627,7 @@ def task_call(ctx: typer.Context, task_id: str, action: str, tool: str | None) -
         non_interactive=runtime.non_interactive,
     )
     payload = status_payload(task_id) if action == "status" else result_payload(task_id)
-    data = APIClient(debug=runtime.debug, console=err_console).request_tool(
+    data = APIClient(debug=runtime.debug, console=err_console, client_type="cli").request_tool(
         endpoint=str(entry.get("endpoint")), payload=payload, api_key=api_key
     ).data
     print_output(console, data, runtime.output_format, runtime.output)
@@ -945,6 +955,7 @@ def make_tool_app(adapter: ToolAdapter) -> typer.Typer:
                 runtime=runtime,
                 wait_options=wait_options,
                 console=console,
+                client_type="cli",
             )
         except Exception as exc:  # noqa: BLE001
             fail(exc)
@@ -977,6 +988,7 @@ def make_tool_app(adapter: ToolAdapter) -> typer.Typer:
                 raw_payload=payload,
                 method=method,
                 console=console,
+                client_type="cli",
             )
         except Exception as exc:  # noqa: BLE001
             fail(exc)

{sv_cli-0.4.0 → sv_cli-0.6.0}/src/sv_cli/tasks.py

@@ -50,7 +50,7 @@ def get_task_tool(task_id: str, tool: str | None = None) -> str:
         return str(entry["tool"])
     raise ConfigError(
         f'No local tool mapping found for task "{task_id}". Re-run with --tool, for example: '
-        f"sv task status {task_id} --tool seogpt2"
+        f"sv task status {task_id} --tool prose"
     )
 
 

{sv_cli-0.4.0 → sv_cli-0.6.0}/tests/test_help_filtering.py

@@ -78,3 +78,15 @@ def test_tool_help_separates_actions_from_option_lookups(tmp_path):
     actions_section = output.split("Option lookups")[0]
     assert "create-task" in actions_section
     assert "languages" not in actions_section
+
+
+def test_prose_is_the_primary_name_and_seogpt2_still_works(tmp_path):
+    """Prose is the current product name; the old names stay as aliases.
+
+    All three must resolve to the same tool - dropping seogpt2/seo-gpt2 would
+    break any existing script that hardcodes them.
+    """
+    for name in ("prose", "seogpt2", "seo-gpt2"):
+        output = _run_cli(tmp_path, name, "create-task", "--help")
+        assert "--topic" in output, f"{name} did not resolve to the Prose tool"
+        assert "--keyword" in output