@alphafox/cli 0.3.5 → 0.3.7

package/skills/strategy/SKILL.md

@@ -1,38 +1,40 @@
 ---
 name: alphafox-strategy
-description: Strategy definitions and chats via public operationIds.
-version: 0.3.5
+description: Strategy definitions — list types (grid, dca, copy, …) and validate config. Creating a running strategy is creating a trader; use alphafox-trading for that.
+version: 0.3.7
 ---
 
-# Strategy / Chat
+# Strategy definitions
 
-Always `--format json --no-input`. Read scopes `trading:read`; writes `chats:write`.
+Always `--format json --no-input`. Read scopes `trading:read`; validate is `trading:write`.
 
-Whenever the human names a coin or ticker, resolve it with `alphafox resolve-symbols` (`skills/market`) before writing strategy config or symbols arrays. Exact matches may be used; a single close match needs confirmation; multiple close matches must be chosen by the human.
+A **definition** is a strategy type (grid, dca, copy, …). A **trader** is one running instance of a definition. Instantiating a definition is `alphafox-trading`, not this skill.
+
+Whenever the human names a ticker (US stock, coin, or contract), resolve it with `alphafox resolve-symbols` (`skills/market`) before writing symbols into a config you later validate or hand to create. 美股 are equity perps in `binance_perp_usdt` (`NVDA/USDT:USDT`, `assetClass=equity_perp`) — do not swap them for a crypto coin.
 
 ## Read
 
 ```bash
 alphafox schema trading.strategy_definitions.list --format json --no-input
 alphafox api GET /api/v1/trading/strategy-definitions --format json --no-input
+alphafox trading strategy_definitions byId get --definitionId <id> --format json --no-input
 ```
 
-## Write (ordinary)
+Use the list to pick the definition the operator named. Copy / rebate-copy / DCA / grid are rows in this catalog, not a separate product.
+
+## Validate config
 
-Read `request.body` first. Do not invent chat or strategy fields.
+Read `request.body` first. Do not invent definition or config fields.
 
 ```bash
-alphafox schema chats.create --format json --no-input
-alphafox chats create --body '{"strategyGenerationMode":"simple"}' --format json --no-input
-# large / nested bodies:
-# alphafox chats create --config @./create-chat.json --format json --no-input
+alphafox schema trading.strategy_definitions.byId.validate_config --format json --no-input
+alphafox trading strategy_definitions byId validate_config --definitionId <id> --config @./strategy-config.json --format json --no-input
 ```
 
-Requires auth. Sends `Idempotency-Key` when available. Duplicate key → `409`; do not invent a new key unless the operator asks to create another chat.
-
-Engine strategy backtest (WASM tape + persist) is `skills/engine-backtest` (`alphafox engine-backtest run`). Chat-attached `/api/v1/backtests` (`backtests.*`) is not a CLI surface — do not call it.
+After the config validates, create the running instance with `alphafox-trading`.
 
 ## operationIds
 
 - `trading.strategy_definitions.list`
-- `chats.create`
+- `trading.strategy_definitions.byId.get`
+- `trading.strategy_definitions.byId.validate_config`

package/skills/trading/SKILL.md

@@ -1,14 +1,26 @@
 ---
 name: alphafox-trading
-description: Traders list and high-risk start/stop with confirmation gates.
-version: 0.3.5
+description: Running strategies (traders) — create, list, start, and stop. A trader is a live or paper strategy instance (grid, dca, copy, …), not a person.
+version: 0.3.7
 ---
 
-# Trading
+# Running strategies (traders)
 
-Always `--format json --no-input`. Read first. Writes need scopes `trading:write`; start/stop also `trading:high-risk`.
+Always `--format json --no-input`. Read first. Creates and updates need `trading:write`; start/stop also `trading:high-risk`.
 
-Human-mentioned tickers must be resolved with `alphafox resolve-symbols` (`skills/market`) before they are written into trader config.
+A **trader** is a running strategy instance (paper or live). Creating a strategy means creating a trader. Bind it to a **strategy definition**, an exchange connector, and runtime settings.
+
+Human-mentioned tickers must be resolved with `alphafox resolve-symbols` (`skills/market`) before they are written into trader config. 美股 stay `equity_perp` contracts such as `NVDA/USDT:USDT`.
+
+Pick the create operation from the definition the operator asked for:
+
+| Kind | Create |
+|---|---|
+| Engine definitions (grid, dca, …) | `trading.traders.create` |
+| Hyperliquid copy | `trading.hl_copy_traders.create` |
+| Rebate copy | `trading.rebate_copy_traders.create` |
+
+Copy leads come from `trading.signal_sources.list` when the operator named one. Same trader lifecycle (list / start / stop) after create.
 
 ## Read
 
@@ -16,9 +28,23 @@ Human-mentioned tickers must be resolved with `alphafox resolve-symbols` (`skill
 alphafox api GET /api/v1/trading/traders --format json --no-input
 ```
 
-## High-risk write
+## Create
+
+Read `alphafox schema <operationId>` first. Body may only include documented `request.body` fields. Large / nested bodies use `--config @file`.
+
+```bash
+alphafox schema trading.traders.create --format json --no-input
+alphafox trading traders create --config @./create-trader.json --dry-run --format json --no-input
+alphafox trading traders create --config @./create-trader.json --yes --format json --no-input
+```
+
+`trading.traders.create` is `high-risk-write` and needs `--yes`. Copy creates follow whatever `risk` the schema reports — `--dry-run` first, then `--yes` when required.
+
+If a required field is missing, re-read the schema and ask the operator. Do not invent ids. The CLI has no authoring-session surface; instantiate from a definition, connector, and config.
+
+## High-risk start / stop
 
-Read `alphafox schema trading.traders.byId.start` first. Body may only include documented fields (`reason` is optional). Do not invent keys.
+Read `alphafox schema trading.traders.byId.start` first. Body may only include documented fields (`reason` is optional).
 
 ```bash
 alphafox schema trading.traders.byId.start --format json --no-input
@@ -39,5 +65,9 @@ Stop: `POST /api/v1/trading/traders/{traderId}/stop` with the same `--dry-run` t
 ## operationIds
 
 - `trading.traders.list`
+- `trading.traders.create`
+- `trading.hl_copy_traders.create`
+- `trading.rebate_copy_traders.create`
+- `trading.signal_sources.list`
 - `trading.traders.byId.start`
 - `trading.traders.byId.stop`