Codebase intelligence for AI and humans: code health scores, auto-generated docs, git analytics, dead code detection, and architectural decisions via MCP.
Python aicode-complexitycode-healthcode-intelligencecode-qualitydead-codedeveloper-toolsdocumentationgit-analyticsmcpopen-sourcepythonrefactoringstatic-analysistechnical-debt
export interface DocumentGroup<T> {
document: string;
items: T[];
}
/** One group per document in first-seen order, lines ascending within. */
export function groupByDocument<T>(
items: readonly T[],
documentOf: (item: T) => string,
lineOf: (item: T) => number,
): DocumentGroup<T>[] {
const groups = new Map<string, T[]>();
for (const item of items) {
const key = documentOf(item);
const list = groups.get(key);
if (list) list.push(item);
else groups.set(key, [item]);
}
return [...groups].map(([document, list]) => ({
document,
items: list.sort((a, b) => lineOf(a) - lineOf(b)),
}));
}