nexusquant-cli 0.1.1__tar.gz → 0.1.2__tar.gz

{nexusquant_cli-0.1.1 → nexusquant_cli-0.1.2}/.gitignore

@@ -4,3 +4,6 @@ __pycache__/
 *.egg-info/
 dist/
 build/
+*.ipynb
+.idea/
+.DS_Store

nexusquant_cli-0.1.2/CLAUDE.md

@@ -0,0 +1,66 @@
+# nexusquant-cli
+
+Python CLI for Nexus strategy providers. Handles Cognito PKCE browser-based login, token storage/refresh, and wraps the Nexus provider API (strategies, signals, containers).
+
+## What this repo does
+
+Command-line tool that strategy providers (and admins) use to manage their strategies and submit signals without going through the web UI. Authenticates via Cognito browser login, stores tokens locally, and calls the same REST API as the frontend.
+
+## Code structure
+
+```
+nexusquant_cli/
+  main.py           # CLI entry point (Click group)
+  api_client.py     # HTTP client wrapping nexus-service REST API
+  auth_pkce.py      # Cognito PKCE auth flow (opens browser, listens for callback)
+  config.py         # Token storage path, API base URL
+  commands/         # One file per command group (auth, strategy, signal, ...)
+  __main__.py       # Allows `python -m nexusquant_cli`
+```
+
+## Install
+
+```bash
+# Development (editable)
+pip install -e .
+
+# From PyPI
+pip install nexusquant-cli
+```
+
+## Usage
+
+```bash
+# Authenticate (opens browser for Cognito login)
+nexusquant auth
+nexusquant auth --status
+nexusquant auth --refresh
+nexusquant auth --logout
+
+# Strategy management
+nexusquant strategy create --strategy-id my_alpha --name "My Alpha" --schema-file schema.json
+nexusquant strategy list
+nexusquant strategy update --strategy-id my_alpha ...
+nexusquant strategy delete --strategy-id my_alpha
+
+# Signal submission
+nexusquant signal submit --strategy-id my_alpha --file signals.json
+```
+
+Tokens are stored at `~/Library/Application Support/nexusquant-cli/credentials.json` on macOS (respects XDG on Linux). File is written with `0600` permissions.
+
+## Deploy / publish
+
+```bash
+# Build distribution
+python -m build
+
+# Publish to PyPI
+twine upload dist/*
+```
+
+## Configuration
+
+API base URL is set in `nexusquant_cli/config.py`. Change `API_BASE_URL` to point at a different environment (staging vs production).
+
+Required Cognito role: `custom:userType=strategyProvider` or `custom:userType=admin`. Standard users cannot use provider commands.

{nexusquant_cli-0.1.1 → nexusquant_cli-0.1.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: nexusquant-cli
-Version: 0.1.1
+Version: 0.1.2
 Summary: NexusQuant strategy provider CLI
 Requires-Python: >=3.10
 Requires-Dist: httpx>=0.27
@@ -21,6 +21,10 @@ It supports browser login through Cognito, stores tokens locally, refreshes toke
 python3 -m pip install -e .
 ```
 
+```bash
+pip install nexusquant-cli
+```
+
 ## Login
 
 ```bash
@@ -62,14 +66,13 @@ Send a single signal:
 nexusquant strategy signal my_alpha_001 \
   --strategy-name "My Alpha" \
   --ticker AAPL \
-  --direction bull \
+  --direction buy \
   --price 150.25 \
-  --level 0.8 \
   --quantity 100 \
   --order-type MARKET
 ```
 
-`--order-type` is a signal-level setting. Use `MARKET` for market orders or `NORMAL` for limit orders; `NORMAL` uses the signal `--price` as the limit reference. If omitted, the service defaults to `MARKET`.
+`--order-type` is a signal-level setting: `MARKET` or `LIMIT` (limit uses `--price`). Legacy `NORMAL` is accepted by the CLI as an alias for `LIMIT`. If omitted, the API defaults to `MARKET`.
 
 Send a multi-route `signals` map:
 
@@ -112,9 +115,8 @@ nexusquant strategy sub config my_alpha_001
     "ticker": "AAPL",
     "time": "2026-04-26T19:30:00Z",
     "price": 150.25,
-    "level": 0.8,
-    "direction": "bull",
-    "order_type": "NORMAL",
+    "direction": "buy",
+    "order_type": "LIMIT",
     "quantity": 100,
     "metadata": {}
   }
@@ -125,12 +127,12 @@ nexusquant strategy sub config my_alpha_001
 
 Normal use does not require configuration. For staging or local development:
 
-| Variable | Meaning |
-| --- | --- |
-| `NEXUSQUANT_API_ENDPOINT` | API endpoint host, default `https://api.nexusquant.co`; CLI calls `/api/...` under it |
-| `NEXUSQUANT_API_BASE_URL` | Optional full API base override, e.g. `https://api.nexusquant.co/api` |
-| `NEXUSQUANT_COGNITO_DOMAIN` | Cognito Hosted UI host, default `auth.lookatwallstreet.com` |
-| `NEXUSQUANT_COGNITO_CLIENT_ID` | Cognito app client id |
-| `NEXUSQUANT_REDIRECT_URI` | OAuth callback, default `http://127.0.0.1:8251/callback` |
+| Variable                       | Meaning                                                                               |
+| ------------------------------ | ------------------------------------------------------------------------------------- |
+| `NEXUSQUANT_API_ENDPOINT`      | API endpoint host, default `https://api.nexusquant.co`; CLI calls `/api/...` under it |
+| `NEXUSQUANT_API_BASE_URL`      | Optional full API base override, e.g. `https://api.nexusquant.co/api`                 |
+| `NEXUSQUANT_COGNITO_DOMAIN`    | Cognito Hosted UI host, default `auth.lookatwallstreet.com`                           |
+| `NEXUSQUANT_COGNITO_CLIENT_ID` | Cognito app client id                                                                 |
+| `NEXUSQUANT_REDIRECT_URI`      | OAuth callback, default `http://127.0.0.1:8251/callback`                              |
 
 There is also a hidden typo-compatible alias: `nexusquant startegy ...` maps to `nexusquant strategy ...`.

{nexusquant_cli-0.1.1 → nexusquant_cli-0.1.2}/README.md

@@ -10,6 +10,10 @@ It supports browser login through Cognito, stores tokens locally, refreshes toke
 python3 -m pip install -e .
 ```
 
+```bash
+pip install nexusquant-cli
+```
+
 ## Login
 
 ```bash
@@ -51,14 +55,13 @@ Send a single signal:
 nexusquant strategy signal my_alpha_001 \
   --strategy-name "My Alpha" \
   --ticker AAPL \
-  --direction bull \
+  --direction buy \
   --price 150.25 \
-  --level 0.8 \
   --quantity 100 \
   --order-type MARKET
 ```
 
-`--order-type` is a signal-level setting. Use `MARKET` for market orders or `NORMAL` for limit orders; `NORMAL` uses the signal `--price` as the limit reference. If omitted, the service defaults to `MARKET`.
+`--order-type` is a signal-level setting: `MARKET` or `LIMIT` (limit uses `--price`). Legacy `NORMAL` is accepted by the CLI as an alias for `LIMIT`. If omitted, the API defaults to `MARKET`.
 
 Send a multi-route `signals` map:
 
@@ -101,9 +104,8 @@ nexusquant strategy sub config my_alpha_001
     "ticker": "AAPL",
     "time": "2026-04-26T19:30:00Z",
     "price": 150.25,
-    "level": 0.8,
-    "direction": "bull",
-    "order_type": "NORMAL",
+    "direction": "buy",
+    "order_type": "LIMIT",
     "quantity": 100,
     "metadata": {}
   }
@@ -114,12 +116,12 @@ nexusquant strategy sub config my_alpha_001
 
 Normal use does not require configuration. For staging or local development:
 
-| Variable | Meaning |
-| --- | --- |
-| `NEXUSQUANT_API_ENDPOINT` | API endpoint host, default `https://api.nexusquant.co`; CLI calls `/api/...` under it |
-| `NEXUSQUANT_API_BASE_URL` | Optional full API base override, e.g. `https://api.nexusquant.co/api` |
-| `NEXUSQUANT_COGNITO_DOMAIN` | Cognito Hosted UI host, default `auth.lookatwallstreet.com` |
-| `NEXUSQUANT_COGNITO_CLIENT_ID` | Cognito app client id |
-| `NEXUSQUANT_REDIRECT_URI` | OAuth callback, default `http://127.0.0.1:8251/callback` |
+| Variable                       | Meaning                                                                               |
+| ------------------------------ | ------------------------------------------------------------------------------------- |
+| `NEXUSQUANT_API_ENDPOINT`      | API endpoint host, default `https://api.nexusquant.co`; CLI calls `/api/...` under it |
+| `NEXUSQUANT_API_BASE_URL`      | Optional full API base override, e.g. `https://api.nexusquant.co/api`                 |
+| `NEXUSQUANT_COGNITO_DOMAIN`    | Cognito Hosted UI host, default `auth.lookatwallstreet.com`                           |
+| `NEXUSQUANT_COGNITO_CLIENT_ID` | Cognito app client id                                                                 |
+| `NEXUSQUANT_REDIRECT_URI`      | OAuth callback, default `http://127.0.0.1:8251/callback`                              |
 
 There is also a hidden typo-compatible alias: `nexusquant startegy ...` maps to `nexusquant strategy ...`.

nexusquant_cli-0.1.2/nexusquant_cli/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.1.1"

{nexusquant_cli-0.1.1 → nexusquant_cli-0.1.2}/nexusquant_cli/auth_pkce.py

@@ -22,6 +22,7 @@ from typing import Any
 import httpx
 
 from nexusquant_cli.config import (
+    clear_credentials,
     cognito_client_id,
     cognito_domain_host,
     load_credentials,
@@ -214,11 +215,19 @@ def ensure_fresh_id_token(*, force_refresh: bool = False) -> str:
     if not refresh_token:
         return str(creds["id_token"])
 
-    new_tokens = refresh_tokens(
-        domain_host=cognito_domain_host(),
-        client_id=cognito_client_id(),
-        refresh_token=refresh_token,
-    )
+    try:
+        new_tokens = refresh_tokens(
+            domain_host=cognito_domain_host(),
+            client_id=cognito_client_id(),
+            refresh_token=refresh_token,
+        )
+    except RuntimeError as exc:
+        if "invalid_grant" in str(exc):
+            clear_credentials()
+            raise RuntimeError(
+                "Refresh token expired or revoked. Please run: nexusquant auth"
+            ) from exc
+        raise
     merged = {
         "id_token": new_tokens.get("id_token") or creds["id_token"],
         "access_token": new_tokens.get("access_token") or creds.get("access_token"),

{nexusquant_cli-0.1.1 → nexusquant_cli-0.1.2}/nexusquant_cli/commands/strategy/cmd.py

@@ -219,19 +219,15 @@ def strategy_signal(
     ] = None,
     direction: Annotated[
         str | None,
-        typer.Option("--direction", help="Signal direction: bull or bear."),
+        typer.Option("--direction", help='Signal direction: "buy" or "sell".'),
     ] = None,
     price: Annotated[
         float | None,
         typer.Option(
             "--price",
-            help="Reference price. Required for send and notional_usd sizing.",
+            help="Reference price. Required when sending; LIMIT orders use this as limit price.",
         ),
     ] = None,
-    level: Annotated[
-        float | None,
-        typer.Option("--level", help="Signal strength/level, e.g. 0.8."),
-    ] = None,
     time_value: Annotated[
         str | None,
         typer.Option(
@@ -239,33 +235,18 @@ def strategy_signal(
             help="Signal timestamp in ISO-8601. Defaults to current UTC time when sending.",
         ),
     ] = None,
-    sizing_kind: Annotated[
-        str | None,
-        typer.Option(
-            "--sizing-kind", help="Optional explicit sizing: shares or notional_usd."
-        ),
-    ] = None,
     quantity: Annotated[
         int | None,
         typer.Option(
-            "--quantity", help="Share quantity for shares sizing. Positive integer."
-        ),
-    ] = None,
-    notional_usd: Annotated[
-        float | None,
-        typer.Option(
-            "--notional-usd",
-            help="USD notional for notional_usd sizing. Positive number.",
+            "--quantity",
+            help="Share quantity (positive integer). Required when sending a single signal.",
         ),
     ] = None,
     order_type: Annotated[
         str | None,
         typer.Option(
             "--order-type",
-            help=(
-                "Signal-level broker order type: MARKET (default) or NORMAL "
-                "(limit order; uses --price)."
-            ),
+            help='Broker order type: MARKET (default at API) or LIMIT (limit at --price). "NORMAL" is accepted as an alias for LIMIT.',
         ),
     ] = None,
     metadata_json: Annotated[
@@ -296,10 +277,10 @@ def strategy_signal(
     ``nexusquant strategy signal my_alpha --history --limit 20``
 
     Single signal:
-    ``nexusquant strategy signal my_alpha --ticker AAPL --direction bull --price 150 --level 0.8 --quantity 100 --order-type MARKET``
+    ``nexusquant strategy signal my_alpha --ticker AAPL --direction buy --price 150 --quantity 100 --order-type MARKET``
 
     Limit signal:
-    ``nexusquant strategy signal my_alpha --ticker AAPL --direction bear --price 150 --level 0.8 --quantity 100 --order-type NORMAL``
+    ``nexusquant strategy signal my_alpha --ticker AAPL --direction sell --price 150 --quantity 100 --order-type LIMIT``
 
     Signals map:
     ``nexusquant strategy signal my_alpha --signals-file signals.json --strategy-name "My Alpha"``
@@ -310,9 +291,7 @@ def strategy_signal(
             ticker,
             direction,
             price,
-            level,
             quantity,
-            notional_usd,
             order_type,
             signals_file,
         )
@@ -348,7 +327,7 @@ def strategy_signal(
             "--ticker": ticker,
             "--direction": direction,
             "--price": price,
-            "--level": level,
+            "--quantity": quantity,
         }.items()
         if value is None
     ]
@@ -357,23 +336,23 @@ def strategy_signal(
             f"Sending a single signal requires: {', '.join(missing)}"
         )
 
+    direction_norm = direction.strip().lower()
+    if direction_norm not in ("buy", "sell"):
+        raise typer.BadParameter('--direction must be "buy" or "sell".')
+
     signal: dict[str, Any] = {
         "ticker": ticker,
         "time": time_value or _now_iso(),
         "price": price,
-        "level": level,
-        "direction": direction,
+        "direction": direction_norm,
+        "quantity": int(quantity),
     }
-    if sizing_kind is not None:
-        signal["sizing_kind"] = sizing_kind
-    if quantity is not None:
-        signal["quantity"] = quantity
-    if notional_usd is not None:
-        signal["notional_usd"] = notional_usd
     if order_type is not None:
         normalized_order_type = order_type.strip().upper()
-        if normalized_order_type not in {"MARKET", "NORMAL"}:
-            raise typer.BadParameter("--order-type must be MARKET or NORMAL.")
+        if normalized_order_type == "NORMAL":
+            normalized_order_type = "LIMIT"
+        if normalized_order_type not in {"MARKET", "LIMIT"}:
+            raise typer.BadParameter('--order-type must be MARKET, LIMIT, or legacy alias NORMAL (=LIMIT).')
         signal["order_type"] = normalized_order_type
     metadata = load_json_option(metadata_json, label="metadata")
     if metadata is not None:

{nexusquant_cli-0.1.1 → nexusquant_cli-0.1.2}/nexusquant_cli/config.py

@@ -7,7 +7,7 @@ from typing import Any
 
 from platformdirs import user_config_dir
 
-CONFIG_DIR = Path(user_config_dir("nexusquant-cli", appauthor=False))
+CONFIG_DIR = Path(user_config_dir("nexusquant-sdk", appauthor=False))
 CREDENTIALS_PATH = CONFIG_DIR / "credentials.json"
 
 DEFAULT_API_ENDPOINT = "https://api.nexusquant.co"

{nexusquant_cli-0.1.1 → nexusquant_cli-0.1.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "nexusquant-cli"
-version = "0.1.1"
+version = "0.1.2"
 description = "NexusQuant strategy provider CLI"
 readme = "README.md"
 requires-python = ">=3.10"

nexusquant_cli-0.1.1/nexusquant_cli/__init__.py

@@ -1 +0,0 @@
-__version__ = "0.1.0"