@backtest-kit/sidekick 0.1.0 → 0.1.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@backtest-kit/sidekick",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "The easiest way to create a new Backtest Kit trading bot project. Like create-react-app, but for algorithmic trading with LLM integration and technical analysis.",
   "author": {
     "name": "Petr Tripolsky",

package/src/classes/{PartialProfitTakingAction.mjs → BacktestPartialProfitTakingAction.mjs}

@@ -3,8 +3,8 @@ import { ActionBase, Constant, commitPartialProfit } from "backtest-kit";
 /**
  * Scale out at Kelly-optimized levels
  */
-export class PartialProfitTakingAction extends ActionBase {
-  async partialProfit({ symbol, level }) {
+export class BacktestPartialProfitTakingAction extends ActionBase {
+  async partialProfitAvailable({ symbol, level }) {
     if (level === Constant.TP_LEVEL3) {
       await commitPartialProfit(symbol, 33);
     }
@@ -17,4 +17,4 @@ export class PartialProfitTakingAction extends ActionBase {
   }
 }
 
-export default PartialProfitTakingAction;
+export default BacktestPartialProfitTakingAction;

package/src/classes/BacktestPositionMonitorAction.mjs

@@ -0,0 +1,53 @@
+import { ActionBase } from "backtest-kit";
+
+/**
+ * Monitors position lifecycle and logs open/close events in backtest mode
+ */
+export class BacktestPositionMonitorAction extends ActionBase {
+  async signalBacktest(event) {
+    switch (event.action) {
+      case "scheduled":
+        console.log(`[POSITION SCHEDULED] ${event.symbol}`);
+        console.log(`  Strategy: ${event.strategyName}`);
+        console.log(`  Current Price: ${event.currentPrice}`);
+        console.log(`  Entry Price: ${event.signal.priceOpen}`);
+        console.log(`  Signal ID: ${event.signal.id}`);
+        console.log(`  Direction: ${event.signal.position}`);
+        console.log(`  Stop Loss: ${event.signal.priceStopLoss}`);
+        console.log(`  Take Profit: ${event.signal.priceTakeProfit}`);
+        break;
+
+      case "opened":
+        console.log(`[POSITION OPENED] ${event.symbol}`);
+        console.log(`  Strategy: ${event.strategyName}`);
+        console.log(`  Entry Price: ${event.currentPrice}`);
+        console.log(`  Signal ID: ${event.signal.id}`);
+        console.log(`  Direction: ${event.signal.position}`);
+        console.log(`  Stop Loss: ${event.signal.priceStopLoss}`);
+        console.log(`  Take Profit: ${event.signal.priceTakeProfit}`);
+        break;
+
+      case "closed":
+        console.log(`[POSITION CLOSED] ${event.symbol}`);
+        console.log(`  Strategy: ${event.strategyName}`);
+        console.log(`  Entry Price (adj): ${event.pnl.priceOpen}`);
+        console.log(`  Exit Price (adj): ${event.pnl.priceClose}`);
+        console.log(`  Signal ID: ${event.signal.id}`);
+        console.log(`  Close Reason: ${event.closeReason}`);
+        console.log(`  PnL: ${event.pnl.pnlPercentage.toFixed(2)}%`);
+        console.log(`  Win: ${event.pnl.pnlPercentage > 0 ? "YES" : "NO"}`);
+        break;
+
+      case "cancelled":
+        console.log(`[POSITION CANCELLED] ${event.symbol}`);
+        console.log(`  Strategy: ${event.strategyName}`);
+        console.log(`  Signal ID: ${event.signal.id}`);
+        console.log(`  Current Price: ${event.currentPrice}`);
+        console.log(`  Cancel Reason: ${event.reason}`);
+        console.log(`  Cancelled At: ${new Date(event.closeTimestamp).toISOString()}`);
+        break;
+    }
+  }
+}
+
+export default BacktestPositionMonitorAction;

package/src/classes/BacktestTightenStopOnBreakevenAction.mjs

@@ -0,0 +1,13 @@
+import { ActionBase, commitTrailingStop } from "backtest-kit";
+
+/**
+ * Tightens trailing-stop by 3% when breakeven is reached
+ */
+export class BacktestTightenStopOnBreakevenAction extends ActionBase {
+  async breakevenAvailable({ symbol, currentPrice }) {
+    // Tighten trailing-stop by 3% (negative value brings stop-loss closer to entry)
+    await commitTrailingStop(symbol, -3, currentPrice);
+  }
+}
+
+export default BacktestTightenStopOnBreakevenAction;

package/src/config/params.mjs

@@ -0,0 +1 @@
+export const CC_OLLAMA_API_KEY = process.env.CC_OLLAMA_API_KEY || "";

package/src/enum/ActionName.mjs

@@ -1,3 +1,5 @@
 export default {
-  PartialProfitTakingAction: "partial_profit_taking_action",
+  BacktestPartialProfitTakingAction: "backtest_partial_profit_taking_action",
+  BacktestTightenStopOnBreakevenAction: "backtest_tighten_stop_on_breakeven_action",
+  BacktestPositionMonitorAction: "backtest_position_monitor_action",
 };

package/src/logic/action/backtest_partial_profit_taking.action.mjs

@@ -0,0 +1,9 @@
+import { addActionSchema } from "backtest-kit";
+import ActionName from "../../enum/ActionName.mjs";
+import { BacktestPartialProfitTakingAction } from "../../classes/BacktestPartialProfitTakingAction.mjs";
+
+addActionSchema({
+  actionName: ActionName.BacktestPartialProfitTakingAction,
+  handler: BacktestPartialProfitTakingAction,
+  note: "Scale out at Kelly-optimized levels (33%, 33%, 34%)",
+});

package/src/logic/action/backtest_position_monitor.action.mjs

@@ -0,0 +1,9 @@
+import { addActionSchema } from "backtest-kit";
+import ActionName from "../../enum/ActionName.mjs";
+import { BacktestPositionMonitorAction } from "../../classes/BacktestPositionMonitorAction.mjs";
+
+addActionSchema({
+  actionName: ActionName.BacktestPositionMonitorAction,
+  handler: BacktestPositionMonitorAction,
+  note: "Monitors and logs position lifecycle events (open/close/scheduled)",
+});

package/src/logic/action/backtest_tighten_stop_on_breakeven.action.mjs

@@ -0,0 +1,9 @@
+import { addActionSchema } from "backtest-kit";
+import ActionName from "../../enum/ActionName.mjs";
+import { BacktestTightenStopOnBreakevenAction } from "../../classes/BacktestTightenStopOnBreakevenAction.mjs";
+
+addActionSchema({
+  actionName: ActionName.BacktestTightenStopOnBreakevenAction,
+  handler: BacktestTightenStopOnBreakevenAction,
+  note: "Tighten trailing-stop by 3% when breakeven is reached",
+});

package/src/logic/index.mjs

@@ -1,6 +1,8 @@
 import "./exchange/binance.exchange.mjs";
 
-import "./action/partial_profit_taking.action.mjs";
+import "./action/backtest_partial_profit_taking.action.mjs";
+import "./action/backtest_tighten_stop_on_breakeven.action.mjs";
+import "./action/backtest_position_monitor.action.mjs";
 
 import "./frame/dec_2025.frame.mjs";
 import "./frame/nov_2025.frame.mjs";

package/src/logic/strategy/main.strategy.mjs

@@ -6,6 +6,8 @@ import { commitHistorySetup } from "../../func/market.func.mjs";
 import StrategyName from "../../enum/StrategyName.mjs";
 import RiskName from "../../enum/RiskName.mjs";
 
+import { CC_OLLAMA_API_KEY } from "../../config/params.mjs";
+
 addStrategySchema({
   strategyName: StrategyName.MainStrategy,
   interval: "5m",
@@ -19,7 +21,7 @@ addStrategySchema({
     return await ollama(
       messages,
       "glm-4.6:cloud",
-      process.env.CC_OLLAMA_API_KEY
+      CC_OLLAMA_API_KEY
     );
   },
   riskList: [

package/src/main/bootstrap.mjs

@@ -0,0 +1,52 @@
+import { Backtest, listenError, overrideStrategySchema } from "backtest-kit";
+
+import { getArgs } from "../utils/getArgs.mjs";
+
+import ActionName from "../enum/ActionName.mjs";
+
+const beginBacktest = async () => {
+  const { symbol, frameName, strategyName, exchangeName } = getArgs();
+
+  overrideStrategySchema({
+    strategyName,
+    actions: [
+      ActionName.BacktestPartialProfitTakingAction,
+      ActionName.BacktestTightenStopOnBreakevenAction,
+      ActionName.BacktestPositionMonitorAction,
+    ],
+  });
+
+  Backtest.background(symbol, {
+    strategyName,
+    frameName,
+    exchangeName,
+  });
+};
+
+const beginPaper = async () => {
+  throw new Error("Todo: implement");
+};
+
+const beginLive = async () => {
+  throw new Error("Todo: implement");
+};
+
+const main = async () => {
+  const { backtest, live, paper } = getArgs();
+
+  if (backtest) {
+    await beginBacktest();
+  }
+
+  if (paper) {
+    await beginPaper();
+  }
+
+  if (live) {
+    await beginLive();
+  }
+};
+
+listenError(console.log);
+
+main();

package/src/utils/getArgs.mjs

@@ -1,25 +1,17 @@
 import { singleshot } from "functools-kit";
-import { parseArgs } from "util";
+import { parseArgs } from "backtest-kit";
 
-export const getArgs = singleshot(() => {
-  const { values } = parseArgs({
-    args: process.argv,
-    options: {
-      strategy: {
-        type: "string",
-      },
-      backtest: {
-        type: "boolean",
-      },
-      paper: {
-        type: "boolean",
-      },
-      live: {
-        type: "boolean",
-      },
-    },
-    strict: false,
-    allowPositionals: true,
-  });
-  return values;
-});
+import ExchangeName from "../enum/ExchangeName.mjs";
+import StrategyName from "../enum/StrategyName.mjs";
+import FrameName from "../enum/FrameName.mjs";
+
+const DEFAULT_SYMBOL = "BTCUSDT";
+
+export const getArgs = singleshot(() => 
+  parseArgs({
+    exchangeName: ExchangeName.BinanceExchange,
+    strategyName: StrategyName.MainStrategy,
+    frameName: FrameName.October2025,
+    symbol: DEFAULT_SYMBOL,
+  })
+);

package/template/package.mustache

@@ -5,17 +5,16 @@
   "type": "module",
   "description": "Backtest Kit trading bot project",
   "scripts": {
-    "start": "node ./src/index.mjs",
-    "test": "echo \"Error: no test specified\" && exit 1"
+    "start": "node ./src/index.mjs --backtest"
   },
   "dependencies": {
-    "@backtest-kit/ollama": "^0.1.0",
-    "@backtest-kit/signals": "^0.1.0",
+    "@backtest-kit/ollama": "^0.1.1",
+    "@backtest-kit/signals": "^0.1.1",
     "@huggingface/inference": "^4.7.1",
     "@langchain/core": "^0.3.57",
     "@langchain/xai": "^0.0.2",
-    "agent-swarm-kit": "^1.1.181",
-    "backtest-kit": "^2.0.3",
+    "agent-swarm-kit": "^1.1.182",
+    "backtest-kit": "^2.0.7",
     "ccxt": "^4.4.41",
     "dotenv": "^16.4.7",
     "functools-kit": "^1.0.95",

package/src/logic/action/partial_profit_taking.action.mjs

@@ -1,8 +0,0 @@
-import { addActionSchema } from "backtest-kit";
-import ActionName from "../../enum/ActionName.mjs";
-import { PartialProfitTakingAction } from "../../classes/PartialProfitTakingAction.mjs";
-
-addActionSchema({
-  actionName: ActionName.PartialProfitTakingAction,
-  handler: PartialProfitTakingAction,
-});