@insiderfinance/totalfinance 0.1.0

package/modules/backtest/dist/options/types.d.ts

@@ -0,0 +1,571 @@
+/**
+ * `@insiderfinance/totalfinance/backtest/options` — types for the chain-driven options-strategy backtester.
+ *
+ * The product surface is DECLARATIVE (matching `@insiderfinance/totalfinance/strategy`'s builders and the library's
+ * S1 input-object idiom): a strategy is `{ entry, exit, roll?, hedge? }` config, with callback
+ * escape hatches (`entry.when` / `entry.build` / `exit.when` / `roll.when`) for the tail. The engine
+ * composes proven primitives — `strategyFromChain` for entry, `Position.value()` for marking,
+ * `optionsMargin` for sizing — so it is a thin, honest driver, never a re-implementation.
+ *
+ * Stage 4.6 (FC8 Decision 5): the single open slot is a position BOOK. `entry` may be one rule or
+ * several (each with an `id`), `book` bounds how many trades may be open, `limits` are pre-trade
+ * gates evaluated on the post-trade book through `@insiderfinance/totalfinance/risk`, `fillPolicy` says whether a
+ * structure fills as one combo or leg by leg, `quoteFreshness` refuses fills on stale quotes exactly
+ * as marking refuses stale marks, `corporateActions` adjust open legs with lineage, `dividends` are
+ * early-assignment evidence, and the run emits the portfolio ledger it reconciles to. Every
+ * existing request runs unchanged: `book.maximumOpenPositions` defaults to 1.
+ */
+import type { NormalizedFill } from '../../../portfolio/dist/index.js';
+import type { CorporateAction, Diagnostics, EpochMs, PriceSource } from '../../../core/dist/index.js';
+import type { Greeks } from '../../../options/dist/index.js';
+import type { PortfolioLedgerSnapshot, PortfolioTimelineResult } from '../../../portfolio/dist/index.js';
+import type { PnlExplain } from '../../../risk/dist/index.js';
+import type { OptionQuote } from '../../../core/dist/index.js';
+import type { FromChainType, Leg, Position } from '../../../strategy/dist/index.js';
+import type { PerformanceSummary } from '../../../performance/dist/index.js';
+import type { CostModel, SlippageModel } from '../costs.js';
+import type { EquityPoint, OptionSettlement } from '../types.js';
+/** One dated option chain: every listed quote at a single point in time (the backtest's tick). */
+export interface ChainSnapshot {
+    /**
+     * Snapshot instant — epoch ms or a zoned ISO datetime. A bare `'YYYY-MM-DD'` is refused: the
+     * time of day prices the chain. An end-of-day chain is observed at the close —
+     * `usEquitySessionInstant(date, 'close')` from `@insiderfinance/totalfinance/core`.
+     */
+    asOf: EpochMs | string;
+    /** Underlying spot at this snapshot (the mark for pricing and delta-hedging). */
+    underlyingPrice: number;
+    /**
+     * Every listed contract's quote. Delta-based strike selection reads `greeks.delta` per quote (stamp
+     * it with `@insiderfinance/totalfinance/options` `chainGreeks` if your source lacks it); other selections do not need it.
+     */
+    quotes: OptionQuote[];
+}
+/** Which listed expiry to trade: the one whose days-to-expiry is nearest `target`, within `[min,max]`. */
+export interface DaysToExpiryTarget {
+    /** Preferred days to expiry. */
+    target: number;
+    /** Reject expiries with fewer DTE than this (default: no floor). */
+    min?: number;
+    /** Reject expiries with more DTE than this (default: no ceiling). */
+    max?: number;
+}
+/** When to open a position: only when this rule is flat (default), whenever the book has room, or a caller predicate. */
+export type EntryWhen = 'flat' | 'always' | ((context: EntryContext) => boolean);
+/** Context passed to entry callbacks (`when` / `build`). */
+export interface EntryContext {
+    snapshot: ChainSnapshot;
+    asOf: EpochMs;
+    cash: number;
+    equity: number;
+    /** True when this rule has no open trade. */
+    flat: boolean;
+    /** Trades open in the book at the decision instant, every rule's (Stage 4.6). */
+    openTrades: readonly OpenTradeView[];
+}
+/** What a callback may see of an open trade: identity, structure, and the current mark. */
+export interface OpenTradeView {
+    tradeId: number;
+    ruleId: string;
+    structure: string;
+    underlying: string;
+    entryAsOf: EpochMs;
+    entryPremium: number;
+    markToMarket: number;
+    legs: readonly Leg[];
+}
+/** How to size a position: a fixed contract count, or margin-aware (largest count within a budget). */
+export type Sizing = {
+    quantity: number;
+} | {
+    maxMarginFraction: number;
+};
+interface EntryCommon {
+    /** Names the rule in trades and rows (default `rule-<index>`); unique across the rules. */
+    id?: string;
+    /** Gate for opening (default `'flat'`). */
+    when?: EntryWhen;
+    /** Expiry selection by days-to-expiry. */
+    daysToExpiry: DaysToExpiryTarget;
+    /** Contract sizing (default `{ quantity: 1 }`). */
+    sizing?: Sizing;
+    /** Fill price source for entry (default `'mid'`). */
+    price?: PriceSource;
+}
+/** Multi-expiry selection for calendars and diagonals: the near leg by delta, the far leg by days. */
+export interface MultiExpirySelection {
+    /** Target |delta| of the short near leg. */
+    shortDelta: number;
+    /** Days-to-expiry target of the near (short) expiry. */
+    nearDaysToExpiry: DaysToExpiryTarget;
+    /** Days-to-expiry target of the far (long) expiry; must resolve to a later expiry than the near one. */
+    farDaysToExpiry: DaysToExpiryTarget;
+    /** Strike distance of the far leg from the near leg (diagonals: required; calendars: not allowed). */
+    width?: number;
+}
+/**
+ * The entry rule — a discriminated union over `structure`, mirroring `strategyFromChain`'s option
+ * grammar so the declarative form maps 1:1 onto the library. The `build` variant is the full escape
+ * hatch: return a `Position` (or `null` to skip) built however you like from the snapshot.
+ */
+export type EntryRule = (EntryCommon & {
+    structure: 'ironCondor';
+    select: {
+        shortDelta: number;
+        wingWidth: number;
+    };
+}) | (EntryCommon & {
+    structure: 'bullCallSpread' | 'bearCallSpread' | 'bullPutSpread' | 'bearPutSpread';
+    select: {
+        shortDelta: number;
+        width: number;
+    };
+}) | (EntryCommon & {
+    structure: 'strangle';
+    select: {
+        shortDelta: number;
+    };
+}) | (EntryCommon & {
+    structure: 'straddle';
+    select?: {
+        strike?: number;
+    };
+}) | (EntryCommon & {
+    structure: 'coveredCall';
+    select: {
+        shortDelta: number;
+        stockPrice?: number;
+    };
+}) | (EntryCommon & {
+    structure: 'protectivePut';
+    select: {
+        shortDelta: number;
+        stockPrice?: number;
+    };
+}) | (EntryCommon & {
+    structure: 'calendarCallSpread' | 'calendarPutSpread';
+    select: MultiExpirySelection;
+}) | (EntryCommon & {
+    structure: 'diagonalCallSpread' | 'diagonalPutSpread' | 'doubleDiagonal';
+    select: MultiExpirySelection;
+}) | (EntryCommon & {
+    build: (context: EntryContext) => Position | null;
+});
+/** The declarative single-expiry `structure` values (a subset of {@link FromChainType}). */
+export type EntryStructure = Exclude<FromChainType, 'calendar'>;
+/** The declarative multi-expiry structures (Stage 4.6), built through `@insiderfinance/totalfinance/strategy`'s constructors. */
+export type MultiExpiryStructure = 'calendarCallSpread' | 'calendarPutSpread' | 'diagonalCallSpread' | 'diagonalPutSpread' | 'doubleDiagonal';
+/** Context passed to exit / roll callbacks. */
+export interface ExitContext {
+    snapshot: ChainSnapshot;
+    asOf: EpochMs;
+    position: Position;
+    /** Signed entry premium (positive = net debit paid, negative = net credit received). */
+    entryPremium: number;
+    /** Current mark-to-market P&L of the position, in account currency. */
+    markToMarket: number;
+    /** `mtm / |entryPremium|` — the fraction of the entry premium captured (+) or lost (−). */
+    pnlFraction: number;
+    /** Calendar days to expiry (nearest leg for a multi-expiry structure). */
+    daysToExpiry: number;
+    /** Aggregate share-equivalent delta of the position. */
+    netDelta: number;
+    greeks: Greeks;
+}
+/**
+ * When to close a position. Declarative triggers OR-combine with the `when` callback; the first to
+ * fire closes the trade (its name is recorded as the exit reason).
+ */
+export interface ExitRule {
+    /** Close when captured P&L reaches this fraction of the entry premium (e.g. `0.5` = 50%). */
+    profitTarget?: number;
+    /** Close when the loss reaches this multiple of the entry premium (e.g. `2` = 200%). */
+    stopLoss?: number;
+    /** Close at or below this many days to expiry. */
+    daysToExpiry?: number;
+    /** Arbitrary exit predicate (OR-combined with the declarative triggers). */
+    when?: (context: ExitContext) => boolean;
+}
+/** Roll instead of closing flat: when the rule fires, close and immediately re-enter via `entry`. */
+export interface RollRule {
+    /** When to roll (defaults to the same triggers as {@link ExitRule}). */
+    when?: ExitRule;
+}
+/** Keep the portfolio delta-neutral by trading the underlying whenever |net delta| exceeds the band. */
+export interface DeltaHedgeRule {
+    /** Rehedge to flat delta when the absolute share-equivalent net delta exceeds this many shares. */
+    deltaBand: number;
+    /** Slippage on the underlying hedge trades (defaults to the backtest's option slippage). */
+    slippage?: SlippageModel;
+    /** Commission on the underlying hedge trades (defaults to the backtest's option commission). */
+    commission?: CostModel;
+}
+/** Where one open option leg's volatility came from at one snapshot (Preview P1). */
+export type MarkSource = 'current-quote' | 'implied-from-price' | 'entry-volatility' | 'carried';
+/** Why a current contract quote could not mark a leg (Preview P1). */
+export type MissingMarkCause = 'missing' | 'ambiguous' | 'stale' | 'unpriceable';
+/**
+ * How open option legs are marked at every snapshot (Preview P1 — `docs/specs/options-backtest.md`,
+ * "Preview P1 amendment"). Every member is optional; the defaults are the truthful ones.
+ */
+export interface MarkingPolicy {
+    /**
+     * `'current-quote'` (DEFAULT) re-marks each open leg from the exact current-snapshot contract
+     * quote — its stated implied volatility, or one implied from the quote's selected price. `'entry'`
+     * holds each leg's entry volatility for the whole trade (the pre-P1 behaviour, now explicit).
+     */
+    volatility?: 'current-quote' | 'entry';
+    /**
+     * What happens when the current contract cannot mark a leg under `'current-quote'`: `'refuse'`
+     * (DEFAULT) throws `backtest.mark_unavailable` naming the leg, the snapshot, and the cause;
+     * `'entry-volatility'` marks THAT leg at its entry volatility for THAT snapshot;
+     * `'carry-last-volatility'` holds the leg's last successfully marked volatility (the mark still
+     * reprices for spot and time). Both fallbacks are counted per trade and warned once per cause.
+     */
+    missingMark?: 'refuse' | 'entry-volatility' | 'carry-last-volatility';
+    /**
+     * A current quote whose `timestampMs` is older than the snapshot's `asOf` by more than this is
+     * STALE and cannot mark (it falls to `missingMark`). Omitted ⇒ every quote a snapshot carries is
+     * current by definition of the snapshot.
+     */
+    maximumQuoteAgeMs?: number;
+}
+/** The applied marking policy, echoed in the assumptions. */
+export interface AppliedMarkingPolicy {
+    volatility: 'current-quote' | 'entry';
+    missingMark: 'refuse' | 'entry-volatility' | 'carry-last-volatility';
+    maximumQuoteAgeMs: number | null;
+}
+/** How many leg-snapshot marks of a trade came from each source (Preview P1 evidence). */
+export interface TradeMarkCounts {
+    /** Snapshots on which the trade was open and marked. */
+    snapshots: number;
+    currentQuote: number;
+    impliedFromPrice: number;
+    /** The `'entry'` policy AND the `'entry-volatility'` fallback. */
+    entryVolatility: number;
+    carried: number;
+}
+/** How many trades the book may hold (Stage 4.6). */
+export interface BookPolicy {
+    /** Open trades at once (default 1 — the shipped single-position behaviour; at most 10,000). */
+    maximumOpenPositions?: number;
+    /** Open trades per underlying (default: no bound). */
+    maximumPerUnderlying?: number;
+}
+/** Pre-trade limits evaluated on the post-trade book; a breach rejects the entry with a row. */
+export interface PortfolioLimits {
+    /** `optionsMargin` of the whole book ≤ fraction × equity. */
+    maximumMarginFraction?: number;
+    /** |Σ share-equivalent delta| per underlying ≤ this many shares. */
+    maximumNetDelta?: number;
+    /** |Σ vega| per underlying (account currency per 1.00 volatility) ≤ this. */
+    maximumNetVega?: number;
+    /** Premium at risk (Σ |entry premium|) in one underlying ≤ fraction × equity. */
+    maximumConcentration?: number;
+    /** The book's worst Taylor P&L over the shock grid (`scenarioGrid`) may not exceed fraction × equity. */
+    scenarioLoss?: {
+        /** Spot shocks as fractions (e.g. −0.1 for −10%). */
+        spotShocks: readonly number[];
+        /** Absolute volatility shocks (e.g. 0.05 for +5 points). */
+        volatilityShocks: readonly number[];
+        maximumLossFraction: number;
+    };
+}
+/** How a structure's legs fill at entry (Stage 4.6). */
+export interface FillPolicy {
+    /** `'combo'` (default) fills every leg at once or rejects the entry; `'legged'` fills legs in order. */
+    mode?: 'combo' | 'legged';
+    /** Under `'legged'`: reject a structure whose sequence stops early (default), or hold the filled legs. */
+    partialFill?: 'reject' | 'allow';
+    /** The per-leg fill side (default: the rule's `price`, else `'mid'`). */
+    price?: PriceSource;
+}
+/** A quote older than this at the decision instant cannot fill (the fill-side twin of `marking.maximumQuoteAgeMs`). */
+export interface QuoteFreshnessPolicy {
+    maximumQuoteAgeMs: number;
+}
+/** A cash dividend on an underlying — early-assignment and dividend-risk evidence. */
+export interface DividendRecord {
+    underlying: string;
+    /** Ex-dividend date, `YYYY-MM-DD`. */
+    exDate: string;
+    /** Per-share amount, > 0. */
+    amount: number;
+}
+export interface OptionsBacktestConfig {
+    /** Time-ordered (or unordered — the engine sorts) chain snapshots. */
+    chains: Iterable<ChainSnapshot>;
+    /** How open legs are marked at every snapshot (default: current quote; refuse a missing mark). */
+    marking?: MarkingPolicy;
+    /** Opening capital (default 100,000). */
+    initialCapital?: number;
+    /**
+     * Continuously-compounded risk-free rate (decimal) for every mark-to-market price and the
+     * assignment carry. REQUIRED: a backtest that silently priced at 4% was a financial assumption
+     * nobody stated.
+     */
+    riskFreeRate: number;
+    /** Continuous dividend yield for pricing (default 0). */
+    dividendYield?: number;
+    /** One rule (the shipped form); exactly one of `entry` and `rules` is given. */
+    entry?: EntryRule;
+    /** Several rules at once (Stage 4.6): each a member of the book, entered in order at every snapshot. */
+    rules?: readonly EntryRule[];
+    exit: ExitRule;
+    /** Roll instead of closing flat when the rule fires. */
+    roll?: RollRule;
+    /** Optional delta-hedging with the underlying. */
+    hedge?: DeltaHedgeRule;
+    /** Commission model for option trades (default none). */
+    commission?: CostModel;
+    /** Slippage model for option trades (default none). */
+    slippage?: SlippageModel;
+    /** American early-assignment modeling (default `'none'`; `'model'` uses the deep-ITM/ex-div heuristic). */
+    assignment?: 'model' | 'none';
+    /** Annualization factor for the performance summary (default 252). */
+    periodsPerYear?: number;
+    /** The book's capacity (default: one open trade). */
+    book?: BookPolicy;
+    /** Pre-trade limits on the post-trade book. */
+    limits?: PortfolioLimits;
+    /** Combo or legged fills; partial-fill policy; the per-leg fill side. */
+    fillPolicy?: FillPolicy;
+    /** Refuse fills on stale quotes. */
+    quoteFreshness?: QuoteFreshnessPolicy;
+    /** Splits and symbol changes adjust open legs with lineage; mergers and spin-offs on an open leg refuse. */
+    corporateActions?: readonly CorporateAction[];
+    /** Cash dividends: dividend-risk evidence per short call, early assignment under `assignment: 'model'`. */
+    dividends?: readonly DividendRecord[];
+    /** The account currency of the ledger (default `'USD'`). */
+    baseCurrency?: string;
+}
+/** Why a trade closed. */
+export type ExitReason = 'profit-target' | 'stop-loss' | 'daysToExpiry' | 'signal' | 'expiry' | 'assignment' | 'roll' | 'open-at-end';
+/** Per-leg realized P&L attribution for a closed (or marked-at-end) options trade. */
+export interface LegAttribution {
+    leg: Leg;
+    realizedPnl: number;
+}
+/**
+ * A closed trade's **greek P&L explain** (entry → exit): the realized gross mark P&L decomposed into
+ * greek contributions (the full 2nd-order Taylor + dividend carry) plus an honest `unexplained`
+ * residual, via `@insiderfinance/totalfinance/risk`'s `explainPositionPnl`. These are the **bare terms** —
+ * the backtest result carries the report envelope (`assumptions`/`diagnostics`) at the top level, so a
+ * per-trade row stays a plain record (matching `perLeg`). The terms sum exactly to `total`, which is
+ * anchored to the trade's gross (pre-cost) P&L: `total === realizedPnl + costs`. (The day-0 entry edge —
+ * fill vs. model mark — is a model/data effect, so it lives in `unexplained`, not a greek term.)
+ *
+ * Under the default `'current-quote'` marking (Preview P1) each leg is re-marked from its current
+ * contract quote, so `vega` (with `vanna`/`vomma`/`veta`) is a live term attributed per leg from the
+ * entry volatility to the exit volatility; under `marking.volatility: 'entry'` the leg volatility is
+ * held for the trade and those terms stay ~0. The rate is held fixed across the trade. See
+ * `explainPositionPnl` for the per-leg vol-attribution contract.
+ */
+export type TradePnlExplain = Omit<PnlExplain, 'assumptions' | 'diagnostics'>;
+/** A corporate action applied to an open trade's legs, with what changed. */
+export interface TradeLineage {
+    lineageId: string;
+    action: CorporateAction['type'];
+    effectiveDate: string;
+    asOf: EpochMs;
+    previous: {
+        underlying: string;
+        strikes: number[];
+        multiplier: number;
+    };
+    adjusted: {
+        underlying: string;
+        strikes: number[];
+        multiplier: number;
+    };
+}
+/** A leg a legged fill could not fill, with why. */
+export interface UnfilledLeg {
+    leg: Leg;
+    cause: 'missing' | 'ambiguous' | 'stale' | 'unpriceable';
+}
+/** One round-trip options trade in the backtest. */
+export interface OptionsTrade {
+    /** The structure as classified/constructed (e.g. `'bullPutSpread'`). */
+    structure: string;
+    entryAsOf: EpochMs;
+    /** Exit time, or `null` if still open at the end of the run. */
+    exitAsOf: EpochMs | null;
+    expiry: string;
+    contracts: number;
+    /** Signed entry premium (positive = debit paid, negative = credit received), in account currency. */
+    entryPremium: number;
+    /** Realized P&L over the trade, net of costs, in account currency. */
+    realizedPnl: number;
+    /** Total commission + slippage paid on entry and exit. */
+    costs: number;
+    exitReason: ExitReason;
+    perLeg: LegAttribution[];
+    legs: readonly Leg[];
+    /**
+     * Greek P&L attribution of the trade's gross mark P&L (entry → exit), via `explainPositionPnl`. The
+     * terms sum to `total` (≈ `realizedPnl + costs`); the `unexplained` residual is 3rd-order-and-higher.
+     * See {@link TradePnlExplain}.
+     */
+    pnlExplain: TradePnlExplain;
+    /** Where the trade's marks came from, counted over every open snapshot (Preview P1). */
+    marks: TradeMarkCounts;
+    /**
+     * The volatility each leg was LAST marked at, aligned to `legs` — `null` for a stock leg or a leg
+     * priced at intrinsic (expired/settled). Under `'current-quote'` this is the exit contract's
+     * volatility; under `'entry'` it is the entry volatility.
+     */
+    exitVolatilities: (number | null)[];
+    /** The book identity (Stage 4.6). */
+    tradeId: number;
+    ruleId: string;
+    underlying: string;
+    /** Ledger instrument ids aligned to `legs` (OCC symbols for options, the underlying for stock). */
+    legInstrumentIds: string[];
+    /** Corporate actions applied while the trade was open, oldest first. */
+    lineage: TradeLineage[];
+    /** True when a legged fill held fewer legs than the structure names. */
+    partial: boolean;
+    unfilledLegs: UnfilledLeg[];
+    /** Legs settled before the trade closed (a calendar's near leg, an early assignment), aligned to `legs` by `legIndex`. */
+    legSettlements: Array<{
+        legIndex: number;
+        settlement: OptionSettlement;
+    }>;
+}
+/** An entry a limit rejected (Stage 4.6): the limit, the value the book would have had, the bound. */
+export interface LimitRejection {
+    asOf: EpochMs;
+    ruleId: string;
+    structure: string;
+    limit: keyof PortfolioLimits;
+    value: number;
+    bound: number;
+    /** `backtest.limit_rejected` */
+    code: string;
+}
+/** An entry the fill policy rejected (Stage 4.6): the legs that could not fill and why. */
+export interface FillRejection {
+    asOf: EpochMs;
+    ruleId: string;
+    structure: string;
+    mode: 'combo' | 'legged';
+    unfilledLegs: UnfilledLeg[];
+    /** `backtest.combo_leg_unfilled` */
+    code: string;
+}
+/** Dividend-risk evidence for one open short call at a snapshot before an ex-date. */
+export interface DividendRiskRow {
+    tradeId: number;
+    legIndex: number;
+    underlying: string;
+    exDate: string;
+    dividend: number;
+    /** The call's extrinsic value per share at the snapshot. */
+    extrinsic: number;
+    /** True when the dividend exceeds the extrinsic value — the classic early-assignment condition. */
+    atRisk: boolean;
+}
+/** The volatility surface's evolution, one row per snapshot (bounded by the snapshot count). */
+export interface SurfaceRow {
+    asOf: EpochMs;
+    /** At-the-money implied volatility per listed expiry (the nearest strike to spot with a volatility). */
+    atTheMoneyVolatilityByExpiry: Record<string, number>;
+    /** IV(25Δ put) − IV(25Δ call) of the nearest listed expiry, or `null` when the chain carries no deltas. */
+    skew25Delta: number | null;
+    /** Where this snapshot's leg marks came from, across every open trade. */
+    markSources: TradeMarkCounts;
+    dividendRisk: DividendRiskRow[];
+}
+/** Applied conventions, echoed (the envelope law). */
+export interface OptionsBacktestAssumptions {
+    conventionsVersion: string;
+    initialCapital: number;
+    riskFreeRate: number;
+    dividendYield: number;
+    /** Fill price source for entries/exits. */
+    priceSource: PriceSource;
+    /** How positions were sized. */
+    sizing: 'fixed-quantity' | 'margin-aware';
+    commission: string;
+    slippage: string;
+    assignment: 'model' | 'none';
+    /** Delta-hedge band in share-equivalents, or `'none'`. */
+    hedge: number | 'none';
+    periodsPerYear: number;
+    /** The applied marking and missing-mark policies (Preview P1). */
+    marking: AppliedMarkingPolicy;
+    /** Stage 4.6: the book, the limits, the fill policy, the freshness policy, and the rules. */
+    book: {
+        maximumOpenPositions: number;
+        maximumPerUnderlying: number | null;
+    };
+    limits: {
+        maximumMarginFraction: number | null;
+        maximumNetDelta: number | null;
+        maximumNetVega: number | null;
+        maximumConcentration: number | null;
+        scenarioLoss: {
+            spotShocks: number[];
+            volatilityShocks: number[];
+            maximumLossFraction: number;
+        } | null;
+    };
+    fillPolicy: {
+        mode: 'combo' | 'legged';
+        partialFill: 'reject' | 'allow';
+        price: PriceSource;
+    };
+    quoteFreshness: {
+        maximumQuoteAgeMs: number | null;
+    };
+    rules: Array<{
+        id: string;
+        structure: string;
+    }>;
+    corporateActions: number;
+    dividends: number;
+    baseCurrency: string;
+    ledger: {
+        sourceId: string;
+        accountId: string;
+        lotRelief: string;
+    };
+    /** `false` exactly when a caller function (a `build`, a `when`) participated. */
+    replayable: boolean;
+}
+/** The result of an options backtest. */
+export interface OptionsBacktestResult {
+    points: EquityPoint[];
+    returns: number[];
+    trades: OptionsTrade[];
+    settlements: OptionSettlement[];
+    /** Every fill the book placed — the same `NormalizedFill`s the ledger folded (Decision 2). */
+    fills: NormalizedFill[];
+    finalValue: number;
+    performance: PerformanceSummary;
+    assumptions: OptionsBacktestAssumptions;
+    diagnostics: OptionsBacktestDiagnostics;
+    /** Stage 4.6: the book's rows and the ledger. */
+    limitRejections: LimitRejection[];
+    fillRejections: FillRejection[];
+    surface: SurfaceRow[];
+    ledger: PortfolioLedgerSnapshot;
+    timeline: PortfolioTimelineResult;
+    /** Content-addressed identity of the request (callbacks recorded as such). */
+    runId: string;
+}
+export interface OptionsBacktestDiagnostics extends Diagnostics {
+    snapshotCount: number;
+    tradeCount: number;
+    openAtEnd: number;
+    limitRejectionCount: number;
+    fillRejectionCount: number;
+    earlyAssignmentCount: number;
+    corporateActionsApplied: number;
+    /** The ledger's NAV minus the engine's equity at the worst mark — always 0 within 1e-6. */
+    reconciliationResidual: number;
+}
+export {};
+//# sourceMappingURL=types.d.ts.map

package/modules/backtest/dist/options/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/options/types.ts"],"names":[],"mappings":"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"}

package/modules/backtest/dist/options/types.js

@@ -0,0 +1,19 @@
+/**
+ * `@insiderfinance/totalfinance/backtest/options` — types for the chain-driven options-strategy backtester.
+ *
+ * The product surface is DECLARATIVE (matching `@insiderfinance/totalfinance/strategy`'s builders and the library's
+ * S1 input-object idiom): a strategy is `{ entry, exit, roll?, hedge? }` config, with callback
+ * escape hatches (`entry.when` / `entry.build` / `exit.when` / `roll.when`) for the tail. The engine
+ * composes proven primitives — `strategyFromChain` for entry, `Position.value()` for marking,
+ * `optionsMargin` for sizing — so it is a thin, honest driver, never a re-implementation.
+ *
+ * Stage 4.6 (FC8 Decision 5): the single open slot is a position BOOK. `entry` may be one rule or
+ * several (each with an `id`), `book` bounds how many trades may be open, `limits` are pre-trade
+ * gates evaluated on the post-trade book through `@insiderfinance/totalfinance/risk`, `fillPolicy` says whether a
+ * structure fills as one combo or leg by leg, `quoteFreshness` refuses fills on stale quotes exactly
+ * as marking refuses stale marks, `corporateActions` adjust open legs with lineage, `dividends` are
+ * early-assignment evidence, and the run emits the portfolio ledger it reconciles to. Every
+ * existing request runs unchanged: `book.maximumOpenPositions` defaults to 1.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/modules/backtest/dist/options/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/options/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG"}

package/modules/backtest/dist/paper/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * `@insiderfinance/totalfinance/backtest/paper` — the paper broker (Stage 7B.2, AT5, Decision 7): the first execution
+ * adapter, deterministic and credential-free. `submit` verifies the authorization grant and journals
+ * (one idempotency key, one plan; a retry returns the same receipt); `step` meets every open order with
+ * the market through the engines' own fill path and returns the fills and the ledger events; `cancel`,
+ * `deliver`, and `halt` are the hazard surface. Paper, backtest, and replay share fills, costs, and
+ * accounting exactly — the difference is who supplies the observations.
+ */
+export { createPaperBroker } from './paper.js';
+export { requireCreatePaperBrokerInput, requirePaperInstrument } from './validate.js';
+export { EXECUTION_RECEIPT_KIND, EXECUTION_RECEIPT_SCHEMA_VERSION } from './types.js';
+export type { CreatePaperBrokerInput, ExecutionReceipt, PaperBroker, PaperBrokerDescription, PaperCancelInput, PaperCancelResult, PaperDeliverInput, PaperDeliverResult, PaperHaltInput, PaperHaltResult, PaperInstrument, PaperStepInput, PaperStepResult, PaperSubmitInput, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/modules/backtest/dist/paper/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/paper/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,6BAA6B,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AACtF,OAAO,EAAE,sBAAsB,EAAE,gCAAgC,EAAE,MAAM,YAAY,CAAC;AACtF,YAAY,EACV,sBAAsB,EACtB,gBAAgB,EAChB,WAAW,EACX,sBAAsB,EACtB,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,EAClB,cAAc,EACd,eAAe,EACf,eAAe,EACf,cAAc,EACd,eAAe,EACf,gBAAgB,GACjB,MAAM,YAAY,CAAC"}

package/modules/backtest/dist/paper/index.js

@@ -0,0 +1,12 @@
+/**
+ * `@insiderfinance/totalfinance/backtest/paper` — the paper broker (Stage 7B.2, AT5, Decision 7): the first execution
+ * adapter, deterministic and credential-free. `submit` verifies the authorization grant and journals
+ * (one idempotency key, one plan; a retry returns the same receipt); `step` meets every open order with
+ * the market through the engines' own fill path and returns the fills and the ledger events; `cancel`,
+ * `deliver`, and `halt` are the hazard surface. Paper, backtest, and replay share fills, costs, and
+ * accounting exactly — the difference is who supplies the observations.
+ */
+export { createPaperBroker } from './paper.js';
+export { requireCreatePaperBrokerInput, requirePaperInstrument } from './validate.js';
+export { EXECUTION_RECEIPT_KIND, EXECUTION_RECEIPT_SCHEMA_VERSION } from './types.js';
+//# sourceMappingURL=index.js.map

package/modules/backtest/dist/paper/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/paper/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,6BAA6B,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AACtF,OAAO,EAAE,sBAAsB,EAAE,gCAAgC,EAAE,MAAM,YAAY,CAAC"}

package/modules/backtest/dist/paper/paper.d.ts

@@ -0,0 +1,8 @@
+import { type CreatePaperBrokerInput, type PaperBroker } from './types.js';
+/**
+ * Build the paper broker over a declared execution policy and a ledger's account. Every method is
+ * explicit about time (`now` / `asOf`), every journal write folds through the transition table,
+ * every fill is a `NormalizedFill` the ledger folds unchanged, and a retry is never a second order.
+ */
+export declare function createPaperBroker(input: CreatePaperBrokerInput): PaperBroker;
+//# sourceMappingURL=paper.d.ts.map