arga-cli 0.1.4__tar.gz → 0.1.6__tar.gz

{arga_cli-0.1.4 → arga_cli-0.1.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: arga-cli
-Version: 0.1.4
+Version: 0.1.6
 Summary: Command-line interface for Arga authentication, MCP installation, and browser validation
 Author: Arga Labs
 Project-URL: Homepage, https://github.com/ArgaLabs/arga-cli
@@ -17,6 +17,8 @@ Classifier: Topic :: Software Development
 Requires-Python: >=3.12
 Description-Content-Type: text/markdown
 Requires-Dist: httpx>=0.27.0
+Requires-Dist: questionary>=2.0.0
+Requires-Dist: rich>=13.0.0
 
 # Arga CLI
 
@@ -87,6 +89,14 @@ Start a pull request validation run:
 arga validate pr --repo arga-labs/validation-server --pr 182
 ```
 
+Any of these commands accept `--json` for machine-parseable output:
+
+```bash
+arga test url --url https://demo-app.com --prompt "test login" --json
+arga runs list --json
+arga runs status <run_id> --json
+```
+
 Create a commit that skips Arga validation:
 
 ```bash
@@ -119,12 +129,6 @@ arga runs logs <run_id>
 arga runs cancel <run_id>
 ```
 
-`arga validate url` is also available and currently behaves the same as `arga test url`:
-
-```bash
-arga validate url --url https://demo-app.com --prompt "test checkout"
-```
-
 ## Command Reference
 
 ### Authentication
@@ -143,7 +147,6 @@ arga logout
 
 ```bash
 arga test url --url https://demo-app.com --prompt "test login flow"
-arga validate url --url https://demo-app.com --prompt "test checkout"
 arga validate pr --repo arga-labs/validation-server --pr 182
 arga validate install arga-labs/validation-server
 arga validate config arga-labs/validation-server
@@ -151,8 +154,9 @@ arga validate config set arga-labs/validation-server --trigger branch --branch m
 ```
 
 - `arga test url` starts a one-off validation against a deployed URL.
-- `arga validate url` is an equivalent URL-validation entry point under the `validate` namespace.
 - `arga validate pr` starts GitHub-backed PR validation for a repository and pull request number.
+
+Both accept `--json` to output `{"run_id": "...", "status": "..."}` instead of human-readable text.
 - `arga validate install <repo>` installs the GitHub webhook for automatic validation on a repository.
 - `arga validate config <repo>` shows the current automatic validation settings, including install state, trigger mode, selected branch, and PR comment behavior.
 - `arga validate config set <repo>` updates the automatic validation settings. Any omitted options keep their current value.
@@ -201,6 +205,8 @@ arga runs cancel <run_id>
 - Add `--errors-only` to keep only failed worker logs plus warning/error runtime entries.
 - `arga runs cancel <run_id>` cancels the run through the validation API.
 
+Both `runs list` and `runs status` accept `--json` for structured output.
+
 ### Git Wrappers
 
 ```bash
@@ -260,6 +266,42 @@ If you need to add the server manually, the generated config looks like:
 }
 ```
 
+## JSON Output
+
+Key commands support `--json` for use in CI pipelines, shell scripts, and agent automation:
+
+```bash
+# Capture the run ID from a validation
+RUN_ID=$(arga test url --url https://app.example.com --prompt "test login" --json | jq -r .run_id)
+
+# Poll run status as JSON
+arga runs status "$RUN_ID" --json | jq .status
+
+# List runs as a JSON array
+arga runs list --repo arga-labs/validation-server --json | jq '.[].run_id'
+
+# Start PR validation and capture result
+arga validate pr --repo arga-labs/validation-server --pr 182 --json
+```
+
+Commands that support `--json`:
+
+| Command | JSON shape |
+|---|---|
+| `arga test url` | `{"run_id": "...", "status": "..."}` |
+| `arga validate pr` | `{"run_id": "...", "status": "..."}` |
+| `arga runs status <id>` | Full run object |
+| `arga runs list` | Array of run summaries |
+
+## Example Project
+
+See [ArgaLabs/example-app](https://github.com/ArgaLabs/example-app) for a complete working example showing how to integrate Arga into a Next.js project with:
+
+- GitHub Actions CI validation on every PR
+- MCP config for Cursor and Claude Code
+- A shell script for manual validation
+- End-to-end walkthrough in the README
+
 ## Using A Custom API URL
 
 By default, the CLI targets `https://api.argalabs.com`.
@@ -270,7 +312,6 @@ To point it at another environment, pass `--api-url` or set `ARGA_API_URL`:
 arga login --api-url http://localhost:8000
 arga mcp install --api-url http://localhost:8000
 arga test url --api-url http://localhost:8000 --url https://demo-app.com --prompt "test checkout"
-arga validate url --api-url http://localhost:8000 --url https://demo-app.com --prompt "test checkout"
 arga validate pr --api-url http://localhost:8000 --repo arga-labs/validation-server --pr 182
 ```
 

{arga_cli-0.1.4 → arga_cli-0.1.6}/README.md

@@ -67,6 +67,14 @@ Start a pull request validation run:
 arga validate pr --repo arga-labs/validation-server --pr 182
 ```
 
+Any of these commands accept `--json` for machine-parseable output:
+
+```bash
+arga test url --url https://demo-app.com --prompt "test login" --json
+arga runs list --json
+arga runs status <run_id> --json
+```
+
 Create a commit that skips Arga validation:
 
 ```bash
@@ -99,12 +107,6 @@ arga runs logs <run_id>
 arga runs cancel <run_id>
 ```
 
-`arga validate url` is also available and currently behaves the same as `arga test url`:
-
-```bash
-arga validate url --url https://demo-app.com --prompt "test checkout"
-```
-
 ## Command Reference
 
 ### Authentication
@@ -123,7 +125,6 @@ arga logout
 
 ```bash
 arga test url --url https://demo-app.com --prompt "test login flow"
-arga validate url --url https://demo-app.com --prompt "test checkout"
 arga validate pr --repo arga-labs/validation-server --pr 182
 arga validate install arga-labs/validation-server
 arga validate config arga-labs/validation-server
@@ -131,8 +132,9 @@ arga validate config set arga-labs/validation-server --trigger branch --branch m
 ```
 
 - `arga test url` starts a one-off validation against a deployed URL.
-- `arga validate url` is an equivalent URL-validation entry point under the `validate` namespace.
 - `arga validate pr` starts GitHub-backed PR validation for a repository and pull request number.
+
+Both accept `--json` to output `{"run_id": "...", "status": "..."}` instead of human-readable text.
 - `arga validate install <repo>` installs the GitHub webhook for automatic validation on a repository.
 - `arga validate config <repo>` shows the current automatic validation settings, including install state, trigger mode, selected branch, and PR comment behavior.
 - `arga validate config set <repo>` updates the automatic validation settings. Any omitted options keep their current value.
@@ -181,6 +183,8 @@ arga runs cancel <run_id>
 - Add `--errors-only` to keep only failed worker logs plus warning/error runtime entries.
 - `arga runs cancel <run_id>` cancels the run through the validation API.
 
+Both `runs list` and `runs status` accept `--json` for structured output.
+
 ### Git Wrappers
 
 ```bash
@@ -240,6 +244,42 @@ If you need to add the server manually, the generated config looks like:
 }
 ```
 
+## JSON Output
+
+Key commands support `--json` for use in CI pipelines, shell scripts, and agent automation:
+
+```bash
+# Capture the run ID from a validation
+RUN_ID=$(arga test url --url https://app.example.com --prompt "test login" --json | jq -r .run_id)
+
+# Poll run status as JSON
+arga runs status "$RUN_ID" --json | jq .status
+
+# List runs as a JSON array
+arga runs list --repo arga-labs/validation-server --json | jq '.[].run_id'
+
+# Start PR validation and capture result
+arga validate pr --repo arga-labs/validation-server --pr 182 --json
+```
+
+Commands that support `--json`:
+
+| Command | JSON shape |
+|---|---|
+| `arga test url` | `{"run_id": "...", "status": "..."}` |
+| `arga validate pr` | `{"run_id": "...", "status": "..."}` |
+| `arga runs status <id>` | Full run object |
+| `arga runs list` | Array of run summaries |
+
+## Example Project
+
+See [ArgaLabs/example-app](https://github.com/ArgaLabs/example-app) for a complete working example showing how to integrate Arga into a Next.js project with:
+
+- GitHub Actions CI validation on every PR
+- MCP config for Cursor and Claude Code
+- A shell script for manual validation
+- End-to-end walkthrough in the README
+
 ## Using A Custom API URL
 
 By default, the CLI targets `https://api.argalabs.com`.
@@ -250,7 +290,6 @@ To point it at another environment, pass `--api-url` or set `ARGA_API_URL`:
 arga login --api-url http://localhost:8000
 arga mcp install --api-url http://localhost:8000
 arga test url --api-url http://localhost:8000 --url https://demo-app.com --prompt "test checkout"
-arga validate url --api-url http://localhost:8000 --url https://demo-app.com --prompt "test checkout"
 arga validate pr --api-url http://localhost:8000 --repo arga-labs/validation-server --pr 182
 ```