@alphafox/cli 0.3.2 → 0.3.4

package/dist/resolve-symbols/run-command.js

@@ -0,0 +1,149 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveSymbolsHelpData = resolveSymbolsHelpData;
+exports.executeResolveSymbols = executeResolveSymbols;
+exports.cmdResolveSymbols = cmdResolveSymbols;
+const profiles_1 = require("../config/profiles");
+const envelope_1 = require("../envelope");
+const client_1 = require("../http/client");
+const catalog_1 = require("./catalog");
+const errors_1 = require("./errors");
+const exchanges_1 = require("./exchanges");
+const match_1 = require("./match");
+const parse_args_1 = require("./parse-args");
+function extractErrorMessage(json, fallback) {
+    if (json && typeof json === "object") {
+        const o = json;
+        if (typeof o.message === "string")
+            return o.message;
+        if (typeof o.detail === "string")
+            return o.detail;
+        if (typeof o.error === "string")
+            return o.error;
+        if (o.error && typeof o.error === "object") {
+            const e = o.error;
+            if (typeof e.message === "string")
+                return e.message;
+        }
+    }
+    return fallback || "Request failed";
+}
+function extractErrorCode(json) {
+    if (json && typeof json === "object") {
+        const o = json;
+        if (typeof o.code === "string" || typeof o.code === "number")
+            return o.code;
+    }
+    return undefined;
+}
+function resolveSymbolsHelpData() {
+    return {
+        name: "resolve-symbols",
+        usage: parse_args_1.RESOLVE_SYMBOLS_USAGE,
+        notes: [
+            "Resolves user-mentioned tickers against the public linear-perp catalog from market.symbols.list",
+            "Default --exchange is binance (binance_perp_usdt). Aliases: binance|okx|bybit|bitget|hyperliquid|aster",
+            "Do not guess CCXT symbols. Exact match may be used directly; a single close match needs user confirmation; multiple close matches must be chosen by the user",
+            "Catalog CRUD remains alphafox market symbols list --exchange <id>",
+        ],
+    };
+}
+async function executeResolveSymbols(args, flags, env = process.env, deps = {}) {
+    if (args.help) {
+        throw new errors_1.ResolveSymbolsError({
+            type: "usage",
+            message: "internal: help should be handled by the command wrapper",
+        });
+    }
+    const exchange = (0, exchanges_1.resolveSymbolsExchangeId)(args.exchange);
+    const profile = (0, profiles_1.resolveProfile)(flags.profile, env, {
+        unsafeCustomEndpoint: flags.unsafeCustomEndpoint,
+    });
+    const api = deps.apiRequest ?? client_1.apiRequest;
+    const res = await api({
+        method: "GET",
+        path: (0, catalog_1.marketSymbolsPath)(exchange.id),
+        profile,
+    }, env);
+    if (res.status >= 400) {
+        throw new errors_1.ResolveSymbolsError({
+            type: "http",
+            status: res.status,
+            message: extractErrorMessage(res.json, res.bodyText),
+            code: extractErrorCode(res.json),
+            hint: res.status === 401 || res.status === 403
+                ? "Run alphafox auth login. Tokens live in the OS keychain."
+                : undefined,
+            details: res.json,
+        });
+    }
+    const catalog = (0, match_1.indexCatalogSymbols)((0, catalog_1.extractCatalogSymbols)(res.json));
+    return {
+        exchange: exchange.id,
+        exchangeLabel: exchange.label,
+        catalogSize: catalog.length,
+        queries: args.queries.map((query) => (0, match_1.resolveQueryAgainstCatalog)(query, catalog, args.limit)),
+    };
+}
+async function cmdResolveSymbols(args, flags, env = process.env, deps = {}) {
+    let parsed;
+    try {
+        parsed = (0, parse_args_1.parseResolveSymbolsArgs)(args);
+    }
+    catch (err) {
+        if ((0, errors_1.isResolveSymbolsError)(err)) {
+            (0, envelope_1.writeError)({
+                type: err.type,
+                subtype: err.subtype,
+                message: err.message,
+                hint: err.hint,
+                status: err.status,
+                details: err.details,
+            }, { exitCode: err.status === 401 || err.status === 403 ? 77 : undefined });
+        }
+        throw err;
+    }
+    if (parsed.help) {
+        (0, envelope_1.writeSuccess)(resolveSymbolsHelpData(), {
+            format: flags.format,
+            jq: flags.jq,
+        });
+        return 0;
+    }
+    const exchange = (0, exchanges_1.resolveSymbolsExchangeId)(parsed.exchange);
+    if (flags.dryRun) {
+        (0, envelope_1.writeSuccess)({
+            dryRun: true,
+            operationId: "market.symbols.list",
+            method: "GET",
+            path: (0, catalog_1.marketSymbolsPath)(exchange.id),
+            exchange: exchange.id,
+            exchangeLabel: exchange.label,
+            queries: parsed.queries,
+        }, { format: flags.format, jq: flags.jq });
+        return 0;
+    }
+    try {
+        const result = await executeResolveSymbols(parsed, flags, env, deps);
+        (0, envelope_1.writeSuccess)(result, {
+            format: flags.format,
+            jq: flags.jq,
+            meta: { operationId: "market.symbols.list" },
+        });
+        return 0;
+    }
+    catch (err) {
+        if ((0, errors_1.isResolveSymbolsError)(err)) {
+            (0, envelope_1.writeError)({
+                type: err.type,
+                subtype: err.subtype,
+                message: err.message,
+                hint: err.hint,
+                status: err.status,
+                code: err.code,
+                details: err.details,
+            }, { exitCode: err.status === 401 || err.status === 403 ? 77 : undefined });
+        }
+        throw err;
+    }
+}

package/dist/resolve-symbols/types.d.ts

@@ -0,0 +1,37 @@
+export type ResolveSymbolsStatus = "exact" | "close" | "ambiguous" | "none";
+export type ResolveSymbolsMatchReason = "exact_canonical" | "exact_compact" | "exact_pair" | "exact_base" | "prefix" | "contains" | "close";
+export interface ResolveSymbolsMatch {
+    readonly symbol: string;
+    readonly reason: ResolveSymbolsMatchReason;
+    readonly score: number;
+}
+export interface ResolveSymbolsQueryResult {
+    readonly query: string;
+    readonly status: ResolveSymbolsStatus;
+    readonly resolved: string | null;
+    readonly needsConfirmation: boolean;
+    readonly matches: readonly ResolveSymbolsMatch[];
+    readonly matchCount: number;
+}
+export interface ResolveSymbolsSuccess {
+    readonly exchange: string;
+    readonly exchangeLabel: string;
+    readonly catalogSize: number;
+    readonly queries: readonly ResolveSymbolsQueryResult[];
+}
+export interface ResolveSymbolsRunArgs {
+    readonly help: boolean;
+    readonly queries: readonly string[];
+    readonly exchange: string;
+    readonly limit: number;
+}
+export interface CatalogSymbol {
+    readonly symbol: string;
+    readonly base: string;
+    readonly quote: string;
+    readonly pair: string;
+    readonly compact: string;
+    readonly searchKey: string;
+    readonly baseKey: string;
+    readonly compactKey: string;
+}

package/dist/resolve-symbols/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/version.d.ts

@@ -1,4 +1,4 @@
 export declare const CLI_NAME = "alphafox";
 export declare const CLI_PACKAGE = "@alphafox/cli";
-export declare const CLI_VERSION = "0.3.2";
+export declare const CLI_VERSION = "0.3.4";
 export { CATALOG_VERSION as CLI_CONTRACT_VERSION } from "./catalog/operations";

package/dist/version.js

@@ -3,6 +3,6 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.CLI_CONTRACT_VERSION = exports.CLI_VERSION = exports.CLI_PACKAGE = exports.CLI_NAME = void 0;
 exports.CLI_NAME = "alphafox";
 exports.CLI_PACKAGE = "@alphafox/cli";
-exports.CLI_VERSION = "0.3.2";
+exports.CLI_VERSION = "0.3.4";
 var operations_1 = require("./catalog/operations");
 Object.defineProperty(exports, "CLI_CONTRACT_VERSION", { enumerable: true, get: function () { return operations_1.CATALOG_VERSION; } });

package/docs/alphafox-cli-installation-guide.md

@@ -88,8 +88,8 @@ Parse the JSON envelope: `ok === true` means success. Errors land on
 ## Step 4: Tell the user to restart
 
 Ask the user to **restart the AI tool** so the new Skills are loaded.
-Then they can ask the Agent to use Alphafox (auth, catalog, trading,
-engine-backtest, …).
+Then they can ask the Agent to use Alphafox. The entry skill `alphafox` routes
+to auth, market, engine-backtest, strategy, trading, and the rest.
 
 ## Human wizard (do not run this from an Agent)
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alphafox/cli",
-  "version": "0.3.2",
+  "version": "0.3.4",
   "description": "Alphafox CLI — Agent/Human entry for the public Application API.",
   "type": "commonjs",
   "bin": {

package/skills/account/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: alphafox-account
 description: Account, wallet, and subscription read paths.
-version: 0.3.2
+version: 0.3.4
 ---
 
 # Account / wallet

package/skills/admin/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: alphafox-admin
 description: Admin-only operations reusing Web role authorization.
-version: 0.3.2
+version: 0.3.4
 ---
 
 # Admin

package/skills/alphafox/SKILL.md

@@ -0,0 +1,38 @@
+---
+name: alphafox
+description: Alphafox CLI entry router. Use for any Alphafox request — install, login, whoami, 回测, engine backtest, strategy chat, traders, ticker/标的 resolve, market data, exchange connectors, wallet, subscriptions, notifications, or admin. Start here, then open the routed domain skill. Do not guess alphafox-engine-backtest vs alphafox-strategy from memory.
+version: 0.3.4
+---
+
+# Alphafox
+
+This skill only routes. After choosing a row, **read that skill's `SKILL.md` and follow it**. Do not improvise domain procedures from this file.
+
+Also read `alphafox-shared` before any CLI invocation (envelope, auth, risk, schema-first writes). Always `--format json --no-input`. Never `--token`.
+
+Human-mentioned tickers go through `alphafox-market` (`alphafox resolve-symbols`) **before** they enter config, backtest, or writes.
+
+## Route
+
+| User intent | Skill |
+|---|---|
+| Install, doctor, version, catalog, how to call the CLI | `alphafox-shared` |
+| Login, logout, whoami, profile, staging vs production | `alphafox-auth` |
+| Coin / ticker / 标的 / `BTC/USDT:USDT` / resolve a misspelled symbol | `alphafox-market` |
+| Engine WASM backtest, experiment, `engine-backtest run`, persist a local run | `alphafox-engine-backtest` |
+| Strategy chat, compiled strategy | `alphafox-strategy` |
+| List / start / stop traders | `alphafox-trading` |
+| Exchange connectors | `alphafox-exchange` |
+| Account, wallet, subscription | `alphafox-account` |
+| Notification channels | `alphafox-notification` |
+| Admin-only operations | `alphafox-admin` |
+
+If several rows apply, load **all** of them (typical: `alphafox-shared` + `alphafox-market` + one domain skill).
+
+## Do not mix these backtest paths
+
+- Local Engine tape + wasm + optional persist → `alphafox-engine-backtest` (`alphafox engine-backtest run`, hyphen).
+- Experiment catalog CRUD → same skill, underscore catalog `engine_backtest.*`.
+- Chat-attached `/api/v1/backtests` (`backtests.*`) is **not** a CLI surface. Do not call it via typed commands, `schema`, or `alphafox api`.
+
+Ambiguous “帮我回测” → `alphafox-engine-backtest`, after resolving symbols.

package/skills/alphafox-shared/SKILL.md

@@ -1,11 +1,13 @@
 ---
 name: alphafox-shared
 description: Shared Alphafox CLI rules for Agents — auth, profiles, envelopes, risk gates, and public operationIds only.
-version: 0.3.2
+version: 0.3.4
 ---
 
 # Alphafox shared Agent contract
 
+User-facing entry is skill `alphafox` (router). This file is the shared CLI contract every domain skill assumes.
+
 Co-versioned with `@alphafox/cli`. Query compatibility with `alphafox version --format json` (`version`, `contractVersion`, `catalogVersion`) and `alphafox catalog`.
 
 ## Install / identity
@@ -54,6 +56,8 @@ Wrong environment / missing permission / missing `--yes`: stop. Do not retry wit
 
 ## Commands
 
+User-mentioned tickers (including typos) must be resolved with `alphafox resolve-symbols` before they are written into config. See `skills/market`.
+
 1. Prefer typed catalog: `alphafox schema <operationId>` then invoke domain commands.
 2. Raw escape hatch only for allowlisted facade:
 

package/skills/auth/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: alphafox-auth
 description: Login, status, logout, whoami, and environment isolation for Alphafox CLI.
-version: 0.3.2
+version: 0.3.4
 ---
 
 # Auth Skill

package/skills/engine-backtest/SKILL.md

@@ -1,26 +1,32 @@
 ---
 name: alphafox-engine-backtest
-description: Local Engine WASM backtest (alphafox engine-backtest run) vs catalog experiment CRUD vs chat backtests stub.
-version: 0.3.2
+description: Local Engine WASM backtest (alphafox engine-backtest run|sweep) vs catalog experiment CRUD.
+version: 0.3.4
 ---
 
 # Engine Backtest
 
 Always `--format json --no-input` (or `--format jsonl` when you need progress). Never `--token`. Tokens live in the OS keychain via `alphafox auth login`.
 
+Human-mentioned tickers must be resolved with `alphafox resolve-symbols` (`skills/market`) before they go into `--config`. Use `data.queries[].resolved` only when `status` is `exact`, or `close` after confirming with the human. Do not invent `BTC/USDT:USDT`. Aster is in the public catalog but is **not** an Engine tape source.
+
 ## Which command
 
 | Intent | Use | Do not |
 |---|---|---|
 | Iterate a strategy locally (pull tape + run wasm + optional persist) | `alphafox engine-backtest run` (hyphen, built-in) | Do not treat this as server-side execution of `engine_backtest.experiments.byId.runs.create` |
+| Local parameter search with explicit axes; persist one Sweep after completion | `alphafox engine-backtest sweep` | Never loop `runs.create` per coordinate. Do not call Chat `backtests.*` |
+| Local search with zero writes | `alphafox engine-backtest sweep ... --no-persist` | Do not persist a cancelled or incomplete search |
+| List / get / delete persisted Sweeps | Catalog `engine_backtest.experiments.byId.sweeps.*` | Do not invent a second catalog. Delete is high-risk and needs `--yes` |
 | List / get / create / rename / delete experiments and persisted runs | Catalog `engine_backtest.*` (underscore) | Do not invent a second catalog |
-| Chat-attached `/api/v1/backtests` job | `skills/strategy` + `backtests.*` | That stub is **not** the Engine WASM runner |
+| Chat-attached `/api/v1/backtests` job | — | Not a CLI surface. Do not call `backtests.*` or `/api/v1/backtests` |
 
-Read the create-experiment body with `alphafox schema` **before** composing JSON. Do not invent experiment fields. Large create/run payloads use `--config @file`, never a guessed `--body`.
+Read the create-experiment body with `alphafox schema` **before** composing JSON. Do not invent experiment fields. Large create/run/sweep payloads use `--config @file`, never a guessed `--body`.
 
 ```bash
 alphafox schema engine_backtest.experiments.create --format json --no-input
 alphafox engine_backtest experiments create --config @./experiment.json --format json --no-input
+alphafox schema engine_backtest.experiments.byId.sweeps.create --format json --no-input
 ```
 
 ## Local run
@@ -50,6 +56,38 @@ Also valid: `--from` / `--to` instead of `--range`. `--create-experiment --name
 
 `--format jsonl` writes one JSON object per progress line (`{event:"progress",stage,fraction}`), then a final `{ok:true,data:{...}}` envelope.
 
+## Local sweep
+
+`alphafox engine-backtest sweep` reuses the same Experiment / definition / config / exchange / range / initial equity / replay timeframe / data quality / execution model / tier flags as `run`. Axes are explicit JSON (`--axes @file`); each axis must name a config path and `min`/`max`/`step` or `values`. The command does not guess parameter paths.
+
+```bash
+alphafox engine-backtest sweep \
+  --experiment <uuid> \
+  --definition grid \
+  --config @./grid.json \
+  --axes @./axes.json \
+  --exchange binance \
+  --range 2026-08-01..2026-08-08 \
+  --initial-equity 10000 \
+  --mode neighborhood \
+  --search-mode standard \
+  --format jsonl --no-input
+```
+
+`--mode` is `neighborhood|range`. `--search-mode` is `standard|fast`. `--concurrency` is 1–8; Free is always serial. After every local coordinate finishes, the command POSTs **one** `engine_backtest.experiments.byId.sweeps.create` summary (4 MiB / point-error caps). It never calls `runs.create` per coordinate and never writes Tape, curves, or full configs. `--no-persist` stays zero-write. A cancelled or incomplete search is not persisted. The same `clientSweepId` is reused if you rebuild the create body for retry; unknown write results (no Sweep id) fail instead of reporting `persisted: true`.
+
+`--format jsonl` includes `planning`, `tape`, `sweep`, and `persist` stages. The final envelope includes counts, `elapsedMs`, best coordinate/config, `sweepId`, `persisted`, and an Experiment URL with `?tab=sweep`.
+
+Read / delete history through typed catalog commands. Delete is high-risk-write:
+
+```bash
+alphafox engine_backtest experiments sweeps list --experimentId <uuid> --format json --no-input
+alphafox engine_backtest experiments sweeps get --experimentId <uuid> --sweepId <uuid> --format json --no-input
+alphafox engine_backtest experiments sweeps delete --experimentId <uuid> --sweepId <uuid> --yes --format json --no-input
+```
+
+Owner isolation and 7-day expiry are enforced by the server. Applying a coordinate to a formal Run is a separate `engine-backtest run`.
+
 ## Iterate
 
 1. Edit config JSON.
@@ -62,10 +100,14 @@ Also valid: `--from` / `--to` instead of `--range`. `--create-experiment --name
 - Unauthenticated persist/create fails like `whoami` (HTTP 401, exit 77).
 - `strict` data quality: missing/gapped tape **stops**. Do not retry as `basic` unless the operator asks.
 - `planBacktest` unsupported → fail with the plan reason. Do not degrade to a guessed universe.
-- Catalog `engine_backtest.experiments.byId.update` / `.delete` are high-risk-write and are **not** this command.
+- Catalog `engine_backtest.experiments.byId.update` / `.delete` / `.sweeps.byId.delete` are high-risk-write and are **not** this command's run/sweep path.
 
 ## operationIds (catalog only)
 
 - `engine_backtest.experiments.create` / `.list` / `.byId.get`
 - `engine_backtest.experiments.byId.runs.create` / `.list`
-- High-risk (not this skill's run path): `engine_backtest.experiments.byId.update` / `.byId.delete` / `.byId.runs.byId.delete`
+- `engine_backtest.experiments.byId.sweeps.create` / `.list`
+- `engine_backtest.experiments.byId.sweeps.byId.get`
+- High-risk (not this skill's run/sweep path): `engine_backtest.experiments.byId.update` / `.byId.delete` / `.byId.runs.byId.delete` / `.byId.sweeps.byId.delete`
+
+Chat `backtests.*` is not an Engine Sweep or Engine Run surface. Do not call it from this skill.

package/skills/exchange/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: alphafox-exchange
 description: Exchange connectors list and connection management via Public API.
-version: 0.3.2
+version: 0.3.4
 ---
 
 # Exchange connectors

package/skills/market/SKILL.md

@@ -1,19 +1,42 @@
 ---
 name: alphafox-market
-description: Market data and spread-radar readonly queries.
-version: 0.3.2
+description: Market data, ticker resolution, and spread-radar readonly queries.
+version: 0.3.4
 ---
 
 # Market
 
 Always `--format json --no-input`. Prefer readonly scopes. No mock success if upstream fails.
 
+## Resolve tickers first
+
+Whenever a human mentions a coin, ticker, or contract — including typos — resolve it **before** putting a symbol into strategy config, backtest, chat settings, or any write.
+
+```bash
+alphafox resolve-symbols BTC ETH 龙虾 --exchange binance --format json --no-input
+```
+
+- Default `--exchange` is Binance (`binance_perp_usdt`). Aliases: `binance|okx|bybit|bitget|hyperliquid|aster`.
+- This built-in loads the public linear-perp catalog via `market.symbols.list` (`GET /api/v1/market/symbols?exchange=...`) and matches locally. Do not guess `BTC/USDT:USDT` from memory. Do not pull a second ccxt universe.
+- Read `data.queries[]`. `resolved` is a CCXT linear swap id (`BTC/USDT:USDT`). `matchCount` is the full hit count; `matches` may be capped by `--limit`.
+
+| `status` | Agent action |
+|---|---|
+| `exact` | Use `resolved`. No confirmation. |
+| `close` | One near match already in `resolved`. Use it, then **confirm with the human**. |
+| `ambiguous` | `resolved` is null. Show `matches[].symbol` and ask the human to pick. Do not pick. |
+| `none` | Stop. Ask the human for another ticker. Do not invent a symbol. |
+
+Do not treat `close` as exact. Do not retry a failed resolve as a different exchange unless the operator names one.
+
+Raw catalog dump (no matching):
+
 ```bash
+alphafox market symbols list --exchange binance_perp_usdt --format json --no-input
 alphafox api GET /api/v1/spread-radar/pairs --format json --no-input
-alphafox api GET /api/v1/market/symbols --format json --no-input
 ```
 
 ## operationIds
 
+- `market.symbols.list` (used by `alphafox resolve-symbols`)
 - `spread_radar.pairs.list`
-- `market.symbols.list`

package/skills/notification/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: alphafox-notification
 description: Notification channels and subscriptions.
-version: 0.3.2
+version: 0.3.4
 ---
 
 # Notification

package/skills/strategy/SKILL.md

@@ -1,12 +1,14 @@
 ---
 name: alphafox-strategy
-description: Strategy definitions, chats, and backtests via public operationIds.
-version: 0.3.2
+description: Strategy definitions and chats via public operationIds.
+version: 0.3.4
 ---
 
-# Strategy / Chat / Backtest
+# Strategy / Chat
 
-Always `--format json --no-input`. Read scopes `trading:read` / `backtests:read`; writes `chats:write` / `backtests:write`.
+Always `--format json --no-input`. Read scopes `trading:read`; writes `chats: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.
 
 ## Read
 
@@ -28,24 +30,9 @@ alphafox chats create --body '{"strategyGenerationMode":"simple"}' --format json
 
 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`). Do not treat `/api/v1/backtests` as the Engine WASM runner — that stub is the chat backtest job below.
-
-## Long-running backtest
-
-```bash
-alphafox schema backtests.create --format json --no-input
-alphafox api POST /api/v1/backtests --body '{"chatId":"<chat-id>"}' --format json --no-input
-alphafox api GET /api/v1/backtests/{backtestId} --format json --no-input
-alphafox api GET /api/v1/backtests/{backtestId}/stream --format jsonl --no-input
-alphafox api POST /api/v1/backtests/{backtestId}/cancel --body '{}' --format json --no-input
-```
-
-`backtests.create` requires `chatId`. `strategyId` is optional: the facade resolves a compiled strategy on that chat. A chat with no compiled strategy returns `CHAT_HAS_NO_COMPILED_STRATEGY` (not `JOB_NOT_FOUND`). Optional `backtestSettings` overlays chat settings when it is a settingsJson object.
-
-If the stream drops, `GET` the backtest by id — do not assume success. Cancel is explicit; interruption must remain queryable.
+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.
 
 ## operationIds
 
 - `trading.strategy_definitions.list`
 - `chats.create`
-- `backtests.create` / `backtests.byId.get` / `backtests.byId.stream` / `backtests.byId.cancel`

package/skills/trading/SKILL.md

@@ -1,13 +1,15 @@
 ---
 name: alphafox-trading
 description: Traders list and high-risk start/stop with confirmation gates.
-version: 0.3.2
+version: 0.3.4
 ---
 
 # Trading
 
 Always `--format json --no-input`. Read first. Writes need scopes `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.
+
 ## Read
 
 ```bash