gapless-crypto-data 4.0.0__tar.gz → 4.0.2__tar.gz

gapless_crypto_data-4.0.2/.github/workflows/publish.yml

@@ -0,0 +1,83 @@
+# Publish to PyPI on GitHub Release
+# ADR-0005: No tests/linting - run locally before release
+#
+# Triggered by: GitHub Release publish event
+# Purpose: Build and publish Python package to PyPI with Sigstore signing
+
+name: Publish to PyPI
+
+on:
+  release:
+    types: [published]
+
+env:
+  UV_SYSTEM_PYTHON: 1
+
+jobs:
+  build:
+    name: Build distribution packages
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.12'
+
+      - name: Install UV
+        run: curl -LsSf https://astral.sh/uv/install.sh | sh
+
+      - name: Add UV to PATH
+        run: echo "$HOME/.local/bin" >> $GITHUB_PATH
+
+      - name: Build package
+        run: |
+          uv venv
+          source .venv/bin/activate
+          uv build
+
+      - name: Store distribution packages
+        uses: actions/upload-artifact@v4
+        with:
+          name: python-package-distributions
+          path: dist/
+
+  publish-to-pypi:
+    name: Publish to PyPI
+    needs: [build]
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write
+      contents: read
+    steps:
+      - name: Download distributions
+        uses: actions/download-artifact@v4
+        with:
+          name: python-package-distributions
+          path: dist/
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          verbose: true
+
+  sign-artifacts:
+    name: Sign with Sigstore
+    needs: [publish-to-pypi]
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write
+      contents: write
+    steps:
+      - name: Download distributions
+        uses: actions/download-artifact@v4
+        with:
+          name: python-package-distributions
+          path: dist/
+
+      - name: Sign with Sigstore
+        uses: sigstore/gh-action-sigstore-python@v3.0.1
+        with:
+          inputs: ./dist/*.tar.gz ./dist/*.whl

gapless_crypto_data-4.0.2/.github/workflows/release.yml

@@ -0,0 +1,130 @@
+# Create GitHub Release on Tag Push
+# ADR-0005: Earthly-based release validation with Pushover alerts
+#
+# Triggered by: Tag push (v*.*.*)
+# Purpose: Create GitHub Release, run Earthly validation, send Pushover notification
+#
+# NOTE: This is a BACKUP workflow. Primary release method is local:
+#   npm run release  # Uses semantic-release locally (faster, instant feedback)
+
+name: Create Release
+
+on:
+  push:
+    tags:
+      - 'v*.*.*'
+
+permissions:
+  contents: write
+
+jobs:
+  release:
+    name: Create GitHub Release
+    runs-on: ubuntu-latest
+    outputs:
+      release_url: ${{ steps.create_release.outputs.url }}
+      version: ${{ steps.get_version.outputs.version }}
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Extract version from tag
+        id: get_version
+        run: |
+          VERSION=${GITHUB_REF#refs/tags/}
+          echo "version=$VERSION" >> $GITHUB_OUTPUT
+
+      - name: Generate changelog
+        id: changelog
+        run: |
+          PREV_TAG=$(git describe --tags --abbrev=0 HEAD^ 2>/dev/null || echo "")
+          if [ -n "$PREV_TAG" ]; then
+            CHANGES=$(git log --pretty=format:"- %s (%h)" $PREV_TAG..HEAD)
+          else
+            CHANGES="- Initial release"
+          fi
+          echo "changes<<EOF" >> $GITHUB_OUTPUT
+          echo "$CHANGES" >> $GITHUB_OUTPUT
+          echo "EOF" >> $GITHUB_OUTPUT
+
+      - name: Create GitHub Release
+        id: create_release
+        uses: softprops/action-gh-release@v2
+        with:
+          tag_name: ${{ steps.get_version.outputs.version }}
+          name: Release ${{ steps.get_version.outputs.version }}
+          body: |
+            # Release ${{ steps.get_version.outputs.version }}
+
+            ## Installation
+            ```bash
+            pip install gapless-crypto-data==${{ steps.get_version.outputs.version }}
+            # or
+            uv add gapless-crypto-data==${{ steps.get_version.outputs.version }}
+            ```
+
+            ## Changes
+            ${{ steps.changelog.outputs.changes }}
+
+            ## Links
+            - [PyPI Package](https://pypi.org/project/gapless-crypto-data/${{ steps.get_version.outputs.version }}/)
+            - [Documentation](https://github.com/terrylica/gapless-crypto-data#readme)
+          draft: false
+          prerelease: false
+          generate_release_notes: true
+
+  earthly-validate:
+    name: Earthly Release Validation
+    needs: [release]
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup Earthly
+        uses: earthly/actions-setup@v1
+        with:
+          version: v0.8.15
+
+      - name: Run Earthly build
+        run: earthly +build
+
+      - name: Generate release stats
+        run: |
+          earthly +release-stats \
+            --VERSION=${{ needs.release.outputs.version }} \
+            --RELEASE_URL=${{ needs.release.outputs.release_url }}
+
+      - name: Upload release stats
+        uses: actions/upload-artifact@v4
+        with:
+          name: release-stats
+          path: logs/release-stats.json
+
+  pushover-notify:
+    name: Send Pushover Notification
+    needs: [release, earthly-validate]
+    runs-on: ubuntu-latest
+    if: success()
+    steps:
+      - name: Send Pushover notification
+        env:
+          PUSHOVER_USER_KEY: ${{ secrets.PUSHOVER_USER_KEY }}
+          PUSHOVER_APP_TOKEN: ${{ secrets.PUSHOVER_APP_TOKEN }}
+        run: |
+          if [ -n "$PUSHOVER_USER_KEY" ] && [ -n "$PUSHOVER_APP_TOKEN" ]; then
+            curl -s \
+              --form-string "token=$PUSHOVER_APP_TOKEN" \
+              --form-string "user=$PUSHOVER_USER_KEY" \
+              --form-string "title=gapless-crypto-data Release" \
+              --form-string "message=Version ${{ needs.release.outputs.version }} released successfully" \
+              --form-string "url=${{ needs.release.outputs.release_url }}" \
+              --form-string "url_title=View Release" \
+              --form-string "priority=0" \
+              https://api.pushover.net/1/messages.json
+            echo "Pushover notification sent"
+          else
+            echo "Pushover credentials not configured, skipping notification"
+          fi

{gapless_crypto_data-4.0.0 → gapless_crypto_data-4.0.2}/.gitignore

@@ -24,12 +24,23 @@ test-env/
 coverage.json
 htmlcov/
 
+# Type checking and testing caches
+.mypy_cache/
+.pytest_cache/
+
 # .Sessions folder - never delete
 .sessions/
 !.sessions/.gitignore
 
-# Lychee link checker cache and results
+# Lychee link checker output
 .lycheecache
-.lycheecache/
-.lychee-results.json
 .lychee-results.txt
+.lychee-results.json
+.lychee-results.md
+
+# Node.js (semantic-release)
+node_modules/
+package-lock.json
+
+# Earthly logs and artifacts
+logs/

gapless_crypto_data-4.0.2/.releaserc.json

@@ -0,0 +1,73 @@
+{
+  "$schema": "https://json.schemastore.org/semantic-release.json",
+  "branches": ["main"],
+  "tagFormat": "v${version}",
+  "plugins": [
+    [
+      "@semantic-release/commit-analyzer",
+      {
+        "preset": "conventionalcommits",
+        "releaseRules": [
+          { "type": "feat", "release": "minor" },
+          { "type": "fix", "release": "patch" },
+          { "type": "perf", "release": "patch" },
+          { "type": "refactor", "release": "patch" },
+          { "type": "docs", "release": false },
+          { "type": "style", "release": false },
+          { "type": "chore", "release": false },
+          { "type": "test", "release": false },
+          { "type": "ci", "release": false },
+          { "breaking": true, "release": "major" }
+        ]
+      }
+    ],
+    [
+      "@semantic-release/release-notes-generator",
+      {
+        "preset": "conventionalcommits",
+        "presetConfig": {
+          "types": [
+            { "type": "feat", "section": "Features" },
+            { "type": "fix", "section": "Bug Fixes" },
+            { "type": "perf", "section": "Performance" },
+            { "type": "refactor", "section": "Refactoring" },
+            { "type": "docs", "section": "Documentation", "hidden": true },
+            { "type": "chore", "section": "Maintenance", "hidden": true }
+          ]
+        }
+      }
+    ],
+    [
+      "@semantic-release/changelog",
+      {
+        "changelogFile": "CHANGELOG.md",
+        "changelogTitle": "# Changelog\n\nAll notable changes to gapless-crypto-data will be documented in this file."
+      }
+    ],
+    [
+      "@semantic-release/exec",
+      {
+        "prepareCmd": "sed -i.bak 's/^version = \".*\"/version = \"${nextRelease.version}\"/' pyproject.toml && rm -f pyproject.toml.bak",
+        "publishCmd": "echo 'Version ${nextRelease.version} prepared for release'"
+      }
+    ],
+    [
+      "@semantic-release/git",
+      {
+        "assets": ["CHANGELOG.md", "pyproject.toml"],
+        "message": "chore(release): ${nextRelease.version} [skip ci]\n\n${nextRelease.notes}"
+      }
+    ],
+    [
+      "@semantic-release/github",
+      {
+        "assets": [
+          { "path": "dist/*.whl", "label": "Python Wheel" },
+          { "path": "dist/*.tar.gz", "label": "Source Distribution" }
+        ],
+        "successComment": false,
+        "failComment": false
+      }
+    ]
+  ]
+}

{gapless_crypto_data-4.0.0 → gapless_crypto_data-4.0.2}/CHANGELOG.md

@@ -5,63 +5,30 @@ All notable changes to gapless-crypto-data will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
-## [4.0.0] - 2025-11-17
+## [4.0.1] - 2025-01-22
 
 ### ⚠️ BREAKING CHANGES
 
-#### CLI Removed
+- **cli**: CLI interface removed completely
+  - CLI entry point removed from package (no longer accessible via `gapless-crypto-data` command)
+  - All CLI functionality available through Python API
+  - See docs/development/CLI_MIGRATION_GUIDE.md for migration examples
+  - Python API remains unchanged and fully backward compatible
 
-The command-line interface has been completely removed in v4.0.0. All functionality is now available exclusively through the Python API.
-
-#### Upgrading from v3.x
-
-**IMPORTANT**: Clean uninstall required to avoid import errors.
-
-```bash
-# Remove v3.x completely
-pip uninstall gapless-crypto-data
-rm -f ~/.local/bin/gapless-crypto-data  # Remove old CLI entry point
-
-# Install v4.0.0
-pip install gapless-crypto-data==4.0.0
-```
-
-**Migration**: See `docs/development/CLI_MIGRATION_GUIDE.md` for Python API equivalents.
-
-**Why the breaking change?**
-
-- CLI represented <5% of usage based on download statistics
-- Python API provides superior programmatic control and composability
-- Maintenance burden of dual interfaces slowed feature development
-- Industry trend: pandas, scikit-learn, requests all dropped CLIs for cleaner APIs
-
-### Added
-
-- **ClickHouse database support**: Primary storage backend with 10x performance vs file-based workflows
-- **Enhanced Python API**: Comprehensive examples and simplified function signatures
-- **11-column microstructure format**: Order flow and liquidity metrics (trade_count, taker_buy_base_volume, etc.)
-- **Multi-agent validation workflows**: Parallel E2E validation and performance profiling methodologies
-- **Semantic versioning automation**: Conventional commits → automated changelog → GitHub releases
-
-### Removed
-
-- **CLI interface**: Completely removed (see breaking changes above)
-- **QuestDB database support**: ClickHouse is now the sole database backend
-- **Legacy interval parameter**: Use `timeframe` parameter instead (5-year deprecation period ended)
-
-### Fixed
+### 📚 Documentation
 
-- **Version consistency**: `__version__` attribute now correctly reflects 4.0.0 (ADR-0006)
-- **Documentation accuracy**: All version references updated to v4.0.0 across README, CLAUDE.md, docstrings
-- **Database references**: Corrected all references from QuestDB to ClickHouse
-- **Module docstring**: Package help text now shows v4.0.0 (ADR-0007)
-- **Test assertions**: Version checks updated to expect 4.0.0
+- **cli**: Update all CLI references to reflect v4.0.0 removal
+  - Updated README.md with removal notice and migration guidance
+  - Updated CLI_MIGRATION_GUIDE.md to past tense
+  - Added clear pointer to Python API examples
 
-### Changed
+### 📝 Notes
 
-- **Database architecture**: ClickHouse replaces QuestDB as primary storage (ADR-0005)
-- **Default behavior**: File-based workflows now optional, database-first recommended
-- **Migration guide**: Enhanced with expected test failures documentation
+- **Version History**: v4.0.0 was published in error with ClickHouse references and has been yanked from PyPI
+  - v4.0.0 contained database-first implementation not appropriate for this repository
+  - ClickHouse implementation moved to separate repository (gapless-crypto-clickhouse)
+  - v4.0.1 is the correct file-based v4.x release
+  - See docs/architecture/decisions/0001-repository-split-clickhouse.md for details
 
 ## [3.3.0] - 2025-10-18
 

gapless_crypto_data-4.0.2/CLAUDE.md

@@ -0,0 +1,70 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project Overview
+
+Gapless Crypto Data is a high-performance cryptocurrency data collection tool providing authentic Binance data with zero-gap guarantee. 22x faster than API-only approaches via Binance Public Data Repository (CloudFront CDN).
+
+**Core Capability**: Collect complete historical OHLCV data with microstructure metrics (11-column format) for 13 timeframes (1s to 1d) across 400+ trading pairs.
+
+## Quick Navigation
+
+### Architecture
+
+- [Architecture Overview](./docs/architecture/OVERVIEW.md) - Core components, data flow, SLOs
+- [Data Format Specification](./docs/architecture/DATA_FORMAT.md) - 11-column microstructure format
+
+### Usage Guides
+
+- [Data Collection Guide](./docs/guides/DATA_COLLECTION.md) - CLI usage, dual data source strategy, troubleshooting
+- [Python API Reference](./docs/guides/python-api.md) - Function-based and class-based APIs, complete examples
+
+### Validation System
+
+- [Validation Overview](./docs/validation/OVERVIEW.md) - 5-layer validation pipeline, DuckDB persistence
+- [ValidationStorage Specification](./docs/validation/STORAGE.md) - Database schema, API methods
+- [AI Agent Query Patterns](./docs/validation/QUERY_PATTERNS.md) - Common patterns for validation analysis
+
+### Development
+
+- [Development Setup](./docs/development/SETUP.md) - Environment setup, IDE configuration, troubleshooting
+- [Development Commands](./docs/development/COMMANDS.md) - Testing, code quality, build, CI/CD
+- [CLI Migration Guide](./docs/development/CLI_MIGRATION_GUIDE.md) - v2.x to v3.x migration
+- [Publishing Guide](./docs/development/PUBLISHING.md) - PyPI publishing workflow
+
+## SDK Quality Standards
+
+**Primary Use Case**: Programmatic API consumption (`import gapless_crypto_data`) by downstream packages and AI coding agents
+
+**Specification**: [`docs/SDK_QUALITY_STANDARDS.yaml`](./docs/SDK_QUALITY_STANDARDS.yaml) - Machine-readable standards
+
+**Key Abstractions**:
+
+- **Type Safety**: PEP 561 compliance via py.typed marker
+- **AI Discoverability**: **probe** module, llms.txt
+- **Structured Exceptions**: Machine-parseable error context
+- **Coverage Strategy**: SDK entry points (85%+) > Core engines (70%+)
+
+## Network Architecture
+
+**CRITICAL - Empirically Validated (2025-01-19)**: DO NOT modify network implementation
+
+- **Data Source**: AWS S3 + CloudFront CDN (400+ edge locations, 99.99% SLA)
+- **Performance**: urllib is 2x faster than httpx for CDN downloads
+- **NO connection pooling** (CloudFront uses different edge servers per request)
+- **NO retry logic** (CloudFront handles failover, 0% failure rate in production)
+
+**Single improvement worth making**: ETag-based caching for bandwidth optimization
+
+## Authentication
+
+**No authentication required** for primary data collection (public Binance data repository). Gap filling uses public Binance API endpoints (rate-limited but no auth required).
+
+## Current Architecture
+
+**Version**: v4.0.1 (validation v3.3.0+ with DuckDB persistence)
+
+**Canonical Reference**: `docs/CURRENT_ARCHITECTURE_STATUS.yaml`
+
+**Production-Ready**: Core collection, intelligent resume (JSON checkpointing), CSV and Parquet output formats, zero-gap guarantee via dual-source validation

{gapless_crypto_data-4.0.0 → gapless_crypto_data-4.0.2}/DOCUMENTATION.md

@@ -2,7 +2,7 @@
 
 Complete documentation for gapless-crypto-data - ultra-fast cryptocurrency data collection from Binance's public repository with zero-gap guarantee.
 
-**Version**: 4.0.0 | **Type**: Cryptocurrency Data Collection | **Compatibility**: UV-native Python SDK
+**Version**: 4.0.1 | **Type**: Cryptocurrency Data Collection | **Compatibility**: UV-native Python SDK
 
 ---
 
@@ -143,7 +143,7 @@ Complete documentation for gapless-crypto-data - ultra-fast cryptocurrency data
 
 ### SDK Quality Standards
 
-- [docs/sdk-quality-standards.yaml](docs/sdk-quality-standards.yaml) - SDK quality specification
+- [docs/SDK_QUALITY_STANDARDS.yaml](docs/SDK_QUALITY_STANDARDS.yaml) - SDK quality specification
   - Type safety standards (PEP 561)
   - Exception hierarchy
   - AI discoverability
@@ -164,16 +164,6 @@ Complete documentation for gapless-crypto-data - ultra-fast cryptocurrency data
   - Parquet format implementation
   - Dependency pruning strategy
 
-### Stabilization Plans
-
-- [docs/api/v3.0.0-stabilization-plan.yaml](docs/api/v3.0.0-stabilization-plan.yaml) - v3.0.0 stabilization
-  - Production readiness roadmap
-  - API stability guarantees
-
-- [docs/api/v3.1.0-test-quality-plan.yaml](docs/api/v3.1.0-test-quality-plan.yaml) - Test quality plan
-  - Test coverage strategy
-  - Quality metrics targets
-
 ---
 
 ## Development
@@ -206,32 +196,16 @@ Complete documentation for gapless-crypto-data - ultra-fast cryptocurrency data
   - Environment variables
   - Security configuration
 
-### Build Documentation
-
-- [UV_BUILD_SUCCESS.md](UV_BUILD_SUCCESS.md) - UV build success
-  - UV build system validation
-  - Build configuration
-
-### Milestone Planning
+### Archived Milestones
 
-- [docs/MILESTONE_v3.0.0.yaml](docs/MILESTONE_v3.0.0.yaml) - v3.0.0 milestone
-  - Production stabilization goals
-  - Implementation timeline
+Historical milestone documentation archived for reference:
 
-- [docs/MILESTONE_v3.1.0.yaml](docs/MILESTONE_v3.1.0.yaml) - v3.1.0 milestone
-  - Feature roadmap
-  - Quality targets
+- [docs/milestones/archive/](docs/milestones/archive/) - Archived v3.x milestones
+  - v3.0.0, v3.1.0 milestone specifications
+  - v2.x milestones removed (history preserved in git)
 
 ### Audit Documentation
 
-- [CONFORMITY_AUDIT_REPORT.md](CONFORMITY_AUDIT_REPORT.md) - Conformity audit
-  - Code quality assessment
-  - Standards compliance
-
-- [dead_code_audit_plan.md](dead_code_audit_plan.md) - Dead code audit
-  - Dead code detection strategy
-  - Cleanup plan
-
 - [docs/audit/comprehensive-audit-plan.yaml](docs/audit/comprehensive-audit-plan.yaml) - Audit plan
   - Comprehensive audit strategy
   - Quality metrics
@@ -246,72 +220,9 @@ Complete documentation for gapless-crypto-data - ultra-fast cryptocurrency data
 
 **Deep technical documentation and machine-readable specifications.**
 
-### Historical Milestones (OpenAPI 3.1.1 Format)
-
-Complete version history with technical details, hard-learned lessons, and implementation rationale.
-
-**v2.15.x Series** (Latest v2 Branch)
-
-- [docs/milestones/MILESTONE_v2.15.1.yaml](docs/milestones/MILESTONE_v2.15.1.yaml) - Latest v2 series
-- [docs/milestones/MILESTONE_v2.15.0.yaml](docs/milestones/MILESTONE_v2.15.0.yaml) - AI agent integration
-
-**v2.14.x Series** (DataFrame Simplification)
-
-- [docs/milestones/MILESTONE_v2.14.0.yaml](docs/milestones/MILESTONE_v2.14.0.yaml) - DataFrame simplification
-
-**v2.12.x Series** (GaplessDataFrame)
-
-- [docs/milestones/MILESTONE_v2.12.0.yaml](docs/milestones/MILESTONE_v2.12.0.yaml) - GaplessDataFrame implementation
-
-**v2.11.x Series** (Datetime Enhancement)
-
-- [docs/milestones/MILESTONE_v2.11.0.yaml](docs/milestones/MILESTONE_v2.11.0.yaml) - Datetime index enhancement
-
-**v2.10.x Series** (Dependency Pruning)
-
-- [docs/milestones/MILESTONE_v2.10.0.yaml](docs/milestones/MILESTONE_v2.10.0.yaml) - Dependency pruning & Parquet
-
-**v2.9.x Series** (Performance Optimization)
-
-- [docs/milestones/MILESTONE_v2.9.0.yaml](docs/milestones/MILESTONE_v2.9.0.yaml) - Performance optimization
+### Historical Milestones
 
-**v2.8.x Series** (Gap Filling Enhancement)
-
-- [docs/milestones/MILESTONE_v2.8.0.yaml](docs/milestones/MILESTONE_v2.8.0.yaml) - Gap filling enhancement
-
-**v2.7.x Series** (Quality Improvements)
-
-- [docs/milestones/MILESTONE_v2.7.0.yaml](docs/milestones/MILESTONE_v2.7.0.yaml) - Quality improvements
-
-**v2.6.x Series** (CLI Enhancement)
-
-- [docs/milestones/MILESTONE_v2.6.1.yaml](docs/milestones/MILESTONE_v2.6.1.yaml) - Patch release
-- [docs/milestones/MILESTONE_v2.6.0.yaml](docs/milestones/MILESTONE_v2.6.0.yaml) - CLI enhancement
-
-**v2.5.x Series** (Validation & Checkpointing)
-
-- [docs/milestones/MILESTONE_v2.5.0.yaml](docs/milestones/MILESTONE_v2.5.0.yaml) - Validation & checkpointing
-
-**v2.4.x Series** (Gap Filling Integration)
-
-- [docs/milestones/MILESTONE_v2.4.0.yaml](docs/milestones/MILESTONE_v2.4.0.yaml) - Gap filling integration
-
-**v2.3.x Series** (Metadata Enhancement)
-
-- [docs/milestones/MILESTONE_v2.3.0.yaml](docs/milestones/MILESTONE_v2.3.0.yaml) - Metadata enhancement
-
-**v2.2.x Series** (Timestamp Format Support)
-
-- [docs/milestones/MILESTONE_v2.2.0.yaml](docs/milestones/MILESTONE_v2.2.0.yaml) - Timestamp format support
-
-**v2.1.x Series** (UTC Timezone Fix)
-
-- [docs/milestones/MILESTONE_v2.1.0.yaml](docs/milestones/MILESTONE_v2.1.0.yaml) - UTC timezone fix
-
-**v2.0.x Series** (Multi-Symbol Support)
-
-- [docs/milestones/MILESTONE_v2.0.1.yaml](docs/milestones/MILESTONE_v2.0.1.yaml) - Patch release
-- [docs/milestones/MILESTONE_v2.0.0.yaml](docs/milestones/MILESTONE_v2.0.0.yaml) - Multi-symbol support
+v2.x milestone files have been removed (history preserved in git). See [CHANGELOG.md](CHANGELOG.md) for complete version history.
 
 ---
 
@@ -330,16 +241,6 @@ Complete version history with technical details, hard-learned lessons, and imple
   - Documentation-specific changes
   - Structural improvements
 
-### Release Notes
-
-- [RELEASE_NOTES.md](RELEASE_NOTES.md) - Detailed release notes
-  - Version-specific features
-  - Migration guides
-
-- [RELEASE_NOTES_SHORT.md](RELEASE_NOTES_SHORT.md) - Short release notes
-  - Quick version summaries
-  - Key highlights only
-
 ---
 
 ## Documentation Statistics
@@ -387,4 +288,4 @@ Complete version history with technical details, hard-learned lessons, and imple
 
 ---
 
-**Last Updated**: 2025-10-18 (v3.2.0)
+**Last Updated**: 2025-11-24 (v4.0.1)