@backtest-kit/cli 6.7.1 → 6.7.2

package/README.md

@@ -341,6 +341,67 @@ npm run backtest:dec
 
 Each strategy run produces its own `dump/` directory, making it straightforward to compare results across time periods — both by inspection and by pointing an AI agent at a specific strategy folder.
 
+## 🔗 Shared Import Aliases
+
+`@backtest-kit/cli` automatically turns every **top-level folder in `cwd`** into a bare import alias available inside any strategy file. No configuration needed — just create the folder.
+
+### How It Works
+
+When the CLI loads a strategy file, it scans the current working directory for subdirectories and registers each one as an import alias. The alias name is the folder name. Both barrel imports and deep subpath imports are supported:
+
+| Import | Resolves to |
+|--------|-------------|
+| `import { fn } from "utils"` | `<cwd>/utils/index.ts` (or `.js`, `.mjs`, `.cjs`) |
+| `import { calcRSI } from "math/rsi"` | `<cwd>/math/rsi.ts` |
+| `import { research } from "logic"` | `<cwd>/logic/index.ts` |
+| `import { ResearchResponseContract } from "logic/contract/ResearchResponse.contract"` | `<cwd>/logic/contract/ResearchResponse.contract.ts` |
+
+### Project Structure
+
+```
+my-project/
+├── utils/                    ← import { formatDate } from "utils"
+│   └── index.ts
+├── math/                     ← import { calcRSI } from "math/rsi"
+│   └── rsi.ts
+├── logic/                    ← import { research } from "logic"
+│   ├── index.ts              ←   barrel
+│   └── contract/
+│       └── ResearchResponse.contract.ts  ← import { ... } from "logic/contract/ResearchResponse.contract"
+└── content/
+    ├── feb_2026.strategy.ts  ← uses all three aliases freely
+    └── mar_2026.strategy.ts  ← same aliases, no duplication
+```
+
+This lets you extract shared utilities, math helpers, or AI agent logic (e.g. `agent-swarm-kit` workflows) into named folders and reuse them across every strategy in the project without relative path hell.
+
+### TypeScript Support
+
+Add a matching `paths` entry to your `tsconfig.json` so the editor resolves the aliases:
+
+```json
+{
+  "compilerOptions": {
+    "moduleResolution": "bundler",
+    "paths": {
+      "logic": ["./logic/index.ts"],
+      "logic/*": ["./logic/*"],
+      "math": ["./math/index.ts"],
+      "math/*": ["./math/*"],
+      "utils": ["./utils/index.ts"],
+      "utils/*": ["./utils/*"]
+    }
+  },
+  "include": [
+    "./logic",
+    "./math",
+    "./utils",
+    "./content",
+    "./modules",
+  ],
+}
+```
+
 ## 🔔 Integrations
 
 ### Web Dashboard (`--ui`)

package/build/index.cjs

@@ -239,6 +239,7 @@ class ResolveService {
         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.IMPORT_PATHS_DIR = process.cwd();
         this.getIsLaunched = () => {
             this.loggerService.log("resolveService getIsLaunched");
             return _is_launched;
@@ -2108,6 +2109,7 @@ class BabelService {
 }
 
 const USE_ESMODULE_DEFAULT = false;
+const IMPORT_PATHS_EXCLUDE = new Set(["dump", "logs", "node_modules"]);
 const TRANSPILE_FN = functoolsKit.memoize(([path]) => `${path}`, (path, code, self, require) => {
     const __filename = self.__filename;
     const __dirname = self.__dirname;
@@ -2206,6 +2208,20 @@ const ENTRY_FACTORY = (filePath, self, seen) => {
     }
     throw new Error(`Failed to load module at ${filePath} (basepath: ${self.params.path})`);
 };
+const READ_IMPORT_PATHS_MAP_FN = functoolsKit.singleshot((importPathsDir) => {
+    const entries = fs.readdirSync(importPathsDir, { withFileTypes: true });
+    const map = {};
+    for (const entry of entries) {
+        if (!entry.isDirectory()) {
+            continue;
+        }
+        if (IMPORT_PATHS_EXCLUDE.has(entry.name)) {
+            continue;
+        }
+        map[entry.name] = path.join(importPathsDir, entry.name);
+    }
+    return map;
+});
 const CREATE_BASE_REQUIRE_FN = (self, seen) => {
     const baseRequire = self.baseRequire();
     return new Proxy(baseRequire, {
@@ -2230,6 +2246,19 @@ const CREATE_BASE_REQUIRE_FN = (self, seen) => {
                 const child = self.fork(path.dirname(resolved));
                 return child.import(resolved, seen);
             }
+            const importPathsMap = READ_IMPORT_PATHS_MAP_FN(self.params.resolve.IMPORT_PATHS_DIR);
+            if (id in importPathsMap) {
+                const resolved = importPathsMap[id];
+                const child = self.fork(resolved);
+                return child.import(resolved, seen);
+            }
+            const importPathsKey = Object.keys(importPathsMap).find((key) => id === key || id.startsWith(`${key}/`));
+            if (importPathsKey) {
+                const subPath = id.slice(importPathsKey.length);
+                const resolved = path.join(importPathsMap[importPathsKey], subPath);
+                const child = self.fork(path.dirname(resolved));
+                return child.import(resolved, seen);
+            }
             return baseRequire(id);
         },
     });
@@ -2260,6 +2289,7 @@ class ClientLoader {
             path: basePath,
             babel: this.params.babel,
             logger: this.params.logger,
+            resolve: this.params.resolve,
         });
     }
     import(filePath, seen = new Set()) {
@@ -2304,9 +2334,11 @@ class LoaderService {
     constructor() {
         this.babelService = inject(TYPES.babelService);
         this.loggerService = inject(TYPES.loggerService);
+        this.resolveService = inject(TYPES.resolveService);
         this.getInstance = functoolsKit.memoize(([basePath]) => `${basePath}`, (basePath) => new ClientLoader({
             babel: this.babelService,
             logger: this.loggerService,
+            resolve: this.resolveService,
             path: basePath,
         }));
         this.import = (filePath, basePath = process.cwd()) => {
@@ -2541,7 +2573,7 @@ const main$b = async () => {
     if (MODES.some((mode) => values[mode])) {
         return;
     }
-    process.stdout.write(`@backtest-kit/cli ${"6.7.1"}\n`);
+    process.stdout.write(`@backtest-kit/cli ${"6.7.2"}\n`);
     process.stdout.write("\n");
     process.stdout.write(`Run with --help to see available commands.\n`);
     process.stdout.write("\n");
@@ -3109,7 +3141,7 @@ const main$1 = async () => {
     if (!values.help) {
         return;
     }
-    process.stdout.write(`@backtest-kit/cli ${"6.7.1"}\n\n`);
+    process.stdout.write(`@backtest-kit/cli ${"6.7.2"}\n\n`);
     process.stdout.write(HELP_TEXT);
     process.exit(0);
 };
@@ -3123,7 +3155,7 @@ const main = async () => {
     if (!values.version) {
         return;
     }
-    process.stdout.write(`@backtest-kit/cli ${"6.7.1"}\n`);
+    process.stdout.write(`@backtest-kit/cli ${"6.7.2"}\n`);
     process.exit(0);
 };
 main();

package/build/index.mjs

@@ -214,6 +214,7 @@ class ResolveService {
         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.IMPORT_PATHS_DIR = process.cwd();
         this.getIsLaunched = () => {
             this.loggerService.log("resolveService getIsLaunched");
             return _is_launched;
@@ -2083,6 +2084,7 @@ class BabelService {
 }
 
 const USE_ESMODULE_DEFAULT = false;
+const IMPORT_PATHS_EXCLUDE = new Set(["dump", "logs", "node_modules"]);
 const TRANSPILE_FN = memoize(([path]) => `${path}`, (path, code, self, require) => {
     const __filename = self.__filename;
     const __dirname = self.__dirname;
@@ -2177,6 +2179,20 @@ const ENTRY_FACTORY = (filePath, self, seen) => {
     }
     throw new Error(`Failed to load module at ${filePath} (basepath: ${self.params.path})`);
 };
+const READ_IMPORT_PATHS_MAP_FN = singleshot((importPathsDir) => {
+    const entries = fs.readdirSync(importPathsDir, { withFileTypes: true });
+    const map = {};
+    for (const entry of entries) {
+        if (!entry.isDirectory()) {
+            continue;
+        }
+        if (IMPORT_PATHS_EXCLUDE.has(entry.name)) {
+            continue;
+        }
+        map[entry.name] = path.join(importPathsDir, entry.name);
+    }
+    return map;
+});
 const CREATE_BASE_REQUIRE_FN = (self, seen) => {
     const baseRequire = self.baseRequire();
     return new Proxy(baseRequire, {
@@ -2201,6 +2217,19 @@ const CREATE_BASE_REQUIRE_FN = (self, seen) => {
                 const child = self.fork(path.dirname(resolved));
                 return child.import(resolved, seen);
             }
+            const importPathsMap = READ_IMPORT_PATHS_MAP_FN(self.params.resolve.IMPORT_PATHS_DIR);
+            if (id in importPathsMap) {
+                const resolved = importPathsMap[id];
+                const child = self.fork(resolved);
+                return child.import(resolved, seen);
+            }
+            const importPathsKey = Object.keys(importPathsMap).find((key) => id === key || id.startsWith(`${key}/`));
+            if (importPathsKey) {
+                const subPath = id.slice(importPathsKey.length);
+                const resolved = path.join(importPathsMap[importPathsKey], subPath);
+                const child = self.fork(path.dirname(resolved));
+                return child.import(resolved, seen);
+            }
             return baseRequire(id);
         },
     });
@@ -2231,6 +2260,7 @@ class ClientLoader {
             path: basePath,
             babel: this.params.babel,
             logger: this.params.logger,
+            resolve: this.params.resolve,
         });
     }
     import(filePath, seen = new Set()) {
@@ -2275,9 +2305,11 @@ class LoaderService {
     constructor() {
         this.babelService = inject(TYPES.babelService);
         this.loggerService = inject(TYPES.loggerService);
+        this.resolveService = inject(TYPES.resolveService);
         this.getInstance = memoize(([basePath]) => `${basePath}`, (basePath) => new ClientLoader({
             babel: this.babelService,
             logger: this.loggerService,
+            resolve: this.resolveService,
             path: basePath,
         }));
         this.import = (filePath, basePath = process.cwd()) => {
@@ -2512,7 +2544,7 @@ const main$b = async () => {
     if (MODES.some((mode) => values[mode])) {
         return;
     }
-    process.stdout.write(`@backtest-kit/cli ${"6.7.1"}\n`);
+    process.stdout.write(`@backtest-kit/cli ${"6.7.2"}\n`);
     process.stdout.write("\n");
     process.stdout.write(`Run with --help to see available commands.\n`);
     process.stdout.write("\n");
@@ -3080,7 +3112,7 @@ const main$1 = async () => {
     if (!values.help) {
         return;
     }
-    process.stdout.write(`@backtest-kit/cli ${"6.7.1"}\n\n`);
+    process.stdout.write(`@backtest-kit/cli ${"6.7.2"}\n\n`);
     process.stdout.write(HELP_TEXT);
     process.exit(0);
 };
@@ -3094,7 +3126,7 @@ const main = async () => {
     if (!values.version) {
         return;
     }
-    process.stdout.write(`@backtest-kit/cli ${"6.7.1"}\n`);
+    process.stdout.write(`@backtest-kit/cli ${"6.7.2"}\n`);
     process.exit(0);
 };
 main();

package/package.json

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

package/template/project/package.mustache

@@ -12,7 +12,7 @@
   "license": "ISC",
   "type": "commonjs",
   "dependencies": {
-    "@backtest-kit/cli": "^6.7.1",
+    "@backtest-kit/cli": "^6.7.2",
     "@backtest-kit/graph": "^6.7.0",
     "@backtest-kit/pinets": "^6.7.0",
     "@backtest-kit/ui": "^6.7.0",

package/types.d.ts

@@ -110,18 +110,28 @@ declare class FrameSchemaService {
 declare class LoaderService {
     private readonly babelService;
     private readonly loggerService;
+    private readonly resolveService;
     private getInstance;
     import: (filePath: string, basePath?: string) => any;
     check: (filePath: string, basePath?: string) => Promise<boolean>;
 }
 
-declare class ResolveService {
+interface IResolve {
+    DEFAULT_TEMPLATE_DIR: string;
+    DEFAULT_MODULES_DIR: string;
+    OVERRIDE_TEMPLATE_DIR: string;
+    OVERRIDE_MODULES_DIR: string;
+    IMPORT_PATHS_DIR: string;
+}
+
+declare class ResolveService implements IResolve {
     readonly loggerService: LoggerService;
     readonly loaderService: LoaderService;
     readonly DEFAULT_TEMPLATE_DIR: string;
     readonly DEFAULT_MODULES_DIR: string;
     readonly OVERRIDE_TEMPLATE_DIR: string;
     readonly OVERRIDE_MODULES_DIR: string;
+    readonly IMPORT_PATHS_DIR: string;
     getIsLaunched: () => boolean;
     attachPine: (pinePath: string) => Promise<string>;
     attachStrategy: (jsPath: string) => Promise<void>;