alphaengine 0.7.0__tar.gz → 0.9.0__tar.gz

{alphaengine-0.7.0 → alphaengine-0.9.0}/AGENTS.md

@@ -56,13 +56,16 @@ animated parameter-surface canvas at boot and while Working) plus
   that is a version bump (`_version.py`).
 - **Compute ops on the executor** include the 0.6 workflow set (`backtest`,
   `score_backtest`, `cpcv`, `factors`, `pairs`, `cointegrated_pairs`,
-  `walk_forward`, `book_overlap`) and the 0.7 CS / book set
+  `walk_forward`, `book_overlap`), the 0.7 CS / book set
   (`panel_transform`, `signal_icir`, `fama_macbeth`, `quantile_book`,
-  `ewma_cov`, `denoise_cov`, `hrp`, `risk_parity`, `vol_target`). Panels and
-  covariance matrices stay in the workspace; figures go over the wire. The
+  `ewma_cov`, `denoise_cov`, `hrp`, `risk_parity`, `vol_target`), and the
+  0.8 process / Grinold set (`ou_calibrate`, `ou_simulate`, `gbm_calibrate`,
+  `jump_calibrate`, `garch`, `dgp_stress`, `grinold_alpha`, `breadth_ir`,
+  `detone_cov`). Panels, covariance matrices, GARCH variance paths, OU paths
+  and alpha vectors stay in the workspace; figures go over the wire. The
   portal must offer an op in a workflow graph or it sits unused; the CLI
-  remains useful without them. Short names in a panel are skipped and counted,
-  they do not shrink the rest of the book.
+  `process` command runs the DGP stress offline without a portal. Short names
+  in a panel are skipped and counted, they do not shrink the rest of the book.
 - `sweep(..., jobs=N)` defaults to 1. Greater than 1 is opt-in and must keep
   trial index identity, including failures.
 - The `connectors` extra is lazy: parquet via `pyarrow`, HTTP via `httpx` to a

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: alphaengine
-Version: 0.7.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">
@@ -60,28 +63,47 @@ Description-Content-Type: text/markdown
   <img src="https://img.shields.io/badge/deps-numpy%20%2B%20scipy-C4893A?style=flat-square" alt="Two dependencies: numpy and scipy">
 </p>
 
-<p align="center">
-  <img src="docs/assets/mark.png" alt="AlphaEngine mark" width="96">
-</p>
+```bash
+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
+```
+
+If the shell cannot find `alphaengine`, this always works:
 
 ```bash
-pip install alphaengine
-alphaengine demo          # the whole offline half, no account, no data of your own
+python -m alphaengine demo
+python -m alphaengine
 ```
 
-<p align="center">
-  <img src="docs/assets/session.png" alt="The session canvas: a living parameter surface, then demo, login, load" width="92%">
-</p>
+```
+┌──────────┬─────────────────────────────────────┬──────────────────┐
+│ ● 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
@@ -196,6 +218,46 @@ 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
+(deflated Sharpe, PBO, performance, screen) are byte-identical. New figures
+are a public contract from this release. The study schema is **1.1**: optional
+`process` and `charts` fields; 1.0 studies still load.
+
+| You have | You get | Module |
+|---|---|---|
+| A spread or a close | OU / GBM / jump / GARCH(1,1) calibration, then Monte Carlo stress under that law | `core.process` |
+| An IC and a cross-section | Grinold alpha, breadth, transfer coefficient | `core.active` |
+| A return panel | Detoned covariance and a PCA variance-explained table | `core.covariance` |
+| Figures that already travel | `{kind, key, title}` hints a portal maps to a chart | `charts`, [figure contract](docs/figure_contract.md) |
+
+The terminal boot is the README banner: tracked `ALPHAENGINE`, the subtitle,
+a teal-left / amber-right mesh (plateau, valley, knife-edge ridge), and
+`your data never leaves.` `alphaengine process` fits a DGP offline, no account.
+
+```python
+from alphaengine.core import ou_calibrate, garch_calibrate, dgp_stress, grinold_alpha
+
+ou = ou_calibrate(spread)            # kappa, theta, half_life; or not mean-reverting
+g = garch_calibrate(returns)         # omega, alpha, beta, persistence in (0, 1)
+s = dgp_stress(close, dgp="ou")      # n_trials = n_paths, source monte_carlo
+a = grinold_alpha(panel, ic=0.05)    # alpha vector stays here; scalars travel
+```
+
+---
+
 ## What's new in 0.7.0
 
 The daily modelling morning, and the overnight book, without a third
@@ -237,6 +299,7 @@ w = hrp_weights(cov, names=names)    # no matrix inverse; weights sum to one
 | Command | Does | Where |
 |---|---|---|
 | `demo` | run the built-in example offline, with no account and no data | shell + session |
+| `process [ou \| gbm \| jump \| garch]` | fit a named process to a series and stress it, offline | shell + session |
 | `runs [--limit N]` | your own week: what ran, what it decided, what it filed | shell + session |
 | `gaps` | what your record says is UNANSWERED, and what closes each one | shell + session |
 | `tonight [--budget N]` | what would run unattended tonight, without running any of it | shell + session |
@@ -320,6 +383,8 @@ alphaengine overlap
 alphaengine size
 alphaengine monitor
 alphaengine demo
+alphaengine process
+alphaengine process ou
 alphaengine runs
 alphaengine runs --limit 50
 alphaengine gaps
@@ -423,8 +488,11 @@ diffable, and versioned so it still parses in two years.
 | `alphaengine.core.panel` | cross-sectional rank, z-score, winsorize, neutralize |
 | `alphaengine.core.signals` | IC, ICIR, quantile returns, decay |
 | `alphaengine.core.cross_section` | Fama-MacBeth, quantile book with turnover |
-| `alphaengine.core.covariance` | EWMA, Ledoit-Wolf, Marchenko-Pastur denoise, detone |
-| `alphaengine.core.allocate` | HRP, risk parity, vol target |
+| `alphaengine.core.covariance` | EWMA, Ledoit-Wolf, Marchenko-Pastur denoise, detone, variance explained |
+| `alphaengine.core.allocate` | HRP, risk parity, vol target (EWMA or GARCH) |
+| `alphaengine.core.process` | OU, GBM, jumps, GARCH(1,1), DGP stress |
+| `alphaengine.core.active` | Grinold alpha, breadth, transfer coefficient |
+| `alphaengine.charts` | frozen `{kind, key, title}` hints; see [figure contract](docs/figure_contract.md) |
 | `alphaengine.sweep` | the grid runner and the sensitivity surface |
 | `alphaengine.study` | the study artifact and its schema |
 | `alphaengine.client` | the workflow client and the step executor |
@@ -518,6 +586,22 @@ Management* 42(1), 13 to 28.
 Fama, E. F., and MacBeth, J. D. (1973). "Risk, Return, and Equilibrium:
 Empirical Tests." *Journal of Political Economy* 81(3), 607 to 636.
 
+**Ornstein-Uhlenbeck / Vasicek**
+Vasicek, O. (1977). "An Equilibrium Characterization of the Term Structure."
+*Journal of Financial Economics* 5(2), 177 to 188.
+
+**GARCH(1,1)**
+Bollerslev, T. (1986). "Generalized Autoregressive Conditional
+Heteroskedasticity." *Journal of Econometrics* 31(3), 307 to 327.
+
+**Jump-diffusion**
+Merton, R. C. (1976). "Option Pricing When Underlying Stock Returns Are
+Discontinuous." *Journal of Financial Economics* 3(1-2), 125 to 144.
+
+**The fundamental law of active management**
+Grinold, R. C., and Kahn, R. N. (2000). *Active Portfolio Management.* 2nd ed.
+McGraw-Hill.
+
 **Downside deviation**
 Sortino, F. A., and Price, L. N. (1994). "Performance Measurement in a Downside
 Risk Framework." *Journal of Investing* 3(3), 59 to 64.

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

@@ -18,28 +18,47 @@
   <img src="https://img.shields.io/badge/deps-numpy%20%2B%20scipy-C4893A?style=flat-square" alt="Two dependencies: numpy and scipy">
 </p>
 
-<p align="center">
-  <img src="docs/assets/mark.png" alt="AlphaEngine mark" width="96">
-</p>
+```bash
+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
+```
+
+If the shell cannot find `alphaengine`, this always works:
 
 ```bash
-pip install alphaengine
-alphaengine demo          # the whole offline half, no account, no data of your own
+python -m alphaengine demo
+python -m alphaengine
 ```
 
-<p align="center">
-  <img src="docs/assets/session.png" alt="The session canvas: a living parameter surface, then demo, login, load" width="92%">
-</p>
+```
+┌──────────┬─────────────────────────────────────┬──────────────────┐
+│ ● 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
@@ -154,6 +173,46 @@ 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
+(deflated Sharpe, PBO, performance, screen) are byte-identical. New figures
+are a public contract from this release. The study schema is **1.1**: optional
+`process` and `charts` fields; 1.0 studies still load.
+
+| You have | You get | Module |
+|---|---|---|
+| A spread or a close | OU / GBM / jump / GARCH(1,1) calibration, then Monte Carlo stress under that law | `core.process` |
+| An IC and a cross-section | Grinold alpha, breadth, transfer coefficient | `core.active` |
+| A return panel | Detoned covariance and a PCA variance-explained table | `core.covariance` |
+| Figures that already travel | `{kind, key, title}` hints a portal maps to a chart | `charts`, [figure contract](docs/figure_contract.md) |
+
+The terminal boot is the README banner: tracked `ALPHAENGINE`, the subtitle,
+a teal-left / amber-right mesh (plateau, valley, knife-edge ridge), and
+`your data never leaves.` `alphaengine process` fits a DGP offline, no account.
+
+```python
+from alphaengine.core import ou_calibrate, garch_calibrate, dgp_stress, grinold_alpha
+
+ou = ou_calibrate(spread)            # kappa, theta, half_life; or not mean-reverting
+g = garch_calibrate(returns)         # omega, alpha, beta, persistence in (0, 1)
+s = dgp_stress(close, dgp="ou")      # n_trials = n_paths, source monte_carlo
+a = grinold_alpha(panel, ic=0.05)    # alpha vector stays here; scalars travel
+```
+
+---
+
 ## What's new in 0.7.0
 
 The daily modelling morning, and the overnight book, without a third
@@ -195,6 +254,7 @@ w = hrp_weights(cov, names=names)    # no matrix inverse; weights sum to one
 | Command | Does | Where |
 |---|---|---|
 | `demo` | run the built-in example offline, with no account and no data | shell + session |
+| `process [ou \| gbm \| jump \| garch]` | fit a named process to a series and stress it, offline | shell + session |
 | `runs [--limit N]` | your own week: what ran, what it decided, what it filed | shell + session |
 | `gaps` | what your record says is UNANSWERED, and what closes each one | shell + session |
 | `tonight [--budget N]` | what would run unattended tonight, without running any of it | shell + session |
@@ -278,6 +338,8 @@ alphaengine overlap
 alphaengine size
 alphaengine monitor
 alphaengine demo
+alphaengine process
+alphaengine process ou
 alphaengine runs
 alphaengine runs --limit 50
 alphaengine gaps
@@ -381,8 +443,11 @@ diffable, and versioned so it still parses in two years.
 | `alphaengine.core.panel` | cross-sectional rank, z-score, winsorize, neutralize |
 | `alphaengine.core.signals` | IC, ICIR, quantile returns, decay |
 | `alphaengine.core.cross_section` | Fama-MacBeth, quantile book with turnover |
-| `alphaengine.core.covariance` | EWMA, Ledoit-Wolf, Marchenko-Pastur denoise, detone |
-| `alphaengine.core.allocate` | HRP, risk parity, vol target |
+| `alphaengine.core.covariance` | EWMA, Ledoit-Wolf, Marchenko-Pastur denoise, detone, variance explained |
+| `alphaengine.core.allocate` | HRP, risk parity, vol target (EWMA or GARCH) |
+| `alphaengine.core.process` | OU, GBM, jumps, GARCH(1,1), DGP stress |
+| `alphaengine.core.active` | Grinold alpha, breadth, transfer coefficient |
+| `alphaengine.charts` | frozen `{kind, key, title}` hints; see [figure contract](docs/figure_contract.md) |
 | `alphaengine.sweep` | the grid runner and the sensitivity surface |
 | `alphaengine.study` | the study artifact and its schema |
 | `alphaengine.client` | the workflow client and the step executor |
@@ -476,6 +541,22 @@ Management* 42(1), 13 to 28.
 Fama, E. F., and MacBeth, J. D. (1973). "Risk, Return, and Equilibrium:
 Empirical Tests." *Journal of Political Economy* 81(3), 607 to 636.
 
+**Ornstein-Uhlenbeck / Vasicek**
+Vasicek, O. (1977). "An Equilibrium Characterization of the Term Structure."
+*Journal of Financial Economics* 5(2), 177 to 188.
+
+**GARCH(1,1)**
+Bollerslev, T. (1986). "Generalized Autoregressive Conditional
+Heteroskedasticity." *Journal of Econometrics* 31(3), 307 to 327.
+
+**Jump-diffusion**
+Merton, R. C. (1976). "Option Pricing When Underlying Stock Returns Are
+Discontinuous." *Journal of Financial Economics* 3(1-2), 125 to 144.
+
+**The fundamental law of active management**
+Grinold, R. C., and Kahn, R. N. (2000). *Active Portfolio Management.* 2nd ed.
+McGraw-Hill.
+
 **Downside deviation**
 Sortino, F. A., and Price, L. N. (1994). "Performance Measurement in a Downside
 Risk Framework." *Journal of Investing* 3(3), 59 to 64.

alphaengine-0.9.0/docs/figure_contract.md

@@ -0,0 +1,46 @@
+# Figure contract
+
+A figure that travels is a **named kind**, not a series. The executor attaches
+`charts: [{kind, key, title}]` hints. The portal maps `kind` + `key` to a
+component. Old portals ignore `charts` and still have the raw keys
+(`ic_by_period`, `best_curve`, …).
+
+No hint carries a nested series. Titles are one line, no em dash.
+
+Study schema **1.1** may also store `charts` and `process` on the artifact.
+Both are optional. A 1.0 study still loads.
+
+## Kinds
+
+| Kind | Payload | Draws as |
+|---|---|---|
+| `curve` | `{i, v}` | line |
+| `period` | `{p, ic}` or `{p, lambda}` | CS time series |
+| `band` | `{i, lo, mid, hi}` | fan / Monte Carlo quantile |
+| `hist` | `{edges, counts}` | histogram |
+| `cost` | `{bps, sharpe}` | cost ladder |
+| `scatter` | `{x, y}` | overlap |
+| `triangle` | `{a, b, v}` | covariance heatmap |
+| `rows` | bounded dict rows | table |
+| `quantiles` | `[float]` | bar |
+
+`i` is a position index into the original series, never a timestamp. Timestamps
+stay on the machine that holds the data.
+
+Lists longer than 512 are a series, not a figure, and the wire guard refuses
+them. Sketches (`path_sketch`, `vol_path`, `mean_path`, `band`) are bucketed
+below that cap before they travel.
+
+## Who emits what
+
+| Op | Typical hints |
+|---|---|
+| `compute.ou_calibrate` | `curve` / `path_sketch` |
+| `compute.ou_simulate` | `curve` / `mean_path`, `band` / `band` |
+| `compute.garch` | `curve` / `vol_path` |
+| `compute.dgp_stress` | `hist` / `sharpe_hist` |
+| `compute.denoise_cov` | `triangle` / `triangle`, `rows` / `variance_explained` |
+| `compute.detone_cov` | same |
+| `compute.grinold_alpha` | scalars only; the alpha vector stays in the workspace |
+
+The Python helper is `alphaengine.charts.chart(kind, key, title)`.

alphaengine-0.9.0/docs/workflows/evaluate_process.json

@@ -0,0 +1,18 @@
+{
+  "name": "evaluate_process",
+  "schema": "alphaengine.workflow/1",
+  "title": "what law describes this path?",
+  "reproducible": true,
+  "needs": ["data"],
+  "selection": "all",
+  "note": "Portal harness copies this. Agents still only index permitted; these ops sit unused until registered.",
+  "stages": [
+    {"op": "data.resolve"},
+    {"op": "compute.gbm_calibrate"},
+    {"op": "compute.ou_calibrate"},
+    {"op": "compute.jump_calibrate"},
+    {"op": "compute.garch"},
+    {"op": "compute.dgp_stress", "params": {"dgp": "gbm"}},
+    {"op": "emit.process_report"}
+  ]
+}

alphaengine-0.9.0/docs/workflows/research_week.json

@@ -0,0 +1,29 @@
+{
+  "name": "research_week",
+  "schema": "alphaengine.workflow/1",
+  "title": "gaps the modeling suite closes once the portal registers the ops",
+  "gaps": [
+    {
+      "question": "what law describes this path?",
+      "workflow": "evaluate_process",
+      "op": "compute.dgp_stress",
+      "cli": "alphaengine process"
+    },
+    {
+      "question": "where does it break under a named DGP?",
+      "workflow": "stress_study",
+      "stage": "dgp_stress",
+      "cli": "alphaengine process ou"
+    },
+    {
+      "question": "how much alpha does the IC imply?",
+      "workflow": "size_position",
+      "op": "compute.grinold_alpha"
+    },
+    {
+      "question": "is the book the market in disguise?",
+      "workflow": "size_position",
+      "op": "compute.detone_cov"
+    }
+  ]
+}

alphaengine-0.9.0/docs/workflows/stress_study.json

@@ -0,0 +1,14 @@
+{
+  "name": "stress_study",
+  "schema": "alphaengine.workflow/1",
+  "title": "where does it break?",
+  "note": "Additive DGP stage for the existing stress_study graph. Copy into the portal harness. The CLI spelling that does not wait on the portal is `alphaengine process` or `stress --input dgp=ou` once this stage is live.",
+  "add_stage": {
+    "id": "dgp_stress",
+    "op": "compute.dgp_stress",
+    "input": "dgp",
+    "default": "gbm",
+    "values": ["ou", "gbm", "jump", "garch"],
+    "after": "compute.cost_ladder"
+  }
+}

{alphaengine-0.7.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.7.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.7.0 → alphaengine-0.9.0}/src/alphaengine/_version.py

@@ -63,12 +63,17 @@ is what a changed figure costs. The API may still move underneath it.
 # doors, same refusals. The published artefact is a new wheel because 0.6.0
 # already left the building.
 #
-# 0.7.0 IS NEW PUBLIC FIGURES, AND A SIMPLER OS AROUND THEM. Existing DSR /
-# PBO / performance / screen goldens stay byte-identical. The artefact grew
-# the daily cross-section (rank, z-score, winsorize, neutralize, ICIR,
-# Fama-MacBeth, quantile book with turnover) and the overnight book
-# (EWMA / Ledoit-Wolf / Marchenko-Pastur covariance, HRP, risk parity, vol
-# target), plus a living parameter-surface canvas and one-verb `login` /
-# `load`. New numbers are a public contract from this release; old numbers
-# did not move.
-__version__ = "0.7.0"
+# 0.8.0 IS THE MODELING SUITE THE REST OF THE LIBRARY WAS MISSING. Existing
+# DSR / PBO / performance / screen goldens stay byte-identical. The artefact
+# grew named processes (OU, GBM, jumps, GARCH), DGP stress with an honest
+# 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.
+#
+# 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"

alphaengine-0.9.0/src/alphaengine/charts.py

@@ -0,0 +1,56 @@
+"""Frozen chart vocabulary the portal draws from figures.
+
+A FIGURE IS A NAMED KIND, not a series. The executor attaches
+`charts: [{kind, key, title}]` hints. The portal maps kind+key to a component.
+Old portals ignore `charts` and still have the raw keys (`ic_by_period`,
+`best_curve`, ...).
+
+KINDS
+    curve     {i, v}              line
+    period    {p, ic|lambda}      CS time series
+    band      {i, lo, mid, hi}    fan / Monte Carlo quantile
+    hist      {edges, counts}     histogram
+    cost      {bps, sharpe}       cost ladder
+    scatter   {x, y}              overlap
+    triangle  {a, b, v}           covariance heatmap
+    rows      bounded dict rows   table
+    quantiles [float]             bar
+
+No hint may carry a nested series. Titles are one line, no em dash.
+"""
+
+from __future__ import annotations
+
+__all__ = ["CHART_KINDS", "chart", "charts"]
+
+CHART_KINDS = frozenset(
+    {
+        "curve",
+        "period",
+        "band",
+        "hist",
+        "cost",
+        "scatter",
+        "triangle",
+        "rows",
+        "quantiles",
+    }
+)
+
+
+def chart(kind: str, key: str, title: str) -> dict[str, str]:
+    """One portal hint. `kind` must be in CHART_KINDS."""
+    k = str(kind)
+    if k not in CHART_KINDS:
+        raise ValueError(f"unknown chart kind {k!r}; expected one of {sorted(CHART_KINDS)}")
+    return {"kind": k, "key": str(key), "title": str(title)}
+
+
+def charts(*items: dict[str, str]) -> list[dict[str, str]]:
+    """Hint list. Empty is allowed: the portal then uses raw keys only."""
+    out: list[dict[str, str]] = []
+    for item in items:
+        if not item:
+            continue
+        out.append(chart(item["kind"], item["key"], item["title"]) if "kind" in item else dict(item))
+    return out