@luxalgo/journal-core

@luxalgo/journal-core

The pure domain engine behind Trade Journal, LuxAlgo's open-source trade journal. No IO, no framework, zero runtime dependencies. Runs identically in Node and the browser.

npm install @luxalgo/journal-core

What it does

Feed it raw executions (fills); it gives you everything a journal displays.

import {
  buildRoundTrips,
  computeMetrics,
  computeEdgeScore,
  calendarMonth,
  dailyStats,
  dailyCumulative,
  equityCurve,
} from "@luxalgo/journal-core";

const trades = buildRoundTrips(executions, { method: "fifo" });
const metrics = computeMetrics(trades, { timeZone: "America/New_York" });
const edge = computeEdgeScore(metrics);
const calendar = calendarMonth(trades, 2026, 8, "America/New_York");

• buildRoundTrips turns fills into flat-to-flat trades: partial fills, scale-ins, flips, futures multipliers, FIFO / LIFO / weighted-average lot matching. Deterministic, with rebuild-stable trade keys.
• computeMetrics produces win rates, profit factor, expectancy, streaks, drawdown and recovery, R multiples, profit concentration.
• computeEdgeScore is the open, versioned 0 to 100 composite; the formula lives in docs/edge-score.md.
• calendarMonth, dailyStats, dailyCumulative, equityCurve, intradayCurve feed the calendar and every chart. Day bucketing is timezone-aware and DST-safe.

Fully unit-tested. MIT, part of the LuxAlgo open-source family.