pretty-git 0.1.2 → 0.1.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2200709c51eb32592b4fe79a3acea35178fab498dbd781edcc4237ceabfa00c7
-  data.tar.gz: c83bdd9cb01c5b345dfa52f0f1d35a03ed167a78307a6a085819453d96c88293
+  metadata.gz: 84571ab2bdd16f92dc31c1883a70433a140253ee0d0c66f1079453fc30f34419
+  data.tar.gz: 532ee3a2e436163f12821073297dc013e874746c5ac269f89c455826566c9f27
 SHA512:
-  metadata.gz: 1d23439b48405024896bec5e173a8573ce0b8fb1b8d1872b98d0201d4cceb85bd07f246f0d2e0a406d1c9f25d40f903280536b32e8dd030dfb04f801bc617d32
-  data.tar.gz: 3137c6d5b19ecbc496f14c9db9395a598d7e7bb8f33f5863db6eb8f3bf9141db141bd2429b8346101a53d79b4a4d687a4b430ad252e1f99bc58f1f2ea0bc6ac4
+  metadata.gz: a0ba7918e1179ebfe3c4771c995b8b0eda978263be1fc6484f0f913e7b2129472272660e3c6dfb24a11f9d64300c26748d0b01fc14f0594e04e9b88cf244b96c
+  data.tar.gz: afaa201615eff920f1af0b86384964437fe7a119fc0d43d2a5ae10ee36211215b84c9607b92354646a20d691f0382f0b5d214385a214e8107596cdcf06eefcb2

data/CHANGELOG.md

@@ -7,6 +7,21 @@ The format is based on Keep a Changelog, and this project adheres to Semantic Ve
 ## [Unreleased]
  
 
+## [0.1.3] - 2025-08-14
+### Added
+- New analytics reports: `hotspots`, `churn`, `ownership` with sorting, scoring, and limits.
+- Exporters: CSV and Markdown support for new reports with dynamic headers via mapping constants.
+- Docs: Detailed sections for new reports in `README.md` and `README.ru.md` with usage and examples (CSV/JSON/YAML/XML).
+
+### Changed
+- Console: dispatching and rendering wired for new reports; consistent theming and width handling.
+- CLI/App: unified analytics dispatch for all reports.
+- Docs: public READMEs cleaned up from internal DR-* mentions; anchors and headings aligned (CSV).
+
+### Fixed
+- Minor documentation inaccuracies and anchor mismatches.
+
+
 ## [0.1.2] - 2025-08-13
 ### Added
 - Languages report: support multiple metrics — `bytes`, `files`, `loc`; dynamic columns in Console/CSV/Markdown; color and percent fields in output.

data/README.md

@@ -14,7 +14,7 @@
   <br>
 </p>
 
-Generator of rich reports for a local Git repository: summary, activity, authors, files, heatmap, languages. Output to Console and formats: JSON, CSV, Markdown, YAML, XML.
+Generator of rich reports for a local Git repository: summary, activity, authors, files, heatmap, languages, hotspots, churn, ownership. Output to Console and formats: JSON, CSV, Markdown, YAML, XML.
 
 — License: MIT.
 
@@ -35,10 +35,13 @@ Generator of rich reports for a local Git repository: summary, activity, authors
   - [files — by files](#files--by-files)
   - [heatmap — commit heatmap](#heatmap--commit-heatmap)
   - [languages — languages](#languages--languages)
+  - [hotspots — hotspots (risky files)](#hotspots--hotspots-risky-files)
+  - [churn — code churn by file](#churn--code-churn-by-file)
+  - [ownership — code ownership](#ownership--code-ownership)
 - [Exports](#exports)
   - [Console](#console)
   - [JSON](#json)
-  - [CSV (DR-001)](#csv-dr-001)
+  - [CSV](#csv)
   - [Markdown](#markdown)
   - [YAML](#yaml)
   - [XML](#xml)
@@ -49,17 +52,17 @@ Generator of rich reports for a local Git repository: summary, activity, authors
 - [Development](#development)
 - [License](#license)
 
-## Features
-* **Reports**: `summary`, `activity`, `authors`, `files`, `heatmap`, `languages`.
+## ✨ Features
+* **Reports**: `summary`, `activity`, `authors`, `files`, `heatmap`, `languages`, `hotspots`, `churn`, `ownership`.
 * **Filters**: branches, authors, paths, time period.
 * **Exports**: `console`, `json`, `csv`, `md`, `yaml`, `xml`.
 * **Output**: to stdout or file via `--out`.
 
-## Requirements
+## ⚙️ Requirements
 * **Ruby**: >= 3.4 (recommended 3.4.x)
 * **Git**: installed and available in `PATH`
 
-## Installation
+## 📦 Installation
 
 ### 🍺 Homebrew (recommended)
 ```bash
@@ -101,7 +104,7 @@ bundle install
 bundle exec pretty-git --help
 ```
 
-## Quick Start
+## 🚀 Quick Start
 ```bash
 # Repository summary to console
 bundle exec bin/pretty-git summary .
@@ -114,21 +117,21 @@ bundle exec bin/pretty-git activity . --time-bucket week --since 2025-01-01 \
   --paths app,lib --format csv --out activity.csv
 ```
 
-## CLI and Options
+## 🧰 CLI and Options
 General form:
 
 ```bash
 pretty-git <report> <repo_path> [options]
 ```
 
-Available reports: `summary`, `activity`, `authors`, `files`, `heatmap`, `languages`.
+Available reports: `summary`, `activity`, `authors`, `files`, `heatmap`, `languages`, `hotspots`, `churn`, `ownership`.
 
 Key options:
 * **--format, -f** `console|json|csv|md|yaml|xml` (default `console`)
 * **--out, -o** Path to write output file
 * **--limit, -l** Number of items shown; `all` or `0` — no limit
 * **--time-bucket** `day|week|month` (for `activity`)
-* **--since/--until** Date/time in ISO8601 or `YYYY-MM-DD` (DR-005)
+* **--since/--until** Date/time in ISO8601 or `YYYY-MM-DD`
 * **--branch** Multi-option, can be specified multiple times
 * **--author/--exclude-author** Filter by authors
 * **--path/--exclude-path** Filter by paths (comma-separated or repeated option)
@@ -165,15 +168,15 @@ pretty-git authors . --format csv --out authors.csv
 * `1` — user error (unknown report/format, bad arguments)
 * `2` — system error (git error etc.)
 
-## Reports and Examples
+## 📊 Reports and Examples
 
-### summary — repository summary
+### 🧭 summary — repository summary
 ```bash
 pretty-git summary . --format json
 ```
 Contains totals (commits, authors, additions, deletions) and top authors/files.
 
-### activity — activity (day/week/month)
+### 📆 activity — activity (day/week/month)
 ```bash
 pretty-git activity . --time-bucket week --format csv
 ```
@@ -186,7 +189,7 @@ JSON example:
 ]
 ```
 
-### authors — by authors
+### 👤 authors — by authors
 ```bash
 pretty-git authors . --format md --limit 10
 ```
@@ -199,7 +202,7 @@ Markdown example:
 | Bob   | b@example.com | 1 | 2 | 0 | 2.0 |
 ```
 
-### files — by files
+### 📁 files — by files
 ```bash
 pretty-git files . --paths app,lib --format csv
 ```
@@ -219,7 +222,7 @@ XML example:
 </files>
 ```
 
-### heatmap — commit heatmap
+### 🔥 heatmap — commit heatmap
 ```bash
 pretty-git heatmap . --format json
 ```
@@ -231,7 +234,7 @@ dow,hour,commits
 1,11,7
 ```
 
-### languages — languages
+### 🈺 languages — languages
 ```bash
 pretty-git languages . --format md --limit 10
 ```
@@ -264,11 +267,92 @@ Export:
 - CSV/MD: columns are dynamic — `language,<metric>,percent`. Markdown also includes a `color` column.
 - JSON/YAML/XML: full report structure including per-language `color` and metadata (`report`, `generated_at`, `repo_path`).
 
-## Exports
+### ⚠️ hotspots — hotspots (risky files)
+```bash
+pretty-git hotspots . --format csv --limit 20
+```
+Highlights riskier files combining change frequency and magnitude.
+
+CSV columns: `path,score,commits,additions,deletions,changes`.
+
+Example:
+```csv
+path,score,commits,additions,deletions,changes
+lib/a.rb,9.5,12,300,220,520
+app/b.rb,7.1,8,140,60,200
+```
+
+JSON example:
+```json
+{
+  "report": "hotspots",
+  "generated_at": "2025-01-31T00:00:00Z",
+  "repo_path": ".",
+  "items": [
+    {"path": "lib/a.rb", "score": 9.5, "commits": 12, "additions": 300, "deletions": 220, "changes": 520}
+  ]
+}
+```
+
+### 🔄 churn — code churn by file
+```bash
+pretty-git churn . --format md --limit 20
+```
+Measures code churn (amount of code changing frequently).
+
+CSV columns: `path,churn,commits,additions,deletions`.
+
+Markdown example:
+```markdown
+| path | churn | commits | additions | deletions |
+|---|---:|---:|---:|---:|
+| lib/a.rb | 520 | 12 | 300 | 220 |
+```
+
+YAML example:
+```yaml
+report: churn
+generated_at: '2025-01-31T00:00:00Z'
+repo_path: .
+items:
+  - path: lib/a.rb
+    churn: 520
+    commits: 12
+    additions: 300
+    deletions: 220
+```
+
+### 🏷️ ownership — code ownership
+```bash
+pretty-git ownership . --format csv --limit 50
+```
+Shows file ownership concentration per primary owner.
+
+CSV columns: `path,owner,owner_share,authors`.
+
+Notes:
+- `owner`: author identifier (name/email) with the largest share of edits.
+- `owner_share`: percent of edits by the owner (0..100).
+- `authors`: total unique authors who edited the file.
+
+XML example:
+```xml
+<ownership>
+  <report>ownership</report>
+  <generated_at>2025-01-31T00:00:00Z</generated_at>
+  <repo_path>.</repo_path>
+  <items>
+    <item path="lib/a.rb" owner="Alice <a@example.com>" owner_share="82.5" authors="2"/>
+  </items>
+  
+</ownership>
+```
+
+## 📤 Exports
 
 Below are exact serialization rules for each format to ensure compatibility with common tools (Excel, BI, CI, etc.).
 
-### Console
+### 🖥️ Console
 ![Console output — basic theme](docs/images/PrettyGitConsole.png)
 _Example terminal output (theme: basic)._ 
 * **Colors**: headers and table heads highlighted; totals: `commits` — yellow, `+additions` — green, `-deletions` — red. `--no-color` fully disables coloring.
@@ -279,7 +363,7 @@ _Example terminal output (theme: basic)._
 * **Purpose**: human-readable terminal output.
 * **Layout**: boxed tables, auto-truncation of long values.
 
-### JSON
+### 🧾 JSON
 * **Keys**: `snake_case`.
 * **Numbers**: integers/floats without localization (dot decimal separator).
 * **Boolean**: `true/false`; **null**: `null`.
@@ -311,7 +395,7 @@ _Example terminal output (theme: basic)._
   Bob,b@example.com,1,2,0,2.0
   ```
 
-### Markdown
+### 📝 Markdown
 * **Tables**: GitHub Flavored Markdown.
 * **Alignment**: numeric columns are right-aligned (`---:`).
 * **Encoding/line endings**: UTF‑8, LF.
@@ -324,7 +408,7 @@ _Example terminal output (theme: basic)._
   | app/models/user.rb | 42 | 2100 | 1400 |
   ```
 
-### YAML
+### 📄 YAML
 * **Structure**: full result hierarchy.
 * **Keys**: serialized as strings.
 * **Numbers/boolean/null**: standard YAML (`123`, `true/false`, `null`).
@@ -344,7 +428,7 @@ _Example terminal output (theme: basic)._
       commits: 1
   ```
 
-### XML
+### 🗂️ XML
 * **Structure**: elements correspond to keys; arrays — repeated `<item>` or specialized tags.
 * **Attributes**: for compact rows (e.g., files report) main fields may be attributes.
 * **Text nodes**: used for scalar values when needed.
@@ -362,7 +446,7 @@ _Example terminal output (theme: basic)._
   </authors>
   ```
 
-## Ignored directories and files
+## 🚫 Ignored directories and files
 
 To keep language statistics meaningful, certain directories and file types are skipped by default.
 
@@ -387,16 +471,16 @@ vendor, node_modules, .git, .bundle, dist, build, out, target, coverage,
 
 These lists mirror the implementation in `lib/pretty_git/analytics/languages.rb` and may evolve.
 
-## Determinism and Sorting
+## 🔁 Determinism and Sorting
 Output is deterministic given the same input. Sorting for files/authors: by changes (desc), then by commits (desc), then by path/name (asc). Limits are applied after sorting; `all` or `0` means no limit.
 
-## Windows Notes
+## 🪟 Windows Notes
 Primary targets — macOS/Linux. Windows is supported best‑effort:
 * Running via Git Bash/WSL is OK
 * Colors can be disabled by `--no-color`
 * Carefully quote arguments when working with paths
 
-## Diagnostics and Errors
+## 🩺 Diagnostics and Errors
 Typical issues and solutions:
 
 * **Unknown report/format** — check the first argument and `--format`.
@@ -405,12 +489,12 @@ Typical issues and solutions:
 * **Empty result** — check your filters (`--since/--until`, `--branch`, `--path`); your selection might be too narrow.
 * **CSV encoding issues** — files are saved as UTF‑8; when opening in Excel, pick UTF‑8.
 
-## FAQ
+## ❓ FAQ
 * **Why Ruby 3.4+?** The project uses dependencies aligned with Ruby 3.4+ and targets the current ecosystem.
 * **New formats?** Yes, add a renderer under `lib/pretty_git/render/` and wire it in the app.
 * **Where does data come from?** From system `git` via CLI calls.
 
-## Development
+## 🛠️ Development
 ```bash
 # Install deps
 bin/setup
@@ -422,5 +506,5 @@ bundle exec rubocop
 
 Style — RuboCop clean. Tests cover aggregators, renderers, CLI, and integration scenarios (determinism, format correctness).
 
-## License
+## 📄 License
 MIT © Contributors

data/README.ru.md

@@ -14,7 +14,7 @@
   <br>
 </p>
 
-Генератор отчётов по локальному Git-репозиторию: сводка, активность, авторы, файлы, тепловая карта. Вывод в консоль и форматы: JSON, CSV, Markdown, YAML, XML.
+Генератор отчётов по локальному Git-репозиторию: сводка, активность, авторы, файлы, теплокарта, языки, hotspots, churn, ownership. Вывод в консоль и форматы: JSON, CSV, Markdown, YAML, XML.
 
 — Лицензия: MIT.
 
@@ -35,10 +35,13 @@
   - [files — по файлам](#files--по-файлам)
   - [heatmap — тепловая карта](#heatmap--тепловая-карта)
   - [languages — языки](#languages--языки)
+  - [hotspots — рискованные файлы](#hotspots--рискованные-файлы)
+  - [churn — churn по файлам](#churn--churn-по-файлам)
+  - [ownership — владение кодом](#ownership--владение-кодом)
 - [Экспорт в форматы](#экспорт-в-форматы)
   - [Console](#console)
   - [JSON](#json)
-  - [CSV (DR-001)](#csv-dr-001)
+  - [CSV](#csv)
   - [Markdown](#markdown)
   - [YAML](#yaml)
   - [XML](#xml)
@@ -49,17 +52,17 @@
 - [Разработка](#разработка)
 - [Лицензия](#лицензия)
 
-## Возможности
-* __Отчёты__: `summary`, `activity`, `authors`, `files`, `heatmap`, `languages`.
+## ✨ Возможности
+* __Отчёты__: `summary`, `activity`, `authors`, `files`, `heatmap`, `languages`, `hotspots`, `churn`, `ownership`.
 * __Фильтры__: ветки, авторы, пути, период времени.
 * __Экспорт__: `console`, `json`, `csv`, `md`, `yaml`, `xml`.
 * __Вывод__: в stdout или файл через `--out`.
 
-## Требования
+## ⚙️ Требования
 * __Ruby__: >= 3.4 (рекомендуется 3.4.x)
 * __Git__: установлен и доступен в `PATH`
 
-## Установка
+## 📦 Установка
 
 ### 🍺 Homebrew (рекомендуется)
 ```bash
@@ -101,7 +104,7 @@ bundle install
 bundle exec pretty-git --help
 ```
 
-## Быстрый старт
+## 🚀 Быстрый старт
 ```bash
 # Сводка репозитория в консоль
 bundle exec bin/pretty-git summary .
@@ -114,21 +117,21 @@ bundle exec bin/pretty-git activity . --time-bucket week --since 2025-01-01 \
   --paths app,lib --format csv --out activity.csv
 ```
 
-## CLI и параметры
+## 🧰 CLI и параметры
 Общий вид:
 
 ```bash
 pretty-git <report> <repo_path> [options]
 ```
 
-Доступные отчёты: `summary`, `activity`, `authors`, `files`, `heatmap`, `languages`.
+Доступные отчёты: `summary`, `activity`, `authors`, `files`, `heatmap`, `languages`, `hotspots`, `churn`, `ownership`.
 
 Ключевые опции:
 * __--format, -f__ `console|json|csv|md|yaml|xml` (по умолчанию `console`)
 * __--out, -o__ Путь для записи в файл
 * __--limit, -l__ Число элементов в топах/выводе; `all` или `0` — без ограничения
 * __--time-bucket__ `day|week|month` (для `activity`)
-* __--since/--until__ Дата/время в ISO8601 или `YYYY-MM-DD` (DR-005)
+* __--since/--until__ Дата/время в ISO8601 или `YYYY-MM-DD`
 * __--branch__ Мульти-опция, можно указывать несколько веток
 * __--author/--exclude-author__ Фильтрация по авторам
 * __--path/--exclude-path__ Фильтрация по путям (через запятую или повтор опции)
@@ -165,15 +168,15 @@ pretty-git authors . --format csv --out authors.csv
 * `1` — ошибка пользователя (неизвестный отчёт/формат, неверные аргументы)
 * `2` — системная ошибка (ошибка Git и пр.)
 
-## Отчёты и примеры
+## 📊 Отчёты и примеры
 
-### summary — сводка
+### 🧭 summary — сводка
 ```bash
 pretty-git summary . --format json
 ```
 Содержит totals (commits, authors, additions, deletions) и топы по авторам/файлам.
 
-### activity — активность (day/week/month)
+### 📆 activity — активность (day/week/month)
 ```bash
 pretty-git activity . --time-bucket week --format csv
 ```
@@ -186,7 +189,7 @@ CSV-колонки: `bucket,timestamp,commits,additions,deletions`.
 ]
 ```
 
-### authors — по авторам
+### 👤 authors — по авторам
 ```bash
 pretty-git authors . --format md --limit 10
 ```
@@ -199,7 +202,7 @@ CSV-колонки: `author,author_email,commits,additions,deletions,avg_commit_
 | Bob   | b@example.com | 1 | 2 | 0 | 2.0 |
 ```
 
-### files — по файлам
+### 📁 files — по файлам
 ```bash
 pretty-git files . --paths app,lib --format csv
 ```
@@ -219,7 +222,7 @@ CSV-колонки: `path,commits,additions,deletions,changes`.
   </files>
 ```
 
-### heatmap — тепловая карта
+### 🔥 heatmap — тепловая карта
 ```bash
 pretty-git heatmap . --format json
 ```
@@ -231,7 +234,7 @@ dow,hour,commits
 1,11,7
 ```
 
-### languages — языки
+### 🈺 languages — языки
 ```bash
 pretty-git languages . --format md --limit 10
 ```
@@ -262,7 +265,88 @@ Markdown      1200     1.7
 - CSV/MD: колонки динамические — `language,<metric>,percent`. В Markdown дополнительно присутствует колонка `color`.
 - JSON/YAML/XML: полная структура отчёта, включая `color` на язык и метаданные (`report`, `generated_at`, `repo_path`).
 
-## Игнорируемые директории и файлы
+### ⚠️ hotspots — рискованные файлы
+```bash
+pretty-git hotspots . --format csv --limit 20
+```
+Подсвечивает потенциально более рискованные файлы по сочетанию частоты и масштаба изменений.
+
+CSV‑колонки: `path,score,commits,additions,deletions,changes`.
+
+Пример:
+```csv
+path,score,commits,additions,deletions,changes
+lib/a.rb,9.5,12,300,220,520
+app/b.rb,7.1,8,140,60,200
+```
+
+Пример JSON:
+```json
+{
+  "report": "hotspots",
+  "generated_at": "2025-01-31T00:00:00Z",
+  "repo_path": ".",
+  "items": [
+    {"path": "lib/a.rb", "score": 9.5, "commits": 12, "additions": 300, "deletions": 220, "changes": 520}
+  ]
+}
+```
+
+### 🔄 churn — churn по файлам
+```bash
+pretty-git churn . --format md --limit 20
+```
+Оценивает churn (объём часто меняющегося кода) по файлам.
+
+CSV‑колонки: `path,churn,commits,additions,deletions`.
+
+Пример Markdown:
+```markdown
+| path | churn | commits | additions | deletions |
+|---|---:|---:|---:|---:|
+| lib/a.rb | 520 | 12 | 300 | 220 |
+```
+
+Пример YAML:
+```yaml
+report: churn
+generated_at: '2025-01-31T00:00:00Z'
+repo_path: .
+items:
+  - path: lib/a.rb
+    churn: 520
+    commits: 12
+    additions: 300
+    deletions: 220
+```
+
+### 🏷️ ownership — владение кодом
+```bash
+pretty-git ownership . --format csv --limit 50
+```
+Показывает концентрацию владения файлами по основному владельцу.
+
+CSV‑колонки: `path,owner,owner_share,authors`.
+
+Примечания:
+- `owner`: идентификатор автора (имя/email) с наибольшей долей правок.
+- `owner_share`: доля правок владельца в процентах (0..100).
+- `authors`: всего уникальных авторов, редактировавших файл.
+
+Пример XML:
+```xml
+<ownership>
+  <report>ownership</report>
+  <generated_at>2025-01-31T00:00:00Z</generated_at>
+  <repo_path>.</repo_path>
+  <items>
+    <item path="lib/a.rb" owner="Alice &lt;a@example.com&gt;" owner_share="82.5" authors="2"/>
+  </items>
+  
+</ownership>
+```
+
+## 🚫 Игнорируемые директории и файлы
 
 Чтобы статистика по языкам оставалась релевантной, некоторые директории и типы файлов пропускаются по умолчанию.
 
@@ -287,11 +371,11 @@ vendor, node_modules, .git, .bundle, dist, build, out, target, coverage,
 
 Списки соответствуют реализации в `lib/pretty_git/analytics/languages.rb` и могут изменяться.
 
-## Экспорт в форматы
+## 📤 Экспорт в форматы
 
 Ниже — точные правила сериализации для каждого формата, чтобы обеспечивалась совместимость с популярными инструментами (Excel, BI, CI и т.п.).
 
-### Console
+### 🖥️ Console
 ![Console output — basic theme](docs/images/PrettyGitConsole.png)
 _Пример вывода в терминале (тема: basic)._ 
 * __Цвета__: заголовки и шапки таблиц подсвечены; суммы: `commits` — жёлтым, `+additions` — зелёным, `-deletions` — красным. `--no-color` полностью отключает раскраску.
@@ -305,7 +389,7 @@ _Пример вывода в терминале (тема: basic)._
 * __Пустые наборы__: печатается `No data`.
 * __Кодировка/переводы строк__: UTF‑8, LF (`\n`).
 
-### JSON
+### 🧾 JSON
 * __Ключи__: `snake_case`.
 * __Числа__: целые/вещественные без локализации (точка как разделитель).
 * __Булевы__: `true/false`; __null__: `null`.
@@ -337,7 +421,7 @@ _Пример вывода в терминале (тема: basic)._
   Bob,b@example.com,1,2,0,2.0
   ```
 
-### Markdown
+### 📝 Markdown
 * __Таблицы__: стандартный синтаксис GitHub Flavored Markdown.
 * __Выравнивание__: числовые колонки выравниваются по правому краю (`---:`).
 * __Кодировка/переводы строк__: UTF‑8, LF.
@@ -350,7 +434,7 @@ _Пример вывода в терминале (тема: basic)._
   | app/models/user.rb | 42 | 2100 | 1400 |
   ```
 
-### YAML
+### 📄 YAML
 * __Структура__: полная иерархия результата.
 * __Ключи__: сериализуются строками.
 * __Числа/булевы/null__: стандарт YAML (`123`, `true/false`, `null`).
@@ -370,7 +454,7 @@ _Пример вывода в терминале (тема: basic)._
       commits: 1
   ```
 
-### XML
+### 🗂️ XML
 * __Структура__: элементы соответствуют ключам; массивы — повторяющиеся `<item>` или специализированные теги.
 * __Атрибуты__: для компактных записей (например, строк файлового отчёта) основные поля могут быть атрибутами элемента.
 * __Текстовые узлы__: применяются для скалярных значений при необходимости.
@@ -388,16 +472,16 @@ _Пример вывода в терминале (тема: basic)._
   </authors>
   ```
 
-## Детерминизм и сортировка
+## 🔁 Детерминизм и сортировка
 Вывод детерминирован при одинаковых входных данных. Сортировка для файлов/авторов: по количеству изменений (desc), затем по числу коммитов (desc), затем по пути/имени (asc). Лимиты применяются поверх отсортированного списка; значение `all` или `0` означает отсутствие ограничения.
 
-## Советы по Windows
+## 🪟 Советы по Windows
 Целевая платформа — macOS/Linux. Windows поддерживается в режиме best‑effort:
 * Запуск через Git Bash/WSL допустим
 * Цвета можно отключить `--no-color`
 * Аккуратное квотирование аргументов при работе с путями
 
-## Диагностика и ошибки
+## 🩺 Диагностика и ошибки
 Типичные ошибки и решения:
 
 * __Неизвестный отчёт/формат__ — проверьте значение первого аргумента и `--format`.
@@ -406,12 +490,12 @@ _Пример вывода в терминале (тема: basic)._
 * __Пустой результат__ — проверьте фильтры (`--since/--until`, `--branch`, `--path`), возможно, выборка слишком узкая.
 * __Проблемы с кодировкой CSV__ — файлы сохраняются в UTF‑8, при открытии в Excel выбирайте UTF‑8.
 
-## FAQ
+## ❓ FAQ
 * __Почему Ruby 3.4+?__ Проект использует зависимости, согласованные с версией 3.4+, и ориентируется на актуальную экосистему.
 * __Можно ли добавить новые форматы?__ Да, добавьте рендерер в `lib/pretty_git/render/` и зарегистрируйте его в приложении.
 * __Откуда берутся данные?__ Из системного `git` через вызовы CLI.
 
-## Разработка
+## 🛠️ Разработка
 ```bash
 # Установка зависимостей
 bin/setup
@@ -423,5 +507,5 @@ bundle exec rubocop
 
 Стиль — RuboCop без ошибок. Тесты покрывают агрегаторы, рендереры, CLI и интеграционные сценарии (детерминизм, корректность форматов).
 
-## Лицензия
+## 📄 Лицензия
 MIT © Contributors

data/lib/pretty_git/analytics/churn.rb

@@ -0,0 +1,75 @@
+# frozen_string_literal: true
+
+require 'time'
+
+module PrettyGit
+  module Analytics
+    # Churn: per-file volatility over the selected period.
+    # churn = additions + deletions (total changed lines)
+    class Churn
+      class << self
+        def call(enum, filters)
+          per_file = aggregate(enum)
+          items = build_items(per_file)
+          items = sort_and_limit(items, filters.limit)
+          build_result(filters, items)
+        end
+
+        private
+
+        def aggregate(enum)
+          acc = Hash.new { |h, k| h[k] = { commits: 0, additions: 0, deletions: 0 } }
+          enum.each do |commit|
+            seen = {}
+            commit.files&.each { |f| process_file_entry(acc, seen, f) }
+          end
+          acc
+        end
+
+        def process_file_entry(acc, seen, file_stat)
+          path = file_stat.path
+          unless seen[path]
+            acc[path][:commits] += 1
+            seen[path] = true
+          end
+          acc[path][:additions] += file_stat.additions.to_i
+          acc[path][:deletions] += file_stat.deletions.to_i
+        end
+
+        def build_items(per_file)
+          per_file.map do |path, v|
+            churn = v[:additions] + v[:deletions]
+            {
+              path: path,
+              churn: churn,
+              commits: v[:commits]
+            }
+          end
+        end
+
+        def sort_and_limit(items, raw_limit)
+          limit = normalize_limit(raw_limit)
+          sorted = items.sort_by { |h| [-h[:churn], -h[:commits], h[:path].to_s] }
+          limit ? sorted.first(limit) : sorted
+        end
+
+        def build_result(filters, items)
+          {
+            report: 'churn',
+            repo_path: File.expand_path(filters.repo_path),
+            period: { since: filters.since_iso8601, until: filters.until_iso8601 },
+            items: items,
+            generated_at: Time.now.utc.iso8601
+          }
+        end
+
+        def normalize_limit(raw)
+          return nil if raw.nil? || raw == 'all'
+
+          n = raw.to_i
+          n <= 0 ? nil : n
+        end
+      end
+    end
+  end
+end

data/lib/pretty_git/analytics/hotspots.rb

@@ -0,0 +1,78 @@
+# frozen_string_literal: true
+
+require 'time'
+
+module PrettyGit
+  module Analytics
+    # Hotspots: files with the highest change activity over the selected period.
+    # score = commits * (additions + deletions)
+    class Hotspots
+      class << self
+        def call(enum, filters)
+          per_file = aggregate(enum)
+          items = build_items(per_file)
+          items = sort_and_limit(items, filters.limit)
+          build_result(filters, items)
+        end
+
+        private
+
+        def aggregate(enum)
+          acc = Hash.new { |h, k| h[k] = { commits: 0, additions: 0, deletions: 0 } }
+          enum.each do |commit|
+            seen = {}
+            commit.files&.each { |f| process_file_entry(acc, seen, f) }
+          end
+          acc
+        end
+
+        def process_file_entry(acc, seen, file_stat)
+          path = file_stat.path
+          unless seen[path]
+            acc[path][:commits] += 1
+            seen[path] = true
+          end
+          acc[path][:additions] += file_stat.additions.to_i
+          acc[path][:deletions] += file_stat.deletions.to_i
+        end
+
+        def build_items(per_file)
+          per_file.map do |path, v|
+            changes = v[:additions] + v[:deletions]
+            score = v[:commits] * changes
+            {
+              path: path,
+              score: score,
+              commits: v[:commits],
+              additions: v[:additions],
+              deletions: v[:deletions]
+            }
+          end
+        end
+
+        def sort_and_limit(items, raw_limit)
+          limit = normalize_limit(raw_limit)
+          sorted = items.sort_by { |h| [-h[:score], -h[:commits], -h[:additions] - h[:deletions], h[:path].to_s] }
+          limit ? sorted.first(limit) : sorted
+        end
+
+        def build_result(filters, items)
+          {
+            report: 'hotspots',
+            repo_path: File.expand_path(filters.repo_path),
+            period: { since: filters.since_iso8601, until: filters.until_iso8601 },
+            items: items,
+            generated_at: Time.now.utc.iso8601
+          }
+        end
+
+        def normalize_limit(raw)
+          return nil if raw.nil? || raw == 'all'
+
+          n = raw.to_i
+          n <= 0 ? nil : n
+        end
+      end
+    end
+  end
+end

data/lib/pretty_git/analytics/ownership.rb

@@ -0,0 +1,90 @@
+# frozen_string_literal: true
+
+require 'time'
+
+module PrettyGit
+  module Analytics
+    # Ownership: per-file code ownership based on change activity (churn).
+    # For each file, the owner is the author with the largest share of churn (adds+dels).
+    class Ownership
+      class << self
+        def call(enum, filters)
+          per_file = aggregate(enum)
+          items = build_items(per_file)
+          items = sort_and_limit(items, filters.limit)
+          build_result(filters, items)
+        end
+
+        private
+
+        # Builds a map: path => { total_churn: N, authors: {"name <email>" => churn} }
+        def aggregate(enum)
+          acc = Hash.new { |h, k| h[k] = { total: 0, authors: Hash.new(0) } }
+          enum.each do |commit|
+            author_key = author_identity(commit)
+            commit.files&.each { |f| process_file_entry(acc, author_key, f) }
+          end
+          acc
+        end
+
+        def process_file_entry(acc, author_key, file_stat)
+          churn = file_stat.additions.to_i + file_stat.deletions.to_i
+          return if churn <= 0
+
+          path = file_stat.path
+          acc[path][:total] += churn
+          acc[path][:authors][author_key] += churn
+        end
+
+        def author_identity(commit)
+          name = commit.author_name.to_s.strip
+          email = commit.author_email.to_s.strip
+          email.empty? ? name : "#{name} <#{email}>"
+        end
+
+        def build_items(per_file)
+          per_file.map do |path, v|
+            owner, share, authors_count = compute_owner(v[:authors], v[:total])
+            {
+              path: path,
+              owner: owner,
+              owner_share: share.round(2),
+              authors: authors_count
+            }
+          end
+        end
+
+        def compute_owner(authors_map, total)
+          return [nil, 0.0, 0] if total.to_i <= 0 || authors_map.nil? || authors_map.empty?
+
+          author, owner_churn = authors_map.max_by { |a, c| [c, a] }
+          share = (owner_churn.to_f * 100.0) / total.to_f
+          [author, share, authors_map.size]
+        end
+
+        def sort_and_limit(items, raw_limit)
+          limit = normalize_limit(raw_limit)
+          sorted = items.sort_by { |h| [-h[:owner_share].to_f, h[:authors].to_i, h[:path].to_s] }
+          limit ? sorted.first(limit) : sorted
+        end
+
+        def build_result(filters, items)
+          {
+            report: 'ownership',
+            repo_path: File.expand_path(filters.repo_path),
+            period: { since: filters.since_iso8601, until: filters.until_iso8601 },
+            items: items,
+            generated_at: Time.now.utc.iso8601
+          }
+        end
+
+        def normalize_limit(raw)
+          return nil if raw.nil? || raw == 'all'
+
+          n = raw.to_i
+          n <= 0 ? nil : n
+        end
+      end
+    end
+  end
+end

data/lib/pretty_git/app.rb

@@ -7,6 +7,9 @@ require_relative 'analytics/files'
 require_relative 'analytics/authors'
 require_relative 'analytics/heatmap'
 require_relative 'analytics/languages'
+require_relative 'analytics/hotspots'
+require_relative 'analytics/churn'
+require_relative 'analytics/ownership'
 require_relative 'render/json_renderer'
 require_relative 'render/console_renderer'
 require_relative 'render/csv_renderer'
@@ -62,22 +65,21 @@ module PrettyGit
     end
 
     def analytics_for(report, enum, filters)
-      case report
-      when 'summary'
-        Analytics::Summary.call(enum, filters)
-      when 'activity'
-        Analytics::Activity.call(enum, filters)
-      when 'authors'
-        Analytics::Authors.call(enum, filters)
-      when 'files'
-        Analytics::Files.call(enum, filters)
-      when 'heatmap'
-        Analytics::Heatmap.call(enum, filters)
-      when 'languages'
-        Analytics::Languages.call(enum, filters)
-      else
-        raise ArgumentError, "Unknown report: #{report}"
-      end
+      dispatch = {
+        'summary' => Analytics::Summary,
+        'activity' => Analytics::Activity,
+        'authors' => Analytics::Authors,
+        'files' => Analytics::Files,
+        'heatmap' => Analytics::Heatmap,
+        'languages' => Analytics::Languages,
+        'hotspots' => Analytics::Hotspots,
+        'churn' => Analytics::Churn,
+        'ownership' => Analytics::Ownership
+      }
+      klass = dispatch[report]
+      raise ArgumentError, "Unknown report: #{report}" unless klass
+
+      klass.call(enum, filters)
     end
   end
 end

data/lib/pretty_git/cli.rb

@@ -9,7 +9,7 @@ require_relative 'cli_helpers'
 module PrettyGit
   # Command-line interface entry point.
   class CLI
-    SUPPORTED_REPORTS = %w[summary activity authors files heatmap languages].freeze
+    SUPPORTED_REPORTS = %w[summary activity authors files heatmap languages hotspots churn ownership].freeze
     SUPPORTED_FORMATS = %w[console json csv md yaml xml].freeze
 
     # rubocop:disable Metrics/AbcSize, Metrics/MethodLength

data/lib/pretty_git/cli_helpers.rb

@@ -9,7 +9,7 @@ module PrettyGit
   # and RuboCop-compliant. Provides parser configuration and execution utilities.
   # rubocop:disable Metrics/ModuleLength
   module CLIHelpers
-    REPORTS = %w[summary activity authors files heatmap languages].freeze
+    REPORTS = %w[summary activity authors files heatmap languages hotspots churn ownership].freeze
     FORMATS = %w[console json csv md yaml xml].freeze
     METRICS = %w[bytes files loc].freeze
 

data/lib/pretty_git/render/console_renderer.rb

@@ -153,6 +153,7 @@ module PrettyGit
     end
 
     # Renders human-friendly console output with optional colors.
+    # rubocop:disable Metrics/ClassLength
     class ConsoleRenderer
       def initialize(io: $stdout, color: true, theme: 'basic')
         @io = io
@@ -162,22 +163,21 @@ module PrettyGit
       end
 
       def call(report, result, _filters)
-        case report
-        when 'summary'
-          render_summary(result)
-        when 'activity'
-          render_activity(result)
-        when 'authors'
-          render_authors(result)
-        when 'files'
-          render_files(result)
-        when 'heatmap'
-          render_heatmap(result)
-        when 'languages'
-          LanguagesSection.render(@io, @table, result, color: @color)
-        else
-          @io.puts result.inspect
-        end
+        handlers = {
+          'summary' => method(:render_summary),
+          'activity' => method(:render_activity),
+          'authors' => method(:render_authors),
+          'files' => method(:render_files),
+          'heatmap' => method(:render_heatmap),
+          'languages' => ->(data) { LanguagesSection.render(@io, @table, data, color: @color) },
+          'hotspots' => method(:render_hotspots),
+          'churn' => method(:render_churn),
+          'ownership' => method(:render_ownership)
+        }
+        handler = handlers[report]
+        return @io.puts(result.inspect) unless handler
+
+        handler.call(result)
       end
 
       private
@@ -266,6 +266,42 @@ module PrettyGit
 
       # Languages rendering moved to PrettyGit::Render::LanguagesSection
 
+      def render_hotspots(data)
+        title "Hotspots for #{data[:repo_path]}"
+        line "Period: #{data.dig(:period, :since)} .. #{data.dig(:period, :until)}"
+
+        @io.puts
+        title 'Hotspots'
+        @table.print(%w[path score commits additions deletions], data[:items])
+
+        @io.puts
+        line "Generated at: #{data[:generated_at]}"
+      end
+
+      def render_churn(data)
+        title "Churn for #{data[:repo_path]}"
+        line "Period: #{data.dig(:period, :since)} .. #{data.dig(:period, :until)}"
+
+        @io.puts
+        title 'Churn'
+        @table.print(%w[path churn commits], data[:items])
+
+        @io.puts
+        line "Generated at: #{data[:generated_at]}"
+      end
+
+      def render_ownership(data)
+        title "Ownership for #{data[:repo_path]}"
+        line "Period: #{data.dig(:period, :since)} .. #{data.dig(:period, :until)}"
+
+        @io.puts
+        title 'Ownership'
+        @table.print(%w[path owner owner_share authors], data[:items])
+
+        @io.puts
+        line "Generated at: #{data[:generated_at]}"
+      end
+
       def title(text)
         @io.puts Colors.title(text, @color, @theme)
       end
@@ -276,5 +312,6 @@ module PrettyGit
 
       # table is handled by @table
     end
+    # rubocop:enable Metrics/ClassLength
   end
 end

data/lib/pretty_git/render/csv_renderer.rb

@@ -6,31 +6,34 @@ module PrettyGit
   module Render
     # Renders CSV according to specs/output_formats.md and DR-001
     class CsvRenderer
+      HEADERS = {
+        'activity' => %w[bucket timestamp commits additions deletions],
+        'authors' => %w[author author_email commits additions deletions avg_commit_size],
+        'files' => %w[path commits additions deletions changes],
+        'heatmap' => %w[dow hour commits],
+        'hotspots' => %w[path score commits additions deletions changes],
+        'churn' => %w[path churn commits additions deletions],
+        'ownership' => %w[path owner owner_share authors]
+      }.freeze
       def initialize(io: $stdout)
         @io = io
       end
 
       def call(report, result, _filters)
-        case report
-        when 'activity'
-          write_csv(%w[bucket timestamp commits additions deletions], result[:items])
-        when 'authors'
-          write_csv(%w[author author_email commits additions deletions avg_commit_size], result[:items])
-        when 'files'
-          write_csv(%w[path commits additions deletions changes], result[:items])
-        when 'heatmap'
-          write_csv(%w[dow hour commits], result[:items])
-        when 'languages'
-          metric = (result[:metric] || 'bytes').to_s
-          headers = ['language', metric, 'percent', 'color']
-          write_csv(headers, result[:items])
-        else
-          raise ArgumentError, "CSV output for report '#{report}' is not supported yet"
-        end
+        headers = headers_for(report, result)
+        write_csv(headers, result[:items])
       end
 
       private
 
+      def headers_for(report, result)
+        return ['language', (result[:metric] || 'bytes').to_s, 'percent', 'color'] if report == 'languages'
+
+        HEADERS.fetch(report) do
+          raise ArgumentError, "CSV output for report '#{report}' is not supported yet"
+        end
+      end
+
       def write_csv(headers, rows)
         csv = CSV.generate(force_quotes: false) do |out|
           out << headers

data/lib/pretty_git/render/markdown_renderer.rb

@@ -4,35 +4,50 @@ module PrettyGit
   module Render
     # Renders Markdown tables and sections per specs/output_formats.md
     class MarkdownRenderer
+      TITLES = {
+        'activity' => 'Activity',
+        'authors' => 'Authors',
+        'files' => 'Top Files',
+        'heatmap' => 'Heatmap',
+        'languages' => 'Languages',
+        'hotspots' => 'Hotspots',
+        'churn' => 'Churn',
+        'ownership' => 'Ownership'
+      }.freeze
+
+      HEADERS = {
+        'activity' => %w[bucket timestamp commits additions deletions],
+        'authors' => %w[author author_email commits additions deletions avg_commit_size],
+        'files' => %w[path commits additions deletions changes],
+        'heatmap' => %w[dow hour commits],
+        'hotspots' => %w[path score commits additions deletions changes],
+        'churn' => %w[path churn commits additions deletions],
+        'ownership' => %w[path owner owner_share authors]
+      }.freeze
       def initialize(io: $stdout)
         @io = io
       end
 
-      # rubocop:disable Metrics/CyclomaticComplexity
       def call(report, result, _filters)
-        case report
-        when 'summary'
-          render_summary(result)
-        when 'activity'
-          render_table('Activity', %w[bucket timestamp commits additions deletions], result[:items])
-        when 'authors'
-          render_table('Authors', %w[author author_email commits additions deletions avg_commit_size], result[:items])
-        when 'files'
-          render_table('Top Files', %w[path commits additions deletions changes], result[:items])
-        when 'heatmap'
-          render_table('Heatmap', %w[dow hour commits], result[:items])
-        when 'languages'
-          metric = (result[:metric] || 'bytes').to_s
-          headers = ['language', metric, 'percent', 'color']
-          render_table('Languages', headers, result[:items])
-        else
-          @io.puts result.inspect
-        end
+        return render_summary(result) if report == 'summary'
+
+        headers = headers_for(report, result)
+        title = title_for(report)
+        render_table(title, headers, result[:items])
       end
-      # rubocop:enable Metrics/CyclomaticComplexity
 
       private
 
+      def headers_for(report, result)
+        return ['language', (result[:metric] || 'bytes').to_s, 'percent', 'color'] if report == 'languages'
+
+        HEADERS.fetch(report, [])
+      end
+
+      def title_for(report)
+        TITLES.fetch(report, report.to_s.capitalize)
+      end
+
       def render_summary(data)
         header_summary(data)
         print_totals(data[:totals])

data/lib/pretty_git/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module PrettyGit
-  VERSION = '0.1.2'
+  VERSION = '0.1.3'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: pretty-git
 version: !ruby/object:Gem::Version
-  version: 0.1.2
+  version: 0.1.3
 platform: ruby
 authors:
 - Pretty Git Authors
@@ -66,9 +66,12 @@ files:
 - lib/pretty_git.rb
 - lib/pretty_git/analytics/activity.rb
 - lib/pretty_git/analytics/authors.rb
+- lib/pretty_git/analytics/churn.rb
 - lib/pretty_git/analytics/files.rb
 - lib/pretty_git/analytics/heatmap.rb
+- lib/pretty_git/analytics/hotspots.rb
 - lib/pretty_git/analytics/languages.rb
+- lib/pretty_git/analytics/ownership.rb
 - lib/pretty_git/analytics/summary.rb
 - lib/pretty_git/app.rb
 - lib/pretty_git/cli.rb