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

{sv_cli-0.5.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,7 +84,7 @@ 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, 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.5.0 → sv_cli-0.6.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: sv-cli
-Version: 0.5.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.5.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.5.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.5.0 → sv_cli-0.6.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "sv-cli"
-version = "0.5.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.5.0 → sv_cli-0.6.0}/src/sv_cli/__init__.py

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

{sv_cli-0.5.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={

{sv_cli-0.5.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.5.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