@backtest-kit/cli 5.11.0 → 5.11.1

package/README.md

@@ -38,6 +38,9 @@ Point the CLI at your strategy file, choose a mode, and it handles exchange conn
 | **Live**         | `--live`                   | Real trades via exchange API                 |
 | **UI Dashboard** | `--ui`                     | Web dashboard at `http://localhost:60050`    |
 | **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   |
+| **Init Project** | `--init`                   | Scaffold a new backtest-kit project          |
 
 ## 🚀 Installation
 
@@ -705,6 +708,93 @@ Or add it to `package.json`:
 npx @backtest-kit/cli --dump --symbol BTCUSDT --timeframe 15m --limit 500 --jsonl
 ```
 
+## 🗂️ 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.
+
+### CLI Flags
+
+| Flag | Type | Description |
+|------|------|-------------|
+| `--init` | boolean | Scaffold a new project |
+| `--output` | string | Target directory name (default: `backtest-kit-project`) |
+
+### Usage
+
+```bash
+npx @backtest-kit/cli --init
+```
+
+Creates `./backtest-kit-project/` in the current working directory.
+
+Override the directory name with `--output`:
+
+```bash
+npx @backtest-kit/cli --init --output my-trading-bot
+```
+
+Creates `./my-trading-bot/`.
+
+The target directory must not exist or must be empty — the command aborts if it contains any files.
+
+### Generated Project Structure
+
+```
+backtest-kit-project/
+├── package.json              # pre-configured with all backtest-kit dependencies
+├── .gitignore
+├── CLAUDE.md                 # AI-agent guide for writing strategies
+├── content/
+│   └── feb_2026.strategy.ts  # example strategy entry point
+├── docs/
+│   ├── lib/                  # fetched automatically (see below)
+│   ├── backtest_actions.md
+│   ├── backtest_graph_pattern.md
+│   ├── backtest_logging_jsonl.md
+│   ├── backtest_pinets_usage.md
+│   ├── backtest_risk_async.md
+│   ├── backtest_strategy_structure.md
+│   ├── pine_debug.md
+│   └── pine_indicator_warmup.md
+├── math/
+│   └── feb_2026.pine         # example PineScript indicator
+├── modules/
+│   ├── dump.module.ts        # exchange schema for --dump mode
+│   └── pine.module.ts        # exchange schema for --pine mode
+├── report/
+│   └── feb_2026.md           # example strategy research report
+└── scripts/
+    └── fetch_docs.mjs        # utility: downloads library READMEs into docs/lib/
+```
+
+### Automatic Documentation Fetch
+
+After scaffolding, the CLI immediately runs `scripts/fetch_docs.mjs` inside the new project, which downloads the latest README files for all bundled libraries into `docs/lib/`:
+
+| File | Source |
+|------|--------|
+| `backtest-kit.md` | `backtest-kit` README |
+| `backtest-kit__graph.md` | `@backtest-kit/graph` README |
+| `backtest-kit__pinets.md` | `@backtest-kit/pinets` README |
+| `backtest-kit__cli.md` | `@backtest-kit/cli` README |
+| `garch.md` | `garch` README |
+| `volume-anomaly.md` | `volume-anomaly` README |
+| `agent-swarm-kit.md` | `agent-swarm-kit` README |
+| `functools-kit.md` | `functools-kit` README |
+
+You can re-run this script at any time to refresh the docs:
+
+```bash
+cd backtest-kit-project
+node ./scripts/fetch_docs.mjs
+```
+
+Or via the pre-configured npm script:
+
+```bash
+npm run sync:lib
+```
+
 ## 🌍 Environment Variables
 
 Create a `.env` file in your project root:

package/build/index.cjs

@@ -29,6 +29,7 @@ var BacktestKitGraph = require('@backtest-kit/graph');
 var BacktestKitOllama = require('@backtest-kit/ollama');
 var BacktestKitPinets = require('@backtest-kit/pinets');
 var BacktestKitSignals = require('@backtest-kit/signals');
+var child_process = require('child_process');
 
 var _documentCurrentScript = typeof document !== 'undefined' ? document.currentScript : null;
 function _interopNamespaceDefault(e) {
@@ -284,15 +285,15 @@ const TYPES = {
 
 const entrySubject = new functoolsKit.BehaviorSubject();
 
-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);
 let _is_launched = false;
 class ResolveService {
     constructor() {
         this.loggerService = inject(TYPES.loggerService);
         this.loaderService = inject(TYPES.loaderService);
-        this.DEFAULT_TEMPLATE_DIR = path.resolve(__dirname$1, '..', 'template');
-        this.DEFAULT_MODULES_DIR = path.resolve(__dirname$1, '..', 'modules');
+        this.DEFAULT_TEMPLATE_DIR = path.resolve(__dirname$2, '..', 'template');
+        this.DEFAULT_MODULES_DIR = path.resolve(__dirname$2, '..', 'modules');
         this.OVERRIDE_TEMPLATE_DIR = path.resolve(process.cwd(), 'template');
         this.OVERRIDE_MODULES_DIR = path.resolve(process.cwd(), 'modules');
         this.getIsLaunched = () => {
@@ -454,6 +455,10 @@ const ALLOWED_EXTENSIONS = [
     `.js`,
     `.pine`,
 ];
+const DISALLOWED_PATHS = [
+    "node_modules",
+    "@backtest-kit",
+];
 const getArgs = functoolsKit.singleshot(() => {
     const { values, positionals } = util.parseArgs({
         args: process.argv,
@@ -548,6 +553,10 @@ const getArgs = functoolsKit.singleshot(() => {
                 type: "boolean",
                 default: false,
             },
+            init: {
+                type: "boolean",
+                default: false,
+            },
         },
         strict: false,
         allowPositionals: true,
@@ -559,7 +568,9 @@ const getArgs = functoolsKit.singleshot(() => {
 });
 const getPositional = functoolsKit.singleshot(() => {
     const { positionals = [] } = getArgs();
-    const result = positionals.find((value) => ALLOWED_EXTENSIONS.some((ext) => value.endsWith(ext)));
+    const result = positionals
+        .filter((value) => !DISALLOWED_PATHS.some((path) => value.includes(path)))
+        .find((value) => ALLOWED_EXTENSIONS.some((ext) => value.endsWith(ext)));
     return result || null;
 });
 
@@ -2220,7 +2231,7 @@ const BEFORE_EXIT_FN$4 = functoolsKit.singleshot(async () => {
 const listenGracefulShutdown$4 = functoolsKit.singleshot(() => {
     process.on("SIGINT", BEFORE_EXIT_FN$4);
 });
-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;
     }
@@ -2231,7 +2242,7 @@ const main$6 = async () => {
     await cli.backtestMainService.connect();
     listenGracefulShutdown$4();
 };
-main$6();
+main$7();
 
 const BEFORE_EXIT_FN$3 = functoolsKit.singleshot(async () => {
     process.off("SIGINT", BEFORE_EXIT_FN$3);
@@ -2252,7 +2263,7 @@ const BEFORE_EXIT_FN$3 = functoolsKit.singleshot(async () => {
 const listenGracefulShutdown$3 = functoolsKit.singleshot(() => {
     process.on("SIGINT", BEFORE_EXIT_FN$3);
 });
-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;
     }
@@ -2263,7 +2274,7 @@ const main$5 = async () => {
     cli.paperMainService.connect();
     listenGracefulShutdown$3();
 };
-main$5();
+main$6();
 
 const BEFORE_EXIT_FN$2 = functoolsKit.singleshot(async () => {
     process.off("SIGINT", BEFORE_EXIT_FN$2);
@@ -2284,7 +2295,7 @@ const BEFORE_EXIT_FN$2 = functoolsKit.singleshot(async () => {
 const listenGracefulShutdown$2 = functoolsKit.singleshot(() => {
     process.on("SIGINT", BEFORE_EXIT_FN$2);
 });
-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;
     }
@@ -2295,7 +2306,7 @@ const main$4 = async () => {
     await cli.liveMainService.connect();
     listenGracefulShutdown$2();
 };
-main$4();
+main$5();
 
 const BEFORE_EXIT_FN$1 = functoolsKit.singleshot(async () => {
     process.off("SIGINT", BEFORE_EXIT_FN$1);
@@ -2305,7 +2316,7 @@ const BEFORE_EXIT_FN$1 = functoolsKit.singleshot(async () => {
 const listenGracefulShutdown$1 = functoolsKit.singleshot(() => {
     process.on("SIGINT", BEFORE_EXIT_FN$1);
 });
-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;
     }
@@ -2315,7 +2326,7 @@ const main$3 = async () => {
     }
     listenGracefulShutdown$1();
 };
-main$3();
+main$4();
 
 const BEFORE_EXIT_FN = functoolsKit.singleshot(async () => {
     process.off("SIGINT", BEFORE_EXIT_FN);
@@ -2325,7 +2336,7 @@ const BEFORE_EXIT_FN = functoolsKit.singleshot(async () => {
 const listenGracefulShutdown = functoolsKit.singleshot(() => {
     process.on("SIGINT", BEFORE_EXIT_FN);
 });
-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;
     }
@@ -2335,7 +2346,7 @@ const main$2 = async () => {
     }
     listenGracefulShutdown();
 };
-main$2();
+main$3();
 
 const EXTRACT_ROWS_FN = (plots, schema) => {
     const keys = Object.keys(schema);
@@ -2357,7 +2368,7 @@ const EXTRACT_ROWS_FN = (plots, schema) => {
     }
     return rows;
 };
-const main$1 = async () => {
+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;
     }
@@ -2429,9 +2440,9 @@ const main$1 = async () => {
     }
     console.log(await BacktestKitPinets.toMarkdown(signalId, plots, signalSchema));
 };
-main$1();
+main$2();
 
-const main = async () => {
+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)))) {
         return;
     }
@@ -2476,6 +2487,83 @@ const main = async () => {
     }
     console.log(JSON.stringify(candles, null, 2));
 };
+main$1();
+
+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 MUSTACHE_EXT = ".mustache";
+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, 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);
+            continue;
+        }
+        if (entry.name.endsWith(MUSTACHE_EXT)) {
+            const destName = entry.name.slice(0, -MUSTACHE_EXT.length);
+            const destPath = path.join(destDir, destName);
+            const template = await fs$1.readFile(srcPath, "utf-8");
+            const rendered = Mustache.render(template, data);
+            await fs$1.writeFile(destPath, rendered, "utf-8");
+            console.log(`  -> ${destPath}`);
+        }
+        else {
+            const destPath = path.join(destDir, entry.name);
+            await fs$1.copyFile(srcPath, destPath);
+            console.log(`  -> ${destPath}`);
+        }
+    }
+}
+function runScript(scriptPath, cwd) {
+    return new Promise((resolve, reject) => {
+        const node = process.execPath;
+        const child = child_process.spawn(node, [scriptPath], { cwd, stdio: "inherit" });
+        child.on("close", (code) => {
+            if (code !== 0) {
+                reject(new Error(`Script exited with code ${code}`));
+                return;
+            }
+            resolve();
+        });
+        child.on("error", reject);
+    });
+}
+const main = 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.init) {
+        return;
+    }
+    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);
+    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 });
+    console.log(`Fetching docs...`);
+    await runScript(path.join(projectPath, "scripts/fetch_docs.mjs"), projectPath);
+    console.log(`Done! Project created at ${projectPath}`);
+};
 main();
 
 function setLogger(logger) {

package/build/index.mjs

@@ -4,8 +4,8 @@ import { Storage, Notification, Markdown, Report, Dump, Memory, StorageLive, Sto
 import { getErrorMessage, errorData, singleshot, str, BehaviorSubject, compose, execpool, queued, sleep, randomString, createAwaiter, TIMEOUT_SYMBOL, typo, retry, trycatch, memoize } from 'functools-kit';
 import fs, { constants } from 'fs';
 import * as stackTrace from 'stack-trace';
-import path, { basename, extname, join, resolve } from 'path';
-import fs$1, { access, readFile, mkdir, writeFile } from 'fs/promises';
+import path, { basename, extname, join, resolve, dirname } from 'path';
+import fs$1, { access, readFile, mkdir, writeFile, readdir, copyFile } from 'fs/promises';
 import dotenv from 'dotenv';
 import { createActivator } from 'di-kit';
 import { fileURLToPath } from 'url';
@@ -30,6 +30,7 @@ import * as BacktestKitOllama from '@backtest-kit/ollama';
 import * as BacktestKitPinets from '@backtest-kit/pinets';
 import { run as run$1, Code, toMarkdown } from '@backtest-kit/pinets';
 import * as BacktestKitSignals from '@backtest-kit/signals';
+import { spawn } from 'child_process';
 
 /**
  * Fix for `Attempted to assign to readonly property (at redactToken)`
@@ -259,15 +260,15 @@ const TYPES = {
 
 const entrySubject = new BehaviorSubject();
 
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
+const __filename$1 = fileURLToPath(import.meta.url);
+const __dirname$1 = path.dirname(__filename$1);
 let _is_launched = false;
 class ResolveService {
     constructor() {
         this.loggerService = inject(TYPES.loggerService);
         this.loaderService = inject(TYPES.loaderService);
-        this.DEFAULT_TEMPLATE_DIR = path.resolve(__dirname, '..', 'template');
-        this.DEFAULT_MODULES_DIR = path.resolve(__dirname, '..', 'modules');
+        this.DEFAULT_TEMPLATE_DIR = path.resolve(__dirname$1, '..', 'template');
+        this.DEFAULT_MODULES_DIR = path.resolve(__dirname$1, '..', 'modules');
         this.OVERRIDE_TEMPLATE_DIR = path.resolve(process.cwd(), 'template');
         this.OVERRIDE_MODULES_DIR = path.resolve(process.cwd(), 'modules');
         this.getIsLaunched = () => {
@@ -429,6 +430,10 @@ const ALLOWED_EXTENSIONS = [
     `.js`,
     `.pine`,
 ];
+const DISALLOWED_PATHS = [
+    "node_modules",
+    "@backtest-kit",
+];
 const getArgs = singleshot(() => {
     const { values, positionals } = parseArgs({
         args: process.argv,
@@ -523,6 +528,10 @@ const getArgs = singleshot(() => {
                 type: "boolean",
                 default: false,
             },
+            init: {
+                type: "boolean",
+                default: false,
+            },
         },
         strict: false,
         allowPositionals: true,
@@ -534,7 +543,9 @@ const getArgs = singleshot(() => {
 });
 const getPositional = singleshot(() => {
     const { positionals = [] } = getArgs();
-    const result = positionals.find((value) => ALLOWED_EXTENSIONS.some((ext) => value.endsWith(ext)));
+    const result = positionals
+        .filter((value) => !DISALLOWED_PATHS.some((path) => value.includes(path)))
+        .find((value) => ALLOWED_EXTENSIONS.some((ext) => value.endsWith(ext)));
     return result || null;
 });
 
@@ -2191,7 +2202,7 @@ const BEFORE_EXIT_FN$4 = singleshot(async () => {
 const listenGracefulShutdown$4 = singleshot(() => {
     process.on("SIGINT", BEFORE_EXIT_FN$4);
 });
-const main$6 = async () => {
+const main$7 = async () => {
     if (!getEntry(import.meta.url)) {
         return;
     }
@@ -2202,7 +2213,7 @@ const main$6 = async () => {
     await cli.backtestMainService.connect();
     listenGracefulShutdown$4();
 };
-main$6();
+main$7();
 
 const BEFORE_EXIT_FN$3 = singleshot(async () => {
     process.off("SIGINT", BEFORE_EXIT_FN$3);
@@ -2223,7 +2234,7 @@ const BEFORE_EXIT_FN$3 = singleshot(async () => {
 const listenGracefulShutdown$3 = singleshot(() => {
     process.on("SIGINT", BEFORE_EXIT_FN$3);
 });
-const main$5 = async () => {
+const main$6 = async () => {
     if (!getEntry(import.meta.url)) {
         return;
     }
@@ -2234,7 +2245,7 @@ const main$5 = async () => {
     cli.paperMainService.connect();
     listenGracefulShutdown$3();
 };
-main$5();
+main$6();
 
 const BEFORE_EXIT_FN$2 = singleshot(async () => {
     process.off("SIGINT", BEFORE_EXIT_FN$2);
@@ -2255,7 +2266,7 @@ const BEFORE_EXIT_FN$2 = singleshot(async () => {
 const listenGracefulShutdown$2 = singleshot(() => {
     process.on("SIGINT", BEFORE_EXIT_FN$2);
 });
-const main$4 = async () => {
+const main$5 = async () => {
     if (!getEntry(import.meta.url)) {
         return;
     }
@@ -2266,7 +2277,7 @@ const main$4 = async () => {
     await cli.liveMainService.connect();
     listenGracefulShutdown$2();
 };
-main$4();
+main$5();
 
 const BEFORE_EXIT_FN$1 = singleshot(async () => {
     process.off("SIGINT", BEFORE_EXIT_FN$1);
@@ -2276,7 +2287,7 @@ const BEFORE_EXIT_FN$1 = singleshot(async () => {
 const listenGracefulShutdown$1 = singleshot(() => {
     process.on("SIGINT", BEFORE_EXIT_FN$1);
 });
-const main$3 = async () => {
+const main$4 = async () => {
     if (!getEntry(import.meta.url)) {
         return;
     }
@@ -2286,7 +2297,7 @@ const main$3 = async () => {
     }
     listenGracefulShutdown$1();
 };
-main$3();
+main$4();
 
 const BEFORE_EXIT_FN = singleshot(async () => {
     process.off("SIGINT", BEFORE_EXIT_FN);
@@ -2296,7 +2307,7 @@ const BEFORE_EXIT_FN = singleshot(async () => {
 const listenGracefulShutdown = singleshot(() => {
     process.on("SIGINT", BEFORE_EXIT_FN);
 });
-const main$2 = async () => {
+const main$3 = async () => {
     if (!getEntry(import.meta.url)) {
         return;
     }
@@ -2306,7 +2317,7 @@ const main$2 = async () => {
     }
     listenGracefulShutdown();
 };
-main$2();
+main$3();
 
 const EXTRACT_ROWS_FN = (plots, schema) => {
     const keys = Object.keys(schema);
@@ -2328,7 +2339,7 @@ const EXTRACT_ROWS_FN = (plots, schema) => {
     }
     return rows;
 };
-const main$1 = async () => {
+const main$2 = async () => {
     if (!getEntry(import.meta.url)) {
         return;
     }
@@ -2400,9 +2411,9 @@ const main$1 = async () => {
     }
     console.log(await toMarkdown(signalId, plots, signalSchema));
 };
-main$1();
+main$2();
 
-const main = async () => {
+const main$1 = async () => {
     if (!getEntry(import.meta.url)) {
         return;
     }
@@ -2447,6 +2458,83 @@ const main = async () => {
     }
     console.log(JSON.stringify(candles, null, 2));
 };
+main$1();
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const MUSTACHE_EXT = ".mustache";
+async function isDirEmpty(dirPath) {
+    try {
+        const files = await readdir(dirPath);
+        return files.length === 0;
+    }
+    catch (error) {
+        if (error.code === "ENOENT") {
+            return true;
+        }
+        throw error;
+    }
+}
+async function copyDir(srcDir, destDir, data) {
+    await mkdir(destDir, { recursive: true });
+    const entries = await readdir(srcDir, { withFileTypes: true });
+    for (const entry of entries) {
+        const srcPath = join(srcDir, entry.name);
+        if (entry.isDirectory()) {
+            await copyDir(srcPath, join(destDir, entry.name), data);
+            continue;
+        }
+        if (entry.name.endsWith(MUSTACHE_EXT)) {
+            const destName = entry.name.slice(0, -MUSTACHE_EXT.length);
+            const destPath = join(destDir, destName);
+            const template = await readFile(srcPath, "utf-8");
+            const rendered = Mustache.render(template, data);
+            await writeFile(destPath, rendered, "utf-8");
+            console.log(`  -> ${destPath}`);
+        }
+        else {
+            const destPath = join(destDir, entry.name);
+            await copyFile(srcPath, destPath);
+            console.log(`  -> ${destPath}`);
+        }
+    }
+}
+function runScript(scriptPath, cwd) {
+    return new Promise((resolve, reject) => {
+        const node = process.execPath;
+        const child = spawn(node, [scriptPath], { cwd, stdio: "inherit" });
+        child.on("close", (code) => {
+            if (code !== 0) {
+                reject(new Error(`Script exited with code ${code}`));
+                return;
+            }
+            resolve();
+        });
+        child.on("error", reject);
+    });
+}
+const main = async () => {
+    if (!getEntry(import.meta.url)) {
+        return;
+    }
+    const { values } = getArgs();
+    if (!values.init) {
+        return;
+    }
+    const projectName = values.output || "backtest-kit-project";
+    const projectPath = join(process.cwd(), projectName);
+    const templatePath = join(__dirname, "../../template/project");
+    const isEmpty = await isDirEmpty(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 });
+    console.log(`Fetching docs...`);
+    await runScript(join(projectPath, "scripts/fetch_docs.mjs"), projectPath);
+    console.log(`Done! Project created at ${projectPath}`);
+};
 main();
 
 function setLogger(logger) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@backtest-kit/cli",
-  "version": "5.11.0",
+  "version": "5.11.1",
   "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",