You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Commit ae0835d
Browse filesBrowse the repository at this point in the historyBrowse files
Copy file name to clipboardExpand all lines: docs/pages/live-surface.md
+6-5Lines changed: 6 additions & 5 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -3,7 +3,7 @@
3
3
@tableofcontents
4
4
5
5
**ABI v4** (`PF_ABI_VERSION == 4`) appends 24 exports and two `pf_report_t`
6
-
fields for `pineforge-live`, the recompute-based live runtime built on top
6
+
fields for the separate Python `pineforge-live`recompute-based project built on top
7
7
of this engine (see [`pineforge-workflow-live/docs/superpowers/specs/2026-09-07-pineforge-live-design.md` §3](https://github.com/pineforge-4pass/pineforge-workflow-live)
8
8
for the full contract this surface serves). Every one of the 24 symbols is
9
9
**default off / read-only** and **never changes a historical run**: the
@@ -12,10 +12,11 @@ accessor is a pure read over state the engine already computed for its own
12
12
internal use. Historical-identity is pinned by the L0 evidence in
13
13
[Evidence](#live_surface_evidence).
14
14
15
-
**No new evaluator.** Nothing here adds a second broker model —
16
-
`run_backtest_full` is still the only fill-deciding entry point. The live
17
-
runtime works by *recomputing* it (see @ref streaming for why the
18
-
`strategy_stream_*` lifecycle is not used instead).
15
+
**No new evaluator in this surface.** The Python runtime recomputes
16
+
`run_backtest_full`. The optional native C++ runner in this engine repository
17
+
uses `strategy_stream_*` instead (see @ref streaming and `runner/README.md`).
18
+
Its live extension API, journals and verification scope are separate from
The separate [Python `pineforge-live` project](https://github.com/pineforge-4pass/pineforge-live)
17
+
uses accumulated-bar `run_backtest_full` recomputation and the
18
+
[ABI v4 live surface](@ref live_surface) instead. Its verification evidence
19
+
and journals are separate from the native runner. Tick-stream fills at observed
20
+
prices/times can differ from batch OHLC path assumptions.
23
21
24
22
This is the runtime model used by a continuously running strategy:
25
23
26
24
1. Call #strategy_stream_begin with every confirmed historical input bar.
27
25
2. Feed normalized trades with #strategy_stream_push_tick, or pass one contiguous
28
26
replay tape to #strategy_stream_push_ticks.
29
-
3. Call #strategy_stream_advance_time at wall-clock boundaries, including
30
-
quiet periods where no trade arrived.
27
+
3. Call #strategy_stream_advance_time when the provider confirms no earlier
28
+
ticks remain, including quiet periods. A wall clock alone does not prove
29
+
that delayed source records have all arrived.
31
30
4. Call #strategy_stream_end, then snapshot cumulative state with
32
31
#strategy_stream_fill_report.
33
32
5. Release report arrays with #report_free and the instance with
0 commit comments