@donativo/roux 0.1.0

package/README.md

@@ -0,0 +1,335 @@
+# Roux
+
+Mine and analyze git history to understand how your codebase evolves — find hotspots, hidden coupling, ownership patterns, and team dynamics from commit data alone.
+
+挖掘和分析 git 历史，理解代码库的演变 — 仅凭 commit 数据就能发现热点、隐式耦合、代码所有权和团队协作模式。
+
+Roux provides 18 analyses covering code hotspots, coupling, churn, ownership, and team collaboration. Written in TypeScript, it starts in milliseconds and installs with `npm install`. Based on the analysis methods from [code-maat](https://github.com/adamtornhill/code-maat), with fully compatible output.
+
+Roux 提供 18 种分析，覆盖代码热点、耦合、变动、所有权和团队协作。TypeScript 编写，毫秒级启动，`npm install` 即可使用。基于 [code-maat](https://github.com/adamtornhill/code-maat) 的分析方法，输出兼容。
+
+## Quick Start / 快速开始
+
+```bash
+# Analyze the current git repository / 分析当前 git 仓库
+npx roux summary
+npx roux coupling
+npx roux main-dev
+
+# Analyze last year only / 只分析最近一年
+npx roux coupling --after 2025-01-01
+
+# Between two releases / 两个版本之间
+npx roux coupling --rev v1.0..v2.0
+
+# Date range / 日期范围
+npx roux revisions --after 2024-01-01 --before 2025-01-01
+
+# Analyze a specific log file / 分析指定的日志文件
+npx roux revisions -l git.log
+
+# Generate a log file first, then analyze / 先生成日志文件，再分析
+git log --all --numstat --date=short --pretty=format:'--%h--%ad--%aN--%s' --no-renames > git.log
+npx roux hotspot -l git.log
+```
+
+## Installation / 安装
+
+```bash
+npm install roux
+```
+
+Or run directly / 或直接运行:
+
+```bash
+npx roux <analysis> [options]
+```
+
+## Analyses / 分析类型
+
+Roux supports 18 analyses:
+
+Roux 支持 18 种分析：
+
+| Analysis / 分析        | Description / 说明                                            | Key Output / 关键输出          |
+|------------------------|---------------------------------------------------------------|--------------------------------|
+| `summary`              | Repository statistics / 仓库统计                              | commits, entities, authors     |
+| `revisions`            | Most modified files / 修改最多的文件                          | entity, n-revs                 |
+| `authors`              | Author diversity per file / 每个文件的作者多样性              | entity, n-authors, n-revs      |
+| `coupling`             | Files that change together / 经常一起修改的文件               | entity, coupled, degree        |
+| `soc`                  | Sum of coupling per file / 每个文件的耦合度总和               | entity, soc                    |
+| `abs-churn`            | Daily code churn / 每日代码变动量                             | date, added, deleted, commits  |
+| `entity-churn`         | Code churn per file / 每个文件的代码变动量                    | entity, added, deleted         |
+| `author-churn`         | Code churn per author / 每个作者的代码变动量                  | author, added, deleted         |
+| `age`                  | Months since last change / 距最后修改的月数                   | entity, age-months             |
+| `entity-ownership`     | Who owns what (by LOC) / 代码所有权（按代码行数）             | entity, author, added, deleted |
+| `main-dev`             | Primary developer (by lines added) / 主要开发者（按新增行数） | entity, main-dev, ownership    |
+| `main-dev-by-revs`     | Primary developer (by commits) / 主要开发者（按提交次数）     | entity, main-dev, ownership    |
+| `refactoring-main-dev` | Top refactorer (by lines deleted) / 主要重构者（按删除行数）  | entity, main-dev, ownership    |
+| `entity-effort`        | Effort distribution / 工作量分布                              | entity, author, author-revs    |
+| `fragmentation`        | Knowledge fragmentation / 知识碎片化                          | entity, fractal-value          |
+| `communication`        | Developer collaboration / 开发者协作关系                      | author, peer, strength         |
+| `messages`             | Commit message pattern matching / 提交信息模式匹配            | entity, matches                |
+| `identity`             | Raw modification data / 原始修改数据                          | all fields                     |
+
+### When to Use Each Analysis / 各分析使用场景
+
+#### Code Hotspots & Complexity / 代码热点与复杂度
+
+- **`summary`** — Quick overview of project scale / 快速了解项目规模
+- **`revisions`** — Find most frequently modified files (hotspots) / 找出修改最频繁的文件（热点）
+- **`age`** — Find code that hasn't changed in a long time (stable infrastructure or forgotten debt) / 找出长期未修改的代码（可能是稳定的基础设施，也可能是被遗忘的技术债）
+
+#### Code Coupling / 代码耦合
+
+- **`coupling`** — Find files that often change together (implicit dependencies) / 找出经常一起修改的文件对（隐式依赖）
+- **`soc`** — Sum of coupling per file. High soc = "God file" that's coupled to too many others, risky to change / 每个文件的耦合度总和。高 soc = God 文件，与过多文件耦合，改动风险大
+- **`messages`** — Match commit message patterns (e.g. "Fix", "Bug") to find bug-prone files / 按 commit message 匹配模式（如 "Fix", "Bug"），找出 bug 重灾区
+
+#### Code Churn / 代码变动
+
+- **`abs-churn`** — Daily code churn, identify development rhythm / 每日代码变动量，识别开发节奏
+- **`entity-churn`** — Churn per file, combine with revisions to identify high-risk files / 每个文件的变动量，结合 revisions 识别高风险文件
+- **`author-churn`** — Churn per author / 每个作者的变动量
+
+#### Code Ownership / 代码所有权
+
+- **`entity-ownership`** — Who owns which code (by lines added) / 谁拥有哪些代码（按新增行数）
+- **`main-dev`** — Primary developer per file (by lines added). Ownership < 0.5 = no clear owner / 每个文件的主要开发者（按新增行数）。ownership < 0.5 表示没有明确负责人
+- **`main-dev-by-revs`** — Primary developer per file (by commit count) / 按 commit 次数计算的主要开发者
+- **`refactoring-main-dev`** — Who is doing refactoring (by lines deleted) / 谁在做重构（按删除行数）
+
+#### Team & Collaboration / 团队与协作
+
+- **`entity-effort`** — Effort distribution across files / 工作量分布
+- **`fragmentation`** — Knowledge fragmentation level (0–1). High = many people touching code with no clear owner / 知识碎片化程度（0–1）。值高说明多人零散修改，无人真正负责
+- **`communication`** — Developer collaboration network / 开发者协作网络
+- **`identity`** — Raw data export for custom analysis / 原始数据导出，供自定义分析
+
+## CLI Options / 命令行选项
+
+```
+roux <analysis> [options]
+```
+
+### Input / 输入
+
+| Flag | Description / 说明 | Default / 默认值 |
+|------|-------------|---------|
+| `-l, --log <file>` | Git log file path / 日志文件路径 | reads current repo / 读取当前仓库 |
+| `--repo <path>` | Git repository path / Git 仓库路径 | current directory / 当前目录 |
+| `--after <date>` | Only commits after date / 只包含此日期之后的提交 (YYYY-MM-DD) | — |
+| `--before <date>` | Only commits before date / 只包含此日期之前的提交 (YYYY-MM-DD) | — |
+| `--rev <range>` | Git revision range / Git 版本范围 (e.g. `v1.0..v2.0`) | `--all` |
+| `-c, --format <fmt>` | Log format / 日志格式: `git2` or `git` | `git2` |
+
+Roux also reads from stdin / 也支持从标准输入读取:
+
+```bash
+cat git.log | npx roux summary
+```
+
+### Thresholds / 阈值
+
+| Flag                           | Description / 说明                                                | Default / 默认值 |
+|--------------------------------|-------------------------------------------------------------------|------------------|
+| `-n, --min-revs <n>`           | Minimum revisions to include entity / 文件最少修改次数            | 5                |
+| `-m, --min-shared-revs <n>`    | Minimum shared revisions for coupling / 耦合分析最少共同修改次数  | 5                |
+| `-i, --min-coupling <n>`       | Minimum coupling percentage / 最低耦合百分比                      | 30               |
+| `-x, --max-coupling <n>`       | Maximum coupling percentage / 最高耦合百分比                      | 100              |
+| `-s, --max-changeset-size <n>` | Ignore commits touching more files / 忽略涉及文件数超过此值的提交 | 30               |
+
+### Transforms / 数据变换
+
+| Flag                           | Description / 说明                                                     |
+|--------------------------------|------------------------------------------------------------------------|
+| `-g, --group <file>`           | Map files to architectural groups (txt/json/md) / 将文件映射到架构分组 |
+| `-p, --team-map <file>`        | Map authors to teams (csv/json/md) / 将作者映射到团队                  |
+| `-t, --temporal-period <days>` | Sliding window aggregation / 滑动窗口聚合                              |
+
+### Output / 输出
+
+| Flag                             | Description / 说明                                       | Default / 默认值 |
+|----------------------------------|----------------------------------------------------------|------------------|
+| `-r, --rows <n>`                 | Limit output rows / 限制输出行数                         | unlimited / 不限 |
+| `-o, --output-format <fmt>`      | `csv` or `json`                                          | `csv`            |
+| `-d, --age-time-now <date>`      | Reference date for age (YYYY-MM-DD) / age 分析的参考日期 | today / 今天     |
+| `-e, --expression-to-match <re>` | Regex for messages analysis / messages 分析的正则表达式  | —                |
+
+## Log Formats / 日志格式
+
+### git2 (default / 默认)
+
+The recommended format. Generate with:
+
+推荐格式。生成方式：
+
+```bash
+git log --all --numstat --date=short \
+  --pretty=format:'--%h--%ad--%aN--%s' --no-renames > git.log
+```
+
+Example / 示例:
+
+```
+--abc1234--2026-01-15--Alice--Fix parser bug
+12	4	src/parser.ts
+0	8	src/old-code.ts
+
+--def5678--2026-01-14--Bob--Add feature
+45	0	src/feature.ts
+```
+
+### git (legacy / 旧版)
+
+Compatible with code-maat's original git format.
+
+兼容 code-maat 原始 git 格式：
+
+```
+[abc1234] Alice 2026-01-15 Fix parser bug
+12	4	src/parser.ts
+0	8	src/old-code.ts
+```
+
+Use `-c git` to select this format. / 使用 `-c git` 选择此格式。
+
+## Transforms / 数据变换
+
+### Architectural Grouping / 架构分组 (`-g`)
+
+Group files into logical layers for higher-level analysis.
+
+将文件分组到逻辑层，进行更高层次的分析。
+
+Supports TXT, JSON, and Markdown formats (auto-detected by file extension).
+
+支持 TXT、JSON、Markdown 格式（按文件扩展名自动检测）。
+
+**TXT** (`groups.txt`):
+```
+src/api     => API Layer
+src/ui      => UI Layer
+src/models  => Data Layer
+```
+
+**JSON** (`groups.json`):
+```json
+{
+  "src/api": "API Layer",
+  "src/ui": "UI Layer",
+  "^src\\/.*Test.*$": "Tests"
+}
+```
+
+**Markdown** (`groups.md`):
+```markdown
+| path | group |
+|------|-------|
+| src/api | API Layer |
+| src/ui | UI Layer |
+| ^src\/.*Test.*$ | Tests |
+```
+
+Regex patterns are also supported (must start with `^` and end with `$`):
+
+也支持正则表达式（必须以 `^` 开头，以 `$` 结尾）：
+
+```
+^src\/.*Test.*$ => Tests
+^src\/((?!.*Test.*).).*$ => Production Code
+```
+
+```bash
+npx roux coupling -l git.log -g groups.json
+```
+
+### Team Mapping / 团队映射 (`-p`)
+
+Map individual authors to teams for team-level analysis.
+
+将个人作者映射到团队，进行团队级别的分析。
+
+Supports CSV, JSON, and Markdown formats (auto-detected by file extension).
+
+支持 CSV、JSON、Markdown 格式（按文件扩展名自动检测）。
+
+**CSV** (`teams.csv`):
+```csv
+author,team
+Alice,Backend
+Bob,Backend
+Charlie,Frontend
+```
+
+**JSON** (`teams.json`):
+```json
+{
+  "Alice": "Backend",
+  "Bob": "Backend",
+  "Charlie": "Frontend"
+}
+```
+
+**Markdown** (`teams.md`):
+```markdown
+| author | team |
+|--------|------|
+| Alice | Backend |
+| Bob | Backend |
+| Charlie | Frontend |
+```
+
+```bash
+npx roux communication -l git.log -p teams.json
+```
+
+### Temporal Coupling / 时间窗口耦合 (`-t`)
+
+Analyze coupling within sliding time windows.
+
+在滑动时间窗口内分析耦合：
+
+```bash
+npx roux coupling -l git.log -t 30    # 30-day windows / 30 天窗口
+```
+
+## Programmatic API / 编程接口
+
+```typescript
+import { analyze, parseGitLog, generateGitLog } from "roux";
+
+// Analyze a repo directly with time filters / 直接分析 repo，带时间过滤
+const result = analyze({
+  analysis: "coupling",
+  repo: "/path/to/repo",
+  after: "2024-01-01",
+  before: "2025-01-01",
+});
+console.log(result); // CSV string
+
+// Or with revision range / 或使用版本范围
+const result2 = analyze({
+  analysis: "revisions",
+  repo: "/path/to/repo",
+  rev: "v1.0..v2.0",
+  outputFormat: "json",
+});
+
+// Or parse a log file manually / 或手动解析日志文件
+const log = fs.readFileSync("git.log", "utf-8");
+const mods = parseGitLog(log);
+const result3 = analyze({ analysis: "summary", input: log });
+```
+
+## Development / 开发
+
+```bash
+npm install
+npm test              # 94 unit tests / 94 个单元测试
+bash test/acceptance/run.sh   # 101 acceptance tests (requires code-maat) / 101 个验收测试（需要 code-maat）
+```
+
+## License / 许可证
+
+MIT

package/dist/analysis/age.d.ts

@@ -0,0 +1,3 @@
+import type { Modification } from "../parsers/types";
+import type { AnalysisOptions } from "./types";
+export declare function age(data: Modification[], options: AnalysisOptions): Record<string, unknown>[];

package/dist/analysis/age.js

@@ -0,0 +1,32 @@
+import { groupBy, orderBy } from "../utils/dataset";
+/** Parse "YYYY-MM-DD" into { year, month, day } without timezone issues */
+function parseYMD(dateStr) {
+    const [y, m, d] = dateStr.split("-").map(Number);
+    return { year: y, month: m, day: d };
+}
+/** Calculate months between two dates, matching java.time.Period semantics */
+function monthsBetween(from, to) {
+    let months = (to.year - from.year) * 12 + (to.month - from.month);
+    if (to.day < from.day) {
+        months--;
+    }
+    return months;
+}
+export function age(data, options) {
+    const now = options.ageTimeNow
+        ? parseYMD(options.ageTimeNow)
+        : (() => {
+            const d = new Date();
+            return { year: d.getFullYear(), month: d.getMonth() + 1, day: d.getDate() };
+        })();
+    const byEntity = groupBy(data, "entity");
+    const result = [];
+    for (const [entity, mods] of byEntity) {
+        const latestDate = mods.reduce((latest, m) => m.date > latest ? m.date : latest, mods[0].date);
+        const from = parseYMD(latestDate);
+        const months = monthsBetween(from, now);
+        result.push({ entity: entity, "age-months": months });
+    }
+    return orderBy(result, "age-months", "asc");
+}
+//# sourceMappingURL=age.js.map

package/dist/analysis/age.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"age.js","sourceRoot":"","sources":["../../src/analysis/age.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAEpD,2EAA2E;AAC3E,SAAS,QAAQ,CAAC,OAAe;IAC/B,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACjD,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC;AACvC,CAAC;AAED,8EAA8E;AAC9E,SAAS,aAAa,CACpB,IAAkD,EAClD,EAAgD;IAEhD,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;IAClE,IAAI,EAAE,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACtB,MAAM,EAAE,CAAC;IACX,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,GAAG,CACjB,IAAoB,EACpB,OAAwB;IAExB,MAAM,GAAG,GAAG,OAAO,CAAC,UAAU;QAC5B,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,UAAU,CAAC;QAC9B,CAAC,CAAC,CAAC,GAAG,EAAE;YACJ,MAAM,CAAC,GAAG,IAAI,IAAI,EAAE,CAAC;YACrB,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,QAAQ,EAAE,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC;QAC9E,CAAC,CAAC,EAAE,CAAC;IAET,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IACzC,MAAM,MAAM,GAA8B,EAAE,CAAC;IAE7C,KAAK,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,QAAQ,EAAE,CAAC;QACtC,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAC3C,CAAC,CAAC,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACnD,MAAM,IAAI,GAAG,QAAQ,CAAC,UAAU,CAAC,CAAC;QAClC,MAAM,MAAM,GAAG,aAAa,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QACxC,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAgB,EAAE,YAAY,EAAE,MAAM,EAAE,CAAC,CAAC;IAClE,CAAC;IAED,OAAO,OAAO,CAAC,MAAM,EAAE,YAAY,EAAE,KAAK,CAAC,CAAC;AAC9C,CAAC"}

package/dist/analysis/authors.d.ts

@@ -0,0 +1,3 @@
+import type { Modification } from "../parsers/types";
+import type { AnalysisOptions } from "./types";
+export declare function authors(data: Modification[], options: AnalysisOptions): Record<string, unknown>[];

package/dist/analysis/authors.js

@@ -0,0 +1,18 @@
+import { groupBy, orderBy } from "../utils/dataset";
+export function authors(data, options) {
+    const byEntity = groupBy(data, "entity");
+    const result = [];
+    for (const [entity, mods] of byEntity) {
+        const uniqueAuthors = new Set(mods.map((m) => m.author));
+        const nRevs = mods.length;
+        if (nRevs >= options.minRevs) {
+            result.push({
+                entity: entity,
+                "n-authors": uniqueAuthors.size,
+                "n-revs": nRevs,
+            });
+        }
+    }
+    return orderBy(result, "n-authors", "desc");
+}
+//# sourceMappingURL=authors.js.map

package/dist/analysis/authors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"authors.js","sourceRoot":"","sources":["../../src/analysis/authors.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAEpD,MAAM,UAAU,OAAO,CACrB,IAAoB,EACpB,OAAwB;IAExB,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IACzC,MAAM,MAAM,GAA8B,EAAE,CAAC;IAE7C,KAAK,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,QAAQ,EAAE,CAAC;QACtC,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;QACzD,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC;QAC1B,IAAI,KAAK,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;YAC7B,MAAM,CAAC,IAAI,CAAC;gBACV,MAAM,EAAE,MAAgB;gBACxB,WAAW,EAAE,aAAa,CAAC,IAAI;gBAC/B,QAAQ,EAAE,KAAK;aAChB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC,MAAM,EAAE,WAAW,EAAE,MAAM,CAAC,CAAC;AAC9C,CAAC"}

package/dist/analysis/churn.d.ts

@@ -0,0 +1,5 @@
+import type { Modification } from "../parsers/types";
+import type { AnalysisOptions } from "./types";
+export declare function absoluteChurn(data: Modification[], _options: AnalysisOptions): Record<string, unknown>[];
+export declare function churnByEntity(data: Modification[], _options: AnalysisOptions): Record<string, unknown>[];
+export declare function churnByAuthor(data: Modification[], _options: AnalysisOptions): Record<string, unknown>[];

package/dist/analysis/churn.js

@@ -0,0 +1,39 @@
+import { groupBy, orderBy } from "../utils/dataset";
+/** Normalize binary (-1) to 0 for churn calculations */
+function loc(value) {
+    return value < 0 ? 0 : value;
+}
+export function absoluteChurn(data, _options) {
+    const byDate = groupBy(data, "date");
+    const result = [];
+    for (const [date, mods] of byDate) {
+        const commits = new Set(mods.map((m) => m.rev)).size;
+        const added = mods.reduce((sum, m) => sum + loc(m.locAdded), 0);
+        const deleted = mods.reduce((sum, m) => sum + loc(m.locDeleted), 0);
+        result.push({ date: date, added, deleted, commits });
+    }
+    return result.sort((a, b) => a.date.localeCompare(b.date));
+}
+export function churnByEntity(data, _options) {
+    const byEntity = groupBy(data, "entity");
+    const result = [];
+    for (const [entity, mods] of byEntity) {
+        const commits = new Set(mods.map((m) => m.rev)).size;
+        const added = mods.reduce((sum, m) => sum + loc(m.locAdded), 0);
+        const deleted = mods.reduce((sum, m) => sum + loc(m.locDeleted), 0);
+        result.push({ entity: entity, added, deleted, commits });
+    }
+    return orderBy(result, "added", "desc");
+}
+export function churnByAuthor(data, _options) {
+    const byAuthor = groupBy(data, "author");
+    const result = [];
+    for (const [author, mods] of byAuthor) {
+        const commits = new Set(mods.map((m) => m.rev)).size;
+        const added = mods.reduce((sum, m) => sum + loc(m.locAdded), 0);
+        const deleted = mods.reduce((sum, m) => sum + loc(m.locDeleted), 0);
+        result.push({ author: author, added, deleted, commits });
+    }
+    return orderBy(result, "added", "desc");
+}
+//# sourceMappingURL=churn.js.map

package/dist/analysis/churn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"churn.js","sourceRoot":"","sources":["../../src/analysis/churn.ts"],"names":[],"mappings":"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"}

package/dist/analysis/communication.d.ts

@@ -0,0 +1,3 @@
+import type { Modification } from "../parsers/types";
+import type { AnalysisOptions } from "./types";
+export declare function communication(data: Modification[], _options: AnalysisOptions): Record<string, unknown>[];

package/dist/analysis/communication.js

@@ -0,0 +1,44 @@
+import { groupBy, orderBy } from "../utils/dataset";
+export function communication(data, _options) {
+    const byEntity = groupBy(data, "entity");
+    // Build a map: author -> set of entities they contribute to
+    const authorEntities = new Map();
+    // Build a map: entity -> set of unique authors
+    const entityAuthors = new Map();
+    for (const [entity, mods] of byEntity) {
+        const authors = new Set(mods.map((m) => m.author));
+        entityAuthors.set(entity, authors);
+        for (const author of authors) {
+            let entities = authorEntities.get(author);
+            if (!entities) {
+                entities = new Set();
+                authorEntities.set(author, entities);
+            }
+            entities.add(entity);
+        }
+    }
+    // Count shared entities for each ordered pair
+    const pairShared = new Map();
+    for (const [, authors] of entityAuthors) {
+        const authorList = [...authors];
+        for (let i = 0; i < authorList.length; i++) {
+            for (let j = 0; j < authorList.length; j++) {
+                if (i === j)
+                    continue;
+                const key = `${authorList[i]}\0${authorList[j]}`;
+                pairShared.set(key, (pairShared.get(key) ?? 0) + 1);
+            }
+        }
+    }
+    const result = [];
+    for (const [key, shared] of pairShared) {
+        const [author, peer] = key.split("\0");
+        const selfCountAuthor = authorEntities.get(author).size;
+        const selfCountPeer = authorEntities.get(peer).size;
+        const average = Math.ceil((selfCountAuthor + selfCountPeer) / 2);
+        const strength = Math.floor((shared / average) * 100);
+        result.push({ author, peer, shared, average, strength });
+    }
+    return orderBy(result, "strength", "desc");
+}
+//# sourceMappingURL=communication.js.map

package/dist/analysis/communication.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"communication.js","sourceRoot":"","sources":["../../src/analysis/communication.ts"],"names":[],"mappings":"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"}

package/dist/analysis/coupling.d.ts

@@ -0,0 +1,4 @@
+import type { Modification } from "../parsers/types";
+import type { AnalysisOptions } from "./types";
+export declare function coupling(data: Modification[], options: AnalysisOptions): Record<string, unknown>[];
+export declare function sumOfCoupling(data: Modification[], options: AnalysisOptions): Record<string, unknown>[];

package/dist/analysis/coupling.js

@@ -0,0 +1,84 @@
+import { groupBy, orderBy } from "../utils/dataset";
+/** Group modifications by revision, return map of rev → entities */
+function entitiesByRevision(data, maxChangesetSize) {
+    const byRev = groupBy(data, "rev");
+    const result = new Map();
+    for (const [rev, mods] of byRev) {
+        const entities = [...new Set(mods.map((m) => m.entity))];
+        if (entities.length <= maxChangesetSize) {
+            result.set(rev, entities);
+        }
+    }
+    return result;
+}
+/** Count how many times each pair of entities co-changed */
+function couplingFrequencies(byRevision) {
+    const freqs = new Map();
+    for (const entities of byRevision.values()) {
+        const sorted = [...entities].sort();
+        for (let i = 0; i < sorted.length; i++) {
+            for (let j = i + 1; j < sorted.length; j++) {
+                const key = `${sorted[i]}||${sorted[j]}`;
+                freqs.set(key, (freqs.get(key) ?? 0) + 1);
+            }
+        }
+    }
+    return freqs;
+}
+/** Count total revisions per entity */
+function revisionsByEntity(data) {
+    const byEntity = groupBy(data, "entity");
+    const result = new Map();
+    for (const [entity, mods] of byEntity) {
+        result.set(entity, new Set(mods.map((m) => m.rev)).size);
+    }
+    return result;
+}
+export function coupling(data, options) {
+    const byRevision = entitiesByRevision(data, options.maxChangesetSize);
+    const freqs = couplingFrequencies(byRevision);
+    const revsByEntity = revisionsByEntity(data);
+    const result = [];
+    for (const [key, sharedRevs] of freqs) {
+        const [e1, e2] = key.split("||");
+        const revs1 = revsByEntity.get(e1) ?? 0;
+        const revs2 = revsByEntity.get(e2) ?? 0;
+        const avgRevs = (revs1 + revs2) / 2;
+        const degree = Math.floor((sharedRevs / avgRevs) * 100);
+        const avgRevsRounded = Math.round(avgRevs);
+        if (sharedRevs >= options.minSharedRevs &&
+            degree >= options.minCoupling &&
+            degree <= options.maxCoupling &&
+            revs1 >= options.minRevs &&
+            revs2 >= options.minRevs) {
+            result.push({
+                entity: e1,
+                coupled: e2,
+                degree,
+                "average-revs": avgRevsRounded,
+            });
+        }
+    }
+    return orderBy(result, "degree", "desc");
+}
+export function sumOfCoupling(data, options) {
+    // SOC uses non-deduplicated entities per revision (matches code-maat row-level counting)
+    const byRev = groupBy(data, "rev");
+    const soc = new Map();
+    for (const [, mods] of byRev) {
+        const entities = mods.map((m) => m.entity);
+        if (entities.length > options.maxChangesetSize)
+            continue;
+        for (const entity of entities) {
+            soc.set(entity, (soc.get(entity) ?? 0) + (entities.length - 1));
+        }
+    }
+    const result = [];
+    for (const [entity, value] of soc) {
+        if (value > options.minRevs) {
+            result.push({ entity, soc: value });
+        }
+    }
+    return orderBy(result, "soc", "desc");
+}
+//# sourceMappingURL=coupling.js.map

package/dist/analysis/coupling.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"coupling.js","sourceRoot":"","sources":["../../src/analysis/coupling.ts"],"names":[],"mappings":"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"}

package/dist/analysis/entity-effort.d.ts

@@ -0,0 +1,3 @@
+import type { Modification } from "../parsers/types";
+import type { AnalysisOptions } from "./types";
+export declare function entityEffort(data: Modification[], _options: AnalysisOptions): Record<string, unknown>[];

package/dist/analysis/entity-effort.js

@@ -0,0 +1,36 @@
+import { groupBy } from "../utils/dataset";
+export function entityEffort(data, _options) {
+    const byEntity = groupBy(data, "entity");
+    const result = [];
+    for (const [entity, mods] of byEntity) {
+        // Group by author within entity, counting unique revisions
+        const authorRevs = new Map();
+        for (const m of mods) {
+            const revs = authorRevs.get(m.author) ?? new Set();
+            revs.add(m.rev);
+            authorRevs.set(m.author, revs);
+        }
+        // total-revs = sum of all author-revs
+        let totalRevs = 0;
+        for (const revs of authorRevs.values()) {
+            totalRevs += revs.size;
+        }
+        // Build rows for each author
+        const entityRows = [];
+        for (const [author, revs] of authorRevs) {
+            entityRows.push({
+                entity: entity,
+                author,
+                "author-revs": revs.size,
+                "total-revs": totalRevs,
+            });
+        }
+        // Sort by author-revs desc within entity
+        entityRows.sort((a, b) => b["author-revs"] - a["author-revs"]);
+        result.push(...entityRows);
+    }
+    // Sort by entity asc (stable — preserves author-revs desc within entity)
+    result.sort((a, b) => a.entity.localeCompare(b.entity));
+    return result;
+}
+//# sourceMappingURL=entity-effort.js.map