thetabook 2.2.2__tar.gz → 2.3.0__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (137) hide show
  1. thetabook-2.3.0/.git-blame-ignore-revs +8 -0
  2. {thetabook-2.2.2 → thetabook-2.3.0}/.github/workflows/ci.yml +3 -0
  3. {thetabook-2.2.2 → thetabook-2.3.0}/.github/workflows/publish.yml +3 -0
  4. thetabook-2.3.0/AGENTS.md +5 -0
  5. {thetabook-2.2.2 → thetabook-2.3.0}/CHANGELOG.md +515 -0
  6. {thetabook-2.2.2 → thetabook-2.3.0}/CLAUDE.md +25 -16
  7. {thetabook-2.2.2 → thetabook-2.3.0}/CONTRIBUTING.md +7 -6
  8. {thetabook-2.2.2 → thetabook-2.3.0}/PKG-INFO +3 -3
  9. {thetabook-2.2.2 → thetabook-2.3.0}/README.md +173 -178
  10. {thetabook-2.2.2 → thetabook-2.3.0}/ROADMAP.md +30 -4
  11. {thetabook-2.2.2 → thetabook-2.3.0}/pyproject.toml +10 -3
  12. thetabook-2.3.0/scripts/demo.sh +488 -0
  13. thetabook-2.3.0/src/thetabook/CLAUDE.md +55 -0
  14. {thetabook-2.2.2 → thetabook-2.3.0}/src/thetabook/analysis/scenarios.py +3 -7
  15. {thetabook-2.2.2 → thetabook-2.3.0}/src/thetabook/analysis/vrp.py +44 -9
  16. thetabook-2.3.0/src/thetabook/backtest/__init__.py +17 -0
  17. thetabook-2.3.0/src/thetabook/backtest/data.py +418 -0
  18. thetabook-2.3.0/src/thetabook/backtest/engine.py +123 -0
  19. thetabook-2.3.0/src/thetabook/backtest/grid.py +531 -0
  20. thetabook-2.3.0/src/thetabook/backtest/manifest.py +302 -0
  21. thetabook-2.3.0/src/thetabook/backtest/metrics.py +240 -0
  22. thetabook-2.3.0/src/thetabook/backtest/report.py +732 -0
  23. thetabook-2.3.0/src/thetabook/backtest/signals.py +112 -0
  24. thetabook-2.3.0/src/thetabook/backtest/strategies/__init__.py +122 -0
  25. thetabook-2.3.0/src/thetabook/backtest/strategies/dual_momentum.py +115 -0
  26. thetabook-2.3.0/src/thetabook/backtest/strategies/sector_rotation.py +173 -0
  27. thetabook-2.3.0/src/thetabook/cli/CLAUDE.md +21 -0
  28. {thetabook-2.2.2 → thetabook-2.3.0}/src/thetabook/cli/__init__.py +3 -0
  29. {thetabook-2.2.2 → thetabook-2.3.0}/src/thetabook/cli/adjust.py +14 -0
  30. thetabook-2.3.0/src/thetabook/cli/backtest.py +334 -0
  31. {thetabook-2.2.2 → thetabook-2.3.0}/src/thetabook/cli/chain.py +5 -2
  32. {thetabook-2.2.2 → thetabook-2.3.0}/src/thetabook/cli/em.py +11 -0
  33. {thetabook-2.2.2 → thetabook-2.3.0}/src/thetabook/cli/evaluate.py +9 -2
  34. {thetabook-2.2.2 → thetabook-2.3.0}/src/thetabook/cli/hv.py +11 -2
  35. {thetabook-2.2.2 → thetabook-2.3.0}/src/thetabook/cli/ideas.py +1 -3
  36. {thetabook-2.2.2 → thetabook-2.3.0}/src/thetabook/cli/import_csv.py +1 -3
  37. {thetabook-2.2.2 → thetabook-2.3.0}/src/thetabook/cli/init.py +2 -4
  38. {thetabook-2.2.2 → thetabook-2.3.0}/src/thetabook/cli/leg_mark.py +9 -2
  39. {thetabook-2.2.2 → thetabook-2.3.0}/src/thetabook/cli/migrate_home.py +2 -8
  40. {thetabook-2.2.2 → thetabook-2.3.0}/src/thetabook/cli/refresh.py +1 -1
  41. {thetabook-2.2.2 → thetabook-2.3.0}/src/thetabook/cli/snapshot.py +1 -4
  42. {thetabook-2.2.2 → thetabook-2.3.0}/src/thetabook/cli/ta.py +1 -2
  43. {thetabook-2.2.2 → thetabook-2.3.0}/src/thetabook/cli/vrp.py +51 -3
  44. {thetabook-2.2.2 → thetabook-2.3.0}/src/thetabook/cli/wiki.py +1 -3
  45. thetabook-2.3.0/src/thetabook/config.py +202 -0
  46. {thetabook-2.2.2 → thetabook-2.3.0}/src/thetabook/ideas/adjust.py +467 -92
  47. {thetabook-2.2.2 → thetabook-2.3.0}/src/thetabook/ideas/core.py +247 -24
  48. {thetabook-2.2.2 → thetabook-2.3.0}/src/thetabook/ideas/evaluate_idea.py +448 -86
  49. {thetabook-2.2.2 → thetabook-2.3.0}/src/thetabook/ideas/manage_ideas.py +19 -12
  50. {thetabook-2.2.2 → thetabook-2.3.0}/src/thetabook/ideas/roll_scenarios.py +20 -6
  51. thetabook-2.3.0/src/thetabook/leg_parse.py +368 -0
  52. thetabook-2.3.0/src/thetabook/market/_schwab.py +262 -0
  53. {thetabook-2.2.2 → thetabook-2.3.0}/src/thetabook/market/bars.py +129 -78
  54. {thetabook-2.2.2 → thetabook-2.3.0}/src/thetabook/market/chains.py +79 -10
  55. {thetabook-2.2.2 → thetabook-2.3.0}/src/thetabook/market/dividends.py +7 -12
  56. {thetabook-2.2.2 → thetabook-2.3.0}/src/thetabook/market/earnings.py +0 -2
  57. {thetabook-2.2.2 → thetabook-2.3.0}/src/thetabook/market/leg_marks.py +1 -0
  58. {thetabook-2.2.2 → thetabook-2.3.0}/src/thetabook/market/prices.py +5 -3
  59. {thetabook-2.2.2 → thetabook-2.3.0}/src/thetabook/market/vol_lookup.py +117 -0
  60. {thetabook-2.2.2 → thetabook-2.3.0}/src/thetabook/models.py +115 -9
  61. {thetabook-2.2.2 → thetabook-2.3.0}/src/thetabook/paths.py +21 -2
  62. {thetabook-2.2.2 → thetabook-2.3.0}/src/thetabook/portfolio/accounts.py +244 -50
  63. {thetabook-2.2.2 → thetabook-2.3.0}/src/thetabook/portfolio/csv_parsers/__init__.py +3 -5
  64. {thetabook-2.2.2 → thetabook-2.3.0}/src/thetabook/portfolio/csv_parsers/_base.py +1 -3
  65. {thetabook-2.2.2 → thetabook-2.3.0}/src/thetabook/portfolio/csv_parsers/empower.py +7 -9
  66. {thetabook-2.2.2 → thetabook-2.3.0}/src/thetabook/portfolio/csv_parsers/fidelity.py +39 -18
  67. {thetabook-2.2.2 → thetabook-2.3.0}/src/thetabook/portfolio/csv_parsers/schwab.py +6 -0
  68. {thetabook-2.2.2 → thetabook-2.3.0}/src/thetabook/portfolio/diff_snapshots.py +11 -2
  69. {thetabook-2.2.2 → thetabook-2.3.0}/src/thetabook/portfolio/get_positions.py +14 -34
  70. {thetabook-2.2.2 → thetabook-2.3.0}/src/thetabook/portfolio/import_csv_snapshot.py +3 -5
  71. {thetabook-2.2.2 → thetabook-2.3.0}/src/thetabook/portfolio/options_book.py +199 -33
  72. {thetabook-2.2.2 → thetabook-2.3.0}/src/thetabook/preflight.py +28 -0
  73. {thetabook-2.2.2 → thetabook-2.3.0}/src/thetabook/pricing/greeks.py +85 -21
  74. {thetabook-2.2.2 → thetabook-2.3.0}/src/thetabook/skills/policy.py +7 -0
  75. {thetabook-2.2.2 → thetabook-2.3.0}/src/thetabook/skills/registry.py +4 -5
  76. thetabook-2.3.0/src/thetabook/templates/config.toml.example +42 -0
  77. thetabook-2.3.0/src/thetabook/templates/idea.md +60 -0
  78. {thetabook-2.2.2 → thetabook-2.3.0}/src/thetabook/templates/skill.md +1 -1
  79. thetabook-2.3.0/src/thetabook/tickers.py +429 -0
  80. {thetabook-2.2.2 → thetabook-2.3.0}/src/thetabook/wiki/render.py +15 -1
  81. {thetabook-2.2.2 → thetabook-2.3.0}/uv.lock +123 -148
  82. thetabook-2.2.2/src/thetabook/config.py +0 -42
  83. thetabook-2.2.2/src/thetabook/leg_parse.py +0 -201
  84. thetabook-2.2.2/src/thetabook/market/_schwab.py +0 -78
  85. thetabook-2.2.2/src/thetabook/templates/config.toml.example +0 -18
  86. thetabook-2.2.2/src/thetabook/templates/idea.md +0 -40
  87. thetabook-2.2.2/src/thetabook/tickers.py +0 -219
  88. {thetabook-2.2.2 → thetabook-2.3.0}/.env.example +0 -0
  89. {thetabook-2.2.2 → thetabook-2.3.0}/.gitignore +0 -0
  90. {thetabook-2.2.2 → thetabook-2.3.0}/.python-version +0 -0
  91. {thetabook-2.2.2 → thetabook-2.3.0}/LICENSE +0 -0
  92. {thetabook-2.2.2 → thetabook-2.3.0}/SECURITY.md +0 -0
  93. {thetabook-2.2.2 → thetabook-2.3.0}/src/thetabook/__init__.py +0 -0
  94. {thetabook-2.2.2 → thetabook-2.3.0}/src/thetabook/analysis/__init__.py +0 -0
  95. {thetabook-2.2.2 → thetabook-2.3.0}/src/thetabook/analysis/em.py +0 -0
  96. {thetabook-2.2.2 → thetabook-2.3.0}/src/thetabook/analysis/hv.py +0 -0
  97. {thetabook-2.2.2 → thetabook-2.3.0}/src/thetabook/analysis/ta.py +0 -0
  98. {thetabook-2.2.2 → thetabook-2.3.0}/src/thetabook/cache.py +0 -0
  99. {thetabook-2.2.2 → thetabook-2.3.0}/src/thetabook/cli/_shared.py +0 -0
  100. {thetabook-2.2.2 → thetabook-2.3.0}/src/thetabook/cli/accounts.py +0 -0
  101. {thetabook-2.2.2 → thetabook-2.3.0}/src/thetabook/cli/bars.py +0 -0
  102. {thetabook-2.2.2 → thetabook-2.3.0}/src/thetabook/cli/bs.py +0 -0
  103. {thetabook-2.2.2 → thetabook-2.3.0}/src/thetabook/cli/diff.py +0 -0
  104. {thetabook-2.2.2 → thetabook-2.3.0}/src/thetabook/cli/dividends.py +0 -0
  105. {thetabook-2.2.2 → thetabook-2.3.0}/src/thetabook/cli/earnings.py +0 -0
  106. {thetabook-2.2.2 → thetabook-2.3.0}/src/thetabook/cli/greeks.py +0 -0
  107. {thetabook-2.2.2 → thetabook-2.3.0}/src/thetabook/cli/positions.py +0 -0
  108. {thetabook-2.2.2 → thetabook-2.3.0}/src/thetabook/cli/price.py +0 -0
  109. {thetabook-2.2.2 → thetabook-2.3.0}/src/thetabook/cli/roll.py +0 -0
  110. {thetabook-2.2.2 → thetabook-2.3.0}/src/thetabook/cli/scenarios.py +0 -0
  111. {thetabook-2.2.2 → thetabook-2.3.0}/src/thetabook/cli/skills.py +0 -0
  112. {thetabook-2.2.2 → thetabook-2.3.0}/src/thetabook/cli/tickers.py +0 -0
  113. {thetabook-2.2.2 → thetabook-2.3.0}/src/thetabook/ideas/__init__.py +0 -0
  114. {thetabook-2.2.2 → thetabook-2.3.0}/src/thetabook/log.py +0 -0
  115. {thetabook-2.2.2 → thetabook-2.3.0}/src/thetabook/market/__init__.py +0 -0
  116. {thetabook-2.2.2 → thetabook-2.3.0}/src/thetabook/portfolio/__init__.py +0 -0
  117. {thetabook-2.2.2 → thetabook-2.3.0}/src/thetabook/portfolio/scaffold.py +0 -0
  118. {thetabook-2.2.2 → thetabook-2.3.0}/src/thetabook/pricing/__init__.py +0 -0
  119. {thetabook-2.2.2 → thetabook-2.3.0}/src/thetabook/pricing/bs.py +0 -0
  120. {thetabook-2.2.2 → thetabook-2.3.0}/src/thetabook/skills/__init__.py +0 -0
  121. {thetabook-2.2.2 → thetabook-2.3.0}/src/thetabook/skills/install.py +0 -0
  122. {thetabook-2.2.2 → thetabook-2.3.0}/src/thetabook/skills/lint.py +0 -0
  123. {thetabook-2.2.2 → thetabook-2.3.0}/src/thetabook/skills/models.py +0 -0
  124. {thetabook-2.2.2 → thetabook-2.3.0}/src/thetabook/skills/parse.py +0 -0
  125. {thetabook-2.2.2 → thetabook-2.3.0}/src/thetabook/skills/render.py +0 -0
  126. {thetabook-2.2.2 → thetabook-2.3.0}/src/thetabook/templates/README.md +0 -0
  127. {thetabook-2.2.2 → thetabook-2.3.0}/src/thetabook/templates/accounts.toml.example +0 -0
  128. {thetabook-2.2.2 → thetabook-2.3.0}/src/thetabook/templates/journal.md +0 -0
  129. {thetabook-2.2.2 → thetabook-2.3.0}/src/thetabook/templates/learnings.md +0 -0
  130. {thetabook-2.2.2 → thetabook-2.3.0}/src/thetabook/templates/skills/setup-thetabook.md +0 -0
  131. {thetabook-2.2.2 → thetabook-2.3.0}/src/thetabook/templates/wiki/index.md +0 -0
  132. {thetabook-2.2.2 → thetabook-2.3.0}/src/thetabook/templates/wiki/log.md +0 -0
  133. {thetabook-2.2.2 → thetabook-2.3.0}/src/thetabook/templates/wiki/overview.md +0 -0
  134. {thetabook-2.2.2 → thetabook-2.3.0}/src/thetabook/templates/wiki/strategy.md +0 -0
  135. {thetabook-2.2.2 → thetabook-2.3.0}/src/thetabook/templates/wiki/underlying.md +0 -0
  136. {thetabook-2.2.2 → thetabook-2.3.0}/src/thetabook/wiki/__init__.py +0 -0
  137. {thetabook-2.2.2 → thetabook-2.3.0}/src/thetabook/wiki/lint.py +0 -0
@@ -0,0 +1,8 @@
1
+ # Revisions to skip in `git blame` — formatting-only, no behavior change.
2
+ #
3
+ # Enable locally with:
4
+ # git config blame.ignoreRevsFile .git-blame-ignore-revs
5
+ # (GitHub honors this file automatically.)
6
+
7
+ # style: apply ruff format across the repo
8
+ 8ab618e6a6e7a858116438e4c573e1358d1ff3d3
@@ -24,6 +24,9 @@ jobs:
24
24
  - name: Lint (ruff)
25
25
  run: uv run ruff check .
26
26
 
27
+ - name: Format (ruff)
28
+ run: uv run ruff format --check .
29
+
27
30
  - name: Type-check (mypy)
28
31
  run: uv run mypy .
29
32
 
@@ -50,6 +50,9 @@ jobs:
50
50
  - name: Lint (ruff)
51
51
  run: uv run ruff check .
52
52
 
53
+ - name: Format (ruff)
54
+ run: uv run ruff format --check .
55
+
53
56
  - name: Type-check (mypy)
54
57
  run: uv run mypy .
55
58
 
@@ -0,0 +1,5 @@
1
+ # thetabook — agent instructions
2
+
3
+ Whatever agent you are, the instructions for this repo live in **[CLAUDE.md](CLAUDE.md)**. It is the single source of truth: project conventions, tooling discipline, code standards, and the wiki operations contract. Read it before touching anything here.
4
+
5
+ @CLAUDE.md
@@ -3,6 +3,521 @@
3
3
  All notable changes to this project are recorded here. Format loosely follows
4
4
  [Keep a Changelog](https://keepachangelog.com). Dates are ISO 8601.
5
5
 
6
+ ## [Unreleased]
7
+
8
+ ## [2.3.0] — 2026-11-01
9
+
10
+ The first release since v2.2.3. It adds a backtester for systematic
11
+ strategies whose live signal is the backtest's own last row,
12
+ share legs in idea files, and a run of risk-correctness fixes that change
13
+ the numbers `evaluate` records.
14
+
15
+ **Expect existing ideas to move on their next `evaluate`.** PoP now
16
+ integrates a ±5σ grid instead of the ±2σ display domain
17
+ ([#96](https://github.com/subsriram/thetabook/issues/96)); max gain / loss
18
+ are computed in closed form and can read `Unbounded`
19
+ ([#99](https://github.com/subsriram/thetabook/issues/99)), with a one-time,
20
+ announced migration of budgets the old math got wrong; and a covered
21
+ structure keeps evaluating as naked until its shares are declared in
22
+ `## Structure` ([#102](https://github.com/subsriram/thetabook/issues/102)).
23
+ **Re-import Schwab or Empower CSV snapshots that hold options**: their
24
+ `averagePrice` was stored per contract, 100× too large
25
+ ([#109](https://github.com/subsriram/thetabook/pull/109)).
26
+
27
+ ### Added
28
+
29
+ - **`thetabook backtest`: hypothetical strategy backtests, with the live
30
+ signal on the same code path**
31
+ ([#108](https://github.com/subsriram/thetabook/issues/108);
32
+ [#110](https://github.com/subsriram/thetabook/pull/110),
33
+ [#114](https://github.com/subsriram/thetabook/pull/114),
34
+ [#115](https://github.com/subsriram/thetabook/pull/115)). A new
35
+ workflow-layer `backtest/` package and a `backtest list | run | grid |
36
+ signal` sub-app, driven by `/backtest`. `run` builds a total-return panel
37
+ from the bars stitch plus cash dividends and enforces signal-at-close →
38
+ trade at close t+lag → earn from t+lag+1, with non-zero costs and short
39
+ borrow by default. It reports against the strategy's benchmark, the
40
+ equal-weight universe and cash, with t-stats on every active return.
41
+ `signal` is the last completed rebalance of that same simulation, not a
42
+ second implementation, so the weekly call can't drift from the backtest
43
+ that justified it. Two strategies ship: `sector-rotation` (11 SPDR sectors,
44
+ weekly) and `dual-momentum` (SPY / TLT / GLD vs BIL, monthly).
45
+
46
+ `grid` sweeps `--vary` over one data panel, prints how many configurations
47
+ were tried, ranks on in-sample Sharpe only, and reports the **deflated
48
+ Sharpe** (Bailey & López de Prado 2014) of the winner. The paper's §6
49
+ worked example is a known-answer test. `--prior-trials` counts searches
50
+ done elsewhere, and `--walk-forward` re-picks the best config per fold and
51
+ chains the tests into one out-of-sample series.
52
+
53
+ `--save` on `run` / `grid` writes an immutable manifest to
54
+ `$THETABOOK_HOME/backtests/`: the JSON payload plus the code version, git
55
+ SHA, argv, params, a panel fingerprint and a UTC timestamp. The file is
56
+ create-only and chmod 0444, an identical re-run is reported rather than
57
+ duplicated, and stdout is byte-identical with or without the flag. This is
58
+ the package's third write boundary, and `personal/backtests` is now a
59
+ reserved skill write path. Everything prints as *hypothetical backtested
60
+ performance*. Conventions are in
61
+ [docs/behaviors.md](docs/behaviors.md) "Backtests".
62
+
63
+ - **Share legs in idea files**
64
+ ([#102](https://github.com/subsriram/thetabook/issues/102),
65
+ [#103](https://github.com/subsriram/thetabook/pull/103)). `## Structure`
66
+ now takes `TICKER shares qty=+100 cost_basis=150.00` beside option lines.
67
+ Shares were previously dropped on both the read and the `adjust --save`
68
+ write side, so every covered call, buy-write or collar evaluated as naked:
69
+ after #99 that meant a confident `Unbounded` on a position bounded at
70
+ −$14,772, printed beside a net delta of the wrong sign. `cost_basis` is
71
+ required, and a share line without it is refused rather than skipped,
72
+ since a zero default reports a profit as the max loss. `evaluate` gives
73
+ share legs their own Greeks and marks rows. `adjust` carries snapshot
74
+ shares through before and after, so `adjust --assign --save` writes a file
75
+ that evaluates as the covered position it modelled. A structure carrying
76
+ shares must sit on a single underlying. `accounts.check_idea` drops its
77
+ snapshot-derived cover guard and sizes off `evaluated_max_loss` alone.
78
+ Its unbounded-loss message names the share-line syntax.
79
+
80
+ - **`scripts/demo.sh`, a guided walkthrough**
81
+ ([#109](https://github.com/subsriram/thetabook/pull/109)). It runs the
82
+ main loop (snapshot, diff, positions, Greeks, account rules,
83
+ vol/TA/scenarios, chain, ideas, evaluate, adjust/roll, wiki) against a
84
+ throwaway `$THETABOOK_HOME` seeded with a fictional book, so no real
85
+ account data appears on screen. Market data is live, borrowed from your
86
+ `.env` and Schwab token. It refuses to run against, inside, or around
87
+ your real home. Supports `--auto`, `--from N`, `--verbose` and `--reset`.
88
+ Dev checkout only, since `scripts/` isn't in the wheel.
89
+
90
+ - **Index options now work: `VIX`, `SPX`, `NDX` and 22 more CBOE roots**
91
+ ([#91](https://github.com/subsriram/thetabook/issues/91)). Schwab's canonical
92
+ form for an index carries a `$` prefix. Bare `VIX` failed on the chains
93
+ endpoint with HTTP 400, and — worse — on the *quotes* endpoint with HTTP
94
+ **200 plus an `errors` payload**, so nothing raised and `thetabook price VIX`
95
+ degraded silently through Massive to yfinance. Meanwhile the expiration
96
+ endpoint accepts either form, so `chain VIX` listed 13 expirations and then
97
+ priced nothing, which reads as "VIX has no options". It does — cash-settled
98
+ European on the SOQ, carrying none of the roll decay that makes VXX a poor
99
+ substitute for expressing a vol view.
100
+
101
+ A new `INDEX_ALIASES` map covers 25 verified roots — 10 with listed options
102
+ (`SPX`, `NDX`, `RUT`, `DJX`, `OEX`, `XEO`, `XSP`, `MRUT`, `VIX`, `SPESG`)
103
+ and 15 quote-only vol/stat indices. Every entry was checked against live
104
+ Schwab: bare returns nothing, `$`-prefixed returns a real quote.
105
+
106
+ It is deliberately **separate from `TICKER_ALIASES`** and applied only at
107
+ the market-data boundary, via `tickers.market_symbol()`. `canonicalize` —
108
+ which feeds snapshot symbols, CSV imports, idea-file legs and OCC roots —
109
+ never sees the `$`. Folding the two together would have written
110
+ `$SPX 260116P05000000` on CSV import against the API's
111
+ `SPX 260116P05000000` (so `diff` reported a phantom close *and* a phantom
112
+ open for one position), silently dropped a `$VIX …` line from an idea's
113
+ `## Structure` block, and — worst — priced a genuine equity at the index
114
+ level had one ever listed under a root like `OEX`. The `$` now stays on the
115
+ wire and out of everything persisted.
116
+
117
+ `price` / `chain` / `em --source iv` / `hv` / `vrp` all work on index roots
118
+ now.
119
+
120
+
121
+ - **`evaluate` labels its probabilities as risk-neutral and reports
122
+ `E[payoff]`** ([#88](https://github.com/subsriram/thetabook/issues/88)).
123
+ `Prob. of profit` / `Expected profit` / `Expected loss` were printed with no
124
+ indication they're computed under the pricing measure — drift `r - q`, not
125
+ the instrument's actual expected return. On equities the gap is small; on
126
+ leveraged and volatility ETPs it's 2–3×. A VXX spread was written up as a
127
+ "~1-in-5" trade at PoP 21.1% when the real-world figure is nearer 1-in-10
128
+ with negative expected value. The conditional rows are now marked as
129
+ conditional, and the probability-weighted `E[payoff]` — the only one of the
130
+ three that carries information about edge — sits alongside them. It lands
131
+ ≈ $0 for a fairly-priced structure, which is the signal.
132
+
133
+ The expectations integrate over their own ±5σ grid rather than the ±2σ
134
+ display domain the P&L table is drawn from. `pnl_price_domain` sizes the
135
+ latter for plotting, and at ±2σ the tails still hold ~5% of the mass — for
136
+ an undefined-risk short, exactly where the loss is unbounded. Clamping it to
137
+ the boundary doesn't blur the answer, it inverts it: a fairly-priced ATM
138
+ short call integrated over the display grid reported **+$9.77** against a
139
+ true **−$10.96**, phantom edge on a zero-edge trade. On the wider grid the
140
+ clamped mass is under one part in a million, and `E[payoff]` reproduces the
141
+ closed form `−qty·100·premium·(1 − e^{rT})` to the cent for naked calls,
142
+ puts, longs, and verticals alike.
143
+
144
+ - **`thetabook vrp --dte N`** ([#89](https://github.com/subsriram/thetabook/issues/89)
145
+ Part B). `vrp` sampled the front expiry, which on a liquid name is routinely
146
+ 0–3 DTE — noisy and unrelated to any dated structure. QQQ's 0-DTE ratio read
147
+ **1.12 in the morning and 0.98 the same afternoon** while the Dec 101-DTE leg
148
+ actually being traded sat at **1.78**. `--dte N` selects the nearest expiry at
149
+ least N days out; the sampled DTE is now repeated on the `IV/HV` line (the one
150
+ people copy), a ≤ 7 DTE sample warns, and an unreachable horizon says what it
151
+ sampled instead.
152
+
153
+ - **Structural-decay warnings on `hv` / `em` / `vrp`**
154
+ ([#89](https://github.com/subsriram/thetabook/issues/89) Part A). Realized
155
+ close-to-close vol on a rolling-futures or leveraged-reset product describes
156
+ the current regime rather than the risk being traded: VXX printed HV20 27.1%
157
+ at HV-rank 5.0% while its own ATM IV was ~60%. A static
158
+ `STRUCTURAL_DECAY_TICKERS` list (vol ETPs, leveraged index and single-stock
159
+ funds) drives an advisory warning in each command where its own output is the
160
+ misleading part. Static rather than inferred on purpose — classifying decay
161
+ from price history is its own problem, and a false positive on an ordinary
162
+ equity is worse than a missed exotic.
163
+
164
+ ### Fixed
165
+
166
+ - **Max gain / loss were read off the display grid, understating tail
167
+ risk** ([#99](https://github.com/subsriram/thetabook/issues/99),
168
+ [#101](https://github.com/subsriram/thetabook/pull/101)). They were
169
+ `np.max` / `np.min` over the S ± 30% plotting domain, so any extreme
170
+ outside it was reported at the edge. A 182-DTE AAPL short 160 put read
171
+ −$3,285.62 against a true −$15,535.62, and that is the figure
172
+ `max_position_pct` enforces, so a position 4.7× over its limit passed
173
+ silently. Widening the grid isn't enough: a put bottoms out at S_T = 0,
174
+ which no lognormal grid reaches. P&L at expiry is piecewise-linear with
175
+ kinks only at the strikes, so evaluating at 0, at each strike and along
176
+ the final ray's slope is exact. Unbounded structures now report `±inf`,
177
+ render `Unbounded`, and raise a distinct `max_position_pct` violation.
178
+ `adjust` shows `unbounded → bounded` instead of a NaN delta. Budgets the
179
+ old math got wrong are re-seeded once, with a stderr warning, and stamped
180
+ `budget_basis: analytic`. Budgets it got right, including hand-declared
181
+ ones, are left alone.
182
+
183
+ - **The price behind a cushion or a PoP is now named**
184
+ ([#100](https://github.com/subsriram/thetabook/issues/100),
185
+ [#101](https://github.com/subsriram/thetabook/pull/101)). `positions`
186
+ measured a VIX cushion against the forward while printing spot beside it,
187
+ so a row like "−7.7% cushion on a 17 call at $15.72 spot" was impossible
188
+ on its face. A `fwd` column now shows the reference, and only when some
189
+ row is forward-settled. `?` marks a forward that didn't resolve, such as
190
+ under `--no-fetch`. `adjust` tracks the forward per scenario, so a roll
191
+ across expiries renders `(fwd $18.42 → $19.05)` instead of naming only
192
+ the new leg's future.
193
+
194
+ - **CSV-imported option `averagePrice` was per contract, not per share**
195
+ ([#109](https://github.com/subsriram/thetabook/pull/109)). The Schwab and
196
+ Empower importers divided total cost basis by contract count, so a short
197
+ call sold for $6.20 landed as `620`. Every consumer reads that field per
198
+ share, and `adjust` on such a snapshot reported a $123,170 realized P&L on
199
+ a $410 buyback. Fidelity reads the broker's own per-share column and is
200
+ unchanged. Snapshots imported before this fix keep the inflated value
201
+ until the CSVs are re-imported.
202
+
203
+ - **Deep bar history comes from yfinance when defeatbeta has no coverage**
204
+ ([#111](https://github.com/subsriram/thetabook/issues/111),
205
+ [#112](https://github.com/subsriram/thetabook/pull/112)). The whole window
206
+ used to go through the live cascade, and Schwab's deep daily history
207
+ carries weekend-dated copies of Friday's close, missing sessions, bad
208
+ prints, and a pre-2020 XLE series 4–15% off. yfinance (defeatbeta's own
209
+ upstream) now serves everything older than 14 days, and the live cascade
210
+ only that tail. Weekend-dated daily rows are dropped from every source
211
+ with one warning, and the sources used are recorded on the frame.
212
+
213
+ - **defeatbeta history was 404ing for every uncached ticker**
214
+ ([#113](https://github.com/subsriram/thetabook/pull/113)). The upstream
215
+ dataset moved its parquet files under `data/US/`, which defeatbeta-api
216
+ 0.0.57 hard-coded the old way, so `hv` / `ta` / `scenarios` silently fell
217
+ back to the live cascade. The floor is now `defeatbeta-api>=0.0.63`, and
218
+ the output-silencing wrapper is updated for its new logging (nltk is gone).
219
+
220
+ - **Fidelity CSV edge cases**
221
+ ([3385271](https://github.com/subsriram/thetabook/commit/3385271)).
222
+ Schwab-held options inside a Fidelity FullView export
223
+ (`PUT AMD$475 EXP 07/17/26`, no option root) warn and are skipped, with a
224
+ pointer to `thetabook refresh`, instead of mis-parsing. Header detection
225
+ is case-insensitive, and a missing `Average Cost Basis` column no longer
226
+ raises.
227
+
228
+ - **VIX options were priced off spot, not the futures curve they reference**
229
+ ([#96](https://github.com/subsriram/thetabook/issues/96)). VIX options settle
230
+ to the SOQ and reference the VIX *future* for their expiry; no cash-and-carry
231
+ links future to spot, so no `r`/`q` choice bridges them. On 2026-09-08 spot
232
+ was 15.72 against an October forward of 18.42 — 17.2% contango — and pricing
233
+ off spot underpriced the chain by **56% at the money and 85% on the wings**,
234
+ while centring every probability on a price the contract never settles
235
+ against. "VIX above 18 at expiry" read **21.5%** off spot against **51.2%**
236
+ off the forward.
237
+
238
+ `VolResolver.resolve_forward()` derives the forward from put-call parity on
239
+ the chain already fetched — `F = K + (C − P)·e^{rT}`, median across strikes
240
+ carrying both legs, so one stale wing can't move it. Resolution is per leg,
241
+ since the forward is per expiry and a calendar spread carries a different one
242
+ on each. It feeds `compute_greeks`, `evaluate`'s PoP / `E[payoff]` /
243
+ expectation grid, `adjust`'s opening marks and scenario PoP, portfolio Greeks
244
+ aggregation, and `positions` cushion — where a VIX 20 call reads +27.2% OTM
245
+ off spot and **+8.6%** off the forward.
246
+
247
+ Pricing on that path uses **Black-76** (`q = r`), not Black-Scholes with the
248
+ spot swapped — the forward already embeds the carry, so leaving `q` at 0
249
+ applied it twice. The error is signed opposite by side: calls were overpriced
250
+ (+1.2% to +7.1%) and **puts underpriced** (−9.8% to −1.4%), so a short VIX 15
251
+ put — the position this work is built around — was marked 5.2% light.
252
+
253
+ `tickers.FORWARD_SETTLED` holds `VIX` alone: the other vol indices share the
254
+ structure but CBOE delisted their options. SPX / NDX / RUT are excluded for a
255
+ different reason — they settle on the index itself, so spot *is* the
256
+ underlying and ordinary carry already gives the forward. Every command-level
257
+ caller warns when parity can't be derived rather than silently using spot —
258
+ including `positions --no-fetch`, which can't derive one at all — and both
259
+ `evaluate` and `adjust` name the forward in their headers.
260
+
261
+ PoP now integrates the same ±5σ grid the expectations use, in both `evaluate`
262
+ and `adjust`. The old ±2σ display domain closed an unbounded profitable
263
+ *region* at its edge, so **recorded PoP moves for most structures**, not just
264
+ forward-settled ones. What matters is whether the profitable region is
265
+ bounded on both sides, not whether P&L is capped:
266
+
267
+ | structure | before | after |
268
+ | --- | ---: | ---: |
269
+ | AAPL 182-DTE short put | 62.5% | 73.3% |
270
+ | AAPL 6-month 170/180 debit call vertical | 38.7% | 49.5% |
271
+ | AAPL iron condor 150/160/190/200 | 36.6% | 36.6% |
272
+
273
+ A debit vertical's profit region is `[breakeven, ∞)` even though its P&L is
274
+ capped, so it moves; an iron condor is bounded on both sides and does not.
275
+ The new figures are the correct ones — the old domain simply stopped
276
+ integrating at `S ± 30%` — but expect existing ideas' recorded PoP to change
277
+ on the next `evaluate`.
278
+
279
+ Schwab's broker Greeks for VIX remain suspect — 10 of 36 October calls report
280
+ delta > 1.0 — and are untouched here; `--greeks-source bs` forces the
281
+ corrected path.
282
+
283
+ - **Schwab has never served option expirations**
284
+ ([#91](https://github.com/subsriram/thetabook/issues/91)).
285
+ `list_expirations_schwab` read `year` / `month` / `day` out of
286
+ `expirationList`, keys the payload has never carried — it returns
287
+ `{"expirationDate": "2026-10-21", …}`. It therefore returned `None` for
288
+ *every* ticker and the cascade quietly fell through to yfinance:
289
+ 15-minute-delayed, and empty for index roots, which is what made #91 look
290
+ like an entitlements problem. The test fixture encoded the same invented
291
+ shape, which is why it survived; it now pins a payload captured live.
292
+
293
+ - **Ticker aliases didn't reach the bars backbone**
294
+ ([#91](https://github.com/subsriram/thetabook/issues/91)). `get_bars` never
295
+ canonicalized, so the alias map applied to the live price cascade but not to
296
+ history: `thetabook price BRKB` worked while `thetabook hv BRKB` silently
297
+ returned nothing. Canonicalization now happens at `get_bars` — the one
298
+ chokepoint every bars consumer passes through — matching what `prices.py`
299
+ and `chains.py` already do at their entry points.
300
+
301
+
302
+ - **Schwab HTTP errors now surface the response body**
303
+ ([#91](https://github.com/subsriram/thetabook/issues/91)).
304
+ `raise_for_status()` renders only the status line, so a Schwab 400 arrived as
305
+ `Client error '400 Bad Request' for url ...` with no hint of what Schwab
306
+ objected to — and for a rejected symbol form the body is the whole diagnosis.
307
+ All six Schwab read call sites now append a truncated excerpt.
308
+
309
+ - **`chain` explains the listable-but-unpriceable case**
310
+ ([#91](https://github.com/subsriram/thetabook/issues/91)). Schwab's two
311
+ endpoints disagree about symbology: `chain VIX` lists 13 expirations — implying
312
+ the symbol is fine — and then every strike lookup returns empty, so the
313
+ reasonable conclusion is "VIX has no options". It does; VIX options are
314
+ cash-settled European and carry none of the roll decay that cost a VXX
315
+ position 79.3% over three years while VIX itself rose 9.6%. The no-contracts
316
+ path now names index symbology as the likely cause, but only in that
317
+ contradictory case — a date that isn't listed gets different advice, and a
318
+ ticker with no options gets the plain message.
319
+
320
+
321
+
322
+ - **Idea frontmatter and the `## Evaluation` body could disagree about
323
+ max gain/loss** ([#92](https://github.com/subsriram/thetabook/issues/92)).
324
+ `update_idea_file` set `max_gain` / `max_loss` only when unset, while the
325
+ body section was regenerated on every run — so a re-evaluated idea carried a
326
+ frozen frontmatter and a fresh body contradicting each other in the same
327
+ file, with nothing marking which was current (observed: `max_gain: 4490.0`
328
+ against a body reading `$4,480.00`, both written by `evaluate` hours apart).
329
+
330
+ Beyond cosmetics: `accounts.check_idea` enforces `max_position_pct` off the
331
+ frontmatter, so the risk check read a figure the body had already moved past,
332
+ and nothing bounded the gap — an idea first evaluated months ago kept its
333
+ original numbers forever.
334
+
335
+ **The enforced number is deliberately unchanged.** `check_idea` still reads
336
+ the same frozen `max_loss` it always did; what the split fixes is that the
337
+ file no longer presents two contradictory figures under one name, and the
338
+ frozen one is now labelled as what it is. A position limit *should* bind on
339
+ the risk accepted at entry rather than on a mark that moves under you — so
340
+ don't expect `max_position_pct` to start tracking the live number.
341
+
342
+ Split into two pairs. `max_gain` / `max_loss` stay write-once and become the
343
+ **author-declared risk budget**; new `evaluated_max_gain` /
344
+ `evaluated_max_loss` refresh every run. `check_idea` enforces the budget and
345
+ falls back to the computed value only when none was set, so a position limit
346
+ binds on the risk accepted at entry rather than on a mark that moves under
347
+ you, and ideas predating the field stay checkable. Existing files keep
348
+ loading unchanged; the new keys appear on the next `evaluate`.
349
+
350
+ `thetabook evaluate --reseed-budget` re-declares the budget from the current
351
+ run. Write-once with no writer would be a trap: every value in a pre-split
352
+ file was machine-written (one reads `-1223.1980000000003`, float noise off
353
+ `np.min` rather than a number anyone declared), and freezing those forever
354
+ while making them the sole input to a risk rule needs a way out that isn't
355
+ hand-editing frontmatter the CLI otherwise owns.
356
+
357
+ `adjust --save` seeds both pairs, and the wiki ideas roll-up now shows
358
+ `evaluated_max_loss` — it's the cross-session review surface, so it should
359
+ carry what the position risks now rather than the frozen seed.
360
+
361
+ Also routes `evaluate`'s write notice through `log.note` to **stderr** —
362
+ stdout is reserved for parseable output, and a status line there is easy to
363
+ miss when output is piped or read by an agent.
364
+
365
+
366
+
367
+ - **`adjust`'s BS-estimated opening premium used flat vol, not chain IV at the
368
+ strike** ([#32](https://github.com/subsriram/thetabook/issues/32)). When
369
+ `--open` / `--add` got a leg with no `premium=` and the chain had no usable
370
+ quote, `resolve_opening_mark` priced it off the flat 25% default — while
371
+ `compute_greeks` priced the *same hypothetical leg in the same scenario* off
372
+ the chain's IV at that strike. The premium and the Greeks then disagreed
373
+ about what the position was worth inside a single invocation.
374
+
375
+ The two lookups diverge precisely where it hurts: a chain can cover a strike
376
+ for **IV** but not for a usable **quote** — an illiquid wing with no
377
+ bid/ask, a yfinance row carrying `implied_vol` and nothing else, or an
378
+ earnings-week wing where IV ramps. The BS fallback now resolves IV per-leg
379
+ through `VolResolver.resolve_leg_iv`, the same call the Greeks make, so one
380
+ sigma drives both. The error was not small on wings: a 45-DTE OTM call at a
381
+ 62% chain IV prices at **$6.96** against **$0.53** at flat 25%, since option
382
+ value is sharply convex in vol when far OTM.
383
+
384
+ Priority is unchanged from the Greeks path — `--vol` override → chain IV at
385
+ the exact strike → flat default — and both the sigma and its provenance are
386
+ now recorded on the leg (`premium_iv`, `premium_iv_source`) and surfaced in
387
+ the comparison table as `bs @ 62% chain IV`, `bs @ 30% --vol override`, or
388
+ `bs @ 25% flat default`, so a BS-estimated premium is auditable instead of
389
+ an unattributed number. This applies under `--marks frozen` too: frozen
390
+ skips the live chain for *marks*, but the Greeks resolve per-leg chain IV in
391
+ a frozen run regardless, so exempting the premium there would have left the
392
+ same divergence alive. Only a resolver-less caller uses the flat vol.
393
+
394
+ The report header now reads `Vol: chain IV (per-leg)` instead of a single
395
+ flat number whenever `--vol` is absent — it previously printed `Vol: 25%`
396
+ above a table row reading `bs @ 62% chain IV`.
397
+
398
+ ## [2.2.3] — 2026-09-08
399
+
400
+ Housekeeping release, plus the last uncovered corner of Schwab's 7-day
401
+ token expiry. Three of these fixes broke real installs: every slash command
402
+ shelled out to a hardcoded `~/.local/bin/uv`, which doesn't exist on a
403
+ Homebrew install, so each one died with exit 127 before reaching the CLI;
404
+ `thetabook greeks` dropped the entire equity book whenever Schwab omitted
405
+ `marketPrice` (which is every share row); and `thetabook accounts` raised a
406
+ traceback instead of first-run guidance for any install with
407
+ `$THETABOOK_HOME` outside the checkout. The read paths now also say
408
+ something when the Schwab token is aging or dead, instead of quietly
409
+ serving yfinance data for a week. **1848 tests pass, ruff + mypy clean.**
410
+
411
+ ### Added
412
+
413
+ - **Schwab token-expiry handling now covers the read paths**
414
+ ([#48](https://github.com/subsriram/thetabook/issues/48)). Proactive +
415
+ reactive expiry handling existed only on the write path (`thetabook
416
+ refresh`); `prices` / `chains` / `dividends` / `bars` used a plain
417
+ `client_from_token_file` and cascaded to Massive/yfinance on auth failure.
418
+ Since an expired token is indistinguishable from a source outage in that
419
+ output, `price` / `greeks` / `evaluate` could run on yfinance for a full
420
+ week without saying so — and Schwab is the account-of-truth for real-time
421
+ quotes, broker Greeks, and dividends. Both gaps are now loud: the read
422
+ cascade warns once per resolved path when the cached token crosses
423
+ `[schwab] proactive_reauth_age_days` (reading the same `creation_timestamp`
424
+ field the write path's `easy_client` compares, with a file-mtime fallback
425
+ for hand-copied tokens), and every Schwab read failure that looks like a
426
+ revoked token appends `thetabook refresh --reauth` as the remedy.
427
+
428
+ The read paths deliberately **warn rather than re-auth**. They're called
429
+ from inside other commands — `greeks` fetches every underlying, `evaluate`
430
+ re-marks every leg — so an `easy_client` there would hijack a read-only
431
+ command with an OAuth browser flow and hang outright in a scripted run.
432
+ An aging token is still *used*: at 6 days it has ~24h of life left, and
433
+ degrading to yfinance a day early is the exact data-quality loss the
434
+ warning exists to prevent. The remedy paragraph is latched per process so
435
+ a dead token doesn't repeat it once per underlying; the per-call failure
436
+ line still prints every time.
437
+
438
+ - **Configurable assignment cost basis for `thetabook adjust --assign`**
439
+ ([#71](https://github.com/subsriram/thetabook/pull/71), closes
440
+ [#38](https://github.com/subsriram/thetabook/issues/38)). Cost-basis
441
+ attribution for shares acquired via short-put assignment is now selectable.
442
+ Default `effective` (strike − premium) is the IRS-correct basis for an
443
+ assigned written put (Pub 550: the premium reduces the share basis rather
444
+ than being separately recognized); `strike` mode is opt-in for reconciling
445
+ against a broker 1099-B that didn't auto-adjust, and adds the premium back
446
+ as a realized-income offset so total P&L is invariant either way. `StockLeg`
447
+ carries `assigned_strike` / `assigned_premium` / `basis_mode` so terminal,
448
+ markdown, and idea-file output all derive the basis from one source.
449
+ Configure via `[adjust] assign_cost_basis` in `personal/config.toml` or
450
+ per-run with `--assign-basis {effective,strike}`.
451
+
452
+ - **`[schwab] proactive_reauth_age_days` in `personal/config.toml`**
453
+ ([#84](https://github.com/subsriram/thetabook/pull/84), closes
454
+ [#49](https://github.com/subsriram/thetabook/issues/49)). The token age at
455
+ which `thetabook refresh` proactively re-runs the OAuth login flow is now a
456
+ config knob rather than a source literal, and **the default moves from 6.5
457
+ days to 6.0** — widening the margin under Schwab's 7-day refresh-token
458
+ expiry from 12 hours to 24. The old buffer was thin against clock skew,
459
+ server-side variance in when the cliff actually bites, and the gap between
460
+ one `refresh` and the next: refresh at day 6.4, come back 13 hours later,
461
+ and you crossed it before the check ever ran. Scoped to `[schwab]` rather
462
+ than to the command because 7 days is *Schwab's* policy, not ours — it can
463
+ change without a release of ours, and a second authenticated broker would
464
+ carry its own value. Anything that isn't a number in `0 < days < 7` —
465
+ out of range, quoted, or a stray `true` — falls back to the default and
466
+ warns once on the Schwab auth path; at or beyond Schwab's own expiry the
467
+ proactive re-auth could only fire after the token is already dead.
468
+
469
+ ### Fixed
470
+
471
+ - **Slash commands invoked `uv` at a hardcoded `~/.local/bin/uv`**
472
+ ([#83](https://github.com/subsriram/thetabook/pull/83)). That's the path
473
+ uv's own installer uses; on a Homebrew install uv lives at
474
+ `/opt/homebrew/bin/uv`, so every command that shelled out died with exit 127
475
+ before reaching the CLI. All 16 command files now invoke a bare `uv` and let
476
+ `PATH` resolve it. `src/thetabook/templates/skill.md` is fixed too — it
477
+ ships in the wheel, so it was seeding the same bad path into newly authored
478
+ skills. Skills already installed from an earlier registry version still
479
+ carry the old path and need `thetabook skills sync` or a re-install.
480
+
481
+ - **`thetabook accounts` crashed when `$THETABOOK_HOME` sat outside the
482
+ checkout** ([#74](https://github.com/subsriram/thetabook/pull/74)).
483
+ `ACCOUNTS_FILE.relative_to(REPO_ROOT)` raised `ValueError` on the first-run
484
+ guidance path for any pipx/uvx install or explicit override, turning
485
+ "nothing configured, here's how to fix it" into a traceback. Adds
486
+ `paths.display_path()` — relative when it can be, absolute otherwise, never
487
+ raising — and routes every `.relative_to(REPO_ROOT)` call site through it.
488
+ Also corrects stale `uv run accounts.py init` commands and repoints
489
+ `cmd_init`'s `cp` line at `TEMPLATES_DIR`, stale since templates moved under
490
+ `src/`.
491
+
492
+ - **`thetabook greeks` silently excluded the entire equity book**
493
+ ([#81](https://github.com/subsriram/thetabook/pull/81)). Schwab's positions
494
+ API leaves `marketPrice` at `0.0` on share-like rows, carrying the value in
495
+ `marketValue` instead — all 67 share positions in a live snapshot come back
496
+ that way. The `if symbol and qty != 0 and price:` guard in
497
+ `extract_equity_positions` therefore dropped every one, so a ~$1.04M long
498
+ equity book contributed zero delta and the output read as options-only with
499
+ no warning. `extract_stock_prices` had the same guard, and `aggregate_greeks`
500
+ builds its auto-fetch set from the (empty) equity map, so the fetch path
501
+ never gap-filled them either. A new `share_price()` helper derives
502
+ `abs(marketValue / quantity)` when `marketPrice` is absent, and both
503
+ extractors use it. Rows that still can't be priced now warn instead of
504
+ vanishing: their shares are shown but excluded from delta (no `marketPrice`,
505
+ no `marketValue`, and nothing fetchable means a worthless or delisted
506
+ holding, whose price doesn't move with anything), with `--prices` as the
507
+ override if that's wrong.
508
+ - **`thetabook positions` computed cushion off a snapshot-aged spot.** With
509
+ share rows now carrying a derived snapshot price, `resolve_spots`' fresh-
510
+ snapshot gap-fill-only path stopped live-fetching any underlying held as
511
+ shares — every covered call. Since `snapshot_is_stale` only means "predates
512
+ the last 4pm ET close", a snapshot pulled at 9:35am stays "fresh" all
513
+ session, so a 3:55pm cushion would have been computed on the morning price
514
+ with nothing in the output saying so. `resolve_spots` now takes the same
515
+ always-re-price-option-underlyings carve-out `greeks` got in 2.2.2, and
516
+ snapshot-sourced spots are flagged in the freshness note.
517
+ - **Equity positions held in more than one account were undercounted.**
518
+ `extract_equity_positions` assigned per row, so the last account seen
519
+ overwrote the others. Shares now accumulate across accounts.
520
+
6
521
  ## [2.2.2] — 2026-06-11
7
522
 
8
523
  A risk-correctness fix for `thetabook greeks`: option underlyings are now