@backtest-kit/cli 6.14.0 → 6.15.0

package/README.md

@@ -41,6 +41,7 @@ Point the CLI at your strategy file, choose a mode, and it handles exchange conn
 | **Telegram**     | `--telegram`               | Trade notifications with price charts        |
 | **PineScript**   | `--pine`                   | Run a local `.pine` indicator against exchange data |
 | **Candle Dump**  | `--dump`                   | Fetch and save raw OHLCV candles to a file   |
+| **Flush**        | `--flush`                  | Delete report/log/markdown/agent folders from strategy dump dir |
 | **Init Project** | `--init`                   | Scaffold a new backtest-kit project          |
 
 ## 🚀 Installation
@@ -144,6 +145,7 @@ npm start -- --symbol BTCUSDT --ui
 | `--telegram`              | boolean | Enable Telegram notifications (default: `false`)                   |
 | `--verbose`               | boolean | Log each candle fetch (default: `false`)                           |
 | `--noCache`               | boolean | Skip candle cache warming before backtest (default: `false`)       |
+| `--noFlush`               | boolean | Skip removing report/log/markdown/agent folders before backtest run (default: `false`) |
 | `--symbol`                | string  | Trading pair (default: `"BTCUSDT"`)                                |
 | `--strategy`              | string  | Strategy name (default: first registered)                          |
 | `--exchange`              | string  | Exchange name (default: first registered)                          |
@@ -178,7 +180,7 @@ Runs the strategy against historical candle data using a registered `FrameSchema
 npm run backtest
 ```
 
-Before running, the CLI warms the candle cache for every interval in `--cacheInterval`. On the next run, cached data is used directly — no API calls needed. Pass `--noCache` to skip this step entirely.
+Before running, the CLI removes the `report`, `log`, `markdown`, and `agent` folders from the strategy's `dump/` directory, then warms the candle cache for every interval in `--cacheInterval`. On the next run, cached data is used directly — no API calls needed. Pass `--noCache` to skip cache warming, `--noFlush` to keep existing output folders.
 
 ### Paper Trading
 
@@ -228,7 +230,7 @@ Runs the same historical period against multiple strategy files and prints a ran
 npm run walker
 ```
 
-Each positional argument is a separate strategy entry point. All files are loaded without changing `process.cwd()` — `.env` is read from the working directory only. After loading, `addWalkerSchema` is called automatically using the exchange and frame registered by the strategy files.
+Each positional argument is a separate strategy entry point. Before loading them, the CLI removes the `report`, `log`, `markdown`, and `agent` folders from each entry point's `dump/` directory. Pass `--noFlush` to keep existing output. All files are loaded without changing `process.cwd()` — `.env` is read from the working directory only. After loading, `addWalkerSchema` is called automatically using the exchange and frame registered by the strategy files.
 
 If no frame is registered, the CLI falls back to the last 31 days from `Date.now()` with a console warning.
 
@@ -240,6 +242,7 @@ If no frame is registered, the CLI falls back to the last 31 days from `Date.now
 | `--symbol` | string | Trading pair (default: `"BTCUSDT"`) |
 | `--cacheInterval` | string | Intervals to pre-cache (default: `"1m, 15m, 30m, 4h"`) |
 | `--noCache` | boolean | Skip candle cache warming (default: `false`) |
+| `--noFlush` | boolean | Skip removing report/log/markdown/agent folders before walker run (default: `false`) |
 | `--verbose` | boolean | Log each candle fetch and strategy progress (default: `false`) |
 | `--output` | string | Output file base name (default: `walker_{SYMBOL}_{TIMESTAMP}`) |
 | `--json` | boolean | Save results as JSON to `./dump/<output>.json` |
@@ -828,6 +831,57 @@ Or add it to `package.json`:
 npx @backtest-kit/cli --dump --symbol BTCUSDT --timeframe 15m --limit 500 --jsonl
 ```
 
+## 🗑️ Flushing Strategy Output (`--flush`)
+
+`@backtest-kit/cli` can delete generated output folders from one or more strategy dump directories without touching cached candle data.
+
+### CLI Flags
+
+| Flag | Type | Description |
+|------|------|-------------|
+| `--flush` | boolean | Enable flush mode |
+
+**Positional arguments (required):** one or more strategy entry point files. For each entry point the CLI resolves its directory and removes the following subdirectories from `<entry-dir>/dump/`:
+
+| Folder | Contents |
+|--------|----------|
+| `report` | Backtest report files (`.jsonl`) |
+| `log` | Run logs (`log.jsonl`) |
+| `markdown` | Exported Markdown reports |
+| `agent` | Agent outline files |
+
+Candle cache (`dump/data/`) and AI forecast outlines (`dump/outline/`) are **not** removed.
+
+### Usage
+
+Flush a single strategy:
+
+```bash
+npx @backtest-kit/cli --flush ./content/feb_2026.strategy/modules/backtest.module.ts
+```
+
+Flush multiple strategies at once:
+
+```bash
+npx @backtest-kit/cli --flush \
+  ./content/feb_2026.strategy/modules/backtest.module.ts \
+  ./content/mar_2026.strategy/modules/backtest.module.ts
+```
+
+Or add it to `package.json`:
+
+```json
+{
+  "scripts": {
+    "flush": "npx @backtest-kit/cli --flush ./content/feb_2026.strategy/modules/backtest.module.ts"
+  }
+}
+```
+
+```bash
+npm run flush
+```
+
 ## 🗂️ Scaffolding a New Project (`--init`)
 
 `@backtest-kit/cli` can bootstrap a ready-to-use project directory with a pre-configured layout, example strategy files, and all documentation fetched automatically.
@@ -985,6 +1039,7 @@ await run(mode, args);
 | `frame` | `string` | Frame name (default: first registered) |
 | `cacheInterval` | `CandleInterval[]` | Intervals to pre-cache (default: `["1m","15m","30m","1h","4h"]`) |
 | `noCache` | `boolean` | Skip candle cache warming (default: `false`) |
+| `noFlush` | `boolean` | Skip removing report/log/markdown/agent folders before the run (default: `false`) |
 | `verbose` | `boolean` | Log each candle fetch (default: `false`) |
 
 **Paper** and **Live** (`mode: "paper"` / `mode: "live"`):

package/build/index.cjs

@@ -473,6 +473,10 @@ const getArgs = functoolsKit.singleshot(() => {
                 type: "boolean",
                 default: false,
             },
+            noFlush: {
+                type: "boolean",
+                default: false,
+            },
             cacheInterval: {
                 type: "string",
                 default: "1m, 15m, 30m, 4h",
@@ -486,6 +490,10 @@ const getArgs = functoolsKit.singleshot(() => {
                 type: "boolean",
                 default: false,
             },
+            flush: {
+                type: "boolean",
+                default: false,
+            },
             timeframe: {
                 type: "string",
                 default: "",
@@ -2461,14 +2469,27 @@ const cli = {
 };
 init();
 
+const NOTIFICATION_CONFIG = {
+    signal: true,
+    risk: true,
+    info: true,
+    breakeven: true,
+    common_error: true,
+    critical_error: true,
+    validation_error: true,
+    partial_loss: false,
+    partial_profit: false,
+    signal_sync: false,
+    strategy_commit: true,
+};
 class SetupUtils {
     constructor() {
         this.enable = functoolsKit.singleshot(() => {
             cli.loggerService.debug("SetupUtils enable");
+            BacktestKit.Notification.enable(NOTIFICATION_CONFIG);
             {
                 BacktestKit.Recent.enable();
                 BacktestKit.Storage.enable();
-                BacktestKit.Notification.enable();
             }
             {
                 BacktestKit.Markdown.enable();
@@ -2590,14 +2611,14 @@ BacktestKit.setConfig({
     CC_WALKER_MARKDOWN_TOP_N: 10,
 });
 
-const MODES = ["backtest", "walker", "paper", "live", "pine", "dump", "init", "help", "version"];
+const MODES = ["backtest", "walker", "paper", "live", "pine", "dump", "flush", "init", "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$b = 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;
     }
@@ -2605,19 +2626,48 @@ const main$b = async () => {
     if (MODES.some((mode) => values[mode])) {
         return;
     }
-    process.stdout.write(`@backtest-kit/cli ${"6.14.0"}\n`);
+    process.stdout.write(`@backtest-kit/cli ${"6.15.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$b();
+main$c();
 
 const notifyShutdown = functoolsKit.singleshot(async () => {
     console.log("Graceful shutdown initiated. Press Ctrl+C again to force quit.");
 });
 
+const FLUSH_DIRS = ["report", "log", "markdown", "agent"];
+const flush = async (entryPoint) => {
+    const moduleRoot = path.dirname(path.resolve(process.cwd(), entryPoint));
+    const dumpDir = path.join(moduleRoot, "dump");
+    for (const dir of FLUSH_DIRS) {
+        const target = path.join(dumpDir, dir);
+        await fs$1.rm(target, { recursive: true, force: true });
+        console.log(`Removed: ${target}`);
+    }
+};
+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;
+    }
+    const { values } = getArgs();
+    if (!values.flush) {
+        return;
+    }
+    const entryPoints = getPositionals();
+    if (!entryPoints.length) {
+        throw new Error("Entry point is required");
+    }
+    for (const entryPoint of entryPoints) {
+        await flush(entryPoint);
+    }
+    process.exit(0);
+};
+main$b();
+
 const BEFORE_EXIT_FN$5 = functoolsKit.singleshot(async () => {
     process.off("SIGINT", BEFORE_EXIT_FN$5);
     const [running = null] = await BacktestKit.Backtest.list();
@@ -2646,6 +2696,10 @@ const main$a = async () => {
     if (!values.backtest) {
         return;
     }
+    if (!values.noFlush) {
+        const [entryPoint = null] = getPositionals();
+        entryPoint && await flush(entryPoint);
+    }
     await cli.backtestMainService.connect();
     listenGracefulShutdown$5();
 };
@@ -2675,6 +2729,11 @@ const main$9 = async () => {
     if (!values.walker) {
         return;
     }
+    if (!values.noFlush) {
+        for (const entryPoint of getPositionals()) {
+            await flush(entryPoint);
+        }
+    }
     listenGracefulShutdown$4();
     await cli.walkerMainService.connect();
 };
@@ -3060,6 +3119,7 @@ Modes:
   --live     <entry>          Live trading with real orders
   --pine     <entry>    Execute a local .pine indicator file
   --dump                Fetch and save raw OHLCV candles
+  --flush  <entry...>   Delete report/log/markdown/agent folders from strategy dump dir
   --init                Scaffold a new project in the current directory
   --help                Print this help message
 
@@ -3071,6 +3131,7 @@ Backtest flags:
   --frame       <string>   Frame name from addFrameSchema (default: first registered)
   --cacheInterval <string> Comma-separated intervals to pre-cache (default: "1m, 15m, 30m, 4h")
   --noCache                Skip candle cache warming before the run
+  --noFlush                Skip removing report/log/markdown/agent folders before backtest run
   --verbose                Log every candle fetch to stdout
   --ui                     Start web dashboard at http://localhost:60050
   --telegram               Send trade notifications to Telegram
@@ -3080,6 +3141,7 @@ Walker flags (--walker):
   --symbol        <string>   Trading pair (default: BTCUSDT)
   --cacheInterval <string>   Comma-separated intervals to pre-cache (default: "1m, 15m, 30m, 4h")
   --noCache                  Skip candle cache warming before the run
+  --noFlush                  Skip removing report/log/markdown/agent folders before walker run
   --verbose                  Log every candle fetch to stdout
   --output        <string>   Output file base name (default: walker_{SYMBOL}_{TIMESTAMP})
   --json                     Save results as JSON to ./dump/<output>.json
@@ -3129,6 +3191,13 @@ Candle dump flags (--dump):
 
   Module file ./modules/dump.module is loaded automatically if it exists.
 
+Flush flags (--flush):
+
+  One or more positional entry points. For each entry point the following
+  subdirectories are removed from <entry-dir>/dump/:
+
+    report   log   markdown   agent
+
 Init flags (--init):
 
   --output <string>   Target directory name (default: backtest-kit-project)
@@ -3144,6 +3213,8 @@ Module hooks (loaded automatically by each mode):
   modules/pine.module       --pine       Exchange schema for PineScript runs
   modules/dump.module       --dump       Exchange schema for candle dumps
 
+  --flush has no associated module. It only removes dump subdirectories.
+
   Extensions .ts, .mjs, .cjs are tried automatically. Missing module = soft warning.
 
 Environment variables:
@@ -3156,13 +3227,15 @@ Environment variables:
 Examples:
 
   node ${ENTRY_PATH} --backtest ./content/feb_2026.strategy.ts
-  node ${ENTRY_PATH} --backtest --symbol BTCUSDT --noCache --ui ./content/feb_2026.strategy.ts
+  node ${ENTRY_PATH} --backtest --symbol BTCUSDT --noCache --noFlush --ui ./content/feb_2026.strategy.ts
   node ${ENTRY_PATH} --walker ./content/feb_2026_v1.strategy.ts ./content/feb_2026_v2.strategy.ts ./content/feb_2026_v3.strategy.ts
-  node ${ENTRY_PATH} --walker --symbol BTCUSDT --noCache --markdown ./content/feb_2026_v1.ts ./content/feb_2026_v2.ts
+  node ${ENTRY_PATH} --walker --symbol BTCUSDT --noCache --noFlush --markdown ./content/feb_2026_v1.ts ./content/feb_2026_v2.ts
   node ${ENTRY_PATH} --paper --symbol ETHUSDT ./content/feb_2026.strategy.ts
   node ${ENTRY_PATH} --live --ui --telegram ./content/feb_2026.strategy.ts
   node ${ENTRY_PATH} --pine ./math/feb_2026.pine --timeframe 15m --limit 500 --jsonl
   node ${ENTRY_PATH} --dump --symbol BTCUSDT --timeframe 15m --limit 500 --jsonl
+  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
 `.trimStart();
 const main$1 = async () => {
@@ -3173,7 +3246,7 @@ const main$1 = async () => {
     if (!values.help) {
         return;
     }
-    process.stdout.write(`@backtest-kit/cli ${"6.14.0"}\n\n`);
+    process.stdout.write(`@backtest-kit/cli ${"6.15.0"}\n\n`);
     process.stdout.write(HELP_TEXT);
     process.exit(0);
 };
@@ -3187,7 +3260,7 @@ const main = async () => {
     if (!values.version) {
         return;
     }
-    process.stdout.write(`@backtest-kit/cli ${"6.14.0"}\n`);
+    process.stdout.write(`@backtest-kit/cli ${"6.15.0"}\n`);
     process.exit(0);
 };
 main();

package/build/index.mjs

@@ -1,11 +1,11 @@
 #!/usr/bin/env node
 import * as BacktestKit from 'backtest-kit';
-import { Log, listExchangeSchema, addExchangeSchema, roundTicks, listFrameSchema, addFrameSchema, listenDoneLive, listenDoneBacktest, shutdown, listenSignal, listStrategySchema, overrideExchangeSchema, Backtest, Session, Cache, Interval, alignToInterval, addWalkerSchema, overrideWalkerSchema, Walker, listenDoneWalker, Live, getCandles, checkCandles, warmCandles, listenRisk, listenStrategyCommit, listenSync, Recent, Storage, Notification, Markdown, Report, Dump, Memory, StorageLive, StorageBacktest, RecentLive, RecentBacktest, NotificationLive, NotificationBacktest, MarkdownWriter, ReportWriter, PersistSignalAdapter, PersistRiskAdapter, PersistScheduleAdapter, PersistPartialAdapter, PersistBreakevenAdapter, PersistCandleAdapter, PersistStorageAdapter, PersistNotificationAdapter, PersistLogAdapter, PersistMeasureAdapter, PersistIntervalAdapter, PersistMemoryAdapter, PersistRecentAdapter, setConfig, Exchange } from 'backtest-kit';
+import { Log, listExchangeSchema, addExchangeSchema, roundTicks, listFrameSchema, addFrameSchema, listenDoneLive, listenDoneBacktest, shutdown, listenSignal, listStrategySchema, overrideExchangeSchema, Backtest, Session, Cache, Interval, alignToInterval, addWalkerSchema, overrideWalkerSchema, Walker, listenDoneWalker, Live, getCandles, checkCandles, warmCandles, listenRisk, listenStrategyCommit, listenSync, Notification, Recent, Storage, Markdown, Report, Dump, Memory, StorageLive, StorageBacktest, RecentLive, RecentBacktest, NotificationLive, NotificationBacktest, MarkdownWriter, ReportWriter, PersistSignalAdapter, PersistRiskAdapter, PersistScheduleAdapter, PersistPartialAdapter, PersistBreakevenAdapter, PersistCandleAdapter, PersistStorageAdapter, PersistNotificationAdapter, PersistLogAdapter, PersistMeasureAdapter, PersistIntervalAdapter, PersistMemoryAdapter, PersistRecentAdapter, setConfig, Exchange } from 'backtest-kit';
 import { getErrorMessage, errorData, singleshot, str, BehaviorSubject, compose, createAwaiter, execpool, queued, sleep, randomString, TIMEOUT_SYMBOL, typo, retry, trycatch, memoize } from 'functools-kit';
 import fs, { constants } from 'fs';
 import * as stackTrace from 'stack-trace';
-import path, { join, resolve, basename, extname, dirname } from 'path';
-import fs$1, { access, readFile, mkdir, writeFile, readdir, copyFile } from 'fs/promises';
+import path, { join, resolve, dirname, basename, extname } from 'path';
+import fs$1, { access, readFile, mkdir, writeFile, rm, readdir, copyFile } from 'fs/promises';
 import dotenv from 'dotenv';
 import { createActivator } from 'di-kit';
 import { fileURLToPath } from 'url';
@@ -448,6 +448,10 @@ const getArgs = singleshot(() => {
                 type: "boolean",
                 default: false,
             },
+            noFlush: {
+                type: "boolean",
+                default: false,
+            },
             cacheInterval: {
                 type: "string",
                 default: "1m, 15m, 30m, 4h",
@@ -461,6 +465,10 @@ const getArgs = singleshot(() => {
                 type: "boolean",
                 default: false,
             },
+            flush: {
+                type: "boolean",
+                default: false,
+            },
             timeframe: {
                 type: "string",
                 default: "",
@@ -2432,14 +2440,27 @@ const cli = {
 };
 init();
 
+const NOTIFICATION_CONFIG = {
+    signal: true,
+    risk: true,
+    info: true,
+    breakeven: true,
+    common_error: true,
+    critical_error: true,
+    validation_error: true,
+    partial_loss: false,
+    partial_profit: false,
+    signal_sync: false,
+    strategy_commit: true,
+};
 class SetupUtils {
     constructor() {
         this.enable = singleshot(() => {
             cli.loggerService.debug("SetupUtils enable");
+            Notification.enable(NOTIFICATION_CONFIG);
             {
                 Recent.enable();
                 Storage.enable();
-                Notification.enable();
             }
             {
                 Markdown.enable();
@@ -2561,14 +2582,14 @@ setConfig({
     CC_WALKER_MARKDOWN_TOP_N: 10,
 });
 
-const MODES = ["backtest", "walker", "paper", "live", "pine", "dump", "init", "help", "version"];
+const MODES = ["backtest", "walker", "paper", "live", "pine", "dump", "flush", "init", "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$b = async () => {
+const main$c = async () => {
     if (!getEntry(import.meta.url)) {
         return;
     }
@@ -2576,19 +2597,48 @@ const main$b = async () => {
     if (MODES.some((mode) => values[mode])) {
         return;
     }
-    process.stdout.write(`@backtest-kit/cli ${"6.14.0"}\n`);
+    process.stdout.write(`@backtest-kit/cli ${"6.15.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$b();
+main$c();
 
 const notifyShutdown = singleshot(async () => {
     console.log("Graceful shutdown initiated. Press Ctrl+C again to force quit.");
 });
 
+const FLUSH_DIRS = ["report", "log", "markdown", "agent"];
+const flush = async (entryPoint) => {
+    const moduleRoot = dirname(resolve(process.cwd(), entryPoint));
+    const dumpDir = join(moduleRoot, "dump");
+    for (const dir of FLUSH_DIRS) {
+        const target = join(dumpDir, dir);
+        await rm(target, { recursive: true, force: true });
+        console.log(`Removed: ${target}`);
+    }
+};
+const main$b = async () => {
+    if (!getEntry(import.meta.url)) {
+        return;
+    }
+    const { values } = getArgs();
+    if (!values.flush) {
+        return;
+    }
+    const entryPoints = getPositionals();
+    if (!entryPoints.length) {
+        throw new Error("Entry point is required");
+    }
+    for (const entryPoint of entryPoints) {
+        await flush(entryPoint);
+    }
+    process.exit(0);
+};
+main$b();
+
 const BEFORE_EXIT_FN$5 = singleshot(async () => {
     process.off("SIGINT", BEFORE_EXIT_FN$5);
     const [running = null] = await Backtest.list();
@@ -2617,6 +2667,10 @@ const main$a = async () => {
     if (!values.backtest) {
         return;
     }
+    if (!values.noFlush) {
+        const [entryPoint = null] = getPositionals();
+        entryPoint && await flush(entryPoint);
+    }
     await cli.backtestMainService.connect();
     listenGracefulShutdown$5();
 };
@@ -2646,6 +2700,11 @@ const main$9 = async () => {
     if (!values.walker) {
         return;
     }
+    if (!values.noFlush) {
+        for (const entryPoint of getPositionals()) {
+            await flush(entryPoint);
+        }
+    }
     listenGracefulShutdown$4();
     await cli.walkerMainService.connect();
 };
@@ -3031,6 +3090,7 @@ Modes:
   --live     <entry>          Live trading with real orders
   --pine     <entry>    Execute a local .pine indicator file
   --dump                Fetch and save raw OHLCV candles
+  --flush  <entry...>   Delete report/log/markdown/agent folders from strategy dump dir
   --init                Scaffold a new project in the current directory
   --help                Print this help message
 
@@ -3042,6 +3102,7 @@ Backtest flags:
   --frame       <string>   Frame name from addFrameSchema (default: first registered)
   --cacheInterval <string> Comma-separated intervals to pre-cache (default: "1m, 15m, 30m, 4h")
   --noCache                Skip candle cache warming before the run
+  --noFlush                Skip removing report/log/markdown/agent folders before backtest run
   --verbose                Log every candle fetch to stdout
   --ui                     Start web dashboard at http://localhost:60050
   --telegram               Send trade notifications to Telegram
@@ -3051,6 +3112,7 @@ Walker flags (--walker):
   --symbol        <string>   Trading pair (default: BTCUSDT)
   --cacheInterval <string>   Comma-separated intervals to pre-cache (default: "1m, 15m, 30m, 4h")
   --noCache                  Skip candle cache warming before the run
+  --noFlush                  Skip removing report/log/markdown/agent folders before walker run
   --verbose                  Log every candle fetch to stdout
   --output        <string>   Output file base name (default: walker_{SYMBOL}_{TIMESTAMP})
   --json                     Save results as JSON to ./dump/<output>.json
@@ -3100,6 +3162,13 @@ Candle dump flags (--dump):
 
   Module file ./modules/dump.module is loaded automatically if it exists.
 
+Flush flags (--flush):
+
+  One or more positional entry points. For each entry point the following
+  subdirectories are removed from <entry-dir>/dump/:
+
+    report   log   markdown   agent
+
 Init flags (--init):
 
   --output <string>   Target directory name (default: backtest-kit-project)
@@ -3115,6 +3184,8 @@ Module hooks (loaded automatically by each mode):
   modules/pine.module       --pine       Exchange schema for PineScript runs
   modules/dump.module       --dump       Exchange schema for candle dumps
 
+  --flush has no associated module. It only removes dump subdirectories.
+
   Extensions .ts, .mjs, .cjs are tried automatically. Missing module = soft warning.
 
 Environment variables:
@@ -3127,13 +3198,15 @@ Environment variables:
 Examples:
 
   node ${ENTRY_PATH} --backtest ./content/feb_2026.strategy.ts
-  node ${ENTRY_PATH} --backtest --symbol BTCUSDT --noCache --ui ./content/feb_2026.strategy.ts
+  node ${ENTRY_PATH} --backtest --symbol BTCUSDT --noCache --noFlush --ui ./content/feb_2026.strategy.ts
   node ${ENTRY_PATH} --walker ./content/feb_2026_v1.strategy.ts ./content/feb_2026_v2.strategy.ts ./content/feb_2026_v3.strategy.ts
-  node ${ENTRY_PATH} --walker --symbol BTCUSDT --noCache --markdown ./content/feb_2026_v1.ts ./content/feb_2026_v2.ts
+  node ${ENTRY_PATH} --walker --symbol BTCUSDT --noCache --noFlush --markdown ./content/feb_2026_v1.ts ./content/feb_2026_v2.ts
   node ${ENTRY_PATH} --paper --symbol ETHUSDT ./content/feb_2026.strategy.ts
   node ${ENTRY_PATH} --live --ui --telegram ./content/feb_2026.strategy.ts
   node ${ENTRY_PATH} --pine ./math/feb_2026.pine --timeframe 15m --limit 500 --jsonl
   node ${ENTRY_PATH} --dump --symbol BTCUSDT --timeframe 15m --limit 500 --jsonl
+  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
 `.trimStart();
 const main$1 = async () => {
@@ -3144,7 +3217,7 @@ const main$1 = async () => {
     if (!values.help) {
         return;
     }
-    process.stdout.write(`@backtest-kit/cli ${"6.14.0"}\n\n`);
+    process.stdout.write(`@backtest-kit/cli ${"6.15.0"}\n\n`);
     process.stdout.write(HELP_TEXT);
     process.exit(0);
 };
@@ -3158,7 +3231,7 @@ const main = async () => {
     if (!values.version) {
         return;
     }
-    process.stdout.write(`@backtest-kit/cli ${"6.14.0"}\n`);
+    process.stdout.write(`@backtest-kit/cli ${"6.15.0"}\n`);
     process.exit(0);
 };
 main();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@backtest-kit/cli",
-  "version": "6.14.0",
+  "version": "6.15.0",
   "description": "Zero-boilerplate CLI runner for backtest-kit strategies. Run backtests, paper trading, and live bots with candle cache warming, web dashboard, and Telegram notifications — no setup code required.",
   "author": {
     "name": "Petr Tripolsky",
@@ -61,11 +61,11 @@
   "devDependencies": {
     "@babel/plugin-transform-modules-umd": "7.27.1",
     "@babel/standalone": "7.29.1",
-    "@backtest-kit/ui": "6.14.0",
-    "@backtest-kit/graph": "6.14.0",
-    "@backtest-kit/ollama": "6.14.0",
-    "@backtest-kit/pinets": "6.14.0",
-    "@backtest-kit/signals": "6.14.0",
+    "@backtest-kit/ui": "6.15.0",
+    "@backtest-kit/graph": "6.15.0",
+    "@backtest-kit/ollama": "6.15.0",
+    "@backtest-kit/pinets": "6.15.0",
+    "@backtest-kit/signals": "6.15.0",
     "@rollup/plugin-replace": "6.0.3",
     "@rollup/plugin-typescript": "11.1.6",
     "@types/image-size": "0.7.0",
@@ -73,7 +73,7 @@
     "@types/mustache": "4.2.6",
     "@types/node": "22.9.0",
     "@types/stack-trace": "0.0.33",
-    "backtest-kit": "6.14.0",
+    "backtest-kit": "6.15.0",
     "glob": "11.0.1",
     "markdown-it": "14.1.1",
     "rimraf": "6.0.1",
@@ -88,12 +88,12 @@
   "peerDependencies": {
     "@babel/plugin-transform-modules-umd": "^7.27.1",
     "@babel/standalone": "^7.29.1",
-    "@backtest-kit/ui": "^6.14.0",
-    "@backtest-kit/graph": "^6.14.0",
-    "@backtest-kit/ollama": "^6.14.0",
-    "@backtest-kit/pinets": "^6.14.0",
-    "@backtest-kit/signals": "^6.14.0",
-    "backtest-kit": "^6.14.0",
+    "@backtest-kit/ui": "^6.15.0",
+    "@backtest-kit/graph": "^6.15.0",
+    "@backtest-kit/ollama": "^6.15.0",
+    "@backtest-kit/pinets": "^6.15.0",
+    "@backtest-kit/signals": "^6.15.0",
+    "backtest-kit": "^6.15.0",
     "markdown-it": "^14.1.1",
     "typescript": "^5.0.0"
   },

package/template/project/package.mustache

@@ -12,12 +12,12 @@
   "license": "ISC",
   "type": "commonjs",
   "dependencies": {
-    "@backtest-kit/cli": "^6.14.0",
-    "@backtest-kit/graph": "^6.14.0",
-    "@backtest-kit/pinets": "^6.14.0",
-    "@backtest-kit/ui": "^6.14.0",
+    "@backtest-kit/cli": "^6.15.0",
+    "@backtest-kit/graph": "^6.15.0",
+    "@backtest-kit/pinets": "^6.15.0",
+    "@backtest-kit/ui": "^6.15.0",
     "agent-swarm-kit": "^2.5.0",
-    "backtest-kit": "^6.14.0",
+    "backtest-kit": "^6.15.0",
     "functools-kit": "^2.2.0",
     "garch": "^1.2.3",
     "get-moment-stamp": "^1.1.2",