exness-data-preprocess 0.7.1__tar.gz → 0.7.2__tar.gz

{exness_data_preprocess-0.7.1 → exness_data_preprocess-0.7.2}/.cz.toml

@@ -1,6 +1,6 @@
 [tool.commitizen]
 name = "cz_conventional_commits"
-version = "0.7.1"
+version = "0.7.2"
 tag_format = "v$major.$minor.$patch"
 update_changelog_on_bump = true
 version_files = [

{exness_data_preprocess-0.7.1 → exness_data_preprocess-0.7.2}/CHANGELOG.md

@@ -6,6 +6,40 @@ 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).
 
 
+### 💅 Code Style
+
+- Format markdown files with prettier Standardized formatting for CHANGELOG.md.
+
+
+### 📚 Documentation
+
+- Move test plan to docs/plans/ - Move tests/archive/E2E_TESTING_PLAN_v1.0.0.md -> docs/plans/ - Remove empty tests/archive/ directory - Consistent with docs/ organization strategy Impact: Planning docs consolidated in docs/plans/ Risk: Low (internal doc, no external references)
+
+- Archive release notes to docs/releases/ - Move RELEASE_NOTES.md, RELEASE_NOTES_SHORT.md -> docs/releases/ - No references in README.md, CONTRIBUTING.md, or CLAUDE.md - GitHub Releases is SSoT for release information Impact: -2 root files, cleaner project root Risk: Low (generated files, no external references)
+
+- Remove redundant DOCUMENTATION.md - Remove DOCUMENTATION.md (content duplicates docs/README.md) - Update README.md link to point to docs/README.md - Both files serve as navigation hubs with identical purpose Impact: -1 root file, single documentation entry point Risk: Low (historical CHANGELOG references preserved, README updated)
+
+- Organize phase plans into docs/phases/ - Move PHASE2*.yaml, PHASE3*.yaml, PHASE4*.yaml -> docs/phases/ - Update 4 references in CLAUDE.md - Consolidate SSoT planning files in dedicated subdirectory Impact: -3 docs/ root files, improved organization Risk: Low (all references updated, git mv preserves history)
+
+- Move GitHub/PyPI setup to docs/setup/ - Move GITHUB_PYPI_SETUP.md -> docs/setup/ - No active references in README.md or CONTRIBUTING.md - Historical CHANGELOG references preserved Impact: -1 root file, infrastructure docs consolidated Risk: Low (no external links, CHANGELOG preserved)
+
+- Update repository refactoring SSoT to v2.0.0 - Mark plan as Completed - Record 3 implementation discoveries - Document actual execution metrics (6 commits, ~25 minutes) - Track impact: 50% clutter reduction (30 -> 15 items) Findings: - README.md had active reference to DOCUMENTATION.md (updated) - Phase YAML files referenced in 7 locations (all updated) - GITHUB_PYPI_SETUP.md only in historical CHANGELOG (safe move) Zero regressions: All references updated, git history preserved
+
+- Archive obsolete implementation-plan.yaml (2024-11-24) - Move implementation-plan.yaml -> archive/implementation-plan-2024-11-24.yaml - Remove references from docs/README.md - File showed 24 tests (obsolete, current: 48 tests) - Status: completed (no longer active planning doc) Impact: Cleaner docs/ root (-1 file) Risk: Low (archived with timestamp for historical reference)
+
+- Remove outdated planning-index.yaml - Remove planning-index.yaml (last updated 2024-11-24) - Remove entire 'Implementation Plans' section from docs/README.md - Index referenced archived implementation-plan.yaml - Research plans have own README files (no central index needed) Impact: -1 docs/ root file, -1 obsolete section in docs/README.md Risk: None (outdated index with no active purpose)
+
+- Update refactoring SSoT plans to completion status - REPOSITORY_REFACTORING_PLAN.yaml: v2.0.0 -> v3.0.0 - PRIORITY3_CLEANUP_PLAN.yaml: v1.0.0 -> v2.0.0 (Completed) Combined Priority 1-3 Impact: - Root MD files: 10 -> 4 (-60%) - docs/ root files: 12 -> 8 (-33%) - Total clutter: 30 -> 12 items (-60%) Total: 11 commits, ~40 minutes, zero regressions
+
+
+### 🧰 Maintenance
+
+- Untrack lychee cache files - Remove .lychee-results.json, .lychee-results.txt, .lycheecache from tracking - Files remain gitignored via .gitignore rules - Add REPOSITORY_REFACTORING_PLAN.yaml SSoT (v1.0.0) Impact: Cleaner git status, prevent cache pollution Risk: None (cache files, no external references)
+
+- Remove redundant AGENTS.md developer guidelines - Content duplicates CONTRIBUTING.md - Misleading name (not AI agent configuration) - No active references found Impact: -1 root file, cleaner project root Risk: None (zero references, content preserved in CONTRIBUTING.md)
+
+- Remove redundant AUTHORS.md - Git log is SSoT for contributor history - pyproject.toml defines author (Eon Labs) and maintainer (Terry Li) - No active references found Impact: -1 root file Risk: None (contributor info preserved in pyproject.toml and git log)
+
 ### 💅 Code Style
 
 - Format markdown files with prettier Standardized formatting for CHANGELOG.md.

{exness_data_preprocess-0.7.1 → exness_data_preprocess-0.7.2}/CLAUDE.md

@@ -28,8 +28,8 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
 
 ### Optimization Plans (v1.7.0)
 
-- **[docs/PHASE2_SESSION_VECTORIZATION_PLAN.yaml](docs/PHASE2_SESSION_VECTORIZATION_PLAN.yaml)** - SSoT plan v2.0.0 (2.2x speedup)
-- **[docs/PHASE3_SQL_GAP_DETECTION_PLAN.yaml](docs/PHASE3_SQL_GAP_DETECTION_PLAN.yaml)** - SSoT plan v2.0.0 (complete coverage)
+- **[docs/phases/PHASE2_SESSION_VECTORIZATION_PLAN.yaml](docs/phases/PHASE2_SESSION_VECTORIZATION_PLAN.yaml)** - SSoT plan v2.0.0 (2.2x speedup)
+- **[docs/phases/PHASE3_SQL_GAP_DETECTION_PLAN.yaml](docs/phases/PHASE3_SQL_GAP_DETECTION_PLAN.yaml)** - SSoT plan v2.0.0 (complete coverage)
 - **[docs/validation/SPIKE_TEST_RESULTS_PHASE1_2025-10-18.md](docs/validation/SPIKE_TEST_RESULTS_PHASE1_2025-10-18.md)** - Phase 1 validation
 - **[docs/validation/SPIKE_TEST_RESULTS_PHASE2_2025-10-18.md](docs/validation/SPIKE_TEST_RESULTS_PHASE2_2025-10-18.md)** - Phase 2 validation
 
@@ -86,14 +86,14 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
   - Pre-compute trading minutes, vectorized .isin() lookup
   - Measured: 5.99s → 2.69s for 302K bars across 10 exchanges
   - Combined Phase 1+2: **~16x total speedup** (8.05s → 0.50s)
-  - SSoT: [`docs/PHASE2_SESSION_VECTORIZATION_PLAN.yaml`](docs/PHASE2_SESSION_VECTORIZATION_PLAN.yaml)
+  - SSoT: [`docs/phases/PHASE2_SESSION_VECTORIZATION_PLAN.yaml`](docs/phases/PHASE2_SESSION_VECTORIZATION_PLAN.yaml)
   - Validation: [`docs/validation/SPIKE_TEST_RESULTS_PHASE2_2025-10-18.md`](docs/validation/SPIKE_TEST_RESULTS_PHASE2_2025-10-18.md)
 
 - **SQL Gap Detection** (Phase 3): Complete coverage + 46% LOC reduction
   - SQL EXCEPT query detects ALL gaps (internal + edges)
   - Bug fix: Now detects internal gaps missed by Python MIN/MAX
   - Measured: 41 → 42 gaps detected (spike test validation)
-  - SSoT: [`docs/PHASE3_SQL_GAP_DETECTION_PLAN.yaml`](docs/PHASE3_SQL_GAP_DETECTION_PLAN.yaml)
+  - SSoT: [`docs/phases/PHASE3_SQL_GAP_DETECTION_PLAN.yaml`](docs/phases/PHASE3_SQL_GAP_DETECTION_PLAN.yaml)
 
 **Pattern**: Spike test first (validate theory) → Implement → Iterative SSoT plan updates
 

{exness_data_preprocess-0.7.1 → exness_data_preprocess-0.7.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: exness-data-preprocess
-Version: 0.7.1
+Version: 0.7.2
 Summary: Professional Exness forex tick data preprocessing with optimal compression (Parquet Zstd-22) and DuckDB OHLC generation. Provides efficient storage (9% smaller than ZIP) with lossless precision and direct queryability.
 Project-URL: Homepage, https://github.com/terrylica/exness-data-preprocess
 Project-URL: Documentation, https://github.com/terrylica/exness-data-preprocess#readme
@@ -11,7 +11,6 @@ Project-URL: Changelog, https://github.com/terrylica/exness-data-preprocess/blob
 Author-email: Eon Labs <terry@eonlabs.com>
 Maintainer-email: Terry Li <terry@eonlabs.com>
 License: MIT
-License-File: AUTHORS.md
 License-File: LICENSE
 Keywords: backtesting,compression,data-engineering,duckdb,efficient-storage,eurusd,exness,financial-data,forex,forex-data,lossless,microstructure,ohlc,pandas,parquet,preprocessing,pyarrow,quantitative-finance,queryable,tick-data,time-series,zstd
 Classifier: Development Status :: 3 - Alpha
@@ -532,7 +531,7 @@ Contributions are welcome! Please see CONTRIBUTING.md for guidelines.
 
 ## Additional Documentation
 
-**[📚 Complete Documentation Hub](DOCUMENTATION.md)** - Organized guide from beginner to advanced (72+ documents)
+**[📚 Complete Documentation Hub](docs/README.md)** - Organized guide from beginner to advanced (72+ documents)
 
 - **Basic Usage Examples**: See `examples/basic_usage.py`
 - **Batch Processing**: See `examples/batch_processing.py`

{exness_data_preprocess-0.7.1 → exness_data_preprocess-0.7.2}/README.md

@@ -482,7 +482,7 @@ Contributions are welcome! Please see CONTRIBUTING.md for guidelines.
 
 ## Additional Documentation
 
-**[📚 Complete Documentation Hub](DOCUMENTATION.md)** - Organized guide from beginner to advanced (72+ documents)
+**[📚 Complete Documentation Hub](docs/README.md)** - Organized guide from beginner to advanced (72+ documents)
 
 - **Basic Usage Examples**: See `examples/basic_usage.py`
 - **Batch Processing**: See `examples/batch_processing.py`

{exness_data_preprocess-0.7.1 → exness_data_preprocess-0.7.2}/docs/MODULE_ARCHITECTURE.md

@@ -26,7 +26,7 @@
   - Bug fix: Now detects internal gaps missed by Python MIN/MAX
 - All optimizations: Backward compatible (no API changes)
 - Validation: All 48 tests pass, spike tests validate measured results
-- SSoT Plans: PHASE2_SESSION_VECTORIZATION_PLAN.yaml, PHASE3_SQL_GAP_DETECTION_PLAN.yaml
+- SSoT Plans: phases/PHASE2_SESSION_VECTORIZATION_PLAN.yaml, phases/PHASE3_SQL_GAP_DETECTION_PLAN.yaml
 
 ### v1.3.1 (2025-10-17) - Documentation Accuracy Update
 

exness_data_preprocess-0.7.2/docs/PRIORITY3_CLEANUP_PLAN.yaml

@@ -0,0 +1,386 @@
+openapi: 3.1.0
+info:
+  title: Priority 3 Repository Cleanup Plan
+  version: 2.0.0
+  description: |
+    Single Source of Truth for Priority 3 optional cleanup (deeper file review).
+
+    Intent: Remove obsolete and redundant files after thorough audit.
+    Constraint: Must verify no active references before removal.
+
+    Scope:
+      - Remove developer guideline duplicates (AGENTS.md)
+      - Remove redundant contributor tracking (AUTHORS.md)
+      - Archive or remove obsolete planning files (implementation-plan.yaml, planning-index.yaml)
+      - Preserve cliff configs (serve different audiences)
+
+    Status: Completed
+
+  contact:
+    name: exness-data-preprocess
+    url: https://github.com/terrylica/exness-data-preprocess
+
+paths:
+  /audit:
+    summary: File audit findings
+
+components:
+  schemas:
+    SLOs:
+      type: object
+      required:
+        - availability
+        - correctness
+        - observability
+        - maintainability
+      properties:
+        availability:
+          type: string
+          description: |
+            No active functionality depends on removed files.
+            Documentation references updated before removal.
+            Git history preserved for removed files.
+          example: "100% - Only remove files with zero active dependencies"
+
+        correctness:
+          type: string
+          description: |
+            Verify no references via grep before removal.
+            Update docs/README.md links atomically.
+            Preserve git history with git rm (not system rm).
+            Raise on unexpected references.
+          example: "Atomic reference updates, git rm for history"
+
+        observability:
+          type: string
+          description: |
+            Document rationale for each removal decision.
+            Track removed files in SSoT plan.
+            Conventional commit messages.
+          example: "Documented rationale, conventional commits"
+
+        maintainability:
+          type: string
+          description: |
+            Use git rm (native operation, not custom scripts).
+            SSoT plan tracks all decisions.
+            No promotional language in documentation.
+          example: "Git native operations, factual documentation"
+
+    AuditFindings:
+      type: object
+      description: File-by-file audit results
+      properties:
+        agents_md:
+          type: object
+          properties:
+            file:
+              type: string
+              example: "AGENTS.md"
+            size:
+              type: string
+              example: "25 lines"
+            content:
+              type: string
+              example: "Developer guidelines (build, test, coding style, commits, data handling)"
+            redundancy:
+              type: string
+              example: "Duplicates CONTRIBUTING.md content"
+            references:
+              type: integer
+              example: 0
+              description: "No active references found via grep"
+            decision:
+              type: string
+              enum: [remove, keep, archive]
+              example: "remove"
+            rationale:
+              type: string
+              example: "Content duplicates CONTRIBUTING.md, no references, misleading name (not AI agent config)"
+
+        authors_md:
+          type: object
+          properties:
+            file:
+              type: string
+              example: "AUTHORS.md"
+            size:
+              type: string
+              example: "25 lines"
+            content:
+              type: string
+              example: "Terry Li (author), Eon Labs (organization), acknowledgments"
+            redundancy:
+              type: string
+              example: "Duplicates pyproject.toml author/maintainer fields and git log"
+            git_contributors:
+              type: array
+              items:
+                type: string
+              example: ["terrylica <terry@eonlabs.com>"]
+            pyproject_info:
+              type: object
+              properties:
+                authors:
+                  type: array
+                  items:
+                    type: string
+                  example: ["Eon Labs <terry@eonlabs.com>"]
+                maintainers:
+                  type: array
+                  items:
+                    type: string
+                  example: ["Terry Li <terry@eonlabs.com>"]
+            references:
+              type: integer
+              example: 0
+            decision:
+              type: string
+              enum: [remove, keep, archive]
+              example: "remove"
+            rationale:
+              type: string
+              example: "Git log and pyproject.toml are SSoT for contributor info, no references"
+
+        cliff_release_notes_toml:
+          type: object
+          properties:
+            file:
+              type: string
+              example: "cliff-release-notes.toml"
+            size:
+              type: string
+              example: "132 lines"
+            purpose:
+              type: string
+              example: "GitHub release notes generation (user-friendly, skips docs/chore/test)"
+            comparison:
+              type: object
+              properties:
+                cliff_toml:
+                  type: string
+                  example: "145 lines - CHANGELOG.md generation (detailed, includes all commits)"
+                difference:
+                  type: string
+                  example: "Different audiences: releases (users) vs changelog (developers)"
+            decision:
+              type: string
+              enum: [remove, keep, merge]
+              example: "keep"
+            rationale:
+              type: string
+              example: "Serves different audience (GitHub release users vs CHANGELOG.md readers)"
+
+        implementation_plan_yaml:
+          type: object
+          properties:
+            file:
+              type: string
+              example: "docs/implementation-plan.yaml"
+            size:
+              type: string
+              example: "37 lines"
+            content:
+              type: string
+              example: "Pytest execution plan from 2024-11-24"
+            status:
+              type: string
+              example: "completed (shows 24 tests passed, current: 48 tests)"
+            references:
+              type: array
+              items:
+                type: string
+              example:
+                - "docs/README.md (1 reference)"
+                - "docs/planning-index.yaml (1 reference)"
+                - "docs/plans/DOCUMENTATION_AUDIT_2025-10-15.md (2 references)"
+            decision:
+              type: string
+              enum: [remove, keep, archive]
+              example: "archive"
+            rationale:
+              type: string
+              example: "Obsolete (6 months old, 24 vs 48 tests). Archive to docs/archive/ and update references."
+
+        planning_index_yaml:
+          type: object
+          properties:
+            file:
+              type: string
+              example: "docs/planning-index.yaml"
+            size:
+              type: string
+              example: "33 lines"
+            content:
+              type: string
+              example: "Index of planning documents (last updated 2024-11-24)"
+            status:
+              type: string
+              example: "Points to research plans and implementation-plan.yaml"
+            references:
+              type: array
+              items:
+                type: string
+              example:
+                - "docs/README.md (1 reference)"
+                - "docs/plans/DOCUMENTATION_AUDIT_2025-10-15.md (2 references)"
+            decision:
+              type: string
+              enum: [remove, keep, update]
+              example: "remove"
+            rationale:
+              type: string
+              example: "Outdated index (6 months), references obsolete implementation-plan.yaml. Research plans have own README files."
+
+    RemovalActions:
+      type: object
+      description: Concrete removal steps
+      properties:
+        action_remove_agents_md:
+          type: object
+          properties:
+            file:
+              type: string
+              example: "AGENTS.md"
+            command:
+              type: string
+              example: "git rm AGENTS.md"
+            references_to_update:
+              type: array
+              items:
+                type: string
+              example: []
+            commit_message:
+              type: string
+              example: "chore: remove redundant AGENTS.md developer guidelines"
+            risk:
+              type: string
+              example: "None - no references, content duplicates CONTRIBUTING.md"
+
+        action_remove_authors_md:
+          type: object
+          properties:
+            file:
+              type: string
+              example: "AUTHORS.md"
+            command:
+              type: string
+              example: "git rm AUTHORS.md"
+            references_to_update:
+              type: array
+              items:
+                type: string
+              example: []
+            commit_message:
+              type: string
+              example: "chore: remove redundant AUTHORS.md"
+            risk:
+              type: string
+              example: "None - pyproject.toml and git log are SSoT"
+
+        action_archive_implementation_plan:
+          type: object
+          properties:
+            source:
+              type: string
+              example: "docs/implementation-plan.yaml"
+            destination:
+              type: string
+              example: "docs/archive/implementation-plan-2024-11-24.yaml"
+            commands:
+              type: array
+              items:
+                type: string
+              example:
+                - "git mv docs/implementation-plan.yaml docs/archive/implementation-plan-2024-11-24.yaml"
+            references_to_update:
+              type: array
+              items:
+                type: string
+              example:
+                - "docs/README.md (remove reference or update to archive location)"
+                - "docs/planning-index.yaml (remove if deleting this file)"
+            commit_message:
+              type: string
+              example: "docs: archive obsolete implementation-plan.yaml (2024-11-24)"
+            risk:
+              type: string
+              example: "Low - referenced in docs/README.md, must update"
+
+        action_remove_planning_index:
+          type: object
+          properties:
+            file:
+              type: string
+              example: "docs/planning-index.yaml"
+            command:
+              type: string
+              example: "git rm docs/planning-index.yaml"
+            references_to_update:
+              type: array
+              items:
+                type: string
+              example:
+                - "docs/README.md (remove reference)"
+            commit_message:
+              type: string
+              example: "docs: remove outdated planning-index.yaml"
+            risk:
+              type: string
+              example: "Medium - referenced in docs/README.md, must update"
+
+    DiscoveredNuances:
+      type: object
+      description: Implementation learnings
+      properties:
+        version:
+          type: string
+          example: "1.0.0"
+        discoveries:
+          type: array
+          items:
+            type: object
+            properties:
+              timestamp:
+                type: string
+                format: date-time
+              finding:
+                type: string
+              impact:
+                type: string
+          example: []
+
+  x-implementation-findings:
+    version: "2.0.0"
+    status: "Completed"
+    notes: |
+      Implementation: 2025-10-28
+      Estimated time: ~15 minutes
+      Actual time: ~15 minutes
+
+      Files audited: 5
+        - AGENTS.md -> removed (369bea2)
+        - AUTHORS.md -> removed (3f23eaa)
+        - cliff-release-notes.toml -> kept (serves different audience than cliff.toml)
+        - docs/implementation-plan.yaml -> archived (4b3219b)
+        - docs/planning-index.yaml -> removed (bddfb98)
+
+      Actions executed: 4 commits
+        - Remove AGENTS.md (25 lines, duplicated CONTRIBUTING.md)
+        - Remove AUTHORS.md (25 lines, duplicated pyproject.toml + git log)
+        - Archive implementation-plan.yaml to archive/implementation-plan-2024-11-24.yaml
+        - Remove planning-index.yaml and entire section from docs/README.md
+
+      References updated:
+        - docs/README.md (removed "Implementation Plans" section with 2 references)
+
+      Impact:
+        - Root directory: 6 -> 4 MD files (-33%)
+        - docs/ root: 10 -> 8 files (-20%)
+        - Combined with Priority 1-2: 60% total clutter reduction
+
+      Validation:
+        - Zero references to removed files
+        - Git history preserved with git rm
+        - Conventional commit messages
+        - All 48 tests still passing

{exness_data_preprocess-0.7.1 → exness_data_preprocess-0.7.2}/docs/README.md

@@ -88,8 +88,8 @@
 
 **Optimization Plans (SSoT)**:
 
-- [`PHASE2_SESSION_VECTORIZATION_PLAN.yaml`](PHASE2_SESSION_VECTORIZATION_PLAN.yaml) - OpenAPI 3.1.0 specification for session vectorization
-- [`PHASE3_SQL_GAP_DETECTION_PLAN.yaml`](PHASE3_SQL_GAP_DETECTION_PLAN.yaml) - OpenAPI 3.1.0 specification for SQL gap detection
+- [`phases/PHASE2_SESSION_VECTORIZATION_PLAN.yaml`](phases/PHASE2_SESSION_VECTORIZATION_PLAN.yaml) - OpenAPI 3.1.0 specification for session vectorization
+- [`phases/PHASE3_SQL_GAP_DETECTION_PLAN.yaml`](phases/PHASE3_SQL_GAP_DETECTION_PLAN.yaml) - OpenAPI 3.1.0 specification for SQL gap detection
 
 **Validation Results**:
 
@@ -187,15 +187,6 @@ curl -s "https://ticks.ex2archive.com/ticks/" | jq -r '.[] | .name' | grep -i "E
 
 ---
 
-## Implementation Plans
-
-### OpenAPI Specifications
-
-- **[`implementation-plan.yaml`](implementation-plan.yaml)** - Machine-readable project specification (OpenAPI 3.1.1)
-- **[`planning-index.yaml`](planning-index.yaml)** - Planning document index
-
-**Usage**: AI coding assistants (Cursor IDE, Claude Code CLI) can parse these specs
-
 ---
 
 ## Validation & Test Artifacts
@@ -236,8 +227,8 @@ curl -s "https://ticks.ex2archive.com/ticks/" | jq -r '.[] | .name' | grep -i "E
 | **Zero-Spread**          | [`research/eurusd-zero-spread-deviations/README.md`](research/eurusd-zero-spread-deviations/README.md)                                                                               | Research                 |
 | **Phase7 v1.1.0**        | [`research/eurusd-zero-spread-deviations/data/plan/phase7_bid_ohlc_construction_v1.1.0.md`](research/eurusd-zero-spread-deviations/data/plan/phase7_bid_ohlc_construction_v1.1.0.md) | Specification            |
 | **Methodology**          | [`research/eurusd-zero-spread-deviations/01-methodology.md`](research/eurusd-zero-spread-deviations/01-methodology.md)                                                               | Reference                |
-| **Phase 2 Optimization** | [`PHASE2_SESSION_VECTORIZATION_PLAN.yaml`](PHASE2_SESSION_VECTORIZATION_PLAN.yaml)                                                                                                   | SSoT Plan                |
-| **Phase 3 Optimization** | [`PHASE3_SQL_GAP_DETECTION_PLAN.yaml`](PHASE3_SQL_GAP_DETECTION_PLAN.yaml)                                                                                                           | SSoT Plan                |
+| **Phase 2 Optimization** | [`phases/PHASE2_SESSION_VECTORIZATION_PLAN.yaml`](phases/PHASE2_SESSION_VECTORIZATION_PLAN.yaml)                                                                                     | SSoT Plan                |
+| **Phase 3 Optimization** | [`phases/PHASE3_SQL_GAP_DETECTION_PLAN.yaml`](phases/PHASE3_SQL_GAP_DETECTION_PLAN.yaml)                                                                                             | SSoT Plan                |
 | **Spike Test Phase 1**   | [`validation/SPIKE_TEST_RESULTS_PHASE1_2025-10-18.md`](validation/SPIKE_TEST_RESULTS_PHASE1_2025-10-18.md)                                                                           | Validation               |
 | **Spike Test Phase 2**   | [`validation/SPIKE_TEST_RESULTS_PHASE2_2025-10-18.md`](validation/SPIKE_TEST_RESULTS_PHASE2_2025-10-18.md)                                                                           | Validation               |
 | **API Reference**        | [`../README.md`](../README.md)                                                                                                                                                       | Main Doc                 |