@backtest-kit/cli 8.1.0 → 8.3.0

package/README.md

@@ -45,6 +45,7 @@ Point the CLI at your strategy file, choose a mode, and it handles exchange conn
 | **Pine Editor**  | `--editor`                 | Open the visual Pine Script editor in the browser   |
 | **Candle Dump**  | `--dump`                   | Fetch and save raw OHLCV candles to a file   |
 | **PnL Debug**    | `--pnldebug`               | Simulate per-minute PnL for a given entry price and direction |
+| **Broker Debug** | `--brokerdebug`            | Fire a single broker commit against the live broker adapter   |
 | **Flush**        | `--flush`                  | Delete report/log/markdown/agent folders from strategy dump dir |
 | **Init Project** | `--init`                   | Scaffold a new backtest-kit project          |
 
@@ -155,6 +156,8 @@ npm start -- --symbol BTCUSDT --ui
 | `--exchange`              | string  | Exchange name (default: first registered)                          |
 | `--frame`                 | string  | Backtest frame name (default: first registered)                    |
 | `--cacheInterval`         | string  | Intervals to pre-cache before backtest (default: `"1m, 15m, 30m, 4h"`) |
+| `--brokerdebug`           | boolean | Fire a single broker commit against the live broker adapter (default: `false`) |
+| `--commit`                | string  | Commit type for `--brokerdebug` (default: `"signal-open"`) |
 
 **Positional argument (required):** path to your strategy entry point file (set once in `package.json` scripts).
 
@@ -567,7 +570,8 @@ The CLI supports **mode-specific module files** that are loaded as side-effect i
 | `--live`          | `./modules/live.module.mjs`     | `Live.background()`         |
 | `--paper`         | `./modules/paper.module.mjs`    | `Live.background()` (paper) |
 | `--backtest`      | `./modules/backtest.module.mjs` | `Backtest.background()`     |
-| `--walker`        | `./modules/walker.module.mjs`   | `Walker.background()`       |
+| `--walker`        | `./modules/walker.module.mjs`     | `Walker.background()`          |
+| `--brokerdebug`   | `./modules/brokerdebug.module.mjs` | broker commit test            |
 
 > File is resolved relative to `cwd` (the strategy directory). All of `.mjs`, `.cjs`, `.ts` extensions are tried automatically. Missing module is a soft warning — not an error.
 
@@ -1170,6 +1174,63 @@ Symbol: BTCUSDT | Direction: short | PriceOpen: 64069.50 | From: 2025-02-25T00:0
   120 | 2025-02-25T02:00:00.000Z  |      63200.00 |   +1.36% |   +1.36% |    -0.06%
 ```
 
+## 🐛 Broker Debug (`--brokerdebug`)
+
+`@backtest-kit/cli` can fire a single broker commit against your live broker adapter without running a full strategy — useful for verifying that your `brokerdebug.module` correctly wires up exchange calls.
+
+### CLI Flags
+
+| Flag | Type | Description |
+|------|------|-------------|
+| `--brokerdebug` | boolean | Enable broker debug mode |
+| `--commit` | string | Commit type to fire (default: `"signal-open"`) |
+| `--symbol` | string | Trading pair (default: `"BTCUSDT"`) |
+| `--exchange` | string | Exchange name (default: first registered) |
+
+**Available `--commit` values:**
+
+| Value | Broker hook |
+|-------|-------------|
+| `signal-open` | `onSignalOpenCommit` |
+| `signal-close` | `onSignalCloseCommit` |
+| `partial-profit` | `onPartialProfitCommit` |
+| `partial-loss` | `onPartialLossCommit` |
+| `average-buy` | `onAverageBuyCommit` |
+| `trailing-stop` | `onTrailingStopCommit` |
+| `trailing-take` | `onTrailingTakeCommit` |
+| `breakeven` | `onBreakevenCommit` |
+
+### How It Works
+
+The CLI loads `./modules/brokerdebug.module`, fetches the last candle for `--symbol` / `--timeframe`, derives synthetic payload values from `currentPrice` (TP = +2%, SL = -2%), and calls the selected broker hook once. Exits with code `0` on success.
+
+### Broker via `brokerdebug.module`
+
+Create a `modules/brokerdebug.module.ts` file and register your broker adapter:
+
+```typescript
+// modules/brokerdebug.module.ts
+import { Broker } from 'backtest-kit';
+import { myExchange } from './exchange.mjs';
+
+class MyBroker {
+  async onSignalOpenCommit({ symbol, priceOpen, position }) {
+    await myExchange.openPosition(symbol, position, priceOpen);
+  }
+  // ... other hooks
+}
+
+Broker.useBrokerAdapter(MyBroker);
+Broker.enable();
+```
+
+### Usage
+
+```bash
+npx @backtest-kit/cli --brokerdebug --commit signal-open --symbol BTCUSDT
+npx @backtest-kit/cli --brokerdebug --commit partial-profit --symbol ETHUSDT --timeframe 1h
+```
+
 ## 🗑️ Flushing Strategy Output (`--flush`)
 
 `@backtest-kit/cli` can delete generated output folders from one or more strategy dump directories without touching cached candle data.
@@ -1308,6 +1369,48 @@ Or via the pre-configured npm script:
 npm run sync:lib
 ```
 
+## 🐳 Running in Docker (`--docker`)
+
+CLI can scaffold a ready-to-use Docker workspace: self-contained directory with `docker-compose.yaml` and a strategy entry point. 
+
+### CLI Flags
+
+| Flag | Type | Description |
+|------|------|-------------|
+| `--docker` | boolean | Scaffold a Docker workspace |
+| `--output` | string | Target directory name (default: `backtest-kit-docker`) |
+
+### Usage
+
+```bash
+npx @backtest-kit/cli --docker
+```
+
+Creates `./backtest-kit-docker/` in the current working directory.
+
+Override the directory name with `--output`:
+
+```bash
+npx @backtest-kit/cli --docker --output my-docker-workspace
+```
+
+The target directory must not exist or must be empty — the command aborts if it contains any files.
+
+### Generated Workspace Structure
+
+```
+backtest-kit-docker/
+├── docker-compose.yaml           # ready-to-run service definition
+├── .env.example                  # environment variable reference
+├── package.json                  # dependencies for editing strategies locally
+├── tsconfig.json                 # TypeScript config for content/
+└── content/
+    └── feb_2026/
+        ├── feb_2026.strategy.ts  # example strategy entry point
+        └── modules/
+            └── backtest.module.ts  # CCXT Binance exchange + frame schema
+```
+
 ## 🌍 Environment Variables
 
 Create a `.env` file in your project root:

package/build/index.cjs

@@ -266,16 +266,16 @@ const TYPES = {
 
 const entrySubject = new functoolsKit.BehaviorSubject();
 
-const __filename$2 = url.fileURLToPath((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('index.cjs', document.baseURI).href)));
-const __dirname$2 = path.dirname(__filename$2);
+const __filename$3 = url.fileURLToPath((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('index.cjs', document.baseURI).href)));
+const __dirname$3 = path.dirname(__filename$3);
 let _is_launched = false;
 class ResolveService {
     constructor() {
         this.loggerService = inject(TYPES.loggerService);
         this.loaderService = inject(TYPES.loaderService);
-        this.DEFAULT_TEMPLATE_DIR = path.resolve(__dirname$2, '..', 'template');
-        this.DEFAULT_MODULES_DIR = path.resolve(__dirname$2, '..', 'modules');
-        this.DEFAULT_CONFIG_DIR = path.resolve(__dirname$2, '..', 'config');
+        this.DEFAULT_TEMPLATE_DIR = path.resolve(__dirname$3, '..', 'template');
+        this.DEFAULT_MODULES_DIR = path.resolve(__dirname$3, '..', 'modules');
+        this.DEFAULT_CONFIG_DIR = path.resolve(__dirname$3, '..', 'config');
         this.OVERRIDE_TEMPLATE_DIR = path.resolve(process.cwd(), 'template');
         this.OVERRIDE_MODULES_DIR = path.resolve(process.cwd(), 'modules');
         this.OVERRIDE_CONFIG_DIR = path.resolve(process.cwd(), 'config');
@@ -586,10 +586,22 @@ const getArgs = functoolsKit.singleshot(() => {
                 type: "string",
                 default: "",
             },
+            brokerdebug: {
+                type: "boolean",
+                default: false,
+            },
+            commit: {
+                type: "string",
+                default: "",
+            },
             init: {
                 type: "boolean",
                 default: false,
             },
+            docker: {
+                type: "boolean",
+                default: false,
+            },
             help: {
                 type: "boolean",
                 default: false,
@@ -2999,14 +3011,14 @@ const cli = {
 };
 init();
 
-const MODES = ["backtest", "walker", "paper", "live", "pine", "editor", "dump", "pnldebug", "flush", "init", "help", "version"];
+const MODES = ["backtest", "walker", "paper", "live", "pine", "editor", "dump", "pnldebug", "brokerdebug", "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$e = 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;
     }
@@ -3014,14 +3026,14 @@ const main$e = async () => {
     if (MODES.some((mode) => values[mode])) {
         return;
     }
-    process.stdout.write(`@backtest-kit/cli ${"8.1.0"}\n`);
+    process.stdout.write(`@backtest-kit/cli ${"8.3.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$e();
+main$f();
 
 const notifyShutdown = functoolsKit.singleshot(async () => {
     console.log("Graceful shutdown initiated. Press Ctrl+C again to force quit.");
@@ -3037,7 +3049,7 @@ const flush = async (entryPoint) => {
         console.log(`Removed: ${target}`);
     }
 };
-const main$d = 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;
     }
@@ -3054,7 +3066,7 @@ const main$d = async () => {
     }
     process.exit(0);
 };
-main$d();
+main$e();
 
 const BEFORE_EXIT_FN$5 = functoolsKit.singleshot(async () => {
     process.off("SIGINT", BEFORE_EXIT_FN$5);
@@ -3076,7 +3088,7 @@ const BEFORE_EXIT_FN$5 = functoolsKit.singleshot(async () => {
 const listenGracefulShutdown$5 = functoolsKit.singleshot(() => {
     process.on("SIGINT", BEFORE_EXIT_FN$5);
 });
-const main$c = 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;
     }
@@ -3091,7 +3103,7 @@ const main$c = async () => {
     await cli.backtestMainService.connect();
     listenGracefulShutdown$5();
 };
-main$c();
+main$d();
 
 const BEFORE_EXIT_FN$4 = functoolsKit.singleshot(async () => {
     process.off("SIGINT", BEFORE_EXIT_FN$4);
@@ -3109,7 +3121,7 @@ const BEFORE_EXIT_FN$4 = functoolsKit.singleshot(async () => {
 const listenGracefulShutdown$4 = functoolsKit.singleshot(() => {
     process.on("SIGINT", BEFORE_EXIT_FN$4);
 });
-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;
     }
@@ -3125,7 +3137,7 @@ const main$b = async () => {
     listenGracefulShutdown$4();
     await cli.walkerMainService.connect();
 };
-main$b();
+main$c();
 
 const BEFORE_EXIT_FN$3 = functoolsKit.singleshot(async () => {
     process.off("SIGINT", BEFORE_EXIT_FN$3);
@@ -3146,7 +3158,7 @@ const BEFORE_EXIT_FN$3 = functoolsKit.singleshot(async () => {
 const listenGracefulShutdown$3 = functoolsKit.singleshot(() => {
     process.on("SIGINT", BEFORE_EXIT_FN$3);
 });
-const main$a = 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;
     }
@@ -3157,7 +3169,7 @@ const main$a = async () => {
     cli.paperMainService.connect();
     listenGracefulShutdown$3();
 };
-main$a();
+main$b();
 
 const BEFORE_EXIT_FN$2 = functoolsKit.singleshot(async () => {
     process.off("SIGINT", BEFORE_EXIT_FN$2);
@@ -3178,7 +3190,7 @@ const BEFORE_EXIT_FN$2 = functoolsKit.singleshot(async () => {
 const listenGracefulShutdown$2 = functoolsKit.singleshot(() => {
     process.on("SIGINT", BEFORE_EXIT_FN$2);
 });
-const main$9 = 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;
     }
@@ -3189,7 +3201,7 @@ const main$9 = async () => {
     await cli.liveMainService.connect();
     listenGracefulShutdown$2();
 };
-main$9();
+main$a();
 
 const BEFORE_EXIT_FN$1 = functoolsKit.singleshot(async () => {
     process.off("SIGINT", BEFORE_EXIT_FN$1);
@@ -3199,7 +3211,7 @@ const BEFORE_EXIT_FN$1 = functoolsKit.singleshot(async () => {
 const listenGracefulShutdown$1 = functoolsKit.singleshot(() => {
     process.on("SIGINT", BEFORE_EXIT_FN$1);
 });
-const main$8 = 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;
     }
@@ -3209,7 +3221,7 @@ const main$8 = async () => {
     }
     listenGracefulShutdown$1();
 };
-main$8();
+main$9();
 
 const BEFORE_EXIT_FN = functoolsKit.singleshot(async () => {
     process.off("SIGINT", BEFORE_EXIT_FN);
@@ -3219,7 +3231,7 @@ const BEFORE_EXIT_FN = functoolsKit.singleshot(async () => {
 const listenGracefulShutdown = functoolsKit.singleshot(() => {
     process.on("SIGINT", BEFORE_EXIT_FN);
 });
-const main$7 = 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;
     }
@@ -3229,7 +3241,7 @@ const main$7 = async () => {
     }
     listenGracefulShutdown();
 };
-main$7();
+main$8();
 
 const EXTRACT_ROWS_FN = (plots, schema) => {
     const keys = Object.keys(schema);
@@ -3251,7 +3263,7 @@ const EXTRACT_ROWS_FN = (plots, schema) => {
     }
     return rows;
 };
-const main$6 = 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;
     }
@@ -3331,9 +3343,9 @@ const main$6 = async () => {
     console.log(await BacktestKitPinets.toMarkdown(signalId, plots, signalSchema));
     process.exit(0);
 };
-main$6();
+main$7();
 
-const main$5 = async () => {
+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;
     }
@@ -3368,9 +3380,9 @@ const main$5 = async () => {
     };
     process.on("SIGINT", beforeExit);
 };
-main$5();
+main$6();
 
-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;
     }
@@ -3431,9 +3443,9 @@ const main$4 = async () => {
     console.log(JSON.stringify(candles, null, 2));
     process.exit(0);
 };
-main$4();
+main$5();
 
-const main$3 = async () => {
+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;
     }
@@ -3527,16 +3539,16 @@ const main$3 = async () => {
     }
     process.exit(0);
 };
-main$3();
+main$4();
 
-const __filename$1 = url.fileURLToPath((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('index.cjs', document.baseURI).href)));
-const __dirname$1 = path.dirname(__filename$1);
+const __filename$2 = url.fileURLToPath((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('index.cjs', document.baseURI).href)));
+const __dirname$2 = path.dirname(__filename$2);
 const MUSTACHE_EXT = ".mustache";
 const MUSTACHE_RENAME = {
     "gitignore": ".gitignore",
     "package": "package.json",
 };
-async function isDirEmpty(dirPath) {
+async function isDirEmpty$1(dirPath) {
     try {
         const files = await fs$1.readdir(dirPath);
         return files.length === 0;
@@ -3548,13 +3560,13 @@ async function isDirEmpty(dirPath) {
         throw error;
     }
 }
-async function copyDir(srcDir, destDir, data) {
+async function copyDir$1(srcDir, destDir, data) {
     await fs$1.mkdir(destDir, { recursive: true });
     const entries = await fs$1.readdir(srcDir, { withFileTypes: true });
     for (const entry of entries) {
         const srcPath = path.join(srcDir, entry.name);
         if (entry.isDirectory()) {
-            await copyDir(srcPath, path.join(destDir, entry.name), data);
+            await copyDir$1(srcPath, path.join(destDir, entry.name), data);
             continue;
         }
         if (entry.name === ".gitkeep") {
@@ -3590,7 +3602,7 @@ function runScript(scriptPath, cwd) {
         child.on("error", reject);
     });
 }
-function runNpmInstall(cwd) {
+function runNpmInstall$1(cwd) {
     return new Promise((resolve, reject) => {
         const npm = process.platform === "win32" ? "npm.cmd" : "npm";
         const child = child_process.spawn(npm, ["install"], { cwd, stdio: "inherit", shell: true });
@@ -3604,7 +3616,7 @@ function runNpmInstall(cwd) {
         child.on("error", reject);
     });
 }
-const main$2 = async () => {
+const main$3 = 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;
     }
@@ -3614,21 +3626,95 @@ const main$2 = async () => {
     }
     const projectName = values.output || "backtest-kit-project";
     const projectPath = path.join(process.cwd(), projectName);
-    const templatePath = path.join(__dirname$1, "../template/project");
-    const isEmpty = await isDirEmpty(projectPath);
+    const templatePath = path.join(__dirname$2, "../template/project");
+    const isEmpty = await isDirEmpty$1(projectPath);
     if (!isEmpty) {
         console.error(`Directory "${projectName}" already exists and is not empty.`);
         process.exit(1);
     }
     console.log(`Creating project in ${projectPath}`);
-    await copyDir(templatePath, projectPath, { PROJECT_NAME: projectName });
+    await copyDir$1(templatePath, projectPath, { PROJECT_NAME: projectName });
     console.log(`Fetching docs...`);
     await runScript(path.join(projectPath, "scripts/fetch_docs.mjs"), projectPath);
     console.log(`Installing dependencies...`);
-    await runNpmInstall(projectPath);
+    await runNpmInstall$1(projectPath);
     console.log(`Done! Project created at ${projectPath}`);
     process.exit(0);
 };
+main$3();
+
+const __filename$1 = url.fileURLToPath((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('index.cjs', document.baseURI).href)));
+const __dirname$1 = path.dirname(__filename$1);
+async function isDirEmpty(dirPath) {
+    try {
+        const files = await fs$1.readdir(dirPath);
+        return files.length === 0;
+    }
+    catch (error) {
+        if (error.code === "ENOENT") {
+            return true;
+        }
+        throw error;
+    }
+}
+async function copyDir(srcDir, destDir) {
+    await fs$1.mkdir(destDir, { recursive: true });
+    const entries = await fs$1.readdir(srcDir, { withFileTypes: true });
+    for (const entry of entries) {
+        const srcPath = path.join(srcDir, entry.name);
+        if (entry.isDirectory()) {
+            await copyDir(srcPath, path.join(destDir, entry.name));
+            continue;
+        }
+        if (entry.name === ".gitkeep") {
+            continue;
+        }
+        const destPath = path.join(destDir, entry.name);
+        await fs$1.copyFile(srcPath, destPath);
+        console.log(`  -> ${destPath}`);
+    }
+}
+function runNpmInstall(cwd) {
+    return new Promise((resolve, reject) => {
+        const npm = process.platform === "win32" ? "npm.cmd" : "npm";
+        const child = child_process.spawn(npm, ["install"], { cwd, stdio: "inherit", shell: true });
+        child.on("close", (code) => {
+            if (code !== 0) {
+                reject(new Error(`npm install exited with code ${code}`));
+                return;
+            }
+            resolve();
+        });
+        child.on("error", reject);
+    });
+}
+const main$2 = 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.docker) {
+        return;
+    }
+    const projectName = values.output || "backtest-kit-docker";
+    const projectPath = path.join(process.cwd(), projectName);
+    const templatePath = path.join(__dirname$1, "../docker");
+    const isEmpty = await isDirEmpty(projectPath);
+    if (!isEmpty) {
+        console.error(`Directory "${projectName}" already exists and is not empty.`);
+        process.exit(1);
+    }
+    console.log(`Creating Docker workspace in ${projectPath}`);
+    await copyDir(templatePath, projectPath);
+    console.log(`Installing dependencies...`);
+    await runNpmInstall(projectPath);
+    console.log(`Done! Docker workspace created at ${projectPath}`);
+    console.log(`Next steps:`);
+    console.log(`  cd ${projectName}`);
+    console.log(`  docker compose up -d`);
+    console.log(`  docker compose logs -f`);
+    process.exit(0);
+};
 main$2();
 
 const ENTRY_PATH = "./node_modules/@backtest-kit/cli/build/index.mjs";
@@ -3646,8 +3732,10 @@ Modes:
   --editor              Open the Pine Script visual editor in the browser
   --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
   --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
   --help                Print this help message
 
 Backtest flags:
@@ -3733,6 +3821,17 @@ PnL debug flags (--pnldebug):
 
   Module file ./modules/pnldebug.module is loaded automatically if it exists.
 
+Broker debug flags (--brokerdebug):
+
+  --symbol      <string>   Trading pair (default: BTCUSDT)
+  --exchange    <string>   Exchange name (default: first registered)
+  --commit      <string>   Commit type to fire: signal-open, signal-close, partial-profit,
+                           partial-loss, average-buy, trailing-stop, trailing-take, breakeven
+                           (default: signal-open)
+
+  Loads ./live.module, fetches the last candle for --symbol/--timeframe, and calls
+  the selected broker commit with synthetic payload values derived from current price.
+
 Flush flags (--flush):
 
   One or more positional entry points. For each entry point the following
@@ -3746,6 +3845,14 @@ Init flags (--init):
 
   Scaffolds a project and runs scripts/fetch_docs.mjs to download library docs.
 
+Docker flags (--docker):
+
+  --output <string>   Target directory name (default: backtest-kit-docker)
+
+  Scaffolds a Docker workspace: docker-compose.yaml, .env.example, package.json,
+  tsconfig.json, and a sample strategy under content/. Run npm install then
+  docker compose up to start the container.
+
 Module hooks (loaded automatically by each mode):
 
   modules/backtest.module   --backtest   Broker adapter for backtest
@@ -3755,7 +3862,8 @@ Module hooks (loaded automatically by each mode):
   modules/pine.module       --pine       Exchange schema for PineScript runs
   modules/editor.module     --editor     Exchange schema for the visual Pine editor
   modules/dump.module       --dump       Exchange schema for candle dumps
-  modules/pnldebug.module   --pnldebug   Exchange schema for PnL debug runs
+  modules/pnldebug.module   --pnldebug      Exchange schema for PnL debug runs
+  modules/brokerdebug.module  --brokerdebug   Broker adapter used for broker commit testing
 
   --flush has no associated module. It only removes dump subdirectories.
 
@@ -3781,9 +3889,12 @@ Examples:
   node ${ENTRY_PATH} --dump --symbol BTCUSDT --timeframe 15m --limit 500 --jsonl
   node ${ENTRY_PATH} --pnldebug --symbol BTCUSDT --priceopen 64069.50 --direction short --when "2025-02-25" --minutes 120
   node ${ENTRY_PATH} --pnldebug --priceopen 67956.73 --direction long --when 1772064000000 --minutes 60 --markdown
+  node ${ENTRY_PATH} --brokerdebug --commit signal-open --symbol BTCUSDT
+  node ${ENTRY_PATH} --brokerdebug --commit partial-profit --symbol ETHUSDT
   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
+  node ${ENTRY_PATH} --docker --output my-docker-workspace
 `.trimStart();
 const main$1 = 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)))) {
@@ -3793,7 +3904,7 @@ const main$1 = async () => {
     if (!values.help) {
         return;
     }
-    process.stdout.write(`@backtest-kit/cli ${"8.1.0"}\n\n`);
+    process.stdout.write(`@backtest-kit/cli ${"8.3.0"}\n\n`);
     process.stdout.write(HELP_TEXT);
     process.exit(0);
 };
@@ -3807,7 +3918,7 @@ const main = async () => {
     if (!values.version) {
         return;
     }
-    process.stdout.write(`@backtest-kit/cli ${"8.1.0"}\n`);
+    process.stdout.write(`@backtest-kit/cli ${"8.3.0"}\n`);
     process.exit(0);
 };
 main();