StateLiveAdapter

Implements TStateAdapter

Live trading state adapter with pluggable storage backend.

Features:

• Adapter pattern for swappable state instance implementations
• Default backend: StatePersistInstance (file-system backed, survives restarts)
• Alternative backends: StateLocalInstance, StateDummyInstance
• Convenience methods: useLocal(), usePersist(), useDummy(), useStateAdapter()
• Memoized instances per (signalId, bucketName) pair; cleared via disposeSignal() from StateAdapter

Primary use case — LLM-driven capitulation rule: Profitable trades endure -0.5–2.5% drawdown and still reach peak 2–3%+. SL trades never go positive (Feb25) or show peak < 0.15% (Feb08, Feb13). Rule: if position open >= N minutes and peakPercent < threshold (e.g. 0.3%), the LLM thesis was not confirmed by market — exit immediately. State persists { peakPercent, minutesOpen } per signal across process restarts.

Constructor

constructor();
Copy

Properties

StateFactory

StateFactory: any
Copy

getInstance

getInstance: any
Copy

disposeSignal

disposeSignal: (signalId: string) => void
Copy

Disposes all memoized instances for the given signalId. Called by StateAdapter when a signal is cancelled or closed.

getState

getState: <Value extends object = object>(dto: { signalId: string; bucketName: string; initialValue: object; }) => Promise<Value>
Copy

Read the current state value for a signal.

setState

setState: <Value extends object = object>(dispatch: Value | Dispatch<Value>, dto: { signalId: string; bucketName: string; initialValue: object; }) => Promise<Value>
Copy

Update the state value for a signal.

useLocal

useLocal: () => void
Copy

Switches to in-memory adapter. All data lives in process memory only.

usePersist

usePersist: () => void
Copy

Switches to file-system backed adapter (default). Data is persisted to disk via PersistStateAdapter.

useDummy

useDummy: () => void
Copy

Switches to dummy adapter that discards all writes.

useStateAdapter

useStateAdapter: (Ctor: TStateInstanceCtor) => void
Copy

Switches to a custom state adapter implementation.

clear

clear: () => void
Copy

Clears the memoized instance cache. Call this when process.cwd() changes between strategy iterations so new instances are created with the updated base path.