@alphafox/cli 0.3.6 → 0.3.7

package/dist/catalog/omit.d.ts

@@ -1,5 +1,7 @@
 /**
- * Chat-attached `/api/v1/backtests` jobs are not a CLI surface.
+ * Not a CLI surface:
+ * - Web `/api/v1/backtests` jobs (`backtests` / `backtests.*`)
+ * - Chat product (`chats` / `chats.*`, `chat_summaries` / `chat_summaries.*`)
  * Local Engine WASM (`engine-backtest run`) and `engine_backtest.*` stay.
  * Match `backtests` / `backtests.*` only — never `engine_backtest.*`.
  */

package/dist/catalog/omit.js

@@ -2,10 +2,17 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.isOmittedCatalogOperation = isOmittedCatalogOperation;
 /**
- * Chat-attached `/api/v1/backtests` jobs are not a CLI surface.
+ * Not a CLI surface:
+ * - Web `/api/v1/backtests` jobs (`backtests` / `backtests.*`)
+ * - Chat product (`chats` / `chats.*`, `chat_summaries` / `chat_summaries.*`)
  * Local Engine WASM (`engine-backtest run`) and `engine_backtest.*` stay.
  * Match `backtests` / `backtests.*` only — never `engine_backtest.*`.
  */
 function isOmittedCatalogOperation(operationId) {
-    return operationId === "backtests" || operationId.startsWith("backtests.");
+    return (operationId === "backtests" ||
+        operationId.startsWith("backtests.") ||
+        operationId === "chats" ||
+        operationId.startsWith("chats.") ||
+        operationId === "chat_summaries" ||
+        operationId.startsWith("chat_summaries."));
 }

package/dist/commands/run.js

@@ -101,7 +101,7 @@ async function runCli(argv, env = process.env) {
                 "alphafox api METHOD PATH [--body JSON|--config @file]",
                 "alphafox engine-backtest run --experiment <uuid> --definition <id> --config @file --exchange <id> --range FROM..TO --initial-equity N",
                 "alphafox engine-backtest sweep --experiment <uuid> --definition <id> --config @file --axes @file --exchange <id> --range FROM..TO --initial-equity N --no-persist",
-                "alphafox resolve-symbols <query...> [--exchange binance]",
+                "alphafox resolve-symbols <query...> [--exchange binance] [--asset-class equity_perp]",
                 "alphafox <domain> <resource> <action> [flags]",
             ],
         }, { format: flags.format, jq: flags.jq });

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

@@ -1,3 +1,9 @@
+import type { SymbolMetadata } from "./types";
 export declare const MARKET_SYMBOLS_PATH = "/api/v1/market/symbols";
 export declare function marketSymbolsPath(exchangeId: string): string;
+export interface MarketCatalogPayload {
+    readonly symbols: string[];
+    readonly symbolMetadata: Readonly<Record<string, SymbolMetadata>>;
+}
 export declare function extractCatalogSymbols(json: unknown): string[];
+export declare function extractMarketCatalog(json: unknown): MarketCatalogPayload;

package/dist/resolve-symbols/catalog.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.MARKET_SYMBOLS_PATH = void 0;
 exports.marketSymbolsPath = marketSymbolsPath;
 exports.extractCatalogSymbols = extractCatalogSymbols;
+exports.extractMarketCatalog = extractMarketCatalog;
 const errors_1 = require("./errors");
 exports.MARKET_SYMBOLS_PATH = "/api/v1/market/symbols";
 function marketSymbolsPath(exchangeId) {
@@ -10,6 +11,9 @@ function marketSymbolsPath(exchangeId) {
     return `${exports.MARKET_SYMBOLS_PATH}?${query}`;
 }
 function extractCatalogSymbols(json) {
+    return extractMarketCatalog(json).symbols;
+}
+function extractMarketCatalog(json) {
     const root = asRecord(json);
     const payload = asRecord(root?.data) ?? root;
     const symbols = payload?.symbols;
@@ -40,8 +44,47 @@ function extractCatalogSymbols(json) {
             details: json,
         });
     }
+    return {
+        symbols: out,
+        symbolMetadata: extractSymbolMetadata(payload?.symbolMetadata),
+    };
+}
+function extractSymbolMetadata(value) {
+    const rec = asRecord(value);
+    if (!rec)
+        return {};
+    const out = {};
+    for (const [rawKey, rawMeta] of Object.entries(rec)) {
+        const key = rawKey.trim();
+        const meta = parseSymbolMetadata(rawMeta);
+        if (!key || !meta)
+            continue;
+        out[key] = meta;
+    }
     return out;
 }
+function parseSymbolMetadata(value) {
+    const rec = asRecord(value);
+    if (!rec)
+        return undefined;
+    const meta = {};
+    if (typeof rec.isTradFiRwa === "boolean") {
+        meta.isTradFiRwa = rec.isTradFiRwa;
+    }
+    if (typeof rec.assetClass === "string" && rec.assetClass.trim()) {
+        meta.assetClass = rec.assetClass.trim();
+    }
+    if (isFiniteNumber(rec.minAmount))
+        meta.minAmount = rec.minAmount;
+    if (isFiniteNumber(rec.minCost))
+        meta.minCost = rec.minCost;
+    if (isFiniteNumber(rec.contractSize))
+        meta.contractSize = rec.contractSize;
+    return Object.keys(meta).length > 0 ? meta : undefined;
+}
+function isFiniteNumber(value) {
+    return typeof value === "number" && Number.isFinite(value);
+}
 function asRecord(value) {
     if (!value || typeof value !== "object" || Array.isArray(value)) {
         return undefined;

package/dist/resolve-symbols/exchanges.js

@@ -42,12 +42,15 @@ for (const exchange of exports.RESOLVE_SYMBOLS_EXCHANGES) {
         EXCHANGE_BY_ALIAS.set(alias.toLowerCase(), exchange);
     }
 }
+const PASSTHROUGH_EXCHANGE_ID = /^[a-z][a-z0-9_]{1,63}$/;
 function resolveSymbolsExchangeId(raw) {
     const key = raw.trim().toLowerCase();
     const exchange = EXCHANGE_BY_ALIAS.get(key);
-    if (!exchange) {
-        const allowed = exports.RESOLVE_SYMBOLS_EXCHANGES.map((item) => item.aliases[0]).join("|");
-        throw new Error(`--exchange must be ${allowed} (got ${raw.trim() || "<empty>"})`);
+    if (exchange)
+        return exchange;
+    if (PASSTHROUGH_EXCHANGE_ID.test(key)) {
+        return { id: key, label: raw.trim(), aliases: [key] };
     }
-    return exchange;
+    const allowed = exports.RESOLVE_SYMBOLS_EXCHANGES.map((item) => item.aliases[0]).join("|");
+    throw new Error(`--exchange must be ${allowed} or a market.symbols.list catalog id (got ${raw.trim() || "<empty>"})`);
 }

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

@@ -1,6 +1,7 @@
-import type { CatalogSymbol, ResolveSymbolsQueryResult } from "./types";
+import type { CatalogSymbol, ResolveAssetClassFilter, ResolveSymbolsQueryResult, SymbolMetadata } from "./types";
 export declare function normalizeSymbolSearchKey(value: string): string;
 export declare function parseCatalogSymbol(symbol: string): CatalogSymbol | null;
-export declare function indexCatalogSymbols(symbols: readonly string[]): readonly CatalogSymbol[];
-export declare function resolveQueryAgainstCatalog(query: string, catalog: readonly CatalogSymbol[], limit?: number): ResolveSymbolsQueryResult;
+export declare function indexCatalogSymbols(symbols: readonly string[], metadata?: Readonly<Record<string, SymbolMetadata>>): readonly CatalogSymbol[];
+export declare function catalogMatchesAssetClass(item: CatalogSymbol, assetClass: ResolveAssetClassFilter): boolean;
+export declare function resolveQueryAgainstCatalog(query: string, catalog: readonly CatalogSymbol[], limit?: number, assetClass?: ResolveAssetClassFilter): ResolveSymbolsQueryResult;
 export declare function levenshtein(left: string, right: string): number;

package/dist/resolve-symbols/match.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.normalizeSymbolSearchKey = normalizeSymbolSearchKey;
 exports.parseCatalogSymbol = parseCatalogSymbol;
 exports.indexCatalogSymbols = indexCatalogSymbols;
+exports.catalogMatchesAssetClass = catalogMatchesAssetClass;
 exports.resolveQueryAgainstCatalog = resolveQueryAgainstCatalog;
 exports.levenshtein = levenshtein;
 const LINEAR_PERP_PATTERN = /^([\p{L}\p{N}]+(?:-[\p{L}\p{N}]+)*)\/(USDT|USDC|USD):\2$/u;
@@ -69,7 +70,7 @@ function parseCatalogSymbol(symbol) {
         compactKey: normalizeSymbolSearchKey(upper),
     };
 }
-function indexCatalogSymbols(symbols) {
+function indexCatalogSymbols(symbols, metadata = {}) {
     const seen = new Set();
     const indexed = [];
     for (const raw of symbols) {
@@ -79,64 +80,59 @@ function indexCatalogSymbols(symbols) {
         if (seen.has(parsed.symbol))
             continue;
         seen.add(parsed.symbol);
-        indexed.push(parsed);
+        indexed.push({
+            ...parsed,
+            metadata: metadata[raw] ?? metadata[parsed.symbol],
+        });
     }
     return indexed;
 }
-function resolveQueryAgainstCatalog(query, catalog, limit = 8) {
+function catalogMatchesAssetClass(item, assetClass) {
+    if (assetClass === "all")
+        return true;
+    const cls = item.metadata?.assetClass;
+    const tradfi = item.metadata?.isTradFiRwa === true;
+    if (assetClass === "equity_perp")
+        return cls === "equity_perp";
+    if (assetClass === "rwa_perp")
+        return cls === "rwa_perp";
+    return !tradfi && cls !== "equity_perp" && cls !== "rwa_perp";
+}
+function resolveQueryAgainstCatalog(query, catalog, limit = 8, assetClass = "all") {
     const trimmed = query.trim();
-    const matches = rankMatches(trimmed, catalog);
+    const scoped = catalog.filter((item) => catalogMatchesAssetClass(item, assetClass));
+    const matches = rankMatches(trimmed, scoped);
     const exact = matches.filter((item) => EXACT_REASONS.has(item.reason));
     const close = matches.filter((item) => !EXACT_REASONS.has(item.reason));
     const capped = (items) => items.slice(0, Math.max(1, limit));
     if (exact.length === 1) {
-        return {
-            query: trimmed,
-            status: "exact",
-            resolved: exact[0].symbol,
-            needsConfirmation: false,
-            matches: exact,
-            matchCount: exact.length,
-        };
+        return result("exact", exact[0].symbol, false, exact, exact.length);
     }
     if (exact.length > 1) {
-        return {
-            query: trimmed,
-            status: "ambiguous",
-            resolved: null,
-            needsConfirmation: true,
-            matches: capped(exact),
-            matchCount: exact.length,
-        };
+        return result("ambiguous", null, true, capped(exact), exact.length);
     }
     if (close.length === 1) {
-        return {
-            query: trimmed,
-            status: "close",
-            resolved: close[0].symbol,
-            needsConfirmation: true,
-            matches: close,
-            matchCount: 1,
-        };
+        return result("close", close[0].symbol, true, close, 1);
     }
     if (close.length > 1) {
+        return result("ambiguous", null, true, capped(close), close.length);
+    }
+    return result("none", null, false, [], 0);
+    function result(status, resolved, needsConfirmation, matches, matchCount) {
+        const chosen = resolved
+            ? matches.find((item) => item.symbol === resolved)
+            : undefined;
         return {
             query: trimmed,
-            status: "ambiguous",
-            resolved: null,
-            needsConfirmation: true,
-            matches: capped(close),
-            matchCount: close.length,
+            status,
+            resolved,
+            assetClass: chosen?.assetClass ?? null,
+            isTradFiRwa: chosen?.isTradFiRwa ?? false,
+            needsConfirmation,
+            matches,
+            matchCount,
         };
     }
-    return {
-        query: trimmed,
-        status: "none",
-        resolved: null,
-        needsConfirmation: false,
-        matches: [],
-        matchCount: 0,
-    };
 }
 function rankMatches(query, catalog) {
     const canonicalQuery = query.trim().toUpperCase();
@@ -161,21 +157,21 @@ function rankMatches(query, catalog) {
 }
 function rankCatalogSymbol(item, canonicalQuery, queryKey, queryBaseKey) {
     if (item.symbol === canonicalQuery) {
-        return match(item.symbol, "exact_canonical", 100);
+        return match(item, "exact_canonical", 100);
     }
     if (item.pair === canonicalQuery) {
-        return match(item.symbol, "exact_pair", 96);
+        return match(item, "exact_pair", 96);
     }
     if (item.compactKey === queryKey || item.searchKey === queryKey) {
-        return match(item.symbol, "exact_compact", 98);
+        return match(item, "exact_compact", 98);
     }
     if (item.baseKey === queryKey || item.baseKey === queryBaseKey) {
-        return match(item.symbol, "exact_base", 95);
+        return match(item, "exact_base", 95);
     }
     let best = null;
     const consider = (reason, score) => {
         if (!best || score > best.score) {
-            best = match(item.symbol, reason, score);
+            best = match(item, reason, score);
         }
     };
     if (queryBaseKey.length >= 2 && item.baseKey.startsWith(queryBaseKey)) {
@@ -219,8 +215,14 @@ function isCloseDistance(left, right, distance) {
         return distance === 1;
     return distance <= 2;
 }
-function match(symbol, reason, score) {
-    return { symbol, reason, score };
+function match(item, reason, score) {
+    return {
+        symbol: item.symbol,
+        reason,
+        score,
+        assetClass: item.metadata?.assetClass ?? null,
+        isTradFiRwa: item.metadata?.isTradFiRwa === true,
+    };
 }
 function clampScore(score) {
     return Math.max(1, Math.min(94, score));

package/dist/resolve-symbols/parse-args.d.ts

@@ -1,5 +1,6 @@
 import type { ResolveSymbolsRunArgs } from "./types";
 export declare const RESOLVE_SYMBOLS_DEFAULT_LIMIT = 8;
 export declare const RESOLVE_SYMBOLS_MAX_LIMIT = 25;
+export declare const RESOLVE_SYMBOLS_ASSET_CLASSES: readonly ["all", "equity_perp", "rwa_perp", "crypto"];
 export declare const RESOLVE_SYMBOLS_USAGE: string[];
 export declare function parseResolveSymbolsArgs(args: readonly string[]): ResolveSymbolsRunArgs;

package/dist/resolve-symbols/parse-args.js

@@ -1,14 +1,21 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.RESOLVE_SYMBOLS_USAGE = exports.RESOLVE_SYMBOLS_MAX_LIMIT = exports.RESOLVE_SYMBOLS_DEFAULT_LIMIT = void 0;
+exports.RESOLVE_SYMBOLS_USAGE = exports.RESOLVE_SYMBOLS_ASSET_CLASSES = exports.RESOLVE_SYMBOLS_MAX_LIMIT = exports.RESOLVE_SYMBOLS_DEFAULT_LIMIT = void 0;
 exports.parseResolveSymbolsArgs = parseResolveSymbolsArgs;
 const errors_1 = require("./errors");
 const exchanges_1 = require("./exchanges");
 exports.RESOLVE_SYMBOLS_DEFAULT_LIMIT = 8;
 exports.RESOLVE_SYMBOLS_MAX_LIMIT = 25;
+exports.RESOLVE_SYMBOLS_ASSET_CLASSES = [
+    "all",
+    "equity_perp",
+    "rwa_perp",
+    "crypto",
+];
 exports.RESOLVE_SYMBOLS_USAGE = [
-    "alphafox resolve-symbols <query...> [--exchange binance] [--limit 8]",
+    "alphafox resolve-symbols <query...> [--exchange binance] [--asset-class all] [--limit 8]",
     "alphafox resolve-symbols --query BTC --query ETH --exchange okx",
+    "alphafox resolve-symbols NVDA AAPL TSLA --exchange binance --asset-class equity_perp",
 ];
 function usage(message, subtype = "invalid_args") {
     throw new errors_1.ResolveSymbolsError({
@@ -30,6 +37,7 @@ function parseResolveSymbolsArgs(args) {
     const queries = [];
     let exchange = exchanges_1.RESOLVE_SYMBOLS_DEFAULT_EXCHANGE;
     let limit = exports.RESOLVE_SYMBOLS_DEFAULT_LIMIT;
+    let assetClass = "all";
     let help = false;
     for (let i = 0; i < args.length; i += 1) {
         const a = args[i];
@@ -59,6 +67,14 @@ function parseResolveSymbolsArgs(args) {
             case "--exchange":
                 exchange = read();
                 break;
+            case "--asset-class": {
+                const value = read().trim().toLowerCase();
+                if (!exports.RESOLVE_SYMBOLS_ASSET_CLASSES.includes(value)) {
+                    usage(`--asset-class must be ${exports.RESOLVE_SYMBOLS_ASSET_CLASSES.join("|")}`, "invalid_asset_class");
+                }
+                assetClass = value;
+                break;
+            }
             case "--limit": {
                 const n = Number(read());
                 if (!Number.isInteger(n) || n <= 0 || n > exports.RESOLVE_SYMBOLS_MAX_LIMIT) {
@@ -72,7 +88,7 @@ function parseResolveSymbolsArgs(args) {
         }
     }
     if (help) {
-        return { help: true, queries: [], exchange, limit };
+        return { help: true, queries: [], exchange, limit, assetClass };
     }
     const normalizedQueries = queries.map((item) => item.trim()).filter(Boolean);
     if (normalizedQueries.length === 0) {
@@ -90,6 +106,7 @@ function parseResolveSymbolsArgs(args) {
         queries: uniqueQueries(normalizedQueries),
         exchange: resolvedExchange,
         limit,
+        assetClass,
     };
 }
 function uniqueQueries(queries) {

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

@@ -41,10 +41,12 @@ function resolveSymbolsHelpData() {
         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>",
+            "Resolves user-mentioned tickers against market.symbols.list for the chosen catalog",
+            "Default --exchange is binance (binance_perp_usdt). Built-in aliases: binance|okx|bybit|bitget|hyperliquid|aster",
+            "US stock perps live in the same catalog (NVDA/USDT:USDT) and are tagged symbolMetadata.assetClass=equity_perp / isTradFiRwa",
+            "For 美股 use --asset-class equity_perp. For gold/silver RWAs use rwa_perp. Crypto perps are untagged or --asset-class crypto",
+            "Each match includes assetClass and isTradFiRwa. Do not treat an equity_perp as a crypto coin",
+            "Catalog dump remains alphafox market symbols list --exchange <id>",
         ],
     };
 }
@@ -77,12 +79,22 @@ async function executeResolveSymbols(args, flags, env = process.env, deps = {})
             details: res.json,
         });
     }
-    const catalog = (0, match_1.indexCatalogSymbols)((0, catalog_1.extractCatalogSymbols)(res.json));
+    const payload = (0, catalog_1.extractMarketCatalog)(res.json);
+    const catalog = (0, match_1.indexCatalogSymbols)(payload.symbols, payload.symbolMetadata);
+    if (args.assetClass !== "all" &&
+        !catalog.some((item) => item.metadata?.assetClass)) {
+        throw new errors_1.ResolveSymbolsError({
+            type: "runtime",
+            subtype: "metadata_missing",
+            message: "market.symbols.list did not include symbolMetadata; cannot apply --asset-class",
+            hint: "Retry without --asset-class, or use a catalog that returns symbolMetadata.assetClass.",
+        });
+    }
     return {
         exchange: exchange.id,
         exchangeLabel: exchange.label,
         catalogSize: catalog.length,
-        queries: args.queries.map((query) => (0, match_1.resolveQueryAgainstCatalog)(query, catalog, args.limit)),
+        queries: args.queries.map((query) => (0, match_1.resolveQueryAgainstCatalog)(query, catalog, args.limit, args.assetClass)),
     };
 }
 async function cmdResolveSymbols(args, flags, env = process.env, deps = {}) {
@@ -119,6 +131,7 @@ async function cmdResolveSymbols(args, flags, env = process.env, deps = {}) {
             path: (0, catalog_1.marketSymbolsPath)(exchange.id),
             exchange: exchange.id,
             exchangeLabel: exchange.label,
+            assetClass: parsed.assetClass,
             queries: parsed.queries,
         }, { format: flags.format, jq: flags.jq });
         return 0;

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

@@ -1,14 +1,26 @@
 export type ResolveSymbolsStatus = "exact" | "close" | "ambiguous" | "none";
+export type ResolveAssetClassFilter = "all" | "equity_perp" | "rwa_perp" | "crypto";
+export interface SymbolMetadata {
+    readonly isTradFiRwa?: boolean;
+    readonly assetClass?: string;
+    readonly minAmount?: number;
+    readonly minCost?: number;
+    readonly contractSize?: number;
+}
 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;
+    readonly assetClass: string | null;
+    readonly isTradFiRwa: boolean;
 }
 export interface ResolveSymbolsQueryResult {
     readonly query: string;
     readonly status: ResolveSymbolsStatus;
     readonly resolved: string | null;
+    readonly assetClass: string | null;
+    readonly isTradFiRwa: boolean;
     readonly needsConfirmation: boolean;
     readonly matches: readonly ResolveSymbolsMatch[];
     readonly matchCount: number;
@@ -24,6 +36,7 @@ export interface ResolveSymbolsRunArgs {
     readonly queries: readonly string[];
     readonly exchange: string;
     readonly limit: number;
+    readonly assetClass: ResolveAssetClassFilter;
 }
 export interface CatalogSymbol {
     readonly symbol: string;
@@ -34,4 +47,5 @@ export interface CatalogSymbol {
     readonly searchKey: string;
     readonly baseKey: string;
     readonly compactKey: string;
+    readonly metadata?: SymbolMetadata;
 }

package/dist/skills-manifest.json

@@ -1,141 +1,141 @@
 {
   "schemaVersion": 1,
   "packageName": "@alphafox/cli",
-  "packageVersion": "0.3.6",
+  "packageVersion": "0.3.7",
   "contractVersion": "2026-08-13",
-  "bundleHash": "1eb4c16a941eee4c125efc6bb64ed7bb0db1d12b71f71cae66e55e64f600cf9a",
+  "bundleHash": "e12e1922538778707e60e931a247ecebb3e028cefeba295f4ca299d8d82d661b",
   "skills": [
     {
       "name": "alphafox",
-      "version": "0.3.6",
+      "version": "0.3.7",
       "files": [
         {
           "path": "SKILL.md",
-          "sha256": "a60f579e6321533d4f965c607f1158ddb50d1a89905d8793eca0b401b3f67fd2",
-          "size": 3055
+          "sha256": "2cd53898008075e68afd8ce955b63cf61f2971ef28f6c13c41853b1c5de967c8",
+          "size": 3553
         }
       ],
-      "hash": "c47e6e2d6154e831a681b731e123053c2d20c6c77654191f0a78ae2137ce5304"
+      "hash": "d687ecf8cc366e26dcb535bf31a30faceb037f021c818fa24997d144a22d3c20"
     },
     {
       "name": "alphafox-account",
-      "version": "0.3.6",
+      "version": "0.3.7",
       "files": [
         {
           "path": "SKILL.md",
-          "sha256": "c60baab539cca008ccc48d53f0262d7a019db82b3945402d16b5ac84624b475f",
+          "sha256": "fc5675dc44494227679994b761ca2e014d36acc207c68e3fb6d833912a7644ee",
           "size": 783
         }
       ],
-      "hash": "e828192ec19a24bc18ce64d07a583eaba498e6a0c356214dbe18ccae6e9f6a6d"
+      "hash": "bc1352e9d352f313f69f5257ba351137778c3ee1d8714d2d80fc39c0824c5cec"
     },
     {
       "name": "alphafox-admin",
-      "version": "0.3.6",
+      "version": "0.3.7",
       "files": [
         {
           "path": "SKILL.md",
-          "sha256": "87bbc12b803be021d94ad8161293263ce69e1d6c50f887a245ebe5c0a285e4f6",
+          "sha256": "6594e6cbfd319a41ae3abf9bf4f8239bb42bc25e6eec295999fe39cd694b2b8b",
           "size": 787
         }
       ],
-      "hash": "2881be10858efaad4543ffbe94f3bf87a91d4b0a4f3d905c3e0a5b8463e8756b"
+      "hash": "d6c5573444a020f376d51a73d44f39da9de8ea20bfd160f838b0de01bbb5e798"
     },
     {
       "name": "alphafox-auth",
-      "version": "0.3.6",
+      "version": "0.3.7",
       "files": [
         {
           "path": "SKILL.md",
-          "sha256": "99e954df23206b0deb32761ce39396897d5af2ee8852e3a8340ed1b9c2e88a46",
+          "sha256": "b7b2694cbcf6e784d89943950435cb34454309cfbe07e383cc028a435dfec77d",
           "size": 1919
         }
       ],
-      "hash": "659ca92bdfa0b31bcd1d39d7af151c308f1f9e7cd541bd38cf89326a825a38b8"
+      "hash": "aa7e2a39058660c4c803ed6e1bed94da0559aa943998336d6f0c83d8930a1d9d"
     },
     {
       "name": "alphafox-engine-backtest",
-      "version": "0.3.6",
+      "version": "0.3.7",
       "files": [
         {
           "path": "SKILL.md",
-          "sha256": "176c329a665709461403671d34e73dd5b58bf389a328010c8a32cec5b949a9c5",
-          "size": 7346
+          "sha256": "e09e938c9dd90d0be156b2d8bd83ba854c4d1a190a1b4aa575ca67db70184ebc",
+          "size": 7584
         }
       ],
-      "hash": "23db5ab285f8600a43561ce3d4b7641ea45cd55c7c3b16d9f6fb7ff0c862b379"
+      "hash": "91de2131ffde0b9fef16221d5589a8c430ae48ddfc4f2dc781d510b9d4c90532"
     },
     {
       "name": "alphafox-exchange",
-      "version": "0.3.6",
+      "version": "0.3.7",
       "files": [
         {
           "path": "SKILL.md",
-          "sha256": "089db4794cd55ba04278d4616cd6d5e92bc4c1d4c7c183001ea363bc4eeba578",
+          "sha256": "53cba327c5507266b4dca7193fad67ba33c0c7bb745be41fd194425b9ef5928e",
           "size": 743
         }
       ],
-      "hash": "d4b0fe876ced82185eb477a23420cb24a8990f3dcbb6d4d5e9412dfd4cd2c279"
+      "hash": "910f451fc7939926cfbeee27ee72f2aae86fcdd78f343e9f02c30df105ac6480"
     },
     {
       "name": "alphafox-market",
-      "version": "0.3.6",
+      "version": "0.3.7",
       "files": [
         {
           "path": "SKILL.md",
-          "sha256": "79fd7431c119b9d9318566c0419e2820ad9b06f0fda2882fdf9d1d7f4c1b9566",
-          "size": 1801
+          "sha256": "6589628478dc9c98c20479a2ffdded4014ce71b9c488dd386a606fef25a37d26",
+          "size": 3078
         }
       ],
-      "hash": "8814883b9b5bfb7eab4406fe1236091410dcb1130d4904dae8756e1302a02687"
+      "hash": "84d243b7c53c519cba34c8c487ba23eae60bde8440c4dcfff06e20efd63c07fa"
     },
     {
       "name": "alphafox-notification",
-      "version": "0.3.6",
+      "version": "0.3.7",
       "files": [
         {
           "path": "SKILL.md",
-          "sha256": "9a90360b83b72bb252349612cb052ffded40d00e07ca8568b76a6b13479252ac",
+          "sha256": "8b985ff7f33696eb11427147cd021d32654f525eea54f8098f368e8750a59381",
           "size": 698
         }
       ],
-      "hash": "99f8309b235b2b89734ed49d0a9e0e8981b5216025815fbe69f9101cf4f412cc"
+      "hash": "1f316dc3fe251699b3f90102cbc16cb4fbd3a3c5c07b923297c075fe2e73a4b3"
     },
     {
       "name": "alphafox-shared",
-      "version": "0.3.6",
+      "version": "0.3.7",
       "files": [
         {
           "path": "SKILL.md",
-          "sha256": "60051a6c9b789e306ec968d3c8762a75039c34a0db2470dfddd1063bf2a3553f",
-          "size": 5071
+          "sha256": "3aac1ab46a759a2c6748516936f886ec028e680bff7deb3ff1abc51af99ed18a",
+          "size": 5163
         }
       ],
-      "hash": "20832738f9f15063291309871197b6274fd24f2630bd2525092ac017f7491b68"
+      "hash": "72a7255ab23ff7c1adf41b1ff2e22834d1b58ee9e2ccea990c64f9277bf8b0a3"
     },
     {
       "name": "alphafox-strategy",
-      "version": "0.3.6",
+      "version": "0.3.7",
       "files": [
         {
           "path": "SKILL.md",
-          "sha256": "e4188e115eca6610c482bbcdf11ab1eb455cb5b6f242af96d1d8090e6ce9ce9d",
-          "size": 1450
+          "sha256": "1ef2a00dd1c74922a3d0248041813609fc58701e7857bb069cbed511b0c46168",
+          "size": 1826
         }
       ],
-      "hash": "878fd5c365eb33a431e91f6922a8cf45bcf94a7136b0105d50f3b487112c3573"
+      "hash": "44c2bf74ff053977f3a8631115ebf868af7cff33856e0c6a4fe55080049c1ae1"
     },
     {
       "name": "alphafox-trading",
-      "version": "0.3.6",
+      "version": "0.3.7",
       "files": [
         {
           "path": "SKILL.md",
-          "sha256": "098e0f975ae9f0169b0da696b76e74ffd3c6748e898e7c4f8c8f8a33aec47dc8",
-          "size": 1435
+          "sha256": "db065fcc272e66d091cfe7469317d7911946f96094f475f64d34d201c392424c",
+          "size": 3122
         }
       ],
-      "hash": "99b72870808f871ddeffd69ee89872e8532f2847494a0e5ad83de48ad58c675a"
+      "hash": "af36dc51e47ca91cb4a2f5ca78e03e17f003ee47b5354cef42947f401fbe48c0"
     }
   ]
 }

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.6";
+export declare const CLI_VERSION = "0.3.7";
 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.6";
+exports.CLI_VERSION = "0.3.7";
 var operations_1 = require("./catalog/operations");
 Object.defineProperty(exports, "CLI_CONTRACT_VERSION", { enumerable: true, get: function () { return operations_1.CATALOG_VERSION; } });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alphafox/cli",
-  "version": "0.3.6",
+  "version": "0.3.7",
   "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.6
+version: 0.3.7
 ---
 
 # 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.6
+version: 0.3.7
 ---
 
 # Admin

package/skills/alphafox/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: alphafox
-description: AlphaFox CLI entry router. Use for any AlphaFox request — install, update, login, whoami, 回测, engine backtest, strategy chat, traders, ticker/标的 resolve, market data, exchange connectors, wallet, subscriptions, notifications, or admin. If a CLI command prints `[alphafox] update available`, ask the user「检测到新的版本，是否需要我帮你升级？」and only then run `alphafox update --format json --no-input`. Start here, then open the routed domain skill. Do not guess alphafox-engine-backtest vs alphafox-strategy from memory.
-version: 0.3.6
+description: AlphaFox CLI entry router. Use for any AlphaFox request — install, update, login, whoami, 回测, engine backtest, strategy definitions, create/list/start/stop a running strategy (trader), ticker/标的 resolve (美股 or crypto), market data, exchange connectors, wallet, subscriptions, notifications, or admin. If a CLI command prints `[alphafox] update available`, ask the user「检测到新的版本，是否需要我帮你升级？」and only then run `alphafox update --format json --no-input`. Start here, then open the routed domain skill. Do not guess alphafox-engine-backtest vs alphafox-strategy vs alphafox-trading from memory.
+version: 0.3.7
 ---
 
 # AlphaFox
@@ -10,7 +10,9 @@ This skill only routes. After choosing a row, **read that skill's `SKILL.md` and
 
 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.
+Human-mentioned tickers go through `alphafox-market` (`alphafox resolve-symbols`) **before** they enter config, backtest, or writes. Keep the operator's asset class (美股 → `equity_perp` on `binance_perp_usdt`).
+
+A **trader** is a running strategy instance (paper or live), not a person. Creating a strategy means creating a trader.
 
 ## Route
 
@@ -18,23 +20,23 @@ Human-mentioned tickers go through `alphafox-market` (`alphafox resolve-symbols`
 |---|---|
 | Install, update, Skills status/sync, 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` |
+| Ticker / 标的 / 美股 / crypto / 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` |
+| Strategy types / definitions / validate config (grid, dca, copy, …) | `alphafox-strategy` |
+| Create, list, start, or stop a running strategy (trader), including copy | `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).
+If several rows apply, load **all** of them (typical: `alphafox-shared` + `alphafox-market` + one domain skill). “帮我建一个网格/DCA/跟单策略” → `alphafox-strategy` (pick the definition) **and** `alphafox-trading` (create the trader).
 
 ## Upgrade reminder
 
 The CLI may print this on **stderr** at most once every 24 hours:
 
 ```text
-[alphafox] update available: 0.3.5 -> 0.3.6. After the user confirms, run: alphafox update --format json --no-input
+[alphafox] update available: 0.3.6 -> 0.3.7. After the user confirms, run: alphafox update --format json --no-input,
 ```
 
 If you see that notice (or `updateAvailable: true` from `alphafox update --check`):
@@ -55,6 +57,6 @@ Do not install Skills from GitHub. Details and dry-run / check commands live in
 
 - 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`.
+- Web `/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,7 +1,7 @@
 ---
 name: alphafox-shared
 description: Shared AlphaFox CLI rules for Agents — auth, profiles, envelopes, risk gates, and public operationIds only.
-version: 0.3.6
+version: 0.3.7
 ---
 
 # AlphaFox shared Agent contract
@@ -76,7 +76,7 @@ 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`.
+User-mentioned tickers (including typos) must be resolved with `alphafox resolve-symbols` before they are written into config. See `skills/market`. 美股 are `equity_perp` on `binance_perp_usdt`; do not swap them for a crypto coin.
 
 1. Prefer typed catalog: `alphafox schema <operationId>` then invoke domain commands.
 2. Raw escape hatch only for allowlisted facade:
@@ -104,7 +104,7 @@ Uncataloged writes cannot carry a non-empty body. Find the `operationId` first.
 ## Risk
 
 - `high-risk-write` and uncataloged mutations (`unknown`) require `--yes` (exit code `10` if missing).
-- Prefer `--dry-run` first for trader start/stop, withdrawals, admin writes.
+- Prefer `--dry-run` first for trader create/start/stop, withdrawals, admin writes.
 - Never auto-retry unknown write outcomes.
 - CLI `--yes` is UX only; the server still enforces role, ownership, and scopes.
 

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.6
+version: 0.3.7
 ---
 
 # Auth Skill

package/skills/engine-backtest/SKILL.md

@@ -1,25 +1,25 @@
 ---
 name: alphafox-engine-backtest
 description: Local Engine WASM backtest (alphafox engine-backtest run|sweep) vs catalog experiment CRUD.
-version: 0.3.6
+version: 0.3.7
 ---
 
 # 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.
+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, and only when `assetClass` matches the operator (美股 → `equity_perp`). Local Engine tape is Binance-style USDT-M perps (`binance|okx|bybit|bitget|hyperliquid`), which is the same catalog that lists equity perps. Aster is in the public catalog but is **not** an Engine tape source. Do not rewrite `NVDA/USDT:USDT` into a crypto coin to force a backtest.
 
 ## 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 parameter search with explicit axes; persist one Sweep after completion | `alphafox engine-backtest sweep` | Never loop `runs.create` per coordinate. Do not call `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 | — | Not a CLI surface. Do not call `backtests.*` or `/api/v1/backtests` |
+| Web `/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/sweep payloads use `--config @file`, never a guessed `--body`.
 
@@ -110,4 +110,4 @@ Owner isolation and 7-day expiry are enforced by the server. Applying a coordina
 - `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.
+`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.6
+version: 0.3.7
 ---
 
 # Exchange connectors

package/skills/market/SKILL.md

@@ -1,33 +1,53 @@
 ---
 name: alphafox-market
-description: Market data, ticker resolution, and spread-radar readonly queries.
-version: 0.3.6
+description: Market data and ticker resolution for US equity perps, RWAs, and crypto on the same perp catalog. Use when the user names 美股, NVDA, AAPL, BTC, or any 标的. Keep the operator's asset class via symbolMetadata — do not rewrite NVDA into a crypto coin.
+version: 0.3.7
 ---
 
 # Market
 
 Always `--format json --no-input`. Prefer readonly scopes. No mock success if upstream fails.
 
-## Resolve tickers first
+## Asset class 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.
+Binance US stocks are **equity perps in the same** `binance_perp_usdt` catalog (`NVDA/USDT:USDT`). They are not a second exchange. `symbolMetadata` tags them:
+
+| Tag | Meaning |
+|---|---|
+| `assetClass: "equity_perp"` and `isTradFiRwa: true` | US stock perp (NVDA, AAPL, TSLA) |
+| `assetClass: "rwa_perp"` and `isTradFiRwa: true` | TradFi RWA perp (XAU, XAG) |
+| untagged / not TradFi | Crypto perp (BTC, ETH) |
+
+| Operator said | Resolve with |
+|---|---|
+| 美股 / US stocks / 持仓 / NVDA the company | `--exchange binance --asset-class equity_perp` |
+| 黄金 / 白银 / RWA | `--exchange binance --asset-class rwa_perp` |
+| BTC / ETH / 加密永续 | `--exchange binance` or `--asset-class crypto` |
+
+`NVDA/USDT:USDT` with `equity_perp` **is** the US stock product. Do not replace it with a different crypto base.
+
+## Resolve tickers
+
+Whenever a human mentions a stock, coin, ticker, or contract — including typos — resolve it **before** putting a symbol into strategy config, backtest, trader settings, or any write.
 
 ```bash
-alphafox resolve-symbols BTC ETH 龙虾 --exchange binance --format json --no-input
+alphafox resolve-symbols BTC ETH --exchange binance --format json --no-input
+alphafox resolve-symbols NVDA AAPL TSLA --exchange binance --asset-class equity_perp --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`.
+- This built-in loads `GET /api/v1/market/symbols?exchange=...` (includes `symbolMetadata`) and matches locally. Do not invent a symbol from memory. Do not pull a second ccxt universe.
+- Read `data.queries[]`. `resolved` is a catalog id such as `NVDA/USDT:USDT` or `BTC/USDT:USDT`. Also read `assetClass` and `isTradFiRwa` on the query and on `matches[]`.
+- `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. |
+| `exact` | Use `resolved` when `assetClass` matches the operator (美股 → `equity_perp`). |
+| `close` | One near match already in `resolved`. Confirm with the human, and confirm the asset class. |
+| `ambiguous` | `resolved` is null. Show `matches[].symbol` plus `assetClass` and ask the human to pick. Do not pick. |
+| `none` | Stop. Ask for another ticker. Do not invent a symbol and do not swap in a crypto coin. |
 
-Do not treat `close` as exact. Do not retry a failed resolve as a different exchange unless the operator names one.
+Do not treat `close` as exact. Do not retry a failed equity resolve as a different crypto base.
 
 Raw catalog dump (no matching):
 

package/skills/notification/SKILL.md

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

package/skills/strategy/SKILL.md

@@ -1,38 +1,40 @@
 ---
 name: alphafox-strategy
-description: Strategy definitions and chats via public operationIds.
-version: 0.3.6
+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.6
+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`