Mountainash PointBreak

An intelligent textbook for PointBreak -- a semantic dependency analysis tool for Python API evolution.

Transitional publishing: This manual remains on the central site until its per-repository cutover.

Open textbook

Chapters

1. Foundations
2. Code Analysis and Parsing
3. Core Data Models
4. Change Type Variants and Aggregates
5. Engine Pipeline
6. Consumer Pipeline
7. Impact Analysis
8. Data Lake and Reduction
9. Gold Layer and Reporting

Key Topics

• Semantic API diffing -- extract API surfaces from Python source, diff across git tags, and classify changes into 16+ ChangeType variants
• Consumer impact analysis -- join breaking upstream changes against actual downstream usage to determine which changes truly affect your code
• Medallion data lake -- Raw Parquet, Bronze DuckDB, Silver ordered diffs, and Gold net-reduced layers with idempotent write patterns
• Gold reduction -- rename composition, add/remove cancellation, and last-wins semantics to distill cumulative API evolution into actionable net diffs
• Engine and consumer pipelines -- LHS pipeline for API surface extraction and version diffing, RHS pipeline for usage extraction with jedi type inference