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

{nexusquant_cli-0.1.0 → 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.0 → nexusquant_cli-0.1.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: nexusquant-cli
-Version: 0.1.0
+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,12 +66,14 @@ 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
+  --quantity 100 \
+  --order-type 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:
 
 ```bash
@@ -109,8 +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",
+    "direction": "buy",
+    "order_type": "LIMIT",
     "quantity": 100,
     "metadata": {}
   }
@@ -121,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.0 → 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,12 +55,14 @@ 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
+  --quantity 100 \
+  --order-type 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:
 
 ```bash
@@ -98,8 +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",
+    "direction": "buy",
+    "order_type": "LIMIT",
     "quantity": 100,
     "metadata": {}
   }
@@ -110,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.0 → 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.0 → 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,23 +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."
+            "--quantity",
+            help="Share quantity (positive integer). Required when sending a single signal.",
         ),
     ] = None,
-    notional_usd: Annotated[
-        float | None,
+    order_type: Annotated[
+        str | None,
         typer.Option(
-            "--notional-usd",
-            help="USD notional for notional_usd sizing. Positive number.",
+            "--order-type",
+            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[
@@ -273,7 +264,8 @@ def strategy_signal(
             readable=True,
             help=(
                 "UTF-8 JSON object for multi-route signals map. Keys are default or user_id; "
-                "values are signal objects. When provided, single-signal options are ignored."
+                "values are signal objects and may include order_type. When provided, "
+                "single-signal options are ignored."
             ),
         ),
     ] = None,
@@ -285,7 +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``
+    ``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 sell --price 150 --quantity 100 --order-type LIMIT``
 
     Signals map:
     ``nexusquant strategy signal my_alpha --signals-file signals.json --strategy-name "My Alpha"``
@@ -296,9 +291,8 @@ def strategy_signal(
             ticker,
             direction,
             price,
-            level,
             quantity,
-            notional_usd,
+            order_type,
             signals_file,
         )
     )
@@ -333,7 +327,7 @@ def strategy_signal(
             "--ticker": ticker,
             "--direction": direction,
             "--price": price,
-            "--level": level,
+            "--quantity": quantity,
         }.items()
         if value is None
     ]
@@ -342,19 +336,24 @@ 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 == "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:
         signal["metadata"] = metadata

{nexusquant_cli-0.1.0 → 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.0 → nexusquant_cli-0.1.2}/pyproject.toml

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

nexusquant_cli-0.1.0/nexusquant_cli/__init__.py

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