Resolve a ticker (+ optional fiscal year) to an EDGAR FilingRef. Lookup order: 1. Our curated KNOWN_CIKS — gives industry metadata for the

Flag items whose short body is legitimate (content filed elsewhere). Returns the number of items newly flagged. Mutates `items` in place.

Standard Platt: P(correct) = 1 / (1 + exp(a*x + b)). With `a < 0`, P increases with raw_score (the common case — higher raw confidenc

Yield (system, [(label, want_long_callable), ...]) for all 11 controls — deterministic.

{period_end: (filed, val)} for ANNUAL (~365-day) flow periods, earliest-filed per end (point-in-time). Used by fiscal-year factor agents (F-Score,

All series F-Score / accruals / asset-growth need, in one bundle.

Deterministic structural gate over the four substance items. Returns a list of human-readable failure reasons (empty == pass). The orchestrat

Lookahead invariants for a Task-4 BacktestResult: no episode opens before the window start, the benchmark anchors at 1.0 on bar 0, metrics are in

Daily in-market flag derived from a leg's executed trades. A position is held from a trade's `entry_date` (the fill bar) up to but not includ

Full pipeline. Returns FilingExtraction; cost is queried from ledger. `enable_l3=False` skips the L3 LLM self-consistency layer — useful for

Market-sell + server settlement. The lifecycle cancels open exits atomically.

Exponential moving average, seeded at the first defined value. `α = 2/(span+1)`. Accepts a series that may have leading `None`s (e.g. the MAC

Compact, rounded snapshot of all indicators as-of `as_of` (inclusive). Uses ONLY bars on/before `as_of`, so no future bar can leak into what the

{as-of date: (filed, val)} for INSTANT (balance-sheet) facts, earliest-filed per date (point-in-time).