Add CI workflow, changelog, contributing guide, cross-links

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Author: tdobrowolski1

.github/workflows/ci.yml

@@ -0,0 +1,19 @@
+name: CI
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.10", "3.11", "3.12", "3.13"]
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+      - run: pip install -e ".[dev]"
+      - run: pytest tests/test_client.py -v

CHANGELOG.md

@@ -0,0 +1,28 @@
+# Changelog
+
+## 0.2.0 (2026-03-26)
+
+### Added
+- `zero_dte()` — real-time 0DTE analytics (regime, pin risk, expected move, hedging, decay)
+- `exposure_history()` — daily exposure snapshots for trend analysis
+- `adv_volatility()` — advanced volatility analytics (SVI parameters, variance surface, arbitrage detection, greeks surfaces, variance swap pricing)
+- Comprehensive method reference table in README
+- SEO-optimized keywords in PyPI metadata
+
+### Changed
+- Updated API plans table to reflect current tiers (Free/Basic/Growth/Alpha)
+- Improved README structure and documentation
+
+## 0.1.0 (2026-03-13)
+
+### Added
+- Initial release
+- Core client with all FlashAlpha API endpoints
+- Exposure analytics: `gex()`, `dex()`, `vex()`, `chex()`, `exposure_levels()`, `exposure_summary()`, `narrative()`
+- Market data: `stock_quote()`, `option_quote()`, `stock_summary()`, `surface()`
+- Historical data: `historical_stock_quote()`, `historical_option_quote()`
+- Pricing: `greeks()`, `iv()`, `kelly()`
+- Volatility: `volatility()`
+- Reference: `tickers()`, `options()`, `symbols()`, `account()`, `health()`
+- Error handling: `AuthenticationError`, `TierRestrictedError`, `NotFoundError`, `RateLimitError`, `ServerError`
+- 36 unit tests, 23 integration tests

CONTRIBUTING.md

@@ -0,0 +1,47 @@
+# Contributing
+
+Thanks for your interest in contributing to the FlashAlpha Python SDK.
+
+## Reporting Issues
+
+Open an issue on [GitHub](https://github.com/FlashAlpha-lab/flashalpha-python/issues) with:
+- Python version
+- SDK version (`flashalpha.__version__`)
+- Steps to reproduce
+- Expected vs actual behavior
+
+## Development Setup
+
+```bash
+git clone https://github.com/FlashAlpha-lab/flashalpha-python.git
+cd flashalpha-python
+pip install -e ".[dev]"
+pytest tests/test_client.py -v
+```
+
+## Running Tests
+
+Unit tests (no API key needed):
+```bash
+pytest tests/test_client.py -v
+```
+
+Integration tests (requires API key):
+```bash
+FLASHALPHA_API_KEY=your_key pytest tests/test_integration.py -m integration -v
+```
+
+## Pull Requests
+
+1. Fork the repo
+2. Create a branch (`git checkout -b feature/your-feature`)
+3. Make your changes
+4. Add tests for new functionality
+5. Run the test suite
+6. Submit a PR
+
+## Code Style
+
+- Type hints on all public methods
+- Docstrings on all public methods
+- Follow existing patterns in `client.py`

README.md

@@ -3,6 +3,7 @@
 [![PyPI](https://img.shields.io/pypi/v/flashalpha)](https://pypi.org/project/flashalpha/)
 [![Python](https://img.shields.io/pypi/pyversions/flashalpha)](https://pypi.org/project/flashalpha/)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![CI](https://github.com/FlashAlpha-lab/flashalpha-python/actions/workflows/ci.yml/badge.svg)](https://github.com/FlashAlpha-lab/flashalpha-python/actions/workflows/ci.yml)
 
 **Python client for the FlashAlpha options analytics API.** Access real-time gamma exposure (GEX), delta exposure (DEX), vanna exposure (VEX), charm exposure (CHEX), 0DTE analytics, Black-Scholes greeks, implied volatility, volatility surfaces, dealer positioning, Kelly criterion sizing, and more — all from Python.
 
@@ -213,8 +214,11 @@ Get your API key at **[flashalpha.com](https://flashalpha.com)**
 
 - [FlashAlpha](https://flashalpha.com) — API keys, docs, pricing
 - [API Documentation](https://flashalpha.com/docs)
-- [Examples](https://github.com/FlashAlpha-lab/flashalpha-examples)
-- [GEX Explained](https://github.com/FlashAlpha-lab/gex-explained)
+- [GEX Explained](https://github.com/FlashAlpha-lab/gex-explained) — gamma exposure theory and code
+- [0DTE Options Analytics](https://github.com/FlashAlpha-lab/0dte-options-analytics) — 0DTE pin risk, expected move, dealer hedging
+- [Volatility Surface Python](https://github.com/FlashAlpha-lab/volatility-surface-python) — SVI calibration, variance swap, skew analysis
+- [Examples](https://github.com/FlashAlpha-lab/flashalpha-examples) — runnable tutorials
+- [Awesome Options Analytics](https://github.com/FlashAlpha-lab/awesome-options-analytics) — curated resource list
 
 ## License