alphaengine 0.8.0__tar.gz → 0.9.0__tar.gz

{alphaengine-0.8.0 → alphaengine-0.9.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: alphaengine
-Version: 0.8.0
+Version: 0.9.0
 Summary: Validated research tooling for investment strategies: deflation, overfitting detection, and honest trial counts.
 Project-URL: Homepage, https://github.com/quantOSC/alphaengine
 Project-URL: Documentation, https://github.com/quantOSC/alphaengine#readme
@@ -36,8 +36,11 @@ Requires-Dist: pytest-cov>=5.0; extra == 'dev'
 Requires-Dist: pytest>=8.0; extra == 'dev'
 Requires-Dist: ruff==0.16.1; extra == 'dev'
 Requires-Dist: statsmodels>=0.14; extra == 'dev'
+Requires-Dist: textual>=1.0; extra == 'dev'
 Provides-Extra: factors
 Requires-Dist: statsmodels>=0.14; extra == 'factors'
+Provides-Extra: tui
+Requires-Dist: textual>=1.0; extra == 'tui'
 Description-Content-Type: text/markdown
 
 <p align="center">
@@ -61,24 +64,46 @@ Description-Content-Type: text/markdown
 </p>
 
 ```bash
-pip install alphaengine
-alphaengine demo          # the whole offline half, no account, no data of your own
-alphaengine process       # fit a DGP to the demo walk and stress it
+pip install alphaengine                 # library and one-shot commands
+pip install "alphaengine[tui]"          # the full-screen session
+alphaengine demo                        # offline. no account, no data of yours
+alphaengine                             # the session
+alphaengine process                     # fit a DGP to the demo walk and stress it
 ```
 
-<p align="center">
-  <img src="docs/assets/session.png" alt="The session canvas: tracked ALPHAENGINE over a teal plateau and amber ridge, then your data never leaves." width="92%">
-</p>
+If the shell cannot find `alphaengine`, this always works:
+
+```bash
+python -m alphaengine demo
+python -m alphaengine
+```
+
+```
+┌──────────┬─────────────────────────────────────┬──────────────────┐
+│ ● maths  │  Ask in plain English.              │  sharpe          │
+│   always │                                     │  mean / std √252 │
+│ ○ flows  │  > which names are overbought?      │  ▁▂▃▅▇█▇▅▃       │
+│ ○ ask    │                                     │  0    0.0012     │
+│          │  chose screen_universe              │  1   -0.0040     │
+│ loaded   │                                     │                  │
+│  sp500   │                                     │                  │
+└──────────┴─────────────────────────────────────┴──────────────────┘
+```
 
-The session is the product. Sign in, load something, then ask:
+There is one session, and it is this screen. A sentence picks a workflow.
+`run <name>` follows that workflow exactly. The math pane opens when a run
+has a statistic to show.
 
 ```bash
 alphaengine
-❯ login
-❯ load prices.csv
-❯ screen
+> login
+> load prices.csv
+> screen
 ```
 
+Prices stay on this machine. A math line's series can travel on its own trace
+so it can be charted. The figures posted with the step stay summaries.
+
 ---
 
 ## What it answers
@@ -193,6 +218,17 @@ distinction is the whole of the data boundary below.
 
 ---
 
+## What's new in 0.9.0
+
+`next_open` fills wait for a prior close. The first bar of a next-open backtest
+no longer trades that bar's own signal at that bar's open. Close fills are
+unchanged, and the published goldens do not move.
+
+The session is the full-screen terminal (`pip install "alphaengine[tui]"`).
+Each statistic keeps its formula, inputs, and series. Those series post to
+`/api/harness/runs/{id}/traces`. A portal that rejects the trace does not fail
+the run.
+
 ## What's new in 0.8.0
 
 Named processes, Grinold, and a frozen chart contract. Existing goldens

{alphaengine-0.8.0 → alphaengine-0.9.0}/README.md

@@ -19,24 +19,46 @@
 </p>
 
 ```bash
-pip install alphaengine
-alphaengine demo          # the whole offline half, no account, no data of your own
-alphaengine process       # fit a DGP to the demo walk and stress it
+pip install alphaengine                 # library and one-shot commands
+pip install "alphaengine[tui]"          # the full-screen session
+alphaengine demo                        # offline. no account, no data of yours
+alphaengine                             # the session
+alphaengine process                     # fit a DGP to the demo walk and stress it
 ```
 
-<p align="center">
-  <img src="docs/assets/session.png" alt="The session canvas: tracked ALPHAENGINE over a teal plateau and amber ridge, then your data never leaves." width="92%">
-</p>
+If the shell cannot find `alphaengine`, this always works:
+
+```bash
+python -m alphaengine demo
+python -m alphaengine
+```
+
+```
+┌──────────┬─────────────────────────────────────┬──────────────────┐
+│ ● maths  │  Ask in plain English.              │  sharpe          │
+│   always │                                     │  mean / std √252 │
+│ ○ flows  │  > which names are overbought?      │  ▁▂▃▅▇█▇▅▃       │
+│ ○ ask    │                                     │  0    0.0012     │
+│          │  chose screen_universe              │  1   -0.0040     │
+│ loaded   │                                     │                  │
+│  sp500   │                                     │                  │
+└──────────┴─────────────────────────────────────┴──────────────────┘
+```
 
-The session is the product. Sign in, load something, then ask:
+There is one session, and it is this screen. A sentence picks a workflow.
+`run <name>` follows that workflow exactly. The math pane opens when a run
+has a statistic to show.
 
 ```bash
 alphaengine
-❯ login
-❯ load prices.csv
-❯ screen
+> login
+> load prices.csv
+> screen
 ```
 
+Prices stay on this machine. A math line's series can travel on its own trace
+so it can be charted. The figures posted with the step stay summaries.
+
 ---
 
 ## What it answers
@@ -151,6 +173,17 @@ distinction is the whole of the data boundary below.
 
 ---
 
+## What's new in 0.9.0
+
+`next_open` fills wait for a prior close. The first bar of a next-open backtest
+no longer trades that bar's own signal at that bar's open. Close fills are
+unchanged, and the published goldens do not move.
+
+The session is the full-screen terminal (`pip install "alphaengine[tui]"`).
+Each statistic keeps its formula, inputs, and series. Those series post to
+`/api/harness/runs/{id}/traces`. A portal that rejects the trace does not fail
+the run.
+
 ## What's new in 0.8.0
 
 Named processes, Grinold, and a frozen chart contract. Existing goldens

{alphaengine-0.8.0 → alphaengine-0.9.0}/pyproject.toml

@@ -42,10 +42,10 @@ dependencies = [
     "scipy>=1.10",
 ]
 
-# THE TERMINAL ENTRY POINT. Deliberately adds nothing new: argparse from the
-# standard library, and the client's urllib transport. A CLI that dragged in a
-# TUI framework would break the two-dependency promise above on behalf of people
-# who may never run it.
+# THE TERMINAL ENTRY POINT. One-shot commands add nothing: argparse from the
+# standard library, and the client's urllib transport. The full-screen session
+# is the optional `tui` extra, so `import alphaengine` and a library install
+# stay at numpy and scipy.
 #
 # INSTALL THIS IN YOUR PROJECT VENV, NOT WITH pipx OR `uv tool install`.
 # `compute.*` ops execute in-process against your own DataFrames, so tool
@@ -75,6 +75,11 @@ connectors = [
     "httpx>=0.27",
     "pyarrow>=15.0",
 ]
+# The interactive session. Not a core dependency: a researcher who only wants
+# a deflated Sharpe should not install a TUI framework to get one.
+tui = [
+    "textual>=1.0",
+]
 dev = [
     "pytest>=8.0",
     "pytest-cov>=5.0",
@@ -88,6 +93,7 @@ dev = [
     # this, mypy cannot resolve statsmodels in a clean environment even though
     # it resolves fine on a machine that happens to have it.
     "statsmodels>=0.14",
+    "textual>=1.0",
 ]
 
 [project.urls]
@@ -179,5 +185,5 @@ ignore_missing_imports = true
 # import is an error, so this is the difference between a build that passes on a
 # machine that happens to have them and one that passes anywhere.
 [[tool.mypy.overrides]]
-module = ["scipy.*", "statsmodels.*", "pyarrow.*", "httpx"]
+module = ["scipy.*", "statsmodels.*", "pyarrow.*", "httpx", "textual.*"]
 ignore_missing_imports = true

{alphaengine-0.8.0 → alphaengine-0.9.0}/src/alphaengine/__init__.py

@@ -23,8 +23,10 @@ WHAT THIS LIBRARY IS NOT
 
 OFFLINE BY CONSTRUCTION
     Importing this module makes no network call and needs no account. numpy and
-    scipy, nothing else. Everything above runs on a laptop with the wifi off,
-    and your data never leaves the machine.
+    scipy, nothing else. Everything above runs on a laptop with the wifi off.
+    A workflow run can also send a math trace — the formula, its inputs, and
+    the series that line was computed on — to the portal on its own channel.
+    Study ingest still refuses anything series-shaped.
 """
 
 from typing import Any

{alphaengine-0.8.0 → alphaengine-0.9.0}/src/alphaengine/_version.py

@@ -69,4 +69,11 @@ is what a changed figure costs. The API may still move underneath it.
 # Monte Carlo trial count, Grinold alpha / breadth / TC, a frozen chart
 # vocabulary, and a terminal boot that is the README banner in glyphs.
 # New figures are a public contract from this release; old numbers did not move.
-__version__ = "0.8.0"
+#
+# 0.9.0: `run_backtest(..., fill_timing="next_open")` no longer fills the first
+# bar with that bar's own signal. A signal is known at the close, and the open
+# of the same bar printed before it. The first fill is now the next bar's open.
+# Close fills are unchanged. No golden in tests/test_goldens.py moves. The
+# same release makes the full-screen terminal the only session, and posts each
+# math line's series on `/traces` without putting those series inside figures.
+__version__ = "0.9.0"