Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 10 additions & 0 deletions docs/adding-a-metric.md
Original file line number Diff line number Diff line change
Expand Up @@ -51,3 +51,13 @@ Check a new metric against these decisions before you add it.
- Below the cut line: clones, coverage, CRAP, temporal coupling and trends.
- Keep or cut a metric on decision cases: read each top-ranked case in source and record a verdict. Correlation alone does not decide. `evaluate_metric_portfolio.py` reports support, N/A and zero rates, Spearman correlation and top-10 overlap per language and scope as input to that review.
- Tune defaults with evidence. The October 2026 pilot adjudicated 729 top-10 cases on four repositories, then set the defaults (for example, `comment_noise` flags 1.0 comment line per code line or more). Its method, results and open follow-ups are in `docs/research/metric-pilot-2026-10/README.md`. Rerun a pilot with `server/scripts/evaluate_metric_portfolio.py`.

## Activity metrics

Git activity (`server/app/services/activity.py`) is review context beside source structure. It is not a source metric.

- It gives two metrics: `commit_count` and `churn_lines`. Churn stays a separate metric, because one bulk rewrite gives high churn in a single commit.
- The window is 30 days, 90 days (the default), 1 year or all history. History follows renames to the file's current path.
- No `.git`, a shallow clone, no commits, a git error or a timeout gives N/A with a reason. Source metrics stay as they are. Uncommitted edits add a note only.
- Activity is laid over a finished tree when the tree is served. It is never part of the analysis cache, so a window change does not rerun the analyzers.
- Out of scope: co-change, author scores and remote fetches.
14 changes: 14 additions & 0 deletions docs/initiative-history.json
Original file line number Diff line number Diff line change
Expand Up @@ -138,5 +138,19 @@
"follow_ups": [
"The pilot README lists its own follow-ups, including a second reviewer and a non-author repository."
]
},
{
"title": "Local activity as review context",
"slug": "git-activity",
"outcome": "completed",
"retired_at": "2026-11-12",
"summary": "Git activity shipped inside the metric system overhaul as commit_count and churn_lines over a chosen window, with N/A reasons when history can't be trusted, and the pilot showed it changes review priority. Reconciled against origin/main 0bfb05ba.",
"reason": "Replaced by the metric system overhaul: #76 shipped Git activity and #79 evaluated it.",
"documentation": [
"docs/adding-a-metric.md",
"docs/research/metrics-2026-10-15/README.md"
],
"revision": "0bfb05ba",
"follow_ups": []
}
]
47 changes: 0 additions & 47 deletions docs/intent/git-activity/implementation-plan.md

This file was deleted.

261 changes: 0 additions & 261 deletions docs/intent/git-activity/initiative-map.json

This file was deleted.

32 changes: 0 additions & 32 deletions docs/intent/git-activity/intent-brief.md

This file was deleted.

Loading
Loading