@backtest-kit/cli 16.5.0 → 17.0.0

package/build/index.cjs

@@ -233,14 +233,14 @@ const getReadySubject = functoolsKit.singleshot(() => {
     return new functoolsKit.Subject();
 });
 
-const main$j = () => {
+const main$l = () => {
     const entrySubject = getEntrySubject();
     entrySubject.subscribe(async (path) => {
         console.log("Running", path);
         await getReadySubject().next();
     });
 };
-main$j();
+main$l();
 
 const ERROR_HANDLER_INSTALLED = Symbol.for("error-handler-installed");
 function dumpStackTrace(error) {
@@ -895,6 +895,10 @@ const getArgs = functoolsKit.singleshot(() => {
                 type: "boolean",
                 default: false,
             },
+            tune: {
+                type: "boolean",
+                default: false,
+            },
             commit: {
                 type: "string",
                 default: "",
@@ -2727,8 +2731,11 @@ class TelegramLogicService {
             const unSignalNotify = BacktestKit.listenSignalNotify(async (event) => {
                 await this.notifySignalInfo(event);
             });
+            const unGc = functoolsKit.Source.fromInterval(90000).connect(() => {
+                this.notifyOrderContinue.gc();
+            });
             const unConnect = () => this.connect.clear();
-            const unListen = functoolsKit.compose(() => unRisk(), () => unSignal(), () => unCommit(), () => unOrderFill(), () => unOrderReject(), () => unOrderContinue(), () => unOrderStop(), () => this.notifyOrderContinue.clear(), () => unSignalNotify(), () => unConnect());
+            const unListen = functoolsKit.compose(() => unRisk(), () => unSignal(), () => unCommit(), () => unOrderFill(), () => unOrderReject(), () => unOrderContinue(), () => unOrderStop(), () => this.notifyOrderContinue.clear(), () => unGc(), () => unSignalNotify(), () => unConnect());
             return () => {
                 STOP_BOT_FN();
                 unListen();
@@ -3676,14 +3683,14 @@ const cli = {
 };
 init();
 
-const MODES = ["backtest", "walker", "paper", "live", "main", "pine", "editor", "dump", "pnldebug", "brokerdebug", "simulator", "flush", "init", "docker", "help", "version"];
+const MODES = ["backtest", "walker", "paper", "live", "main", "pine", "editor", "dump", "pnldebug", "brokerdebug", "simulator", "tune", "flush", "init", "docker", "help", "version"];
 const ENTRY_PATH$1 = "./node_modules/@backtest-kit/cli/build/index.mjs";
 const HELP_TEXT$1 = `
 Example:
 
   node ${ENTRY_PATH$1} --help
 `.trimStart();
-const main$i = async () => {
+const main$k = async () => {
     if (!getEntry((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('index.cjs', document.baseURI).href)))) {
         return;
     }
@@ -3691,14 +3698,14 @@ const main$i = async () => {
     if (MODES.some((mode) => values[mode])) {
         return;
     }
-    process.stdout.write(`@backtest-kit/cli ${"16.5.0"}\n`);
+    process.stdout.write(`@backtest-kit/cli ${"17.0.0"}\n`);
     process.stdout.write("\n");
     process.stdout.write(`Run with --help to see available commands.\n`);
     process.stdout.write("\n");
     process.stdout.write(HELP_TEXT$1);
     process.exit(0);
 };
-main$i();
+main$k();
 
 const notifyShutdown = functoolsKit.singleshot(async () => {
     console.log("Graceful shutdown initiated.");
@@ -3714,7 +3721,7 @@ const flush = async (entryPoint) => {
         console.log(`Removed: ${target}`);
     }
 };
-const main$h = async () => {
+const main$j = async () => {
     if (!getEntry((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('index.cjs', document.baseURI).href)))) {
         return;
     }
@@ -3731,7 +3738,7 @@ const main$h = async () => {
     }
     process.exit(0);
 };
-main$h();
+main$j();
 
 const BEFORE_EXIT_FN$6 = functoolsKit.singleshot(async () => {
     process.off("SIGINT", BEFORE_EXIT_FN$6);
@@ -3754,7 +3761,7 @@ const BEFORE_EXIT_FN$6 = functoolsKit.singleshot(async () => {
 const listenGracefulShutdown$6 = functoolsKit.singleshot(() => {
     process.on("SIGINT", BEFORE_EXIT_FN$6);
 });
-const main$g = async () => {
+const main$i = async () => {
     if (!getEntry((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('index.cjs', document.baseURI).href)))) {
         return;
     }
@@ -3772,7 +3779,7 @@ const main$g = async () => {
     await cli.backtestMainService.connect();
     listenGracefulShutdown$6();
 };
-main$g();
+main$i();
 
 const BEFORE_EXIT_FN$5 = functoolsKit.singleshot(async () => {
     process.off("SIGINT", BEFORE_EXIT_FN$5);
@@ -3791,7 +3798,7 @@ const BEFORE_EXIT_FN$5 = functoolsKit.singleshot(async () => {
 const listenGracefulShutdown$5 = functoolsKit.singleshot(() => {
     process.on("SIGINT", BEFORE_EXIT_FN$5);
 });
-const main$f = async () => {
+const main$h = async () => {
     if (!getEntry((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('index.cjs', document.baseURI).href)))) {
         return;
     }
@@ -3810,7 +3817,7 @@ const main$f = async () => {
     listenGracefulShutdown$5();
     await cli.walkerMainService.connect();
 };
-main$f();
+main$h();
 
 const BEFORE_EXIT_FN$4 = functoolsKit.singleshot(async () => {
     process.off("SIGINT", BEFORE_EXIT_FN$4);
@@ -3832,7 +3839,7 @@ const BEFORE_EXIT_FN$4 = functoolsKit.singleshot(async () => {
 const listenGracefulShutdown$4 = functoolsKit.singleshot(() => {
     process.on("SIGINT", BEFORE_EXIT_FN$4);
 });
-const main$e = async () => {
+const main$g = async () => {
     if (!getEntry((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('index.cjs', document.baseURI).href)))) {
         return;
     }
@@ -3846,7 +3853,7 @@ const main$e = async () => {
     await cli.paperMainService.connect();
     listenGracefulShutdown$4();
 };
-main$e();
+main$g();
 
 const BEFORE_EXIT_FN$3 = functoolsKit.singleshot(async () => {
     process.off("SIGINT", BEFORE_EXIT_FN$3);
@@ -3868,7 +3875,7 @@ const BEFORE_EXIT_FN$3 = functoolsKit.singleshot(async () => {
 const listenGracefulShutdown$3 = functoolsKit.singleshot(() => {
     process.on("SIGINT", BEFORE_EXIT_FN$3);
 });
-const main$d = async () => {
+const main$f = async () => {
     if (!getEntry((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('index.cjs', document.baseURI).href)))) {
         return;
     }
@@ -3882,7 +3889,7 @@ const main$d = async () => {
     await cli.liveMainService.connect();
     listenGracefulShutdown$3();
 };
-main$d();
+main$f();
 
 const stopBacktestList$1 = async () => {
     for (const item of await BacktestKit.Backtest.list()) {
@@ -3946,7 +3953,7 @@ const BEFORE_EXIT_FN$2 = functoolsKit.singleshot(async () => {
 const listenGracefulShutdown$2 = functoolsKit.singleshot(() => {
     process.on("SIGINT", BEFORE_EXIT_FN$2);
 });
-const main$c = async () => {
+const main$e = async () => {
     if (!getEntry((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('index.cjs', document.baseURI).href)))) {
         return;
     }
@@ -4002,7 +4009,7 @@ const main$c = async () => {
     listenGracefulShutdown$2();
     await cli.resolveService.attachEntry(path.resolve(cwd, entryPoint));
 };
-main$c();
+main$e();
 
 const MODE_MODULE = {
     backtest: "backtest.module",
@@ -4105,7 +4112,7 @@ const createGracefulShutdown = (mode) => {
         process.on("SIGINT", handler);
     });
 };
-const main$b = async () => {
+const main$d = async () => {
     if (!getEntry((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('index.cjs', document.baseURI).href)))) {
         return;
     }
@@ -4181,7 +4188,7 @@ const main$b = async () => {
     }
     await getEntrySubject().next(absolutePath);
 };
-main$b();
+main$d();
 
 const BEFORE_EXIT_FN$1 = functoolsKit.singleshot(async () => {
     process.off("SIGINT", BEFORE_EXIT_FN$1);
@@ -4192,7 +4199,7 @@ const BEFORE_EXIT_FN$1 = functoolsKit.singleshot(async () => {
 const listenGracefulShutdown$1 = functoolsKit.singleshot(() => {
     process.on("SIGINT", BEFORE_EXIT_FN$1);
 });
-const main$a = async () => {
+const main$c = async () => {
     if (!getEntry((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('index.cjs', document.baseURI).href)))) {
         return;
     }
@@ -4202,7 +4209,7 @@ const main$a = async () => {
     }
     listenGracefulShutdown$1();
 };
-main$a();
+main$c();
 
 const BEFORE_EXIT_FN = functoolsKit.singleshot(async () => {
     process.off("SIGINT", BEFORE_EXIT_FN);
@@ -4213,7 +4220,7 @@ const BEFORE_EXIT_FN = functoolsKit.singleshot(async () => {
 const listenGracefulShutdown = functoolsKit.singleshot(() => {
     process.on("SIGINT", BEFORE_EXIT_FN);
 });
-const main$9 = async () => {
+const main$b = async () => {
     if (!getEntry((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('index.cjs', document.baseURI).href)))) {
         return;
     }
@@ -4223,7 +4230,7 @@ const main$9 = async () => {
     }
     listenGracefulShutdown();
 };
-main$9();
+main$b();
 
 const EXTRACT_ROWS_FN = (plots, schema) => {
     const keys = Object.keys(schema);
@@ -4245,7 +4252,7 @@ const EXTRACT_ROWS_FN = (plots, schema) => {
     }
     return rows;
 };
-const main$8 = async () => {
+const main$a = async () => {
     if (!getEntry((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('index.cjs', document.baseURI).href)))) {
         return;
     }
@@ -4345,9 +4352,9 @@ const main$8 = async () => {
     console.log(await BacktestKitPinets.toMarkdown(signalId, plots, signalSchema));
     process.exit(0);
 };
-main$8();
+main$a();
 
-const main$7 = async () => {
+const main$9 = async () => {
     if (!getEntry((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('index.cjs', document.baseURI).href)))) {
         return;
     }
@@ -4410,9 +4417,9 @@ const main$7 = async () => {
     };
     process.on("SIGINT", beforeExit);
 };
-main$7();
+main$9();
 
-const main$6 = async () => {
+const main$8 = async () => {
     if (!getEntry((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('index.cjs', document.baseURI).href)))) {
         return;
     }
@@ -4493,9 +4500,9 @@ const main$6 = async () => {
     console.log(JSON.stringify(candles, null, 2));
     process.exit(0);
 };
-main$6();
+main$8();
 
-const main$5 = async () => {
+const main$7 = async () => {
     if (!getEntry((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('index.cjs', document.baseURI).href)))) {
         return;
     }
@@ -4609,11 +4616,326 @@ const main$5 = async () => {
     }
     process.exit(0);
 };
-main$5();
+main$7();
 
-const SIMULATOR_NAME = "cli_simulator";
-const IDEA_DIRECTIONS = ["LONG", "SHORT", "NEUTRAL"];
-const validateIdea = (idea, line) => {
+const getBroker = functoolsKit.singleshot(() => {
+    // Reaches into BrokerAdapter internals on purpose: the public commit*
+    // methods skip when payload.backtest=true and require enable(), while
+    // brokerdebug must fire exactly one commit at the raw adapter proxy.
+    const broker = BacktestKit.Broker["getInstance"]();
+    if (!broker) {
+        throw new Error("Broker instance is not initialized.");
+    }
+    return broker;
+});
+/** Called when a new signal is opened (position entry confirmed). */
+const commitOrderOpen = functoolsKit.trycatch(async (payload) => {
+    const broker = getBroker();
+    return await broker.onOrderOpenCommit(payload);
+}, {
+    fallback: (error) => {
+        console.log(error);
+        process.exit(-1);
+    },
+});
+/** Called when a new signal is closed (take-profit, stop-loss, or manual close). */
+const commitOrderClose = functoolsKit.trycatch(async (payload) => {
+    const broker = getBroker();
+    return await broker.onOrderCloseCommit(payload);
+}, {
+    fallback: (error) => {
+        console.log(error);
+        process.exit(-1);
+    },
+});
+/** Called when a partial profit close is committed. */
+const commitPartialProfit = functoolsKit.trycatch(async (payload) => {
+    const broker = getBroker();
+    return await broker.onPartialProfitCommit(payload);
+}, {
+    fallback: (error) => {
+        console.log(error);
+        process.exit(-1);
+    },
+});
+/** Called when a partial loss close is committed. */
+const commitPartialLoss = functoolsKit.trycatch(async (payload) => {
+    const broker = getBroker();
+    return await broker.onPartialLossCommit(payload);
+}, {
+    fallback: (error) => {
+        console.log(error);
+        process.exit(-1);
+    },
+});
+/** Called when a trailing stop update is committed. */
+const commitTrailingStop = functoolsKit.trycatch(async (payload) => {
+    const broker = getBroker();
+    return await broker.onTrailingStopCommit(payload);
+}, {
+    fallback: (error) => {
+        console.log(error);
+        process.exit(-1);
+    },
+});
+/** Called when a trailing take-profit update is committed. */
+const commitTrailingTake = functoolsKit.trycatch(async (payload) => {
+    const broker = getBroker();
+    return await broker.onTrailingTakeCommit(payload);
+}, {
+    fallback: (error) => {
+        console.log(error);
+        process.exit(-1);
+    },
+});
+/** Called when a breakeven stop is committed (stop loss moved to entry price). */
+const commitBreakeven = functoolsKit.trycatch(async (payload) => {
+    const broker = getBroker();
+    return await broker.onBreakevenCommit(payload);
+}, {
+    fallback: (error) => {
+        console.log(error);
+        process.exit(-1);
+    },
+});
+/** Called when a DCA (average-buy) entry is committed. */
+const commitAverageBuy = functoolsKit.trycatch(async (payload) => {
+    const broker = getBroker();
+    return await broker.onAverageBuyCommit(payload);
+}, {
+    fallback: (error) => {
+        console.log(error);
+        process.exit(-1);
+    },
+});
+const COMMITS = [
+    "signal-open",
+    "signal-close",
+    "partial-profit",
+    "partial-loss",
+    "average-buy",
+    "trailing-stop",
+    "trailing-take",
+    "breakeven",
+];
+const ZERO_PNL = {
+    pnlPercentage: 0,
+    priceOpen: 0,
+    priceClose: 0,
+    pnlCost: 0,
+    pnlEntries: 0,
+};
+const main$6 = async () => {
+    if (!getEntry((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('index.cjs', document.baseURI).href)))) {
+        return;
+    }
+    const { values } = getArgs();
+    if (!values.brokerdebug) {
+        return;
+    }
+    {
+        const cwd = process.cwd();
+        dotenv.config({ path: path.join(cwd, '.env'), override: true, quiet: true });
+    }
+    await cli.configConnectionService.loadConfig("setup.config");
+    {
+        const loader = await cli.configConnectionService.loadConfig("loader.config");
+        try {
+            if (typeof loader === "function") {
+                await loader();
+            }
+            if (typeof loader?.loader === "function") {
+                await loader.loader();
+            }
+        }
+        catch (error) {
+            console.error("Module loader failed", error);
+            process.exit(-1);
+        }
+    }
+    await cli.moduleConnectionService.loadModule("brokerdebug.module");
+    const [defaultExchangeName = null] = await BacktestKit.listExchangeSchema();
+    const exchangeName = values.exchange || defaultExchangeName?.exchangeName;
+    const symbol = values.symbol || "BTCUSDT";
+    const commit = values.commit || "signal-open";
+    if (!COMMITS.includes(commit)) {
+        console.error(`Unknown --commit value: ${commit}`);
+        console.error(`Available: ${COMMITS.join(", ")}`);
+        process.exit(1);
+    }
+    const candles = await BacktestKit.Exchange.getCandles(symbol, "1m", 5, { exchangeName });
+    const lastCandle = candles[candles.length - 1];
+    const currentPrice = lastCandle.close;
+    const priceTakeProfit = currentPrice * 1.02;
+    const priceStopLoss = currentPrice * 0.98;
+    const context = {
+        strategyName: "broker-test",
+        exchangeName: exchangeName,
+    };
+    const signalId = `broker-debug-${Date.now()}`;
+    const when = BacktestKit.alignToInterval(new Date(), "1m");
+    {
+        console.log(`symbol=${symbol} price=${currentPrice} commit=${commit}`);
+        console.time(commit);
+    }
+    const run = async () => {
+        if (commit === "signal-open") {
+            await commitOrderOpen({
+                type: "active",
+                symbol,
+                signalId,
+                cost: 100,
+                position: "long",
+                priceOpen: currentPrice,
+                priceTakeProfit,
+                priceStopLoss,
+                pnl: ZERO_PNL,
+                peakProfit: ZERO_PNL,
+                maxDrawdown: ZERO_PNL,
+                attempt: 0,
+                context,
+                when,
+                backtest: true,
+            });
+        }
+        if (commit === "signal-close") {
+            await commitOrderClose({
+                symbol,
+                signalId,
+                cost: 100,
+                position: "long",
+                currentPrice,
+                priceOpen: currentPrice,
+                priceTakeProfit,
+                priceStopLoss,
+                totalEntries: 1,
+                totalPartials: 0,
+                attempt: 0,
+                pnl: ZERO_PNL,
+                peakProfit: ZERO_PNL,
+                maxDrawdown: ZERO_PNL,
+                context,
+                when,
+                backtest: true,
+            });
+        }
+        if (commit === "partial-profit") {
+            await commitPartialProfit({
+                symbol,
+                signalId,
+                percentToClose: 50,
+                cost: 50,
+                currentPrice,
+                position: "long",
+                priceTakeProfit,
+                priceStopLoss,
+                context,
+                when,
+                backtest: true,
+            });
+        }
+        if (commit === "partial-loss") {
+            await commitPartialLoss({
+                symbol,
+                signalId,
+                percentToClose: 50,
+                cost: 50,
+                currentPrice,
+                position: "long",
+                priceTakeProfit,
+                priceStopLoss,
+                context,
+                when,
+                backtest: true,
+            });
+        }
+        if (commit === "average-buy") {
+            await commitAverageBuy({
+                symbol,
+                signalId,
+                currentPrice,
+                cost: 100,
+                position: "long",
+                priceTakeProfit,
+                priceStopLoss,
+                context,
+                when,
+                backtest: true,
+            });
+        }
+        if (commit === "trailing-stop") {
+            await commitTrailingStop({
+                symbol,
+                signalId,
+                percentShift: -50,
+                currentPrice,
+                newStopLossPrice: priceStopLoss + (currentPrice - priceStopLoss) * 0.5,
+                takeProfitPrice: priceTakeProfit,
+                position: "long",
+                context,
+                when,
+                backtest: true,
+            });
+        }
+        if (commit === "trailing-take") {
+            await commitTrailingTake({
+                symbol,
+                signalId,
+                percentShift: 50,
+                currentPrice,
+                newTakeProfitPrice: priceTakeProfit + (priceTakeProfit - currentPrice) * 0.5,
+                takeProfitPrice: priceTakeProfit,
+                position: "long",
+                context,
+                when,
+                backtest: true,
+            });
+        }
+        if (commit === "breakeven") {
+            await commitBreakeven({
+                symbol,
+                signalId,
+                currentPrice,
+                newStopLossPrice: currentPrice,
+                newTakeProfitPrice: priceTakeProfit,
+                position: "long",
+                context,
+                when,
+                backtest: true,
+            });
+        }
+    };
+    await BacktestKit.runInMockContext(run, {
+        when,
+        strategyName: context.strategyName,
+        exchangeName: context.exchangeName,
+        frameName: "",
+        symbol,
+        backtest: true,
+    });
+    {
+        console.log(`${commit} OK`);
+        console.timeEnd(commit);
+    }
+    process.exit(0);
+};
+main$6();
+
+const SIMULATOR_NAME$1 = "cli_simulator";
+const CONFIG_KEYS$1 = ["gridAxes", "reportOrder"];
+const validateConfig$1 = (config) => {
+    if (typeof config !== "object" || config === null || Array.isArray(config)) {
+        return "config must be a JSON object";
+    }
+    for (const key of Object.keys(config)) {
+        if (!CONFIG_KEYS$1.includes(key)) {
+            return `unknown key "${key}" (expected: ${CONFIG_KEYS$1.join(", ")})`;
+        }
+    }
+    return null;
+};
+const IDEA_DIRECTIONS$1 = ["LONG", "SHORT", "NEUTRAL"];
+const validateIdea$1 = (idea, line) => {
     if (typeof idea !== "object" || idea === null) {
         return `line ${line}: not an object`;
     }
@@ -4626,15 +4948,18 @@ const validateIdea = (idea, line) => {
     if (typeof idea.symbol !== "string" || !idea.symbol) {
         return `line ${line}: "symbol" must be a non-empty string`;
     }
-    if (!IDEA_DIRECTIONS.includes(idea.direction)) {
-        return `line ${line}: "direction" must be one of ${IDEA_DIRECTIONS.join("|")}, got ${JSON.stringify(idea.direction)}`;
+    if (!IDEA_DIRECTIONS$1.includes(idea.direction)) {
+        return `line ${line}: "direction" must be one of ${IDEA_DIRECTIONS$1.join("|")}, got ${JSON.stringify(idea.direction)}`;
     }
     if (typeof idea.author !== "string" || !idea.author) {
         return `line ${line}: "author" must be a non-empty string`;
     }
     return null;
 };
-const toMarkdown = (result) => {
+const toMarkdown$1 = (result) => {
+    const buckets = Object.entries(result.reports).filter(([, bucket]) => bucket.reports.length > 0);
+    const allReports = buckets.flatMap(([, bucket]) => bucket.reports);
+    const profitable = allReports.filter(({ totalPnlPercent }) => totalPnlPercent > 0).length;
     const lines = [];
     lines.push(`# Simulator Report — ${result.symbol}`);
     lines.push("");
@@ -4642,34 +4967,38 @@ const toMarkdown = (result) => {
     lines.push(`| --- | --- |`);
     lines.push(`| Ideas (total / directional) | ${result.ideasTotal} / ${result.ideasDirectional} |`);
     lines.push(`| Profiles (truncated) | ${result.profileCount} (${result.truncatedCount}) |`);
-    lines.push(`| Authors allowed / banned | ${result.allowedAuthors.length} / ${result.bannedAuthors.length} |`);
-    lines.push(`| Grid points | ${result.reports.length} |`);
+    lines.push(`| Profitable corridor | ${profitable} / ${allReports.length} grid points |`);
     lines.push(`| Hold minutes avg / p95 / p99 | ${result.avgHoldMinutes.toFixed(0)} / ${result.p95HoldMinutes} / ${result.p99HoldMinutes} |`);
-    lines.push("");
-    lines.push(`## Ranking winners`);
-    lines.push("");
-    lines.push(`| Criterion | Stop% | Trailing% | Hold | Aligned | Track | HitRate | Trades | PNL% | WinRate | Sharpe | Sortino |`);
-    lines.push(`| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |`);
-    for (const best of result.best) {
-        if (!best.report) {
-            lines.push(`| ${best.criterion} | — | — | — | — | — | — | — | — | — | — | — |`);
-            continue;
+    // каждая метрика — самодостаточная корзина: свои победители и
+    // свои словари банов, между собой не склеиваются
+    for (const [metric, bucket] of buckets) {
+        lines.push("");
+        lines.push(`## Metric: ${metric}`);
+        lines.push("");
+        lines.push(`| Criterion | Stop% | Hold | Track | HitRate | Trades | PNL% | WinRate | Sharpe | Sortino |`);
+        lines.push(`| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |`);
+        for (const best of bucket.best) {
+            if (!best.report) {
+                lines.push(`| ${best.criterion} | — | — | — | — | — | — | — | — | — |`);
+                continue;
+            }
+            const { point } = best.report;
+            lines.push(`| ${best.criterion} | ${point.hardStopPercent} | ${point.holdMinutes / 60}h | ${point.minAuthorTrack} | ${point.minAuthorHitRate} | ` +
+                `${best.report.trades} | ${best.report.totalPnlPercent.toFixed(2)}% | ${(best.report.winRate * 100).toFixed(0)}% | ${best.report.sharpe.toFixed(2)} | ${best.report.sortino.toFixed(2)} |`);
+        }
+        const sharpeBest = bucket.best.find(({ criterion }) => criterion === "sharpe");
+        lines.push("");
+        lines.push(`### Allowed authors (sharpe winner rule)`);
+        lines.push("");
+        lines.push(`| Author | Ideas | Hits | HitRate |`);
+        lines.push(`| --- | --- | --- | --- |`);
+        for (const stat of (sharpeBest?.authorStats ?? []).filter(({ banned }) => !banned)) {
+            lines.push(`| ${stat.author} | ${stat.ideas} | ${stat.hits} | ${(stat.hitRate * 100).toFixed(0)}% |`);
         }
-        const { point } = best.report;
-        lines.push(`| ${best.criterion} | ${point.hardStopPercent} | ${point.trailingTakePercent} | ${point.holdMinutes / 60}h | ${point.minIdeasAligned} | ${point.minAuthorTrack} | ${point.minAuthorHitRate} | ` +
-            `${best.report.trades} | ${best.report.totalPnlPercent.toFixed(2)}% | ${(best.report.winRate * 100).toFixed(0)}% | ${best.report.sharpe.toFixed(2)} | ${best.report.sortino.toFixed(2)} |`);
-    }
-    lines.push("");
-    lines.push(`## Allowed authors (production whitelist)`);
-    lines.push("");
-    lines.push(`| Author | Ideas | Hits | HitRate |`);
-    lines.push(`| --- | --- | --- | --- |`);
-    for (const stat of result.authorStats.filter(({ banned }) => !banned)) {
-        lines.push(`| ${stat.author} | ${stat.ideas} | ${stat.hits} | ${(stat.hitRate * 100).toFixed(0)}% |`);
     }
     return lines.join("\n");
 };
-const main$4 = async () => {
+const main$5 = async () => {
     if (!getEntry((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('index.cjs', document.baseURI).href)))) {
         return;
     }
@@ -4682,6 +5011,33 @@ const main$4 = async () => {
         console.error("Error: positional path to an ideas .jsonl file is required");
         process.exit(1);
     }
+    // конфиг — позиционный JSON; без него подтягивается пустой объект
+    // и схема живёт на дефолтах движка (оси, порядок отчёта)
+    const [configPath = null] = positionals.filter((value) => value.endsWith(".json") && !value.endsWith(".jsonl"));
+    let config = {};
+    if (configPath) {
+        let content;
+        try {
+            content = await fs$1.readFile(path.resolve(configPath), "utf-8");
+        }
+        catch (error) {
+            console.error(`Error: cannot read config file: ${configPath}`);
+            process.exit(1);
+        }
+        try {
+            config = JSON.parse(content);
+        }
+        catch {
+            console.error(`Error: invalid JSON in config file: ${configPath}`);
+            process.exit(1);
+        }
+        const problem = validateConfig$1(config);
+        if (problem) {
+            console.error(`Error: simulator config does not match the structure — ${problem}`);
+            console.error(`Expected shape: { "gridAxes"?: ISimulatorGridAxes, "reportOrder"?: "sharpe"|"sortino"|"pnl"|"recovery" }`);
+            process.exit(1);
+        }
+    }
     let ideas = [];
     {
         let content;
@@ -4706,7 +5062,7 @@ const main$4 = async () => {
                 console.error(`Error: invalid JSON in ideas file, line ${i + 1}`);
                 process.exit(1);
             }
-            const problem = validateIdea(idea, i + 1);
+            const problem = validateIdea$1(idea, i + 1);
             if (problem) {
                 console.error(`Error: ideas file does not match the idea structure — ${problem}`);
                 console.error(`Expected shape: { "id": number, "ts": number, "symbol": string, "direction": "LONG"|"SHORT"|"NEUTRAL", "author": string }`);
@@ -4742,20 +5098,24 @@ const main$4 = async () => {
     }
     const [defaultExchangeName = null] = await BacktestKit.listExchangeSchema();
     const exchangeName = values.exchange || defaultExchangeName?.exchangeName;
+    if (values.verbose) {
+        BacktestKit.overrideExchangeSchema({
+            exchangeName,
+            callbacks: {
+                onCandleData(symbol, interval, since) {
+                    console.log(`Received candle data for symbol: ${symbol}, interval: ${interval}, since: ${since.toUTCString()}`);
+                },
+            },
+        });
+    }
     const symbol = values.symbol || "BTCUSDT";
+    // оси и порядок отчёта приходят позиционным конфигом потребителя;
+    // пустой конфиг — дефолтная сетка движка из connection-сервиса
     BacktestKit.addSimulatorSchema({
-        simulatorName: SIMULATOR_NAME,
+        simulatorName: SIMULATOR_NAME$1,
         exchangeName,
-        gridAxes: {
-            hardStopPercent: [1, 1.5, 2, 2.5, 3, 4, 5, 7],
-            trailingTakePercent: [0.5, 1, 1.5, 2, 3, 4],
-            holdMinutes: [24 * 60, 2 * 24 * 60, 3 * 24 * 60],
-            minIdeasAligned: [1, 2, 3],
-            minAuthorTrack: [2, 3, 5],
-            minAuthorHitRate: [0.5, 0.6],
-            minWeightAligned: [0, 0.6, 1.2],
-            profitLockPercent: [0, 1.5, 2.5],
-        },
+        ...(config.gridAxes ? { gridAxes: config.gridAxes } : {}),
+        ...(config.reportOrder ? { reportOrder: config.reportOrder } : {}),
         callbacks: {
             onProgress: (symbol, stage, processed, total) => {
                 if (values.verbose) {
@@ -4807,9 +5167,8 @@ const main$4 = async () => {
                 if (values.verbose) {
                     console.log("onDone", {
                         symbol,
-                        reports: result.reports.length,
-                        allowedAuthors: result.allowedAuthors.length,
-                        bannedAuthors: result.bannedAuthors.length,
+                        reports: Object.values(result.reports).flatMap((bucket) => bucket.reports).length,
+                        bans: Object.values(result.reports).flatMap((bucket) => bucket.bans).length,
                     });
                 }
             },
@@ -4817,7 +5176,7 @@ const main$4 = async () => {
     });
     const result = await BacktestKit.Simulator.run({
         symbol,
-        simulatorName: SIMULATOR_NAME,
+        simulatorName: SIMULATOR_NAME$1,
         ideas,
     });
     const dumpName = values.output || `simulator_${symbol}_${Date.now()}`;
@@ -4832,11 +5191,308 @@ const main$4 = async () => {
     if (values.markdown) {
         const filePath = path.resolve(dumpDir, `${dumpName}.md`);
         await fs$1.mkdir(dumpDir, { recursive: true });
-        await fs$1.writeFile(filePath, toMarkdown(result), "utf-8");
+        await fs$1.writeFile(filePath, toMarkdown$1(result), "utf-8");
         console.log(`Saved: ${filePath}`);
         process.exit(0);
     }
-    console.log(toMarkdown(result));
+    console.log(toMarkdown$1(result));
+    process.exit(0);
+};
+main$5();
+
+const SIMULATOR_NAME = "cli_tune";
+const CONFIG_KEYS = ["point", "authorStats", "gridAxes", "reportOrder"];
+const POINT_NUMBER_FIELDS = [
+    "hardStopPercent",
+    "trailingTakePercent",
+    "holdMinutes",
+    "minAuthorTrack",
+    "minAuthorHitRate",
+    "profitLockPercent",
+];
+const IDEA_DIRECTIONS = ["LONG", "SHORT", "NEUTRAL"];
+const validateIdea = (idea, line) => {
+    if (typeof idea !== "object" || idea === null) {
+        return `line ${line}: not an object`;
+    }
+    if (typeof idea.id !== "number") {
+        return `line ${line}: "id" must be a number, got ${typeof idea.id}`;
+    }
+    if (typeof idea.ts !== "number") {
+        return `line ${line}: "ts" must be a number (unix ms), got ${typeof idea.ts}`;
+    }
+    if (typeof idea.symbol !== "string" || !idea.symbol) {
+        return `line ${line}: "symbol" must be a non-empty string`;
+    }
+    if (!IDEA_DIRECTIONS.includes(idea.direction)) {
+        return `line ${line}: "direction" must be one of ${IDEA_DIRECTIONS.join("|")}, got ${JSON.stringify(idea.direction)}`;
+    }
+    if (typeof idea.author !== "string" || !idea.author) {
+        return `line ${line}: "author" must be a non-empty string`;
+    }
+    return null;
+};
+const validateConfig = (config) => {
+    if (typeof config !== "object" || config === null || Array.isArray(config)) {
+        return "config must be a JSON object";
+    }
+    for (const key of Object.keys(config)) {
+        if (!CONFIG_KEYS.includes(key)) {
+            return `unknown key "${key}" (expected: ${CONFIG_KEYS.join(", ")})`;
+        }
+    }
+    if (typeof config.point !== "object" || config.point === null) {
+        return `"point" is required — the frozen grid point of a training run`;
+    }
+    for (const field of POINT_NUMBER_FIELDS) {
+        if (typeof config.point[field] !== "number") {
+            return `"point.${field}" must be a number, got ${typeof config.point[field]}`;
+        }
+    }
+    if (typeof config.point.authorMetric !== "string") {
+        return `"point.authorMetric" must be a string, got ${typeof config.point.authorMetric}`;
+    }
+    if (!Array.isArray(config.authorStats) || !config.authorStats.length) {
+        return `"authorStats" is required — the frozen raw track record (non-empty array)`;
+    }
+    for (let i = 0; i < config.authorStats.length; i++) {
+        const stat = config.authorStats[i];
+        if (typeof stat !== "object" ||
+            stat === null ||
+            typeof stat.author !== "string" ||
+            typeof stat.ideas !== "number" ||
+            typeof stat.hits !== "number") {
+            return `"authorStats[${i}]" must be { author: string, ideas: number, hits: number }`;
+        }
+    }
+    return null;
+};
+/** Одноточечные оси, зеркалящие замороженную точку — сетка инертна. */
+const axesFromPoint = (point) => ({
+    hardStopPercent: [point.hardStopPercent],
+    trailingTakePercent: [point.trailingTakePercent],
+    holdMinutes: [point.holdMinutes],
+    minAuthorTrack: [point.minAuthorTrack],
+    minAuthorHitRate: [point.minAuthorHitRate],
+    profitLockPercent: [point.profitLockPercent],
+    authorMetric: [point.authorMetric],
+});
+const pointLabel = (point) => `H=${point.hardStopPercent} TT=${point.trailingTakePercent} hold=${point.holdMinutes / 60}h ` +
+    `track=${point.minAuthorTrack} rate=${point.minAuthorHitRate} ` +
+    `lock=${point.profitLockPercent} metric=${point.authorMetric}`;
+const fmtRatio = (value) => Number.isFinite(value) ? value.toFixed(2) : "inf";
+const toMarkdown = (test) => {
+    const lines = [];
+    lines.push(`# Tune Report — ${test.symbol}`);
+    lines.push("");
+    lines.push(`ONE out-of-sample shot of a FROZEN training artifact: nothing is trained here — the point and the raw author track record come from the input config verbatim, bans are re-derived from the frozen numbers under the point's rule, unseen authors are banned by default.`);
+    lines.push("");
+    lines.push(`Frozen point: ${pointLabel(test.point)}`);
+    lines.push("");
+    lines.push(`## Out-of-sample (${test.ideasDirectional} directional ideas)`);
+    lines.push("");
+    lines.push(`| Metric | Value |`);
+    lines.push(`| --- | --- |`);
+    lines.push(`| Trades (skipped busy) | ${test.report.trades} (${test.report.skippedBusy}) |`);
+    lines.push(`| PNL | ${test.report.totalPnlPercent.toFixed(2)}% |`);
+    lines.push(`| Win rate | ${(test.report.winRate * 100).toFixed(0)}% |`);
+    lines.push(`| Profit factor | ${fmtRatio(test.report.profitFactor)} |`);
+    lines.push(`| Max series drawdown | ${test.report.maxSeriesDrawdownPercent.toFixed(2)}% |`);
+    lines.push(`| Sharpe / Sortino | ${fmtRatio(test.report.sharpe)} / ${fmtRatio(test.report.sortino)} |`);
+    lines.push(`| Recovery factor | ${fmtRatio(test.report.recoveryFactor)} |`);
+    lines.push(`| Exits | ${Object.entries(test.report.exitReasons).map(([reason, count]) => `${reason}=${count}`).join(", ")} |`);
+    lines.push("");
+    lines.push(`## Test trades`);
+    lines.push("");
+    lines.push(`| Direction | Exit | PNL% | Hold | Entry (UTC) |`);
+    lines.push(`| --- | --- | --- | --- | --- |`);
+    for (const trade of test.trades) {
+        lines.push(`| ${trade.direction} | ${trade.exitReason} | ${trade.pnlPercent.toFixed(2)} | ${trade.holdMinutesActual}m | ${new Date(trade.entryTimestamp).toISOString()} |`);
+    }
+    lines.push("");
+    lines.push(`## Frozen author track record (re-derived bans under the point's rule)`);
+    lines.push("");
+    lines.push(`| Author | Ideas | Hits | Banned |`);
+    lines.push(`| --- | --- | --- | --- |`);
+    for (const stat of test.authorStats) {
+        lines.push(`| ${stat.author} | ${stat.ideas} | ${stat.hits} | ${stat.banned ? "yes" : ""} |`);
+    }
+    return lines.join("\n");
+};
+const main$4 = async () => {
+    if (!getEntry((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('index.cjs', document.baseURI).href)))) {
+        return;
+    }
+    const { values, positionals } = getArgs();
+    if (!values.tune) {
+        return;
+    }
+    const [ideasPath = null] = positionals.filter((value) => value.endsWith(".jsonl"));
+    if (!ideasPath) {
+        console.error("Error: positional path to an ideas .jsonl file is required");
+        process.exit(1);
+    }
+    // конфиг — позиционный JSON; без него подтягивается пустой объект
+    // (и валидация честно скажет, что замороженной точки нет)
+    const [configPath = null] = positionals.filter((value) => value.endsWith(".json") && !value.endsWith(".jsonl"));
+    let config = {};
+    if (configPath) {
+        let content;
+        try {
+            content = await fs$1.readFile(path.resolve(configPath), "utf-8");
+        }
+        catch (error) {
+            console.error(`Error: cannot read config file: ${configPath}`);
+            process.exit(1);
+        }
+        try {
+            config = JSON.parse(content);
+        }
+        catch {
+            console.error(`Error: invalid JSON in config file: ${configPath}`);
+            process.exit(1);
+        }
+    }
+    {
+        const problem = validateConfig(config);
+        if (problem) {
+            console.error(`Error: tune config does not match the structure — ${problem}`);
+            console.error(`Expected shape: { "point": ISimulatorGridPoint, "authorStats": [{ "author", "ideas", "hits" }], "gridAxes"?, "reportOrder"? }`);
+            process.exit(1);
+        }
+    }
+    let ideas = [];
+    {
+        let content;
+        try {
+            content = await fs$1.readFile(path.resolve(ideasPath), "utf-8");
+        }
+        catch (error) {
+            console.error(`Error: cannot read ideas file: ${ideasPath}`);
+            process.exit(1);
+        }
+        const rows = content.split("\n").filter(Boolean);
+        if (!rows.length) {
+            console.error(`Error: ideas file is empty: ${ideasPath}`);
+            process.exit(1);
+        }
+        for (let i = 0; i < rows.length; i++) {
+            let idea;
+            try {
+                idea = JSON.parse(rows[i]);
+            }
+            catch {
+                console.error(`Error: invalid JSON in ideas file, line ${i + 1}`);
+                process.exit(1);
+            }
+            const problem = validateIdea(idea, i + 1);
+            if (problem) {
+                console.error(`Error: ideas file does not match the idea structure — ${problem}`);
+                console.error(`Expected shape: { "id": number, "ts": number, "symbol": string, "direction": "LONG"|"SHORT"|"NEUTRAL", "author": string }`);
+                process.exit(1);
+            }
+            ideas.push(idea);
+        }
+    }
+    {
+        const cwd = process.cwd();
+        dotenv.config({ path: path.join(cwd, '.env'), override: true, quiet: true });
+    }
+    await cli.configConnectionService.loadConfig("setup.config");
+    {
+        const loader = await cli.configConnectionService.loadConfig("loader.config");
+        try {
+            if (typeof loader === "function") {
+                await loader();
+            }
+            if (typeof loader?.loader === "function") {
+                await loader.loader();
+            }
+        }
+        catch (error) {
+            console.error("Module loader failed", error);
+            process.exit(-1);
+        }
+    }
+    await cli.moduleConnectionService.loadModule("tune.module");
+    {
+        await cli.exchangeSchemaService.addSchema();
+        await cli.symbolSchemaService.addSchema();
+    }
+    const [defaultExchangeName = null] = await BacktestKit.listExchangeSchema();
+    const exchangeName = values.exchange || defaultExchangeName?.exchangeName;
+    if (values.verbose) {
+        BacktestKit.overrideExchangeSchema({
+            exchangeName,
+            callbacks: {
+                onCandleData(symbol, interval, since) {
+                    console.log(`Received candle data for symbol: ${symbol}, interval: ${interval}, since: ${since.toUTCString()}`);
+                },
+            },
+        });
+    }
+    const symbol = values.symbol || "BTCUSDT";
+    // сетка для test() инертна (оценивается ровно замороженная точка):
+    // без явных осей в конфиге они одноточечно зеркалят точку
+    BacktestKit.addSimulatorSchema({
+        simulatorName: SIMULATOR_NAME,
+        exchangeName,
+        gridAxes: config.gridAxes ?? axesFromPoint(config.point),
+        ...(config.reportOrder ? { reportOrder: config.reportOrder } : {}),
+        callbacks: {
+            onProgress: (symbol, stage, processed, total) => {
+                if (values.verbose) {
+                    console.log("onProgress", { symbol, stage, processed, total });
+                }
+            },
+            onIdeas: (symbol, ideasTotal, ideasDirectional) => {
+                if (values.verbose) {
+                    console.log("onIdeas", { symbol, ideasTotal, ideasDirectional });
+                }
+            },
+            onProfiles: (symbol, profiles, truncatedCount) => {
+                if (values.verbose) {
+                    console.log("onProfiles", { symbol, profiles: profiles.length, truncatedCount });
+                }
+            },
+            onTestDone: (symbol, result) => {
+                if (values.verbose) {
+                    console.log("onTestDone", {
+                        symbol,
+                        trades: result.report.trades,
+                        pnl: +result.report.totalPnlPercent.toFixed(2),
+                    });
+                }
+            },
+        },
+    });
+    // только out-of-sample: обучения нет, точка и трек-рекорд приходят
+    // из конфига verbatim — test() перевыводит баны под правило точки,
+    // невиданные авторы забанены по умолчанию
+    const test = await BacktestKit.Simulator.test({
+        symbol,
+        simulatorName: SIMULATOR_NAME,
+        ideas,
+        point: config.point,
+        authorStats: config.authorStats,
+    });
+    const dumpName = values.output || `tune_${symbol}_${Date.now()}`;
+    const dumpDir = path.join(process.cwd(), "dump");
+    if (values.json) {
+        const filePath = path.resolve(dumpDir, `${dumpName}.json`);
+        await fs$1.mkdir(dumpDir, { recursive: true });
+        await fs$1.writeFile(filePath, JSON.stringify(test, null, 2), "utf-8");
+        console.log(`Saved: ${filePath}`);
+        process.exit(0);
+    }
+    if (values.markdown) {
+        const filePath = path.resolve(dumpDir, `${dumpName}.md`);
+        await fs$1.mkdir(dumpDir, { recursive: true });
+        await fs$1.writeFile(filePath, toMarkdown(test), "utf-8");
+        console.log(`Saved: ${filePath}`);
+        process.exit(0);
+    }
+    console.log(toMarkdown(test));
     process.exit(0);
 };
 main$4();
@@ -5037,7 +5693,8 @@ Modes:
   --dump                Fetch and save raw OHLCV candles
   --pnldebug            Simulate PnL per minute for a given entry price and direction
   --brokerdebug         Fire a single broker commit against the live broker adapter
-  --simulator <ideas.jsonl>  Sweep exit/entry parameters over crowd ideas, train author whitelist
+  --simulator <ideas.jsonl> [config.json]  Feasibility probe over crowd ideas: is there a profitable corridor at all
+  --tune      <ideas.jsonl> <config.json>   ONE out-of-sample shot of a frozen training artifact (point + author track)
   --flush  <entry...>   Delete report/log/markdown/agent folders from strategy dump dir
   --init                Scaffold a new project in the current directory
   --docker              Scaffold a Docker workspace for running strategies in a container
@@ -5167,16 +5824,22 @@ Simulator flags (--simulator):
   --markdown               Save summary report to ./dump/<output>.md
   --verbose                Log every simulator lifecycle callback to the console
 
-  Positional: path to an ideas .jsonl file — one idea per line with the exact shape
+  Positionals: path to an ideas .jsonl file — one idea per line with the exact shape
   { "id": number, "ts": number, "symbol": string, "direction": "LONG"|"SHORT"|"NEUTRAL",
-  "author": string }. The file is validated BEFORE any work; a line that does not
-  match the structure aborts the run with an error.
+  "author": string } — and an OPTIONAL config .json with the shape
+  { "gridAxes"?: ISimulatorGridAxes, "reportOrder"?: "sharpe"|"sortino"|"pnl"|"recovery" }.
+  Both files are validated BEFORE any work; a mismatch aborts the run with an error.
+  No config -> an empty object is used and the engine defaults apply (the full
+  default grid axes and reportOrder "sharpe" of the connection service).
 
-  Runs the backtest-kit Simulator entity: one 5-day candle pass per idea, flood
-  dedupe (one idea per author per direction per 8h), default-ban author filter
-  (ban thresholds are grid axes), grid evaluation with time-based Sharpe/Sortino,
-  four ranking winners. The report includes the production author whitelist.
-  Ideas of other symbols are filtered out — one shared feed serves any --symbol.
+  A FEASIBILITY PROBE, not an out-of-sample shot (that is --tune): the grid from
+  the config (or the engine default) answers one question — does the feed contain
+  a profitable corridor at all. One candle pass per idea to the grid's longest
+  hold, flood dedupe (one idea per author per direction per 8h), default-ban
+  author filter graded inside each point's own hold window, time-based
+  Sharpe/Sortino, per-metric buckets with their own ranking winners and ban
+  dictionaries. Ideas of other symbols are filtered out — one shared feed serves
+  any --symbol.
 
   No output flag → print the Markdown summary to stdout. With --verbose every
   simulator lifecycle callback (onProgress, onIdeas, onProfiles, onAuthorsTrained,
@@ -5185,6 +5848,33 @@ Simulator flags (--simulator):
   Module file ./modules/simulator.module is loaded automatically if it exists
   (register your exchange there); without it CCXT Binance is used by default.
 
+Tune flags (--tune):
+
+  --symbol      <string>   Trading pair to test (default: BTCUSDT)
+  --exchange    <string>   Exchange name (default: first registered)
+  --output      <string>   Output file base name (default: tune_{SYMBOL}_{TIMESTAMP})
+  --json                   Save the full ISimulatorTestResult to ./dump/<output>.json
+  --markdown               Save the out-of-sample report to ./dump/<output>.md
+  --verbose                Log simulator lifecycle callbacks to the console
+
+  Positionals: path to an ideas .jsonl file (same shape and validation as
+  --simulator) and a config .json carrying the FROZEN training artifact:
+  { "point": ISimulatorGridPoint, "authorStats": [{ "author", "ideas", "hits" }],
+  "gridAxes"?, "reportOrder"? }. The point and authorStats are REQUIRED — without
+  them there is nothing to test and the run aborts with an error. gridAxes are
+  optional: by default they mirror the frozen point one value per axis (the grid
+  is inert for a test).
+
+  ONE OUT-OF-SAMPLE SHOT, no training: the CLI never runs the sweep — pick your
+  candidate elsewhere (a Simulator.run of your own), freeze its point and raw
+  author track record into the config, and fire it once here via Simulator.test.
+  Bans are re-derived from the frozen numbers under the point's rule; authors
+  unseen in the config are banned by default. The report carries the result with
+  the trade list and the frozen track record with re-derived ban flags.
+
+  Module file ./modules/tune.module is loaded automatically if it exists
+  (register your exchange there); without it CCXT Binance is used by default.
+
 Flush flags (--flush):
 
   One or more positional entry points. For each entry point the following
@@ -5218,7 +5908,8 @@ Module hooks (loaded automatically by each mode):
   modules/dump.module       --dump       Exchange schema for candle dumps
   modules/pnldebug.module   --pnldebug      Exchange schema for PnL debug runs
   modules/brokerdebug.module  --brokerdebug   Broker adapter used for broker commit testing
-  modules/simulator.module  --simulator     Exchange schema for crowd-ideas simulation
+  modules/simulator.module  --simulator     Exchange schema for the crowd-ideas feasibility probe
+  modules/tune.module       --tune          Exchange schema for the walk-forward parameter search
 
   --flush has no associated module. It only removes dump subdirectories.
 
@@ -5248,7 +5939,9 @@ Examples:
   node ${ENTRY_PATH} --brokerdebug --commit signal-open --symbol BTCUSDT
   node ${ENTRY_PATH} --brokerdebug --commit partial-profit --symbol ETHUSDT
   node ${ENTRY_PATH} --simulator --symbol BTCUSDT ./assets/tv-ideas.normalized.jsonl
-  node ${ENTRY_PATH} --simulator --symbol BTCUSDT --json --output jun_2026_sweep ./assets/tv-ideas.normalized.jsonl
+  node ${ENTRY_PATH} --simulator --symbol BTCUSDT --json --output jun_2026_probe ./assets/tv-ideas.normalized.jsonl ./assets/probe.config.json
+  node ${ENTRY_PATH} --tune --symbol BTCUSDT ./assets/tv-ideas.normalized.jsonl
+  node ${ENTRY_PATH} --tune --symbol BTCUSDT --markdown --output jun_2026_tune ./assets/tv-ideas.normalized.jsonl ./assets/tune.config.json
   node ${ENTRY_PATH} --flush ./content/feb_2026.strategy/feb_2026.strategy.ts
   node ${ENTRY_PATH} --flush ./content/feb_2026.strategy/feb_2026.strategy.ts ./content/feb_2026.strategy/feb_2026.test.ts
   node ${ENTRY_PATH} --init --output my-trading-bot
@@ -5262,7 +5955,7 @@ const main$1 = async () => {
     if (!values.help) {
         return;
     }
-    process.stdout.write(`@backtest-kit/cli ${"16.5.0"}\n\n`);
+    process.stdout.write(`@backtest-kit/cli ${"17.0.0"}\n\n`);
     process.stdout.write(HELP_TEXT);
     process.exit(0);
 };
@@ -5276,7 +5969,7 @@ const main = async () => {
     if (!values.version) {
         return;
     }
-    process.stdout.write(`@backtest-kit/cli ${"16.5.0"}\n`);
+    process.stdout.write(`@backtest-kit/cli ${"17.0.0"}\n`);
     process.exit(0);
 };
 main();