What problem does it solve?
Analyze git history to build a security ownership topology (people-to-file), compute bus factor and sensitive-code ownership, and export CSV/JSON for graph databases and visualization. Trigger only when the user explicitly wants a security-oriented ownership or bus-factor analysis grounded in git history (for example: orphaned sensitive code, security maintainers, CODEOWNERS reality checks for risk, sensitive hotspots, or ownership clusters). Do not trigger for general maintainer lists or non-security ownership questions.
Core Features & Use Cases
-
Build a bipartite graph of people and files from git history, then compute ownership risk and export graph artifacts for Neo4j/Gephi. Also build a file co-change graph (Jaccard similarity on shared commits) to cluster files by how they move together while ignoring large, noisy commits.
-
Communities are computed by default; graphml output is optional (--graphml).
-
Query the outputs with scripts/query_ownership.py for bounded JSON slices.
By default, the script flags common auth/crypto/secret paths. Override by providing a CSV file:
- The CLI options described in the script include --repo, --since, --until, --identity, --sensitive-config, and so on, to customize scopes, time windows, and visualization outputs.
Quick Start
Run the ownership map on your repository to generate the security-ownership outputs (CSV/JSON) for graph visualization.