hookstride-cli 0.2.1__tar.gz → 0.3.0__tar.gz

{hookstride_cli-0.2.1 → hookstride_cli-0.3.0}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.5
 Name: hookstride-cli
-Version: 0.2.1
-Summary: Command-line access to Hookstride projects, webhook activity, and billing.
+Version: 0.3.0
+Summary: Manage Hookstride projects and destinations, inspect webhook activity and billing.
 License: Proprietary
 Requires-Python: >=3.11
 Requires-Dist: click<9,>=8.1
@@ -13,9 +13,9 @@ Description-Content-Type: text/markdown
 
 # Hookstride CLI
 
-Hookstride CLI provides command-line access to project information, webhook activity, incoming integrations, and billing records in Hookstride. It includes an interactive console for inspecting the same information without using the web dashboard.
+Hookstride CLI lets you manage projects and webhook destinations, inspect delivery activity, and view billing records. It includes an interactive console with the same selected-project commands.
 
-The current release supports read operations only. It cannot create or modify destinations, replay deliveries, manage credentials, or initiate payments.
+Version 0.3.0 adds project creation and updates, plus destination creation, updates, and pausing/resuming. Billing and credential changes, delivery replay, and destructive operations remain unavailable.
 
 ## Installation
 
@@ -65,8 +65,14 @@ hookstride status
 hookstride auth status
 hookstride projects list
 hookstride projects use PROJECT_UUID
+hookstride projects create --account ACCOUNT_UUID --name "Staging" --slug staging
+hookstride projects update PROJECT_UUID --name "Production EU"
 
 hookstride destinations list
+hookstride destinations create --name "Webhook receiver" --url "https://app.example.com/webhooks/hookstride"
+hookstride destinations update DESTINATION_UUID --url "https://api.example.com/webhooks/hookstride"
+hookstride destinations update DESTINATION_UUID --pause
+hookstride destinations update DESTINATION_UUID --resume
 hookstride keys list
 hookstride events list --status failed
 hookstride events show EVENT_UUID
@@ -82,7 +88,7 @@ hookstride billing history
 hookstride config show
 ```
 
-Replace `PROJECT_UUID` and `EVENT_UUID` with identifiers from your account.
+Replace the example UUIDs with identifiers from your account. Find your workspace's `account_id` with `hookstride --json projects list`; that ID is required for project creation. Project creation and renaming require an admin/owner role. Destination changes require developer access or higher.
 
 Commands that operate on a project use the selected project. You can override the selection for an individual command:
 
@@ -96,7 +102,7 @@ hookstride --project PROJECT_UUID events list
 hookstride console
 ```
 
-Use `help` to view commands, Tab for completion, and `exit` or Ctrl+D to leave. The console also supports `show projects`, `show events`, `show destinations`, `use PROJECT_UUID`, `back`, and `set env dev|production`.
+Use `help` to view commands, Tab for completion, and `exit` or Ctrl+D to leave. The console also supports `show projects`, `show events`, `show destinations`, `use PROJECT_UUID`, `back`, and `set env dev|production`. The same `projects create/update` and `destinations create/update` commands work inside the console. Commands with customer-provided names and URLs are not saved to console history.
 
 ### JSON output
 
@@ -108,24 +114,23 @@ hookstride --project PROJECT_UUID --json events list --status failed
 hookstride --env production --json billing history
 ```
 
-Errors go to standard error; unsuccessful requests return a nonzero exit code.
+Errors go to standard error; unsuccessful requests return a nonzero exit code. When creating a destination, the server returns a signing secret **once**. Save it securely immediately. Both terminal output and `--json` deliberately include that one-time secret, so avoid piping creation output into logs or public CI artifacts.
 
 ## Environments and local settings
 
-The CLI connects to the development API by default: `https://api-dev.hookstride.voteeasy.net`.
+The CLI connects to the production API by default: `https://api.hookstride.com`.
+A new release must be published to PyPI before existing installations receive this change.
 
-To access production, select it explicitly:
+To inspect the development API explicitly, select it:
 
 ```bash
-hookstride --env production console
+hookstride --env dev console
 ```
 
-Production requests use `https://api.hookstride.voteeasy.net`. Use a Control API token issued for the selected environment. A custom HTTPS API origin can be supplied with `--api-url`.
+Development requests use `https://api-dev.hookstride.com`. Use a Control API token issued for the selected environment. A custom HTTPS API origin can be supplied with `--api-url`.
 
 Project selections are stored separately by environment in `~/.config/hookstride/settings.json`. This file contains project identifiers, **not authentication tokens**. Console tokens and command history remain in memory and are discarded at exit.
 
 ## Documentation
 
-Product documentation: https://hookstride.voteeasy.net/docs
-
-Source: https://github.com/quarj0/webhook-reliability-api/tree/main/cli
+Documentation: https://hookstride.com

{hookstride_cli-0.2.1 → hookstride_cli-0.3.0}/README.md

@@ -1,8 +1,8 @@
 # Hookstride CLI
 
-Hookstride CLI provides command-line access to project information, webhook activity, incoming integrations, and billing records in Hookstride. It includes an interactive console for inspecting the same information without using the web dashboard.
+Hookstride CLI lets you manage projects and webhook destinations, inspect delivery activity, and view billing records. It includes an interactive console with the same selected-project commands.
 
-The current release supports read operations only. It cannot create or modify destinations, replay deliveries, manage credentials, or initiate payments.
+Version 0.3.0 adds project creation and updates, plus destination creation, updates, and pausing/resuming. Billing and credential changes, delivery replay, and destructive operations remain unavailable.
 
 ## Installation
 
@@ -52,8 +52,14 @@ hookstride status
 hookstride auth status
 hookstride projects list
 hookstride projects use PROJECT_UUID
+hookstride projects create --account ACCOUNT_UUID --name "Staging" --slug staging
+hookstride projects update PROJECT_UUID --name "Production EU"
 
 hookstride destinations list
+hookstride destinations create --name "Webhook receiver" --url "https://app.example.com/webhooks/hookstride"
+hookstride destinations update DESTINATION_UUID --url "https://api.example.com/webhooks/hookstride"
+hookstride destinations update DESTINATION_UUID --pause
+hookstride destinations update DESTINATION_UUID --resume
 hookstride keys list
 hookstride events list --status failed
 hookstride events show EVENT_UUID
@@ -69,7 +75,7 @@ hookstride billing history
 hookstride config show
 ```
 
-Replace `PROJECT_UUID` and `EVENT_UUID` with identifiers from your account.
+Replace the example UUIDs with identifiers from your account. Find your workspace's `account_id` with `hookstride --json projects list`; that ID is required for project creation. Project creation and renaming require an admin/owner role. Destination changes require developer access or higher.
 
 Commands that operate on a project use the selected project. You can override the selection for an individual command:
 
@@ -83,7 +89,7 @@ hookstride --project PROJECT_UUID events list
 hookstride console
 ```
 
-Use `help` to view commands, Tab for completion, and `exit` or Ctrl+D to leave. The console also supports `show projects`, `show events`, `show destinations`, `use PROJECT_UUID`, `back`, and `set env dev|production`.
+Use `help` to view commands, Tab for completion, and `exit` or Ctrl+D to leave. The console also supports `show projects`, `show events`, `show destinations`, `use PROJECT_UUID`, `back`, and `set env dev|production`. The same `projects create/update` and `destinations create/update` commands work inside the console. Commands with customer-provided names and URLs are not saved to console history.
 
 ### JSON output
 
@@ -95,24 +101,23 @@ hookstride --project PROJECT_UUID --json events list --status failed
 hookstride --env production --json billing history
 ```
 
-Errors go to standard error; unsuccessful requests return a nonzero exit code.
+Errors go to standard error; unsuccessful requests return a nonzero exit code. When creating a destination, the server returns a signing secret **once**. Save it securely immediately. Both terminal output and `--json` deliberately include that one-time secret, so avoid piping creation output into logs or public CI artifacts.
 
 ## Environments and local settings
 
-The CLI connects to the development API by default: `https://api-dev.hookstride.voteeasy.net`.
+The CLI connects to the production API by default: `https://api.hookstride.com`.
+A new release must be published to PyPI before existing installations receive this change.
 
-To access production, select it explicitly:
+To inspect the development API explicitly, select it:
 
 ```bash
-hookstride --env production console
+hookstride --env dev console
 ```
 
-Production requests use `https://api.hookstride.voteeasy.net`. Use a Control API token issued for the selected environment. A custom HTTPS API origin can be supplied with `--api-url`.
+Development requests use `https://api-dev.hookstride.com`. Use a Control API token issued for the selected environment. A custom HTTPS API origin can be supplied with `--api-url`.
 
 Project selections are stored separately by environment in `~/.config/hookstride/settings.json`. This file contains project identifiers, **not authentication tokens**. Console tokens and command history remain in memory and are discarded at exit.
 
 ## Documentation
 
-Product documentation: https://hookstride.voteeasy.net/docs
-
-Source: https://github.com/quarj0/webhook-reliability-api/tree/main/cli
+Documentation: https://hookstride.com

{hookstride_cli-0.2.1 → hookstride_cli-0.3.0}/pyproject.toml

@@ -4,8 +4,8 @@ build-backend = "hatchling.build"
 
 [project]
 name = "hookstride-cli"
-version = "0.2.1"
-description = "Command-line access to Hookstride projects, webhook activity, and billing."
+version = "0.3.0"
+description = "Manage Hookstride projects and destinations, inspect webhook activity and billing."
 readme = "README.md"
 requires-python = ">=3.11"
 license = { text = "Proprietary" }

{hookstride_cli-0.2.1 → hookstride_cli-0.3.0}/src/hookstride_cli/__init__.py

@@ -1,3 +1,3 @@
 """Hookstride developer CLI."""
 
-__version__ = "0.2.1"
+__version__ = "0.3.0"

{hookstride_cli-0.2.1 → hookstride_cli-0.3.0}/src/hookstride_cli/console.py

@@ -1,8 +1,7 @@
-"""Interactive, read-only Hookstride console.
+"""Interactive Hookstride console with allowlisted project and destination writes.
 
-The console intentionally does not execute shell commands. It uses the same
-project-scoped Control API commands as the CLI, keeps tokens only in memory,
-and stores no history on disk.
+The console never executes shell commands, retains tokens only in memory,
+and stores no command history on disk.
 """
 
 from __future__ import annotations
@@ -25,11 +24,11 @@ from typer.main import get_command
 from . import main as cli
 
 # Only these typed commands may execute through the console.
-# Future write actions must be explicitly reviewed, not implicitly unlocked.
-READ_COMMANDS: dict[str, set[str]] = {
+# Write actions are intentionally allowlisted, never automatically unlocked.
+ALLOWED_COMMANDS: dict[str, set[str]] = {
     "auth": {"status"},
-    "projects": {"list", "use"},
-    "destinations": {"list"},
+    "projects": {"list", "use", "create", "update"},
+    "destinations": {"list", "create", "update"},
     "keys": {"list"},
     "events": {"list", "show"},
     "billing": {"status", "history"},
@@ -38,7 +37,7 @@ READ_COMMANDS: dict[str, set[str]] = {
 }
 ROOT_COMMANDS = {"status", "stats"}
 
-# Aliases that feel like a familiar operator console, but remain read-only.
+# Aliases that feel like a familiar operator console.
 SHOW_TARGETS: dict[str, tuple[str, ...] | None] = {
     "options": None,
     "projects": ("projects", "list"),
@@ -72,6 +71,8 @@ COMMAND_COMPLETIONS = sorted(
         *SAFE_HISTORY_COMMANDS,
         "use ", "projects use ", "events show ", "events list --status ",
         "events list --origin ", "events list --page ", "set project ",
+        "projects create --name ", "projects update ",
+        "destinations create --name ", "destinations update ",
         "set env ", "json ", "show ", "auth ",
     }
 )
@@ -194,6 +195,8 @@ class HookstrideConsole:
             "[bold]help[/bold]                  Show console help\n"
             "[bold]show options[/bold]          Display environment, project and authentication\n"
             "[bold]show projects[/bold]         List accessible projects\n"
+            "[bold]projects create --name N --account UUID[/bold]   Create a project\n"
+            "[bold]projects update UUID --name N[/bold]     Rename a project\n"
             "[bold]use UUID[/bold]              Select a project (also saves preference)\n"
             "[bold]back[/bold]                  Leave the active project context\n"
             "[bold]set env dev[/bold]           Switch to development API\n"
@@ -202,6 +205,8 @@ class HookstrideConsole:
             "[bold]auth logout[/bold]           Clear the current environment's session token\n"
             "[bold]auth status[/bold]           Validate current token\n"
             "[bold]show destinations[/bold]     Inspect outgoing webhooks\n"
+            "[bold]destinations create --name N --url HTTPS_URL[/bold]   Add receiver\n"
+            "[bold]destinations update UUID --pause[/bold]   Pause a receiver\n"
             "[bold]show events[/bold]           View recent events\n"
             "[bold]events list --status failed[/bold]   Filter delivery history\n"
             "[bold]events show UUID[/bold]      Inspect a delivery and attempts\n"
@@ -223,7 +228,6 @@ class HookstrideConsole:
             ["API", self.session.origin],
             ["Project", project],
             ["Authenticated token", "configured" if self._current_token() else "missing"],
-            ["Mode", "read-only"],
         ]
         cli._table(_FakeContext(self.session), "Session options", ["Setting", "Value"], rows)
 
@@ -294,7 +298,7 @@ class HookstrideConsole:
         self._write("[green]✓[/green] Signed out for this console environment.")
 
     def _execute_cli(self, args: list[str], *, json_output: bool = False) -> None:
-        """Invoke existing read-only Click/Typer commands, never a shell."""
+        """Invoke explicitly allowed Click/Typer commands, never a shell."""
         if not _allowed_cli(args):
             raise cli.CLIError("Unknown or unavailable command. Type 'help'.")
         group = args[0]
@@ -382,7 +386,7 @@ class HookstrideConsole:
 
     def run(self) -> None:
         self._write(
-            "\n[bold cyan]HOOKSTRIDE[/bold cyan] [dim]CONSOLE v0.2[/dim]\n"
+            f"\n[bold cyan]HOOKSTRIDE[/bold cyan] [dim]CONSOLE v{cli.VERSION}[/dim]\n"
             "[dim]Type 'help' for commands, 'auth login' for a token, "
             "or 'exit' to quit.[/dim]\n"
         )
@@ -431,8 +435,8 @@ def _allowed_cli(parts: list[str]) -> bool:
         return len(parts) == 1
     return (
         len(parts) >= 2
-        and parts[0] in READ_COMMANDS
-        and parts[1] in READ_COMMANDS[parts[0]]
+        and parts[0] in ALLOWED_COMMANDS
+        and parts[1] in ALLOWED_COMMANDS[parts[0]]
     )