nexus-agent-cli 0.2.0__tar.gz → 0.6.0__tar.gz

{nexus_agent_cli-0.2.0 → nexus_agent_cli-0.6.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: nexus-agent-cli
-Version: 0.2.0
+Version: 0.6.0
 Summary: Nexus internal agent ops CLI — pull run params, push analysis results, send notifications. Admin only.
 Requires-Python: >=3.10
 Requires-Dist: httpx>=0.27
@@ -61,6 +61,26 @@ nexus-agent push-backtest --ticker tqqq \
     --conservative conservative_aggregated.json \
     --normal normal_aggregated.json
 
+# 回读 S3（均为只读，登录即可）：最新回测 / 市场分析报告 / 组合推荐
+nexus-agent get-backtest --ticker tqqq --out tqqq_backtest.json
+nexus-agent get-market-analysis --ticker tqqq --out tqqq_market.json
+nexus-agent get-portfolio --out portfolio.json
+
+# 拉取 S3 上最新的 signal_position 基线 config（Position-Research 阶段用）
+nexus-agent pull-config --ticker tqqq --kind normal --out tqqq-normal.json
+
+# 历史版本（by-date）：列出 → 取指定版本
+nexus-agent pull-config --ticker tqqq --kind normal --list --since 2026-06-01
+nexus-agent pull-config --ticker tqqq --kind normal --date 2026-06-01_to_2026-06-14 --out old.json
+nexus-agent get-market-analysis --ticker tqqq --list
+nexus-agent get-portfolio --list --since 2026-06-01
+
+# 回传 Position-Research 产出的 3 套仓位 config（≠ push-backtest 的回测聚合）
+nexus-agent push-config --ticker tqqq --time-range 2026-06-01_2026-06-14 \
+    --aggressive tqqq-aggressive.json \
+    --conservative tqqq-conservative.json \
+    --normal tqqq-normal.json
+
 # 服务端 SES 发通知邮件
 nexus-agent notify --to a@x.com --to b@y.com --subject "Weekly report" --body-file summary.txt
 ```
@@ -73,7 +93,7 @@ nexus-agent notify --to a@x.com --to b@y.com --subject "Weekly report" --body-fi
 | `NEXUS_AGENT_API_BASE_URL` | — | 直接覆盖完整 API base（含 `/api`） |
 | `NEXUS_AGENT_COGNITO_DOMAIN` | `auth.lookatwallstreet.com` | Cognito Hosted UI 域名 |
 | `NEXUS_AGENT_COGNITO_CLIENT_ID` | （内置） | Cognito app client id |
-| `NEXUS_AGENT_REDIRECT_URI` | `http://127.0.0.1:8252/callback` | 本地回调（须 localhost+端口） |
+| `NEXUS_AGENT_REDIRECT_URI` | `http://127.0.0.1:8251/callback` | 本地回调（须 localhost+端口；端口必须已加入 Cognito app client 的 Allowed callback URLs） |
 
 例如指向本地后端调试：
 

{nexus_agent_cli-0.2.0 → nexus_agent_cli-0.6.0}/README.md

@@ -50,6 +50,26 @@ nexus-agent push-backtest --ticker tqqq \
     --conservative conservative_aggregated.json \
     --normal normal_aggregated.json
 
+# 回读 S3（均为只读，登录即可）：最新回测 / 市场分析报告 / 组合推荐
+nexus-agent get-backtest --ticker tqqq --out tqqq_backtest.json
+nexus-agent get-market-analysis --ticker tqqq --out tqqq_market.json
+nexus-agent get-portfolio --out portfolio.json
+
+# 拉取 S3 上最新的 signal_position 基线 config（Position-Research 阶段用）
+nexus-agent pull-config --ticker tqqq --kind normal --out tqqq-normal.json
+
+# 历史版本（by-date）：列出 → 取指定版本
+nexus-agent pull-config --ticker tqqq --kind normal --list --since 2026-06-01
+nexus-agent pull-config --ticker tqqq --kind normal --date 2026-06-01_to_2026-06-14 --out old.json
+nexus-agent get-market-analysis --ticker tqqq --list
+nexus-agent get-portfolio --list --since 2026-06-01
+
+# 回传 Position-Research 产出的 3 套仓位 config（≠ push-backtest 的回测聚合）
+nexus-agent push-config --ticker tqqq --time-range 2026-06-01_2026-06-14 \
+    --aggressive tqqq-aggressive.json \
+    --conservative tqqq-conservative.json \
+    --normal tqqq-normal.json
+
 # 服务端 SES 发通知邮件
 nexus-agent notify --to a@x.com --to b@y.com --subject "Weekly report" --body-file summary.txt
 ```
@@ -62,7 +82,7 @@ nexus-agent notify --to a@x.com --to b@y.com --subject "Weekly report" --body-fi
 | `NEXUS_AGENT_API_BASE_URL` | — | 直接覆盖完整 API base（含 `/api`） |
 | `NEXUS_AGENT_COGNITO_DOMAIN` | `auth.lookatwallstreet.com` | Cognito Hosted UI 域名 |
 | `NEXUS_AGENT_COGNITO_CLIENT_ID` | （内置） | Cognito app client id |
-| `NEXUS_AGENT_REDIRECT_URI` | `http://127.0.0.1:8252/callback` | 本地回调（须 localhost+端口） |
+| `NEXUS_AGENT_REDIRECT_URI` | `http://127.0.0.1:8251/callback` | 本地回调（须 localhost+端口；端口必须已加入 Cognito app client 的 Allowed callback URLs） |
 
 例如指向本地后端调试：
 

nexus_agent_cli-0.6.0/nexus_agent_cli/__init__.py

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

{nexus_agent_cli-0.2.0 → nexus_agent_cli-0.6.0}/nexus_agent_cli/api_client.py

@@ -60,6 +60,21 @@ def get_strategy_data(
     return get_json("/nexus-agent/strategy-data/", params=params)
 
 
+def get_backtest(ticker: str) -> Any:
+    """GET /nexus-agent/backtest/ — latest aggregated backtest data for one ticker."""
+    return get_json("/nexus-agent/backtest/", params={"ticker": ticker})
+
+
+def get_market_analysis(ticker: str) -> Any:
+    """GET /nexus-agent/market-analysis/ — latest market analysis report for one ticker."""
+    return get_json("/nexus-agent/market-analysis/", params={"ticker": ticker})
+
+
+def get_portfolio_recommendation() -> Any:
+    """GET /nexus-agent/portfolio-recommendation/ — latest portfolio recommendation."""
+    return get_json("/nexus-agent/portfolio-recommendation/")
+
+
 def upload_market_analysis(ticker: str, content: str, language: str = "zh") -> Any:
     """POST /nexus-agent/upload/market-analysis/"""
     return post_json(
@@ -85,6 +100,63 @@ def upload_backtest(ticker: str, levels: dict[str, Any]) -> Any:
     return post_json("/nexus-agent/upload/backtest/", {"ticker": ticker, **levels})
 
 
+def get_position_config(
+    ticker: str, kind: str = "normal", date_range: str | None = None
+) -> Any:
+    """GET /nexus-agent/position-config/ — signal_position config from S3.
+
+    Mirrors the worker's download_latest_normal_config_from_s3: the server reads
+    configs/signal_position/{ticker}/<date_range>/{ticker}-{kind}.json and returns it
+    as JSON. With date_range, fetch that specific historical version; otherwise the
+    latest. This is the Position-Research baseline the local skill cannot otherwise read.
+    """
+    params: dict[str, Any] = {"ticker": ticker, "kind": kind}
+    if date_range:
+        params["date_range"] = date_range
+    return get_json("/nexus-agent/position-config/", params=params)
+
+
+def list_history(
+    artifact_type: str, ticker: str | None = None, kind: str | None = None, since: str | None = None
+) -> Any:
+    """GET /nexus-agent/history/ — list historical versions of an artifact.
+
+    artifact_type: config / market-analysis / portfolio.
+    Returns {type, count, items: [{key, created_at, date_range?}, ...]} newest-first.
+    """
+    params: dict[str, Any] = {"type": artifact_type}
+    if ticker:
+        params["ticker"] = ticker
+    if kind:
+        params["kind"] = kind
+    if since:
+        params["since"] = since
+    return get_json("/nexus-agent/history/", params=params)
+
+
+def upload_position_config(
+    ticker: str, configs: dict[str, Any], time_range: str | None = None
+) -> Any:
+    """POST /nexus-agent/upload/position-config/ — write the 3 position configs to S3.
+
+    configs: {aggressive/conservative/normal: {<level>: {...}}}. Distinct from
+    upload_backtest (which uploads backtest aggregation, not position configs).
+    Server writes configs/signal_position/{ticker}/{time_range}/{ticker}-{kind}.json
+    and invalidates the dashboard cache.
+    """
+    body: dict[str, Any] = {"ticker": ticker, **configs}
+    if time_range is not None:
+        body["time_range"] = time_range
+    return post_json("/nexus-agent/upload/position-config/", body)
+
+
+def upload_position_report(ticker: str, content: str) -> Any:
+    """POST /nexus-agent/upload/position-report/ — archive a position-update narrative (md)."""
+    return post_json(
+        "/nexus-agent/upload/position-report/", {"ticker": ticker, "content": content}
+    )
+
+
 def notify(
     to: list[str], subject: str, body_text: str | None = None, body_html: str | None = None
 ) -> Any:

nexus_agent_cli-0.6.0/nexus_agent_cli/commands/run/cmd.py

@@ -0,0 +1,300 @@
+from __future__ import annotations
+
+import json
+from pathlib import Path
+
+import typer
+from rich.console import Console
+from rich.json import JSON
+
+from nexus_agent_cli import api_client
+
+console = Console()
+
+
+def _run_err(e: Exception) -> None:
+    console.print(f"[red]{e}[/red]")
+    raise typer.Exit(1) from e
+
+
+def register(app: typer.Typer) -> None:
+    @app.command("run-config", help="Pull this week's run params (tickers + date range).")
+    def run_config(
+        tickers: str = typer.Option(
+            None, "--tickers", help="Comma-separated override, e.g. TQQQ,SOXL,IBIT."
+        ),
+    ) -> None:
+        try:
+            data = api_client.get_run_config(tickers=tickers)
+        except Exception as e:
+            _run_err(e)
+        console.print(JSON(json.dumps(data)))
+
+    @app.command(
+        "strategy-data",
+        help="Pull strategy trigger rows for one ticker (Sheets creds stay server-side).",
+    )
+    def strategy_data(
+        ticker: str = typer.Option(..., "--ticker", help="tqqq / soxl / ibit."),
+        start: str = typer.Option(None, "--start", help="Start date YYYY-MM-DD (optional)."),
+        end: str = typer.Option(None, "--end", help="End date YYYY-MM-DD (optional)."),
+        out: Path = typer.Option(
+            None, "--out", help="Write the JSON response to this file instead of stdout."
+        ),
+    ) -> None:
+        try:
+            data = api_client.get_strategy_data(ticker, start_date=start, end_date=end)
+        except Exception as e:
+            _run_err(e)
+        if out is not None:
+            out.write_text(json.dumps(data, ensure_ascii=False, indent=2), encoding="utf-8")
+            console.print(f"[green]已保存 {data.get('count')} 行 →[/green] {out}")
+        else:
+            console.print(JSON(json.dumps(data)))
+
+    @app.command(
+        "push-market-analysis", help="Upload a market analysis markdown report for one ticker."
+    )
+    def push_market_analysis(
+        ticker: str = typer.Option(..., "--ticker", help="tqqq / soxl / ibit."),
+        file: Path = typer.Option(
+            ..., "--file", exists=True, readable=True, help="Path to the markdown report."
+        ),
+        language: str = typer.Option("zh", "--language", help="zh (default) or en."),
+    ) -> None:
+        try:
+            content = file.read_text(encoding="utf-8")
+            data = api_client.upload_market_analysis(ticker, content, language=language)
+        except Exception as e:
+            _run_err(e)
+        console.print(f"[green]已上传:[/green] {data.get('key')}")
+
+    @app.command(
+        "push-portfolio", help="Upload a portfolio recommendation report (English + optional CN)."
+    )
+    def push_portfolio(
+        file: Path = typer.Option(
+            ..., "--file", exists=True, readable=True, help="English markdown report."
+        ),
+        file_cn: Path = typer.Option(
+            None, "--file-cn", exists=True, readable=True, help="Chinese markdown report (optional)."
+        ),
+        time_range: str = typer.Option(
+            None, "--time-range", help="e.g. 2026-06-01_2026-06-14 (optional, for the S3 key)."
+        ),
+    ) -> None:
+        try:
+            content = file.read_text(encoding="utf-8")
+            content_cn = file_cn.read_text(encoding="utf-8") if file_cn else None
+            data = api_client.upload_portfolio_recommendation(
+                content, content_cn=content_cn, time_range=time_range
+            )
+        except Exception as e:
+            _run_err(e)
+        console.print(JSON(json.dumps(data)))
+
+    @app.command("push-backtest", help="Upload aggregated backtest JSON for one ticker.")
+    def push_backtest(
+        ticker: str = typer.Option(..., "--ticker", help="tqqq / soxl / ibit."),
+        aggressive: Path = typer.Option(
+            None, "--aggressive", exists=True, readable=True, help="aggressive_aggregated.json"
+        ),
+        conservative: Path = typer.Option(
+            None, "--conservative", exists=True, readable=True, help="conservative_aggregated.json"
+        ),
+        normal: Path = typer.Option(
+            None, "--normal", exists=True, readable=True, help="normal_aggregated.json"
+        ),
+    ) -> None:
+        levels: dict[str, object] = {}
+        for name, path in (
+            ("aggressive", aggressive),
+            ("conservative", conservative),
+            ("normal", normal),
+        ):
+            if path is not None:
+                try:
+                    levels[name] = json.loads(path.read_text(encoding="utf-8"))
+                except Exception as e:
+                    _run_err(e)
+        if not levels:
+            console.print("[red]至少提供一个档位文件: --aggressive / --conservative / --normal[/red]")
+            raise typer.Exit(1)
+        try:
+            data = api_client.upload_backtest(ticker, levels)
+        except Exception as e:
+            _run_err(e)
+        console.print(JSON(json.dumps(data)))
+
+    @app.command(
+        "pull-config",
+        help="Pull the latest signal_position config for one ticker from S3 (the "
+        "Position-Research baseline; S3 creds stay server-side).",
+    )
+    def pull_config(
+        ticker: str = typer.Option(..., "--ticker", help="tqqq / soxl / ibit."),
+        kind: str = typer.Option(
+            "normal", "--kind", help="normal (default) / aggressive / conservative."
+        ),
+        list_versions: bool = typer.Option(
+            False, "--list", help="List historical config versions instead of fetching one."
+        ),
+        date_range: str = typer.Option(
+            None, "--date", help="Fetch a specific version by its date_range (from --list)."
+        ),
+        since: str = typer.Option(
+            None, "--since", help="With --list: only versions created on/after this ISO date."
+        ),
+        out: Path = typer.Option(
+            None, "--out", help="Write JSON to this file instead of stdout."
+        ),
+    ) -> None:
+        try:
+            if list_versions:
+                data = api_client.list_history("config", ticker=ticker, kind=kind, since=since)
+            else:
+                data = api_client.get_position_config(ticker, kind=kind, date_range=date_range)
+        except Exception as e:
+            _run_err(e)
+        _emit(data, out)
+
+    def _emit(data: object, out) -> None:
+        if out is not None:
+            out.write_text(json.dumps(data, ensure_ascii=False, indent=2), encoding="utf-8")
+            console.print(f"[green]已保存 →[/green] {out}")
+        else:
+            console.print(JSON(json.dumps(data)))
+
+    @app.command(
+        "get-backtest", help="Fetch the latest aggregated backtest data for one ticker from S3."
+    )
+    def get_backtest(
+        ticker: str = typer.Option(..., "--ticker", help="tqqq / soxl / ibit."),
+        out: Path = typer.Option(None, "--out", help="Write JSON to this file instead of stdout."),
+    ) -> None:
+        try:
+            data = api_client.get_backtest(ticker)
+        except Exception as e:
+            _run_err(e)
+        _emit(data, out)
+
+    @app.command(
+        "get-market-analysis",
+        help="Fetch the latest market analysis report for one ticker from S3.",
+    )
+    def get_market_analysis(
+        ticker: str = typer.Option(..., "--ticker", help="tqqq / soxl / ibit."),
+        list_versions: bool = typer.Option(
+            False, "--list", help="List historical report versions instead of fetching the latest."
+        ),
+        since: str = typer.Option(
+            None, "--since", help="With --list: only versions created on/after this ISO date."
+        ),
+        out: Path = typer.Option(None, "--out", help="Write JSON to this file instead of stdout."),
+    ) -> None:
+        try:
+            if list_versions:
+                data = api_client.list_history("market-analysis", ticker=ticker, since=since)
+            else:
+                data = api_client.get_market_analysis(ticker)
+        except Exception as e:
+            _run_err(e)
+        _emit(data, out)
+
+    @app.command(
+        "get-portfolio", help="Fetch the latest portfolio recommendation from S3."
+    )
+    def get_portfolio(
+        list_versions: bool = typer.Option(
+            False, "--list", help="List historical portfolio versions instead of the latest."
+        ),
+        since: str = typer.Option(
+            None, "--since", help="With --list: only versions created on/after this ISO date."
+        ),
+        out: Path = typer.Option(None, "--out", help="Write JSON to this file instead of stdout."),
+    ) -> None:
+        try:
+            if list_versions:
+                data = api_client.list_history("portfolio", since=since)
+            else:
+                data = api_client.get_portfolio_recommendation()
+        except Exception as e:
+            _run_err(e)
+        _emit(data, out)
+
+    @app.command(
+        "push-config",
+        help="Upload the 3 Position-Research configs for one ticker "
+        "(distinct from push-backtest, which uploads backtest aggregation).",
+    )
+    def push_config(
+        ticker: str = typer.Option(..., "--ticker", help="tqqq / soxl / ibit."),
+        aggressive: Path = typer.Option(
+            None, "--aggressive", exists=True, readable=True, help="{ticker}-aggressive.json"
+        ),
+        conservative: Path = typer.Option(
+            None, "--conservative", exists=True, readable=True, help="{ticker}-conservative.json"
+        ),
+        normal: Path = typer.Option(
+            None, "--normal", exists=True, readable=True, help="{ticker}-normal.json"
+        ),
+        time_range: str = typer.Option(
+            None, "--time-range", help="e.g. 2026-06-01_2026-06-14 (for the S3 key)."
+        ),
+    ) -> None:
+        configs: dict[str, object] = {}
+        for name, path in (
+            ("aggressive", aggressive),
+            ("conservative", conservative),
+            ("normal", normal),
+        ):
+            if path is not None:
+                try:
+                    configs[name] = json.loads(path.read_text(encoding="utf-8"))
+                except Exception as e:
+                    _run_err(e)
+        if not configs:
+            console.print("[red]至少提供一个档位文件: --aggressive / --conservative / --normal[/red]")
+            raise typer.Exit(1)
+        try:
+            data = api_client.upload_position_config(ticker, configs, time_range=time_range)
+        except Exception as e:
+            _run_err(e)
+        console.print(JSON(json.dumps(data)))
+
+    @app.command(
+        "push-position-report",
+        help="Archive a position-update narrative markdown (reports/position_updates/).",
+    )
+    def push_position_report(
+        ticker: str = typer.Option(..., "--ticker", help="tqqq / soxl / ibit."),
+        file: Path = typer.Option(
+            ..., "--file", exists=True, readable=True, help="Path to the markdown report."
+        ),
+    ) -> None:
+        try:
+            data = api_client.upload_position_report(ticker, file.read_text(encoding="utf-8"))
+        except Exception as e:
+            _run_err(e)
+        console.print(f"[green]已上传:[/green] {data.get('key')}")
+
+    @app.command("notify", help="Send a notification email via server-side SES.")
+    def notify(
+        to: list[str] = typer.Option(..., "--to", help="Recipient (repeatable)."),
+        subject: str = typer.Option(..., "--subject", help="Email subject."),
+        body_file: Path = typer.Option(
+            None, "--body-file", exists=True, readable=True, help="Plain-text body file."
+        ),
+        body: str = typer.Option(None, "--body", help="Inline plain-text body."),
+    ) -> None:
+        body_text = body
+        if body_file is not None:
+            body_text = body_file.read_text(encoding="utf-8")
+        if not body_text:
+            console.print("[red]需要 --body 或 --body-file 之一。[/red]")
+            raise typer.Exit(1)
+        try:
+            data = api_client.notify(list(to), subject, body_text=body_text)
+        except Exception as e:
+            _run_err(e)
+        console.print(f"[green]已发送:[/green] {data}")

{nexus_agent_cli-0.2.0 → nexus_agent_cli-0.6.0}/nexus_agent_cli/config.py

@@ -15,8 +15,11 @@ CREDENTIALS_PATH = CONFIG_DIR / "credentials.json"
 DEFAULT_API_ENDPOINT = "https://api.nexusquant.co"
 DEFAULT_COGNITO_DOMAIN = "auth.lookatwallstreet.com"
 DEFAULT_COGNITO_CLIENT_ID = "5o7hhd4hn4birr8c29vndehiat"
-# 与 nexusquant-cli (8251) 错开端口，便于两套 CLI 同机登录。
-DEFAULT_REDIRECT_URI = "http://127.0.0.1:8252/callback"
+# 与 nexusquant-cli 共用同一个 Cognito app client（5o7hhd4hn4birr8c29vndehiat），
+# 该 client 只登记了 8251/callback。沿用 8251 以避免 redirect_mismatch；
+# 两套 CLI 不会同时跑 OAuth 回调，端口冲突可忽略。需要错开时用 NEXUS_AGENT_REDIRECT_URI 覆盖
+# （但所选端口必须已加入 app client 的 Allowed callback URLs）。
+DEFAULT_REDIRECT_URI = "http://127.0.0.1:8251/callback"
 
 
 def _env(name: str, default: str | None = None) -> str | None:

{nexus_agent_cli-0.2.0 → nexus_agent_cli-0.6.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "nexus-agent-cli"
-version = "0.2.0"
+version = "0.6.0"
 description = "Nexus internal agent ops CLI — pull run params, push analysis results, send notifications. Admin only."
 readme = "README.md"
 requires-python = ">=3.10"

nexus_agent_cli-0.2.0/nexus_agent_cli/__init__.py

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

nexus_agent_cli-0.2.0/nexus_agent_cli/commands/run/cmd.py

@@ -1,148 +0,0 @@
-from __future__ import annotations
-
-import json
-from pathlib import Path
-
-import typer
-from rich.console import Console
-from rich.json import JSON
-
-from nexus_agent_cli import api_client
-
-console = Console()
-
-
-def _run_err(e: Exception) -> None:
-    console.print(f"[red]{e}[/red]")
-    raise typer.Exit(1) from e
-
-
-def register(app: typer.Typer) -> None:
-    @app.command("run-config", help="Pull this week's run params (tickers + date range).")
-    def run_config(
-        tickers: str = typer.Option(
-            None, "--tickers", help="Comma-separated override, e.g. TQQQ,SOXL,IBIT."
-        ),
-    ) -> None:
-        try:
-            data = api_client.get_run_config(tickers=tickers)
-        except Exception as e:
-            _run_err(e)
-        console.print(JSON(json.dumps(data)))
-
-    @app.command(
-        "strategy-data",
-        help="Pull strategy trigger rows for one ticker (Sheets creds stay server-side).",
-    )
-    def strategy_data(
-        ticker: str = typer.Option(..., "--ticker", help="tqqq / soxl / ibit."),
-        start: str = typer.Option(None, "--start", help="Start date YYYY-MM-DD (optional)."),
-        end: str = typer.Option(None, "--end", help="End date YYYY-MM-DD (optional)."),
-        out: Path = typer.Option(
-            None, "--out", help="Write the JSON response to this file instead of stdout."
-        ),
-    ) -> None:
-        try:
-            data = api_client.get_strategy_data(ticker, start_date=start, end_date=end)
-        except Exception as e:
-            _run_err(e)
-        if out is not None:
-            out.write_text(json.dumps(data, ensure_ascii=False, indent=2), encoding="utf-8")
-            console.print(f"[green]已保存 {data.get('count')} 行 →[/green] {out}")
-        else:
-            console.print(JSON(json.dumps(data)))
-
-    @app.command(
-        "push-market-analysis", help="Upload a market analysis markdown report for one ticker."
-    )
-    def push_market_analysis(
-        ticker: str = typer.Option(..., "--ticker", help="tqqq / soxl / ibit."),
-        file: Path = typer.Option(
-            ..., "--file", exists=True, readable=True, help="Path to the markdown report."
-        ),
-        language: str = typer.Option("zh", "--language", help="zh (default) or en."),
-    ) -> None:
-        try:
-            content = file.read_text(encoding="utf-8")
-            data = api_client.upload_market_analysis(ticker, content, language=language)
-        except Exception as e:
-            _run_err(e)
-        console.print(f"[green]已上传:[/green] {data.get('key')}")
-
-    @app.command(
-        "push-portfolio", help="Upload a portfolio recommendation report (English + optional CN)."
-    )
-    def push_portfolio(
-        file: Path = typer.Option(
-            ..., "--file", exists=True, readable=True, help="English markdown report."
-        ),
-        file_cn: Path = typer.Option(
-            None, "--file-cn", exists=True, readable=True, help="Chinese markdown report (optional)."
-        ),
-        time_range: str = typer.Option(
-            None, "--time-range", help="e.g. 2026-06-01_2026-06-14 (optional, for the S3 key)."
-        ),
-    ) -> None:
-        try:
-            content = file.read_text(encoding="utf-8")
-            content_cn = file_cn.read_text(encoding="utf-8") if file_cn else None
-            data = api_client.upload_portfolio_recommendation(
-                content, content_cn=content_cn, time_range=time_range
-            )
-        except Exception as e:
-            _run_err(e)
-        console.print(JSON(json.dumps(data)))
-
-    @app.command("push-backtest", help="Upload aggregated backtest JSON for one ticker.")
-    def push_backtest(
-        ticker: str = typer.Option(..., "--ticker", help="tqqq / soxl / ibit."),
-        aggressive: Path = typer.Option(
-            None, "--aggressive", exists=True, readable=True, help="aggressive_aggregated.json"
-        ),
-        conservative: Path = typer.Option(
-            None, "--conservative", exists=True, readable=True, help="conservative_aggregated.json"
-        ),
-        normal: Path = typer.Option(
-            None, "--normal", exists=True, readable=True, help="normal_aggregated.json"
-        ),
-    ) -> None:
-        levels: dict[str, object] = {}
-        for name, path in (
-            ("aggressive", aggressive),
-            ("conservative", conservative),
-            ("normal", normal),
-        ):
-            if path is not None:
-                try:
-                    levels[name] = json.loads(path.read_text(encoding="utf-8"))
-                except Exception as e:
-                    _run_err(e)
-        if not levels:
-            console.print("[red]至少提供一个档位文件: --aggressive / --conservative / --normal[/red]")
-            raise typer.Exit(1)
-        try:
-            data = api_client.upload_backtest(ticker, levels)
-        except Exception as e:
-            _run_err(e)
-        console.print(JSON(json.dumps(data)))
-
-    @app.command("notify", help="Send a notification email via server-side SES.")
-    def notify(
-        to: list[str] = typer.Option(..., "--to", help="Recipient (repeatable)."),
-        subject: str = typer.Option(..., "--subject", help="Email subject."),
-        body_file: Path = typer.Option(
-            None, "--body-file", exists=True, readable=True, help="Plain-text body file."
-        ),
-        body: str = typer.Option(None, "--body", help="Inline plain-text body."),
-    ) -> None:
-        body_text = body
-        if body_file is not None:
-            body_text = body_file.read_text(encoding="utf-8")
-        if not body_text:
-            console.print("[red]需要 --body 或 --body-file 之一。[/red]")
-            raise typer.Exit(1)
-        try:
-            data = api_client.notify(list(to), subject, body_text=body_text)
-        except Exception as e:
-            _run_err(e)
-        console.print(f"[green]已发送:[/green] {data}")