estela 0.1.0

package/dist/metrics/index.d.ts

@@ -0,0 +1,101 @@
+import type { CommitRecord, TimeEntry } from "@estela/shared";
+/**
+ * Métricas del panel compartido.
+ *
+ * Funciones puras: entran commits e imputaciones, salen cifras. Sin base de
+ * datos y sin interfaz, para que cada número tenga un test y se pueda defender
+ * cuando el líder técnico pregunte de dónde sale. Lo que arruina una demo no es
+ * una gráfica fea, es una cifra que no cuadra.
+ *
+ * Lo que deliberadamente NO se calcula: líneas de código como titular, número
+ * de commits, y cualquier índice compuesto de "productividad". Son métricas de
+ * vanidad; enseñarlas a quien dirige equipos descalifica la herramienta en el
+ * primer vistazo porque todo el oficio sabe que se inflan solas.
+ */
+export interface FeatureEffort {
+    /** Nombre legible: la rama sin su prefijo de convención. */
+    readonly name: string;
+    readonly branch: string;
+    readonly seconds: number;
+    readonly days: number;
+    readonly firstDay: string;
+    readonly lastDay: string;
+    /** Lo entregado, en palabras de quien lo hizo. */
+    readonly delivered: readonly {
+        hash: string;
+        subject: string;
+    }[];
+    readonly linesAdded: number;
+    readonly linesDeleted: number;
+    /** `null` cuando no se sabe si está integrada. */
+    readonly merged: boolean | null;
+}
+/**
+ * Agrupa el trabajo por rama.
+ *
+ * Un gestor piensa en funcionalidades, no en martes: "18h en el informe de
+ * servicios" es una frase que puede contrastar con lo que pidió; "3h el día 14"
+ * no le dice nada.
+ */
+export declare function effortByFeature(entries: readonly TimeEntry[], commits: readonly CommitRecord[], mergedBranches?: ReadonlySet<string> | null): FeatureEffort[];
+/** Quita el prefijo de convención: `feature/informe-x` → `informe-x`. */
+export declare function featureName(branch: string): string;
+export interface Cadence {
+    readonly byDay: readonly {
+        date: string;
+        seconds: number;
+    }[];
+    readonly activeDays: number;
+    /** Días naturales entre el primero y el último con trabajo. */
+    readonly spanDays: number;
+    /** Hueco más largo sin actividad, en días. */
+    readonly longestGapDays: number;
+    readonly medianSecondsPerActiveDay: number;
+}
+/**
+ * Cómo se repartió el trabajo en el tiempo.
+ *
+ * Un líder técnico lo lee de un vistazo: trabajo repartido significa un
+ * proyecto que respira; todo amontonado la víspera significa otra cosa.
+ */
+export declare function cadence(entries: readonly TimeEntry[]): Cadence;
+export interface ChurnFile {
+    readonly file: string;
+    readonly touches: number;
+    readonly spanDays: number;
+    readonly lastDay: string;
+}
+/**
+ * Ficheros que se vuelven a tocar.
+ *
+ * Es la métrica que más respeto gana ante un líder técnico porque es
+ * diagnóstica y no autocomplaciente: mucha reescritura significa requisitos
+ * cambiando o diseño que se resistió. Enseñarla sin que la pida dice que no se
+ * oculta nada.
+ *
+ * Solo cuenta si los retoques están próximos en el tiempo: un fichero tocado en
+ * enero y en agosto no es reescritura, es mantenimiento normal.
+ */
+export declare function churn(commits: readonly CommitRecord[], options?: {
+    withinDays?: number;
+    minTouches?: number;
+}): ChurnFile[];
+export interface OpenWork {
+    readonly branch: string;
+    readonly name: string;
+    readonly lastDay: string;
+    readonly ageDays: number;
+    readonly commits: number;
+}
+/**
+ * Ramas con trabajo sin integrar.
+ *
+ * Es lo que un jefe de proyecto más quiere y menos tiene: riesgo acumulado que
+ * no se ve hasta que estalla en la integración.
+ *
+ * Ojo al presentarlo: una rama lleva ocho días abierta tanto si el desarrollador
+ * va lento como si el cliente no la revisa. El número no distingue, así que la
+ * interfaz no debe insinuar culpa.
+ */
+export declare function openWork(commits: readonly CommitRecord[], mergedBranches: ReadonlySet<string>, today?: Date): OpenWork[];
+//# sourceMappingURL=index.d.ts.map

package/dist/metrics/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/metrics/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAG9D;;;;;;;;;;;;GAYG;AAMH,MAAM,WAAW,aAAa;IAC5B,4DAA4D;IAC5D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,kDAAkD;IAClD,QAAQ,CAAC,SAAS,EAAE,SAAS;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACjE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,kDAAkD;IAClD,QAAQ,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAAC;CACjC;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,SAAS,SAAS,EAAE,EAC7B,OAAO,EAAE,SAAS,YAAY,EAAE,EAChC,cAAc,GAAE,WAAW,CAAC,MAAM,CAAC,GAAG,IAAW,GAChD,aAAa,EAAE,CAgDjB;AAgBD,yEAAyE;AACzE,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAQlD;AAMD,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,KAAK,EAAE,SAAS;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC7D,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,+DAA+D;IAC/D,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,8CAA8C;IAC9C,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,yBAAyB,EAAE,MAAM,CAAC;CAC5C;AAED;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,OAAO,EAAE,SAAS,SAAS,EAAE,GAAG,OAAO,CAsC9D;AAMD,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,KAAK,CACnB,OAAO,EAAE,SAAS,YAAY,EAAE,EAChC,OAAO,GAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAO,GACzD,SAAS,EAAE,CAyCb;AAMD,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;;;;;GASG;AACH,wBAAgB,QAAQ,CACtB,OAAO,EAAE,SAAS,YAAY,EAAE,EAChC,cAAc,EAAE,WAAW,CAAC,MAAM,CAAC,EACnC,KAAK,OAAa,GACjB,QAAQ,EAAE,CAuBZ"}

package/dist/metrics/index.js

@@ -0,0 +1,221 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.effortByFeature = effortByFeature;
+exports.featureName = featureName;
+exports.cadence = cadence;
+exports.churn = churn;
+exports.openWork = openWork;
+const shared_1 = require("@estela/shared");
+/**
+ * Agrupa el trabajo por rama.
+ *
+ * Un gestor piensa en funcionalidades, no en martes: "18h en el informe de
+ * servicios" es una frase que puede contrastar con lo que pidió; "3h el día 14"
+ * no le dice nada.
+ */
+function effortByFeature(entries, commits, mergedBranches = null) {
+    const byBranch = new Map();
+    const get = (branch) => {
+        let entry = byBranch.get(branch);
+        if (!entry) {
+            entry = { seconds: 0, days: new Set(), commits: [] };
+            byBranch.set(branch, entry);
+        }
+        return entry;
+    };
+    for (const entry of entries) {
+        if (!entry.billable)
+            continue;
+        const bucket = get(bucketFor(entry));
+        bucket.seconds += entry.seconds;
+        bucket.days.add((0, shared_1.localDate)(entry.startedAt));
+    }
+    for (const commit of commits) {
+        if (!commit.branch)
+            continue;
+        // Solo se cuentan commits de ramas donde además hubo trabajo imputado: si
+        // no, aparecerían funcionalidades con commits y cero horas, que confunden.
+        const bucket = byBranch.get(commit.branch);
+        if (bucket)
+            bucket.commits.push(commit);
+    }
+    return [...byBranch.entries()]
+        .map(([branch, b]) => {
+        const days = [...b.days].sort();
+        const sorted = [...b.commits].sort((x, y) => y.at.getTime() - x.at.getTime());
+        return {
+            name: featureName(branch),
+            branch,
+            seconds: b.seconds,
+            days: days.length,
+            firstDay: days[0] ?? "",
+            lastDay: days[days.length - 1] ?? "",
+            delivered: sorted.map((c) => ({ hash: c.hash.slice(0, 7), subject: c.subject })),
+            linesAdded: sorted.reduce((s, c) => s + c.linesAdded, 0),
+            linesDeleted: sorted.reduce((s, c) => s + c.linesDeleted, 0),
+            // Un grupo por tipo de trabajo no es una rama: preguntarle si está
+            // integrado no significa nada, y decir "en curso" sería confuso.
+            merged: branch.startsWith("kind:") ? null
+                : mergedBranches ? mergedBranches.has(branch) : null,
+        };
+    })
+        .sort((a, b) => b.seconds - a.seconds);
+}
+/**
+ * A qué grupo pertenece una imputación.
+ *
+ * El trabajo sin rama no es un hueco sin explicar: una reunión o un viaje no
+ * ocurren en ninguna rama. Agruparlo por su tipo da una línea que un gestor
+ * entiende —"1h 30m en reuniones"— en vez de un "sin rama" que solo genera la
+ * pregunta de qué falló.
+ */
+function bucketFor(entry) {
+    if (entry.branch)
+        return entry.branch;
+    if (entry.kind !== "development")
+        return `kind:${entry.kind}`;
+    return "kind:other";
+}
+/** Quita el prefijo de convención: `feature/informe-x` → `informe-x`. */
+function featureName(branch) {
+    if (branch.startsWith("kind:")) {
+        const kind = branch.slice(5);
+        return shared_1.WORK_KIND_LABELS[kind] ?? "Trabajo general";
+    }
+    return branch.replace(/^(feature|feat|fix|hotfix|chore|bugfix|release)\//i, "")
+        .replace(/[-_]+/g, " ")
+        .trim() || branch;
+}
+/**
+ * Cómo se repartió el trabajo en el tiempo.
+ *
+ * Un líder técnico lo lee de un vistazo: trabajo repartido significa un
+ * proyecto que respira; todo amontonado la víspera significa otra cosa.
+ */
+function cadence(entries) {
+    const perDay = new Map();
+    for (const entry of entries) {
+        if (!entry.billable)
+            continue;
+        const day = (0, shared_1.localDate)(entry.startedAt);
+        perDay.set(day, (perDay.get(day) ?? 0) + entry.seconds);
+    }
+    const byDay = [...perDay.entries()]
+        .map(([date, seconds]) => ({ date, seconds }))
+        .sort((a, b) => a.date.localeCompare(b.date));
+    if (byDay.length === 0) {
+        return { byDay, activeDays: 0, spanDays: 0, longestGapDays: 0, medianSecondsPerActiveDay: 0 };
+    }
+    const first = byDay[0].date;
+    const last = byDay[byDay.length - 1].date;
+    const spanDays = daysBetween(first, last) + 1;
+    let longestGap = 0;
+    for (let i = 1; i < byDay.length; i++) {
+        longestGap = Math.max(longestGap, daysBetween(byDay[i - 1].date, byDay[i].date) - 1);
+    }
+    const sorted = byDay.map((d) => d.seconds).sort((a, b) => a - b);
+    const mid = Math.floor(sorted.length / 2);
+    const median = sorted.length % 2 === 0
+        ? Math.round(((sorted[mid - 1] ?? 0) + (sorted[mid] ?? 0)) / 2)
+        : sorted[mid] ?? 0;
+    return {
+        byDay,
+        activeDays: byDay.length,
+        spanDays,
+        longestGapDays: longestGap,
+        medianSecondsPerActiveDay: median,
+    };
+}
+/**
+ * Ficheros que se vuelven a tocar.
+ *
+ * Es la métrica que más respeto gana ante un líder técnico porque es
+ * diagnóstica y no autocomplaciente: mucha reescritura significa requisitos
+ * cambiando o diseño que se resistió. Enseñarla sin que la pida dice que no se
+ * oculta nada.
+ *
+ * Solo cuenta si los retoques están próximos en el tiempo: un fichero tocado en
+ * enero y en agosto no es reescritura, es mantenimiento normal.
+ */
+function churn(commits, options = {}) {
+    const within = options.withinDays ?? 14;
+    const minTouches = options.minTouches ?? 3;
+    const byFile = new Map();
+    for (const commit of commits) {
+        for (const file of commit.files) {
+            const list = byFile.get(file);
+            if (list)
+                list.push(commit.at);
+            else
+                byFile.set(file, [commit.at]);
+        }
+    }
+    const result = [];
+    for (const [file, dates] of byFile) {
+        if (dates.length < minTouches)
+            continue;
+        dates.sort((a, b) => a.getTime() - b.getTime());
+        // Retoques encadenados: cada uno a menos de `within` días del anterior.
+        let runStart = 0;
+        let best = { count: 1, from: 0, to: 0 };
+        for (let i = 1; i < dates.length; i++) {
+            const gap = (dates[i].getTime() - dates[i - 1].getTime()) / 86_400_000;
+            if (gap > within)
+                runStart = i;
+            const count = i - runStart + 1;
+            if (count > best.count)
+                best = { count, from: runStart, to: i };
+        }
+        if (best.count < minTouches)
+            continue;
+        const from = dates[best.from];
+        const to = dates[best.to];
+        result.push({
+            file,
+            touches: best.count,
+            spanDays: Math.max(1, Math.round((to.getTime() - from.getTime()) / 86_400_000)),
+            lastDay: (0, shared_1.localDate)(to),
+        });
+    }
+    return result.sort((a, b) => b.touches - a.touches || a.spanDays - b.spanDays);
+}
+/**
+ * Ramas con trabajo sin integrar.
+ *
+ * Es lo que un jefe de proyecto más quiere y menos tiene: riesgo acumulado que
+ * no se ve hasta que estalla en la integración.
+ *
+ * Ojo al presentarlo: una rama lleva ocho días abierta tanto si el desarrollador
+ * va lento como si el cliente no la revisa. El número no distingue, así que la
+ * interfaz no debe insinuar culpa.
+ */
+function openWork(commits, mergedBranches, today = new Date()) {
+    const byBranch = new Map();
+    for (const commit of commits) {
+        if (!commit.branch || mergedBranches.has(commit.branch))
+            continue;
+        const entry = byBranch.get(commit.branch);
+        if (entry) {
+            entry.count++;
+            if (commit.at > entry.last)
+                entry.last = commit.at;
+        }
+        else {
+            byBranch.set(commit.branch, { last: commit.at, count: 1 });
+        }
+    }
+    return [...byBranch.entries()]
+        .map(([branch, b]) => ({
+        branch,
+        name: featureName(branch),
+        lastDay: (0, shared_1.localDate)(b.last),
+        ageDays: Math.max(0, Math.round((today.getTime() - b.last.getTime()) / 86_400_000)),
+        commits: b.count,
+    }))
+        .sort((a, b) => b.ageDays - a.ageDays);
+}
+// ---------------------------------------------------------------------------
+function daysBetween(a, b) {
+    return Math.round((new Date(`${b}T12:00:00Z`).getTime() - new Date(`${a}T12:00:00Z`).getTime()) / 86_400_000);
+}
+//# sourceMappingURL=index.js.map

package/dist/metrics/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/metrics/index.ts"],"names":[],"mappings":";;AA4CA,0CAoDC;AAiBD,kCAQC;AAsBD,0BAsCC;AAwBD,sBA4CC;AAwBD,4BA2BC;AA3SD,2CAA6D;AAoC7D;;;;;;GAMG;AACH,SAAgB,eAAe,CAC7B,OAA6B,EAC7B,OAAgC,EAChC,iBAA6C,IAAI;IAEjD,MAAM,QAAQ,GAAG,IAAI,GAAG,EAGpB,CAAC;IAEL,MAAM,GAAG,GAAG,CAAC,MAAc,EAAE,EAAE;QAC7B,IAAI,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACjC,IAAI,CAAC,KAAK,EAAE,CAAC;YAAC,KAAK,GAAG,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,GAAG,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;YAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QAAC,CAAC;QAClG,OAAO,KAAK,CAAC;IACf,CAAC,CAAC;IAEF,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,CAAC,KAAK,CAAC,QAAQ;YAAE,SAAS;QAC9B,MAAM,MAAM,GAAG,GAAG,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;QACrC,MAAM,CAAC,OAAO,IAAI,KAAK,CAAC,OAAO,CAAC;QAChC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,IAAA,kBAAS,EAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC;IAC9C,CAAC;IAED,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,IAAI,CAAC,MAAM,CAAC,MAAM;YAAE,SAAS;QAC7B,0EAA0E;QAC1E,2EAA2E;QAC3E,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAC3C,IAAI,MAAM;YAAE,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC1C,CAAC;IAED,OAAO,CAAC,GAAG,QAAQ,CAAC,OAAO,EAAE,CAAC;SAC3B,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE;QACnB,MAAM,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;QAChC,MAAM,MAAM,GAAG,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;QAC9E,OAAO;YACL,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC;YACzB,MAAM;YACN,OAAO,EAAE,CAAC,CAAC,OAAO;YAClB,IAAI,EAAE,IAAI,CAAC,MAAM;YACjB,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE;YACvB,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,EAAE;YACpC,SAAS,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;YAChF,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC;YACxD,YAAY,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,YAAY,EAAE,CAAC,CAAC;YAC5D,mEAAmE;YACnE,iEAAiE;YACjE,MAAM,EAAE,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI;gBACvC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI;SACvD,CAAC;IACJ,CAAC,CAAC;SACD,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC;AAC3C,CAAC;AAED;;;;;;;GAOG;AACH,SAAS,SAAS,CAAC,KAAgB;IACjC,IAAI,KAAK,CAAC,MAAM;QAAE,OAAO,KAAK,CAAC,MAAM,CAAC;IACtC,IAAI,KAAK,CAAC,IAAI,KAAK,aAAa;QAAE,OAAO,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;IAC9D,OAAO,YAAY,CAAC;AACtB,CAAC;AAED,yEAAyE;AACzE,SAAgB,WAAW,CAAC,MAAc;IACxC,IAAI,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QAC/B,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAkC,CAAC;QAC9D,OAAO,yBAAgB,CAAC,IAAI,CAAC,IAAI,iBAAiB,CAAC;IACrD,CAAC;IACD,OAAO,MAAM,CAAC,OAAO,CAAC,oDAAoD,EAAE,EAAE,CAAC;SAC5E,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC;SACtB,IAAI,EAAE,IAAI,MAAM,CAAC;AACtB,CAAC;AAgBD;;;;;GAKG;AACH,SAAgB,OAAO,CAAC,OAA6B;IACnD,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAC;IACzC,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,CAAC,KAAK,CAAC,QAAQ;YAAE,SAAS;QAC9B,MAAM,GAAG,GAAG,IAAA,kBAAS,EAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QACvC,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC;IAC1D,CAAC;IAED,MAAM,KAAK,GAAG,CAAC,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC;SAChC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;SAC7C,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IAEhD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,cAAc,EAAE,CAAC,EAAE,yBAAyB,EAAE,CAAC,EAAE,CAAC;IAChG,CAAC;IAED,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC,IAAI,CAAC;IAC7B,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAE,CAAC,IAAI,CAAC;IAC3C,MAAM,QAAQ,GAAG,WAAW,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;IAE9C,IAAI,UAAU,GAAG,CAAC,CAAC;IACnB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,WAAW,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAE,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IACzF,CAAC;IAED,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACjE,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC1C,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC,KAAK,CAAC;QACpC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QAC/D,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAErB,OAAO;QACL,KAAK;QACL,UAAU,EAAE,KAAK,CAAC,MAAM;QACxB,QAAQ;QACR,cAAc,EAAE,UAAU;QAC1B,yBAAyB,EAAE,MAAM;KAClC,CAAC;AACJ,CAAC;AAaD;;;;;;;;;;GAUG;AACH,SAAgB,KAAK,CACnB,OAAgC,EAChC,UAAwD,EAAE;IAE1D,MAAM,MAAM,GAAG,OAAO,CAAC,UAAU,IAAI,EAAE,CAAC;IACxC,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,CAAC,CAAC;IAE3C,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAC;IACzC,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;YAChC,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAC9B,IAAI,IAAI;gBAAE,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;;gBAC1B,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;QACrC,CAAC;IACH,CAAC;IAED,MAAM,MAAM,GAAgB,EAAE,CAAC;IAE/B,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,EAAE,CAAC;QACnC,IAAI,KAAK,CAAC,MAAM,GAAG,UAAU;YAAE,SAAS;QACxC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;QAEhD,wEAAwE;QACxE,IAAI,QAAQ,GAAG,CAAC,CAAC;QACjB,IAAI,IAAI,GAAG,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC;QACxC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACtC,MAAM,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC,OAAO,EAAE,GAAG,KAAK,CAAC,CAAC,GAAG,CAAC,CAAE,CAAC,OAAO,EAAE,CAAC,GAAG,UAAU,CAAC;YACzE,IAAI,GAAG,GAAG,MAAM;gBAAE,QAAQ,GAAG,CAAC,CAAC;YAC/B,MAAM,KAAK,GAAG,CAAC,GAAG,QAAQ,GAAG,CAAC,CAAC;YAC/B,IAAI,KAAK,GAAG,IAAI,CAAC,KAAK;gBAAE,IAAI,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC;QAClE,CAAC;QAED,IAAI,IAAI,CAAC,KAAK,GAAG,UAAU;YAAE,SAAS;QACtC,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAE,CAAC;QAC/B,MAAM,EAAE,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,CAAE,CAAC;QAC3B,MAAM,CAAC,IAAI,CAAC;YACV,IAAI;YACJ,OAAO,EAAE,IAAI,CAAC,KAAK;YACnB,QAAQ,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC,GAAG,UAAU,CAAC,CAAC;YAC/E,OAAO,EAAE,IAAA,kBAAS,EAAC,EAAE,CAAC;SACvB,CAAC,CAAC;IACL,CAAC;IAED,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC;AACjF,CAAC;AAcD;;;;;;;;;GASG;AACH,SAAgB,QAAQ,CACtB,OAAgC,EAChC,cAAmC,EACnC,KAAK,GAAG,IAAI,IAAI,EAAE;IAElB,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAyC,CAAC;IAElE,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC;YAAE,SAAS;QAClE,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAC1C,IAAI,KAAK,EAAE,CAAC;YACV,KAAK,CAAC,KAAK,EAAE,CAAC;YACd,IAAI,MAAM,CAAC,EAAE,GAAG,KAAK,CAAC,IAAI;gBAAE,KAAK,CAAC,IAAI,GAAG,MAAM,CAAC,EAAE,CAAC;QACrD,CAAC;aAAM,CAAC;YACN,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;QAC7D,CAAC;IACH,CAAC;IAED,OAAO,CAAC,GAAG,QAAQ,CAAC,OAAO,EAAE,CAAC;SAC3B,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACrB,MAAM;QACN,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC;QACzB,OAAO,EAAE,IAAA,kBAAS,EAAC,CAAC,CAAC,IAAI,CAAC;QAC1B,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,GAAG,UAAU,CAAC,CAAC;QACnF,OAAO,EAAE,CAAC,CAAC,KAAK;KACjB,CAAC,CAAC;SACF,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC;AAC3C,CAAC;AAED,8EAA8E;AAE9E,SAAS,WAAW,CAAC,CAAS,EAAE,CAAS;IACvC,OAAO,IAAI,CAAC,KAAK,CACf,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,OAAO,EAAE,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,OAAO,EAAE,CAAC,GAAG,UAAU,CAAC,CAAC;AAChG,CAAC"}

package/dist/metrics/metrics.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=metrics.test.d.ts.map

package/dist/metrics/metrics.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.test.d.ts","sourceRoot":"","sources":["../../src/metrics/metrics.test.ts"],"names":[],"mappings":""}

package/dist/metrics/metrics.test.js

@@ -0,0 +1,162 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const strict_1 = __importDefault(require("node:assert/strict"));
+const node_test_1 = require("node:test");
+const index_js_1 = require("./index.js");
+function entry(day, hours, branch = "feature/x") {
+    const startedAt = new Date(`${day}T14:00:00Z`);
+    return {
+        id: `e-${day}-${branch}`, projectId: "p", startedAt,
+        endedAt: new Date(startedAt.getTime() + hours * 3600_000),
+        seconds: Math.round(hours * 3600), description: "Trabajo",
+        billable: true, invoiceId: null, aiCost: { microUsd: 0 },
+        agentSeconds: 0, commitHashes: [], agents: [],
+        source: "agent", kind: "development", branch,
+    };
+}
+function commit(day, branch, files, subject = "feat: algo") {
+    return {
+        repoPath: "/repo", hash: `${day.replace(/-/g, "")}${branch.length}`.padEnd(40, "0"),
+        at: new Date(`${day}T15:00:00Z`), authorEmail: "yo@ejemplo.com", authorName: "Yo",
+        branch, subject, linesAdded: 10, linesDeleted: 2, files,
+    };
+}
+// ── Esfuerzo por funcionalidad ─────────────────────────────────────────
+(0, node_test_1.test)("agrupa las horas por rama, no por día", () => {
+    // Un gestor piensa en funcionalidades: "18h en el informe de servicios" es
+    // una frase que puede contrastar; "3h el martes" no le dice nada.
+    const features = (0, index_js_1.effortByFeature)([
+        entry("2026-08-10", 3, "feature/informe"),
+        entry("2026-08-11", 2, "feature/informe"),
+        entry("2026-08-11", 1, "feature/login"),
+    ], []);
+    strict_1.default.equal(features.length, 2);
+    strict_1.default.equal(features[0].branch, "feature/informe", "la de más horas primero");
+    strict_1.default.equal(features[0].seconds, 5 * 3600);
+    strict_1.default.equal(features[0].days, 2);
+});
+(0, node_test_1.test)("el nombre legible quita el prefijo de convención", () => {
+    strict_1.default.equal((0, index_js_1.featureName)("feature/servicios-socios-cartera"), "servicios socios cartera");
+    strict_1.default.equal((0, index_js_1.featureName)("fix/SavePreferences"), "SavePreferences");
+    strict_1.default.equal((0, index_js_1.featureName)("main"), "main");
+});
+(0, node_test_1.test)("adjunta lo entregado en palabras de quien lo hizo", () => {
+    const features = (0, index_js_1.effortByFeature)([entry("2026-08-10", 3, "feature/informe")], [commit("2026-08-10", "feature/informe", ["a.cs"], "feat: filtro de Canarias")]);
+    strict_1.default.equal(features[0].delivered.length, 1);
+    strict_1.default.equal(features[0].delivered[0].subject, "feat: filtro de Canarias");
+});
+(0, node_test_1.test)("no inventa funcionalidades con commits pero sin horas", () => {
+    // Si apareciera una rama con commits y cero horas, el lector se preguntaría
+    // por qué y perdería confianza en el resto de las cifras.
+    const features = (0, index_js_1.effortByFeature)([entry("2026-08-10", 3, "feature/informe")], [commit("2026-08-10", "feature/otra", ["b.cs"])]);
+    strict_1.default.equal(features.length, 1);
+    strict_1.default.equal(features[0].branch, "feature/informe");
+});
+(0, node_test_1.test)("lo no facturable no cuenta como esfuerzo del proyecto", () => {
+    const interno = { ...entry("2026-08-10", 5, "feature/x"), billable: false };
+    strict_1.default.equal((0, index_js_1.effortByFeature)([interno], []).length, 0);
+});
+(0, node_test_1.test)("marca si la funcionalidad está integrada", () => {
+    const merged = new Set(["feature/hecha"]);
+    const features = (0, index_js_1.effortByFeature)([entry("2026-08-10", 1, "feature/hecha"), entry("2026-08-11", 1, "feature/abierta")], [], merged);
+    strict_1.default.equal(features.find((f) => f.branch === "feature/hecha").merged, true);
+    strict_1.default.equal(features.find((f) => f.branch === "feature/abierta").merged, false);
+});
+(0, node_test_1.test)("sin información de integración, no se afirma nada", () => {
+    // null no es false: decir "sin integrar" cuando no se sabe sería mentir
+    // sobre el estado del proyecto delante del cliente.
+    const features = (0, index_js_1.effortByFeature)([entry("2026-08-10", 1)], []);
+    strict_1.default.equal(features[0].merged, null);
+});
+// ── Ritmo ──────────────────────────────────────────────────────────────
+(0, node_test_1.test)("mide el hueco más largo sin actividad", () => {
+    const c = (0, index_js_1.cadence)([
+        entry("2026-08-01", 2), entry("2026-08-02", 2), entry("2026-08-10", 2),
+    ]);
+    strict_1.default.equal(c.activeDays, 3);
+    strict_1.default.equal(c.spanDays, 10);
+    strict_1.default.equal(c.longestGapDays, 7, "del 2 al 10 hay 7 días sin nada");
+});
+(0, node_test_1.test)("la mediana resiste un día atípico", () => {
+    // La media se dispara con una jornada de 12h y haría parecer que el ritmo
+    // habitual es otro. La mediana dice lo que pasa un día normal.
+    const c = (0, index_js_1.cadence)([
+        entry("2026-08-01", 2), entry("2026-08-02", 2),
+        entry("2026-08-03", 2), entry("2026-08-04", 12),
+    ]);
+    strict_1.default.equal(c.medianSecondsPerActiveDay, 2 * 3600);
+});
+(0, node_test_1.test)("sin trabajo, ritmo en cero y sin dividir por cero", () => {
+    const c = (0, index_js_1.cadence)([]);
+    strict_1.default.equal(c.activeDays, 0);
+    strict_1.default.equal(c.spanDays, 0);
+    strict_1.default.equal(c.medianSecondsPerActiveDay, 0);
+});
+// ── Reescritura ────────────────────────────────────────────────────────
+(0, node_test_1.test)("detecta un fichero que se toca una y otra vez", () => {
+    const commits = [
+        commit("2026-08-10", "f/a", ["Servicio.cs"]),
+        commit("2026-08-11", "f/a", ["Servicio.cs"]),
+        commit("2026-08-13", "f/a", ["Servicio.cs", "Otro.cs"]),
+    ];
+    const result = (0, index_js_1.churn)(commits, { minTouches: 3 });
+    strict_1.default.equal(result.length, 1);
+    strict_1.default.equal(result[0].file, "Servicio.cs");
+    strict_1.default.equal(result[0].touches, 3);
+});
+(0, node_test_1.test)("tocar un fichero con meses de diferencia no es reescritura", () => {
+    // Enero y agosto es mantenimiento normal. Llamarlo reescritura sería acusar
+    // al proyecto de un problema que no tiene.
+    const commits = [
+        commit("2026-01-10", "f/a", ["Viejo.cs"]),
+        commit("2026-05-10", "f/a", ["Viejo.cs"]),
+        commit("2026-08-10", "f/a", ["Viejo.cs"]),
+    ];
+    strict_1.default.equal((0, index_js_1.churn)(commits, { withinDays: 14, minTouches: 3 }).length, 0);
+});
+(0, node_test_1.test)("un fichero tocado dos veces no llega al umbral", () => {
+    const commits = [
+        commit("2026-08-10", "f/a", ["A.cs"]),
+        commit("2026-08-11", "f/a", ["A.cs"]),
+    ];
+    strict_1.default.equal((0, index_js_1.churn)(commits, { minTouches: 3 }).length, 0);
+});
+// ── Trabajo abierto ────────────────────────────────────────────────────
+(0, node_test_1.test)("lista las ramas sin integrar y su antigüedad", () => {
+    const hoy = new Date("2026-08-20T12:00:00Z");
+    const result = (0, index_js_1.openWork)([commit("2026-08-12", "feature/abierta", ["a.cs"]),
+        commit("2026-08-19", "feature/reciente", ["b.cs"]),
+        commit("2026-08-01", "feature/hecha", ["c.cs"])], new Set(["feature/hecha"]), hoy);
+    strict_1.default.equal(result.length, 2, "la integrada no aparece");
+    strict_1.default.equal(result[0].branch, "feature/abierta", "la más antigua primero");
+    strict_1.default.equal(result[0].ageDays, 8);
+    strict_1.default.equal(result[1].ageDays, 1);
+});
+(0, node_test_1.test)("sin ramas abiertas, lista vacía en vez de error", () => {
+    strict_1.default.deepEqual((0, index_js_1.openWork)([commit("2026-08-01", "main", ["a.cs"])], new Set(["main"])), []);
+});
+(0, node_test_1.test)("el trabajo sin rama se agrupa por su tipo, no como un hueco", () => {
+    // "sin rama" delante de un cliente es una pregunta incómoda sin buena
+    // respuesta. Una reunión no ocurre en ninguna rama: es una línea legítima.
+    const reunion = { ...entry("2026-08-10", 1.5, null), kind: "meeting" };
+    const viaje = { ...entry("2026-08-11", 2, null), id: "v", kind: "travel" };
+    const features = (0, index_js_1.effortByFeature)([reunion, viaje, entry("2026-08-12", 3)], []);
+    const nombres = features.map((f) => f.name);
+    strict_1.default.ok(nombres.includes("Reunión"));
+    strict_1.default.ok(nombres.includes("Desplazamiento"));
+    strict_1.default.ok(!nombres.some((n) => n.includes("sin rama")));
+});
+(0, node_test_1.test)("a un grupo por tipo no se le pregunta si está integrado", () => {
+    // "Reunión — en curso" no significa nada y confunde.
+    const reunion = { ...entry("2026-08-10", 1, null), kind: "meeting" };
+    const features = (0, index_js_1.effortByFeature)([reunion], [], new Set(["main"]));
+    strict_1.default.equal(features[0].merged, null);
+});
+(0, node_test_1.test)("desarrollo sin rama cae en un grupo general, no en 'otro'", () => {
+    const features = (0, index_js_1.effortByFeature)([entry("2026-08-10", 1, null)], []);
+    strict_1.default.equal(features[0].name, "Otro");
+});
+//# sourceMappingURL=metrics.test.js.map

package/dist/metrics/metrics.test.js.map

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

package/dist/metrics/people.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Quién es quién en un repositorio.
+ *
+ * Git no tiene identidades, tiene pares (nombre, correo) escritos a mano en
+ * cada máquina. En el repositorio de Accuro, una sola persona aparece así:
+ *
+ *   Denys Fonseca <denys.fonseca@accuro.es>    79 commits
+ *   Denys Fonseca <denys.fonseca@paipe.com>   134 commits
+ *   dfonseca      <denys.fonseca@accuro.es>    11 commits
+ *
+ * Agrupar por correo la parte en dos. Agrupar por nombre también. Una vista de
+ * equipo que enseñe a Denys tres veces no se la cree nadie, y con razón: si
+ * falla en lo que el lector puede comprobar de un vistazo, deja de creerse
+ * también lo que no puede comprobar.
+ *
+ * La regla: **dos identidades son la misma persona si comparten el correo, o si
+ * comparten un nombre que de verdad identifique a alguien**, y esa relación se
+ * propaga. Es el problema de las componentes conexas de un grafo, y resuelve el
+ * caso de arriba en un paso: `dfonseca` entra por el correo que comparte con
+ * `Denys Fonseca`, y arrastra consigo el segundo correo de esa persona.
+ *
+ * El matiz del nombre no es teórico. Unir por cualquier nombre fusionaba a dos
+ * compañeros distintos porque ambos habían commiteado alguna vez como "JD": un
+ * alias de dos letras hacía de puente entre `nx-jleon@` y `nx-jmoreira@`. Por
+ * eso solo une un nombre con apellido, y los alias sueltos se agrupan por
+ * correo, que es el vínculo fuerte.
+ *
+ * El sesgo es deliberado: ante la duda, partir antes que fundir. Una persona
+ * partida en dos filas se ve en pantalla y se entiende; dos personas fundidas
+ * atribuyen el trabajo de alguien a otro sin que nadie lo note.
+ */
+export interface AuthorRow {
+    readonly name: string;
+    readonly email: string;
+    readonly commits: number;
+}
+export interface Person {
+    /** Nombre para enseñar: el más humano de los que usa. */
+    readonly name: string;
+    readonly emails: readonly string[];
+    readonly names: readonly string[];
+    readonly commits: number;
+}
+/** Une identidades de git que pertenecen a la misma persona. */
+export declare function mergeIdentities(rows: readonly AuthorRow[]): Person[];
+//# sourceMappingURL=people.d.ts.map

package/dist/metrics/people.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"people.d.ts","sourceRoot":"","sources":["../../src/metrics/people.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,MAAM;IACrB,yDAAyD;IACzD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,gEAAgE;AAChE,wBAAgB,eAAe,CAAC,IAAI,EAAE,SAAS,SAAS,EAAE,GAAG,MAAM,EAAE,CAmDpE"}