@aida-dev/metrics 0.4.0 → 0.5.0

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { CommitStream, Commit } from '@aida-dev/core';
+import { Commit, CommitStream } from '@aida-dev/core';
 import { z } from 'zod';
 
 declare const Attribution: z.ZodObject<{
@@ -10,6 +10,38 @@ declare const Attribution: z.ZodObject<{
     defaultAttribution: z.ZodEnum<["ai", "human", "unknown"]>;
     coverageThreshold: z.ZodNumber;
     belowThreshold: z.ZodBoolean;
+    modes: z.ZodObject<{
+        none: z.ZodNumber;
+        autocomplete: z.ZodNumber;
+        assisted: z.ZodNumber;
+        agent: z.ZodNumber;
+        unknown: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        unknown: number;
+        none: number;
+        autocomplete: number;
+        assisted: number;
+        agent: number;
+    }, {
+        unknown: number;
+        none: number;
+        autocomplete: number;
+        assisted: number;
+        agent: number;
+    }>;
+    modeEvidence: z.ZodObject<{
+        declared: z.ZodNumber;
+        inferred: z.ZodNumber;
+        none: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        none: number;
+        declared: number;
+        inferred: number;
+    }, {
+        none: number;
+        declared: number;
+        inferred: number;
+    }>;
 }, "strip", z.ZodTypeAny, {
     ai: number;
     human: number;
@@ -19,6 +51,18 @@ declare const Attribution: z.ZodObject<{
     defaultAttribution: "ai" | "human" | "unknown";
     coverageThreshold: number;
     belowThreshold: boolean;
+    modes: {
+        unknown: number;
+        none: number;
+        autocomplete: number;
+        assisted: number;
+        agent: number;
+    };
+    modeEvidence: {
+        none: number;
+        declared: number;
+        inferred: number;
+    };
 }, {
     ai: number;
     human: number;
@@ -28,8 +72,125 @@ declare const Attribution: z.ZodObject<{
     defaultAttribution: "ai" | "human" | "unknown";
     coverageThreshold: number;
     belowThreshold: boolean;
+    modes: {
+        unknown: number;
+        none: number;
+        autocomplete: number;
+        assisted: number;
+        agent: number;
+    };
+    modeEvidence: {
+        none: number;
+        declared: number;
+        inferred: number;
+    };
 }>;
 type Attribution = z.infer<typeof Attribution>;
+declare const AgeStats: z.ZodObject<{
+    commits: z.ZodNumber;
+    avgAgeDays: z.ZodNumber;
+    medianAgeDays: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    commits: number;
+    avgAgeDays: number;
+    medianAgeDays: number;
+}, {
+    commits: number;
+    avgAgeDays: number;
+    medianAgeDays: number;
+}>;
+type AgeStats = z.infer<typeof AgeStats>;
+declare const FileCategory: z.ZodEnum<["source", "tests", "migrations", "config", "docs", "generated"]>;
+type FileCategory = z.infer<typeof FileCategory>;
+declare const CategoryCounts: z.ZodObject<{
+    source: z.ZodNumber;
+    tests: z.ZodNumber;
+    migrations: z.ZodNumber;
+    config: z.ZodNumber;
+    docs: z.ZodNumber;
+    generated: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    source: number;
+    tests: number;
+    migrations: number;
+    config: number;
+    docs: number;
+    generated: number;
+}, {
+    source: number;
+    tests: number;
+    migrations: number;
+    config: number;
+    docs: number;
+    generated: number;
+}>;
+type CategoryCounts = z.infer<typeof CategoryCounts>;
+declare const CohortContext: z.ZodObject<{
+    age: z.ZodNullable<z.ZodObject<{
+        commits: z.ZodNumber;
+        avgAgeDays: z.ZodNumber;
+        medianAgeDays: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        commits: number;
+        avgAgeDays: number;
+        medianAgeDays: number;
+    }, {
+        commits: number;
+        avgAgeDays: number;
+        medianAgeDays: number;
+    }>>;
+    taskMix: z.ZodNullable<z.ZodObject<{
+        source: z.ZodNumber;
+        tests: z.ZodNumber;
+        migrations: z.ZodNumber;
+        config: z.ZodNumber;
+        docs: z.ZodNumber;
+        generated: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        source: number;
+        tests: number;
+        migrations: number;
+        config: number;
+        docs: number;
+        generated: number;
+    }, {
+        source: number;
+        tests: number;
+        migrations: number;
+        config: number;
+        docs: number;
+        generated: number;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    age: {
+        commits: number;
+        avgAgeDays: number;
+        medianAgeDays: number;
+    } | null;
+    taskMix: {
+        source: number;
+        tests: number;
+        migrations: number;
+        config: number;
+        docs: number;
+        generated: number;
+    } | null;
+}, {
+    age: {
+        commits: number;
+        avgAgeDays: number;
+        medianAgeDays: number;
+    } | null;
+    taskMix: {
+        source: number;
+        tests: number;
+        migrations: number;
+        config: number;
+        docs: number;
+        generated: number;
+    } | null;
+}>;
+type CohortContext = z.infer<typeof CohortContext>;
 declare const MergeRatio: z.ZodObject<{
     aiCommitsTotal: z.ZodNumber;
     aiCommitsMerged: z.ZodNumber;
@@ -243,6 +404,38 @@ declare const Metrics: z.ZodObject<{
         defaultAttribution: z.ZodEnum<["ai", "human", "unknown"]>;
         coverageThreshold: z.ZodNumber;
         belowThreshold: z.ZodBoolean;
+        modes: z.ZodObject<{
+            none: z.ZodNumber;
+            autocomplete: z.ZodNumber;
+            assisted: z.ZodNumber;
+            agent: z.ZodNumber;
+            unknown: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            unknown: number;
+            none: number;
+            autocomplete: number;
+            assisted: number;
+            agent: number;
+        }, {
+            unknown: number;
+            none: number;
+            autocomplete: number;
+            assisted: number;
+            agent: number;
+        }>;
+        modeEvidence: z.ZodObject<{
+            declared: z.ZodNumber;
+            inferred: z.ZodNumber;
+            none: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            none: number;
+            declared: number;
+            inferred: number;
+        }, {
+            none: number;
+            declared: number;
+            inferred: number;
+        }>;
     }, "strip", z.ZodTypeAny, {
         ai: number;
         human: number;
@@ -252,6 +445,18 @@ declare const Metrics: z.ZodObject<{
         defaultAttribution: "ai" | "human" | "unknown";
         coverageThreshold: number;
         belowThreshold: boolean;
+        modes: {
+            unknown: number;
+            none: number;
+            autocomplete: number;
+            assisted: number;
+            agent: number;
+        };
+        modeEvidence: {
+            none: number;
+            declared: number;
+            inferred: number;
+        };
     }, {
         ai: number;
         human: number;
@@ -261,6 +466,18 @@ declare const Metrics: z.ZodObject<{
         defaultAttribution: "ai" | "human" | "unknown";
         coverageThreshold: number;
         belowThreshold: boolean;
+        modes: {
+            unknown: number;
+            none: number;
+            autocomplete: number;
+            assisted: number;
+            agent: number;
+        };
+        modeEvidence: {
+            none: number;
+            declared: number;
+            inferred: number;
+        };
     }>;
     mergeRatio: z.ZodObject<{
         aiCommitsTotal: z.ZodNumber;
@@ -321,6 +538,200 @@ declare const Metrics: z.ZodObject<{
             d90_plus: number;
         };
     }>;
+    cohorts: z.ZodObject<{
+        ai: z.ZodObject<{
+            age: z.ZodNullable<z.ZodObject<{
+                commits: z.ZodNumber;
+                avgAgeDays: z.ZodNumber;
+                medianAgeDays: z.ZodNumber;
+            }, "strip", z.ZodTypeAny, {
+                commits: number;
+                avgAgeDays: number;
+                medianAgeDays: number;
+            }, {
+                commits: number;
+                avgAgeDays: number;
+                medianAgeDays: number;
+            }>>;
+            taskMix: z.ZodNullable<z.ZodObject<{
+                source: z.ZodNumber;
+                tests: z.ZodNumber;
+                migrations: z.ZodNumber;
+                config: z.ZodNumber;
+                docs: z.ZodNumber;
+                generated: z.ZodNumber;
+            }, "strip", z.ZodTypeAny, {
+                source: number;
+                tests: number;
+                migrations: number;
+                config: number;
+                docs: number;
+                generated: number;
+            }, {
+                source: number;
+                tests: number;
+                migrations: number;
+                config: number;
+                docs: number;
+                generated: number;
+            }>>;
+        }, "strip", z.ZodTypeAny, {
+            age: {
+                commits: number;
+                avgAgeDays: number;
+                medianAgeDays: number;
+            } | null;
+            taskMix: {
+                source: number;
+                tests: number;
+                migrations: number;
+                config: number;
+                docs: number;
+                generated: number;
+            } | null;
+        }, {
+            age: {
+                commits: number;
+                avgAgeDays: number;
+                medianAgeDays: number;
+            } | null;
+            taskMix: {
+                source: number;
+                tests: number;
+                migrations: number;
+                config: number;
+                docs: number;
+                generated: number;
+            } | null;
+        }>;
+        baseline: z.ZodObject<{
+            age: z.ZodNullable<z.ZodObject<{
+                commits: z.ZodNumber;
+                avgAgeDays: z.ZodNumber;
+                medianAgeDays: z.ZodNumber;
+            }, "strip", z.ZodTypeAny, {
+                commits: number;
+                avgAgeDays: number;
+                medianAgeDays: number;
+            }, {
+                commits: number;
+                avgAgeDays: number;
+                medianAgeDays: number;
+            }>>;
+            taskMix: z.ZodNullable<z.ZodObject<{
+                source: z.ZodNumber;
+                tests: z.ZodNumber;
+                migrations: z.ZodNumber;
+                config: z.ZodNumber;
+                docs: z.ZodNumber;
+                generated: z.ZodNumber;
+            }, "strip", z.ZodTypeAny, {
+                source: number;
+                tests: number;
+                migrations: number;
+                config: number;
+                docs: number;
+                generated: number;
+            }, {
+                source: number;
+                tests: number;
+                migrations: number;
+                config: number;
+                docs: number;
+                generated: number;
+            }>>;
+        }, "strip", z.ZodTypeAny, {
+            age: {
+                commits: number;
+                avgAgeDays: number;
+                medianAgeDays: number;
+            } | null;
+            taskMix: {
+                source: number;
+                tests: number;
+                migrations: number;
+                config: number;
+                docs: number;
+                generated: number;
+            } | null;
+        }, {
+            age: {
+                commits: number;
+                avgAgeDays: number;
+                medianAgeDays: number;
+            } | null;
+            taskMix: {
+                source: number;
+                tests: number;
+                migrations: number;
+                config: number;
+                docs: number;
+                generated: number;
+            } | null;
+        }>;
+    }, "strip", z.ZodTypeAny, {
+        ai: {
+            age: {
+                commits: number;
+                avgAgeDays: number;
+                medianAgeDays: number;
+            } | null;
+            taskMix: {
+                source: number;
+                tests: number;
+                migrations: number;
+                config: number;
+                docs: number;
+                generated: number;
+            } | null;
+        };
+        baseline: {
+            age: {
+                commits: number;
+                avgAgeDays: number;
+                medianAgeDays: number;
+            } | null;
+            taskMix: {
+                source: number;
+                tests: number;
+                migrations: number;
+                config: number;
+                docs: number;
+                generated: number;
+            } | null;
+        };
+    }, {
+        ai: {
+            age: {
+                commits: number;
+                avgAgeDays: number;
+                medianAgeDays: number;
+            } | null;
+            taskMix: {
+                source: number;
+                tests: number;
+                migrations: number;
+                config: number;
+                docs: number;
+                generated: number;
+            } | null;
+        };
+        baseline: {
+            age: {
+                commits: number;
+                avgAgeDays: number;
+                medianAgeDays: number;
+            } | null;
+            taskMix: {
+                source: number;
+                tests: number;
+                migrations: number;
+                config: number;
+                docs: number;
+                generated: number;
+            } | null;
+        };
+    }>;
     baseline: z.ZodNullable<z.ZodObject<{
         assumed: z.ZodBoolean;
         mergeRatio: z.ZodObject<{
@@ -452,6 +863,18 @@ declare const Metrics: z.ZodObject<{
         defaultAttribution: "ai" | "human" | "unknown";
         coverageThreshold: number;
         belowThreshold: boolean;
+        modes: {
+            unknown: number;
+            none: number;
+            autocomplete: number;
+            assisted: number;
+            agent: number;
+        };
+        modeEvidence: {
+            none: number;
+            declared: number;
+            inferred: number;
+        };
     };
     mergeRatio: {
         aiCommitsTotal: number;
@@ -470,6 +893,38 @@ declare const Metrics: z.ZodObject<{
             d90_plus: number;
         };
     };
+    cohorts: {
+        ai: {
+            age: {
+                commits: number;
+                avgAgeDays: number;
+                medianAgeDays: number;
+            } | null;
+            taskMix: {
+                source: number;
+                tests: number;
+                migrations: number;
+                config: number;
+                docs: number;
+                generated: number;
+            } | null;
+        };
+        baseline: {
+            age: {
+                commits: number;
+                avgAgeDays: number;
+                medianAgeDays: number;
+            } | null;
+            taskMix: {
+                source: number;
+                tests: number;
+                migrations: number;
+                config: number;
+                docs: number;
+                generated: number;
+            } | null;
+        };
+    };
     baseline: {
         mergeRatio: {
             commitsTotal: number;
@@ -513,6 +968,18 @@ declare const Metrics: z.ZodObject<{
         defaultAttribution: "ai" | "human" | "unknown";
         coverageThreshold: number;
         belowThreshold: boolean;
+        modes: {
+            unknown: number;
+            none: number;
+            autocomplete: number;
+            assisted: number;
+            agent: number;
+        };
+        modeEvidence: {
+            none: number;
+            declared: number;
+            inferred: number;
+        };
     };
     mergeRatio: {
         aiCommitsTotal: number;
@@ -531,6 +998,38 @@ declare const Metrics: z.ZodObject<{
             d90_plus: number;
         };
     };
+    cohorts: {
+        ai: {
+            age: {
+                commits: number;
+                avgAgeDays: number;
+                medianAgeDays: number;
+            } | null;
+            taskMix: {
+                source: number;
+                tests: number;
+                migrations: number;
+                config: number;
+                docs: number;
+                generated: number;
+            } | null;
+        };
+        baseline: {
+            age: {
+                commits: number;
+                avgAgeDays: number;
+                medianAgeDays: number;
+            } | null;
+            taskMix: {
+                source: number;
+                tests: number;
+                migrations: number;
+                config: number;
+                docs: number;
+                generated: number;
+            } | null;
+        };
+    };
     baseline: {
         mergeRatio: {
             commitsTotal: number;
@@ -560,6 +1059,10 @@ declare const Metrics: z.ZodObject<{
 }>;
 type Metrics = z.infer<typeof Metrics>;
 
+declare function calculateAgeStats(commits: Commit[], now: Date): AgeStats | null;
+declare function categorizeFile(path: string): FileCategory;
+declare function calculateCategoryCounts(commits: Commit[]): CategoryCounts | null;
+
 declare function calculateMergeRatio(commitStream: CommitStream, isTarget?: (commit: Commit) => boolean): MergeRatio;
 declare function calculateBaselineMergeRatio(commitStream: CommitStream, isTarget?: (commit: Commit) => boolean): CohortMergeRatio;
 
@@ -572,4 +1075,4 @@ interface MetricsOptions {
 }
 declare function calculateMetrics(commitStream: CommitStream, options?: MetricsOptions): Metrics;
 
-export { Attribution, Baseline, CohortMergeRatio, Delta, MergeRatio, Metrics, type MetricsOptions, Persistence, calculateBaselineMergeRatio, calculateBaselinePersistence, calculateMergeRatio, calculateMetrics, calculatePersistence };
+export { AgeStats, Attribution, Baseline, CategoryCounts, CohortContext, CohortMergeRatio, Delta, FileCategory, MergeRatio, Metrics, type MetricsOptions, Persistence, calculateAgeStats, calculateBaselineMergeRatio, calculateBaselinePersistence, calculateCategoryCounts, calculateMergeRatio, calculateMetrics, calculatePersistence, categorizeFile };

package/dist/index.js

@@ -1,6 +1,63 @@
 // src/index.ts
 import { formatISODate } from "@aida-dev/core";
 
+// src/cohort.ts
+import { daysBetween } from "@aida-dev/core";
+function calculateAgeStats(commits, now) {
+  if (commits.length === 0) {
+    return null;
+  }
+  const ages = commits.map((commit) => daysBetween(new Date(commit.authorDate), now)).sort((a, b) => a - b);
+  const avg = ages.reduce((sum, days) => sum + days, 0) / ages.length;
+  const median = ages.length % 2 === 0 ? (ages[ages.length / 2 - 1] + ages[ages.length / 2]) / 2 : ages[Math.floor(ages.length / 2)];
+  return {
+    commits: commits.length,
+    avgAgeDays: Math.round(avg * 100) / 100,
+    medianAgeDays: Math.round(median * 100) / 100
+  };
+}
+function categorizeFile(path) {
+  const lower = path.toLowerCase();
+  const base = lower.split("/").pop() ?? lower;
+  if (/^(pnpm-lock\.yaml|package-lock\.json|yarn\.lock|bun\.lockb?|composer\.lock|cargo\.lock|gemfile\.lock|poetry\.lock|changelog(\.[a-z]+)?)$/.test(
+    base
+  ) || /\.(snap|min\.js|min\.css)$/.test(base) || /(^|\/)(dist|build|out|coverage|\.next|node_modules)\//.test(lower)) {
+    return "generated";
+  }
+  if (/(^|\/)(__tests__|__mocks__|tests?|spec|e2e|cypress)\//.test(lower) || /\.(test|spec)\.[a-z]+$/.test(base)) {
+    return "tests";
+  }
+  if (/(^|\/)migrations?\//.test(lower)) {
+    return "migrations";
+  }
+  if (/\.(md|mdx|rst|adoc|txt)$/.test(base) || /(^|\/)docs?\//.test(lower)) {
+    return "docs";
+  }
+  if (base.startsWith(".") || /\.(json|ya?ml|toml|ini|cfg|conf|env|properties)$/.test(base) || /\.config\.[a-z]+$/.test(base) || /(^|\/)(\.github|\.circleci|\.vscode|config)\//.test(lower) || /^(dockerfile|makefile|tsconfig.*|eslint.*|prettier.*)/.test(base)) {
+    return "config";
+  }
+  return "source";
+}
+function calculateCategoryCounts(commits) {
+  if (commits.length === 0) {
+    return null;
+  }
+  const counts = {
+    source: 0,
+    tests: 0,
+    migrations: 0,
+    config: 0,
+    docs: 0,
+    generated: 0
+  };
+  for (const commit of commits) {
+    for (const file of commit.stats.files) {
+      counts[categorizeFile(file.path)]++;
+    }
+  }
+  return counts;
+}
+
 // src/merge-ratio.ts
 function computeMergeRatio(commits) {
   const merged = commits.filter((commit) => commit.inDefaultBranchAncestry);
@@ -25,7 +82,7 @@ function calculateBaselineMergeRatio(commitStream, isTarget = (commit) => commit
 }
 
 // src/persistence.ts
-import { daysBetween } from "@aida-dev/core";
+import { daysBetween as daysBetween2 } from "@aida-dev/core";
 function calculatePersistence(commitStream, isTarget = (commit) => commit.tags.attribution === "ai") {
   const targetCommits = commitStream.commits.filter(isTarget);
   if (targetCommits.length === 0) {
@@ -74,7 +131,7 @@ function calculatePersistence(commitStream, isTarget = (commit) => commit.tags.a
   }
   const persistenceDays = [];
   for (const lifecycle of fileLifecycles.values()) {
-    lifecycle.persistenceDays = daysBetween(lifecycle.firstTargetCommitDate, lifecycle.lastSeenDate);
+    lifecycle.persistenceDays = daysBetween2(lifecycle.firstTargetCommitDate, lifecycle.lastSeenDate);
     persistenceDays.push(lifecycle.persistenceDays);
   }
   const avgDays = persistenceDays.length > 0 ? persistenceDays.reduce((sum, days) => sum + days, 0) / persistenceDays.length : 0;
@@ -111,7 +168,20 @@ var Attribution = z.object({
   defaultAttribution: z.enum(["ai", "human", "unknown"]),
   // prior applied to unknown commits
   coverageThreshold: z.number().min(0).max(1),
-  belowThreshold: z.boolean()
+  belowThreshold: z.boolean(),
+  // Autonomy axis (#25): commit counts per mode and per mode-evidence level
+  modes: z.object({
+    none: z.number().int().nonnegative(),
+    autocomplete: z.number().int().nonnegative(),
+    assisted: z.number().int().nonnegative(),
+    agent: z.number().int().nonnegative(),
+    unknown: z.number().int().nonnegative()
+  }),
+  modeEvidence: z.object({
+    declared: z.number().int().nonnegative(),
+    inferred: z.number().int().nonnegative(),
+    none: z.number().int().nonnegative()
+  })
 });
 var MergeRatio = z.object({
   aiCommitsTotal: z.number().int().nonnegative(),
@@ -130,6 +200,31 @@ var Persistence = z.object({
     d90_plus: z.number().int().nonnegative()
   })
 });
+var AgeStats = z.object({
+  commits: z.number().int().nonnegative(),
+  avgAgeDays: z.number().nonnegative(),
+  medianAgeDays: z.number().nonnegative()
+});
+var FileCategory = z.enum([
+  "source",
+  "tests",
+  "migrations",
+  "config",
+  "docs",
+  "generated"
+]);
+var CategoryCounts = z.object({
+  source: z.number().int().nonnegative(),
+  tests: z.number().int().nonnegative(),
+  migrations: z.number().int().nonnegative(),
+  config: z.number().int().nonnegative(),
+  docs: z.number().int().nonnegative(),
+  generated: z.number().int().nonnegative()
+});
+var CohortContext = z.object({
+  age: AgeStats.nullable(),
+  taskMix: CategoryCounts.nullable()
+});
 var CohortMergeRatio = z.object({
   commitsTotal: z.number().int().nonnegative(),
   commitsMerged: z.number().int().nonnegative(),
@@ -158,6 +253,12 @@ var Metrics = z.object({
   attribution: Attribution,
   mergeRatio: MergeRatio,
   persistence: Persistence,
+  // Fairness context (#29, #36): age and task mix per cohort, so consumers
+  // can judge whether the AI-vs-baseline comparison is apples-to-apples.
+  cohorts: z.object({
+    ai: CohortContext,
+    baseline: CohortContext
+  }),
   // Null when no commit is attributed 'human' and no defaultAttribution prior
   // assigns the unknowns: AIDA does not invent a comparison cohort.
   baseline: Baseline.nullable(),
@@ -173,8 +274,12 @@ function round(value, decimals) {
 function calculateMetrics(commitStream, options = {}) {
   const { defaultAttribution = "unknown", coverageThreshold = 0.7 } = options;
   const counts = { ai: 0, human: 0, unknown: 0 };
+  const modes = { none: 0, autocomplete: 0, assisted: 0, agent: 0, unknown: 0 };
+  const modeEvidence = { declared: 0, inferred: 0, none: 0 };
   for (const commit of commitStream.commits) {
     counts[commit.tags.attribution]++;
+    modes[commit.tags.mode]++;
+    modeEvidence[commit.tags.modeEvidence]++;
   }
   const total = commitStream.commits.length;
   const coverage = total > 0 ? (counts.ai + counts.human) / total : 0;
@@ -186,13 +291,29 @@ function calculateMetrics(commitStream, options = {}) {
     coverage: round(coverage, 4),
     defaultAttribution,
     coverageThreshold,
-    belowThreshold: coverage < coverageThreshold
+    belowThreshold: coverage < coverageThreshold,
+    modes,
+    modeEvidence
   };
-  const isAI = (commit) => commit.tags.attribution === "ai" || defaultAttribution === "ai" && commit.tags.attribution === "unknown";
-  const isBaseline = (commit) => commit.tags.attribution === "human" || defaultAttribution === "human" && commit.tags.attribution === "unknown";
+  const isExcluded = (commit) => commit.tags.sources.includes("manifest:excluded");
+  const isAI = (commit) => commit.tags.attribution === "ai" || defaultAttribution === "ai" && commit.tags.attribution === "unknown" && !isExcluded(commit);
+  const isBaseline = (commit) => commit.tags.attribution === "human" || defaultAttribution === "human" && commit.tags.attribution === "unknown" && !isExcluded(commit);
   const mergeRatio = calculateMergeRatio(commitStream, isAI);
   const persistence = calculatePersistence(commitStream, isAI);
-  const baselineSize = commitStream.commits.filter(isBaseline).length;
+  const now = /* @__PURE__ */ new Date();
+  const aiCommits = commitStream.commits.filter(isAI);
+  const baselineCommits = commitStream.commits.filter(isBaseline);
+  const cohorts = {
+    ai: {
+      age: calculateAgeStats(aiCommits, now),
+      taskMix: calculateCategoryCounts(aiCommits)
+    },
+    baseline: {
+      age: calculateAgeStats(baselineCommits, now),
+      taskMix: calculateCategoryCounts(baselineCommits)
+    }
+  };
+  const baselineSize = baselineCommits.length;
   const baselineAssumed = defaultAttribution === "human" && counts.unknown > 0;
   const baseline = baselineSize > 0 ? {
     assumed: baselineAssumed,
@@ -210,6 +331,7 @@ function calculateMetrics(commitStream, options = {}) {
   const caveats = [
     `Attribution coverage is ${(coverage * 100).toFixed(1)}%: metrics only describe commits whose provenance is known.`,
     "Persistence is file-level, not line-level.",
+    "Persistence comparisons are only meaningful between cohorts of similar age and task mix \u2014 check the cohorts section before reading the delta.",
     "Merge ratio: commits from all branches checked against default branch ancestry. Squash merges may undercount unmerged commits.",
     "Time-windowed collection (--since) also windows the ancestry check: commits merged into the default branch before the window may appear unmerged.",
     "AI tagging uses heuristic patterns; false positives/negatives possible."
@@ -235,23 +357,31 @@ function calculateMetrics(commitStream, options = {}) {
     attribution,
     mergeRatio,
     persistence,
+    cohorts,
     baseline,
     delta,
     caveats
   };
 }
 export {
+  AgeStats,
   Attribution,
   Baseline,
+  CategoryCounts,
+  CohortContext,
   CohortMergeRatio,
   Delta,
+  FileCategory,
   MergeRatio,
   Metrics,
   Persistence,
+  calculateAgeStats,
   calculateBaselineMergeRatio,
   calculateBaselinePersistence,
+  calculateCategoryCounts,
   calculateMergeRatio,
   calculateMetrics,
-  calculatePersistence
+  calculatePersistence,
+  categorizeFile
 };
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/merge-ratio.ts","../src/persistence.ts","../src/schema/metrics.ts"],"sourcesContent":["import { Commit, CommitStream, formatISODate } from '@aida-dev/core';\nimport { calculateBaselineMergeRatio, calculateMergeRatio } from './merge-ratio.js';\nimport { calculateBaselinePersistence, calculatePersistence } from './persistence.js';\nimport { Attribution, Metrics } from './schema/metrics.js';\n\nexport * from './schema/metrics.js';\nexport * from './merge-ratio.js';\nexport * from './persistence.js';\n\nexport interface MetricsOptions {\n  // Prior applied to 'unknown' commits: which cohort (if any) they join.\n  defaultAttribution?: 'ai' | 'human' | 'unknown';\n  coverageThreshold?: number;\n}\n\nfunction round(value: number, decimals: number): number {\n  const factor = 10 ** decimals;\n  return Math.round(value * factor) / factor;\n}\n\nexport function calculateMetrics(\n  commitStream: CommitStream,\n  options: MetricsOptions = {}\n): Metrics {\n  const { defaultAttribution = 'unknown', coverageThreshold = 0.7 } = options;\n\n  const counts = { ai: 0, human: 0, unknown: 0 };\n  for (const commit of commitStream.commits) {\n    counts[commit.tags.attribution]++;\n  }\n  const total = commitStream.commits.length;\n  const coverage = total > 0 ? (counts.ai + counts.human) / total : 0;\n\n  const attribution: Attribution = {\n    commitsTotal: total,\n    ai: counts.ai,\n    human: counts.human,\n    unknown: counts.unknown,\n    coverage: round(coverage, 4),\n    defaultAttribution,\n    coverageThreshold,\n    belowThreshold: coverage < coverageThreshold,\n  };\n\n  // Cohort membership: unknown commits join a cohort only via the prior.\n  const isAI = (commit: Commit) =>\n    commit.tags.attribution === 'ai' ||\n    (defaultAttribution === 'ai' && commit.tags.attribution === 'unknown');\n  const isBaseline = (commit: Commit) =>\n    commit.tags.attribution === 'human' ||\n    (defaultAttribution === 'human' && commit.tags.attribution === 'unknown');\n\n  const mergeRatio = calculateMergeRatio(commitStream, isAI);\n  const persistence = calculatePersistence(commitStream, isAI);\n\n  // No baseline cohort → no baseline, no delta. AIDA does not invent a\n  // comparison out of unattributed commits.\n  const baselineSize = commitStream.commits.filter(isBaseline).length;\n  const baselineAssumed = defaultAttribution === 'human' && counts.unknown > 0;\n\n  const baseline =\n    baselineSize > 0\n      ? {\n          assumed: baselineAssumed,\n          mergeRatio: calculateBaselineMergeRatio(commitStream, isBaseline),\n          persistence: calculateBaselinePersistence(commitStream, isBaseline),\n        }\n      : null;\n\n  const delta = baseline\n    ? {\n        mergeRatio: round(mergeRatio.mergeRatio - baseline.mergeRatio.mergeRatio, 4),\n        avgPersistenceDays: round(persistence.avgDays - baseline.persistence.avgDays, 2),\n        medianPersistenceDays: round(\n          persistence.medianDays - baseline.persistence.medianDays,\n          2\n        ),\n      }\n    : null;\n\n  const caveats = [\n    `Attribution coverage is ${(coverage * 100).toFixed(1)}%: metrics only describe commits whose provenance is known.`,\n    'Persistence is file-level, not line-level.',\n    'Merge ratio: commits from all branches checked against default branch ancestry. Squash merges may undercount unmerged commits.',\n    'Time-windowed collection (--since) also windows the ancestry check: commits merged into the default branch before the window may appear unmerged.',\n    'AI tagging uses heuristic patterns; false positives/negatives possible.',\n  ];\n  if (baseline?.assumed) {\n    caveats.push(\n      `Baseline includes ${counts.unknown} unattributed commit(s) assumed human via defaultAttribution — undetected AI usage may leak into it.`\n    );\n  }\n  if (!baseline) {\n    caveats.push(\n      'No baseline: no commits are attributed as human. Set defaultAttribution to \"human\" in .aida.json if unattributed commits in this repo are human-authored.'\n    );\n  }\n\n  return {\n    generatedAt: formatISODate(new Date()),\n    window: {\n      since: commitStream.since,\n      until: commitStream.until,\n    },\n    repoPath: commitStream.repoPath,\n    defaultBranch: commitStream.defaultBranch,\n    attribution,\n    mergeRatio,\n    persistence,\n    baseline,\n    delta,\n    caveats,\n  };\n}\n","import { Commit, CommitStream } from '@aida-dev/core';\nimport { CohortMergeRatio, MergeRatio } from './schema/metrics.js';\n\nfunction computeMergeRatio(commits: Commit[]): CohortMergeRatio {\n  const merged = commits.filter((commit) => commit.inDefaultBranchAncestry);\n\n  return {\n    commitsTotal: commits.length,\n    commitsMerged: merged.length,\n    mergeRatio: commits.length > 0 ? merged.length / commits.length : 0,\n  };\n}\n\nexport function calculateMergeRatio(\n  commitStream: CommitStream,\n  isTarget: (commit: Commit) => boolean = (commit) => commit.tags.attribution === 'ai'\n): MergeRatio {\n  const aiCommits = commitStream.commits.filter(isTarget);\n  const result = computeMergeRatio(aiCommits);\n\n  return {\n    aiCommitsTotal: result.commitsTotal,\n    aiCommitsMerged: result.commitsMerged,\n    mergeRatio: result.mergeRatio,\n  };\n}\n\nexport function calculateBaselineMergeRatio(\n  commitStream: CommitStream,\n  isTarget: (commit: Commit) => boolean = (commit) => commit.tags.attribution === 'human'\n): CohortMergeRatio {\n  const baselineCommits = commitStream.commits.filter(isTarget);\n  return computeMergeRatio(baselineCommits);\n}\n","import { Commit, CommitStream, daysBetween } from '@aida-dev/core';\nimport { Persistence } from './schema/metrics.js';\n\ninterface FileLifecycle {\n  path: string;\n  firstTargetCommitDate: Date;\n  lastSeenDate: Date;\n  persistenceDays: number;\n}\n\nexport function calculatePersistence(\n  commitStream: CommitStream,\n  isTarget: (commit: Commit) => boolean = (commit) => commit.tags.attribution === 'ai'\n): Persistence {\n  const targetCommits = commitStream.commits.filter(isTarget);\n\n  if (targetCommits.length === 0) {\n    return {\n      commitsConsidered: 0,\n      avgDays: 0,\n      medianDays: 0,\n      buckets: {\n        d0_1: 0,\n        d2_7: 0,\n        d8_30: 0,\n        d31_90: 0,\n        d90_plus: 0,\n      },\n    };\n  }\n\n  // Group files by path and track their lifecycle\n  const fileLifecycles = new Map<string, FileLifecycle>();\n\n  // Sort commits by date (oldest first)\n  const sortedCommits = [...commitStream.commits].sort(\n    (a, b) => new Date(a.authorDate).getTime() - new Date(b.authorDate).getTime()\n  );\n\n  // Track first target commit per file\n  for (const commit of sortedCommits) {\n    if (isTarget(commit)) {\n      const commitDate = new Date(commit.authorDate);\n\n      for (const file of commit.stats.files) {\n        if (!fileLifecycles.has(file.path)) {\n          fileLifecycles.set(file.path, {\n            path: file.path,\n            firstTargetCommitDate: commitDate,\n            lastSeenDate: commitDate,\n            persistenceDays: 0,\n          });\n        }\n      }\n    }\n  }\n\n  // Track last seen date for each file\n  for (const commit of sortedCommits) {\n    const commitDate = new Date(commit.authorDate);\n\n    for (const file of commit.stats.files) {\n      const lifecycle = fileLifecycles.get(file.path);\n      if (lifecycle) {\n        // Update last seen date if file is not deleted\n        if (file.status !== 'deleted') {\n          lifecycle.lastSeenDate = commitDate;\n        }\n      }\n    }\n  }\n\n  // Calculate persistence days for each file\n  const persistenceDays: number[] = [];\n\n  for (const lifecycle of fileLifecycles.values()) {\n    lifecycle.persistenceDays = daysBetween(lifecycle.firstTargetCommitDate, lifecycle.lastSeenDate);\n    persistenceDays.push(lifecycle.persistenceDays);\n  }\n\n  // Calculate statistics\n  const avgDays =\n    persistenceDays.length > 0\n      ? persistenceDays.reduce((sum, days) => sum + days, 0) / persistenceDays.length\n      : 0;\n\n  const sortedDays = [...persistenceDays].sort((a, b) => a - b);\n  const medianDays =\n    sortedDays.length > 0\n      ? sortedDays.length % 2 === 0\n        ? (sortedDays[sortedDays.length / 2 - 1] + sortedDays[sortedDays.length / 2]) / 2\n        : sortedDays[Math.floor(sortedDays.length / 2)]\n      : 0;\n\n  // Calculate buckets\n  const buckets = {\n    d0_1: persistenceDays.filter((days) => days <= 1).length,\n    d2_7: persistenceDays.filter((days) => days >= 2 && days <= 7).length,\n    d8_30: persistenceDays.filter((days) => days >= 8 && days <= 30).length,\n    d31_90: persistenceDays.filter((days) => days >= 31 && days <= 90).length,\n    d90_plus: persistenceDays.filter((days) => days > 90).length,\n  };\n\n  return {\n    commitsConsidered: targetCommits.length,\n    avgDays: Math.round(avgDays * 100) / 100, // Round to 2 decimal places\n    medianDays: Math.round(medianDays * 100) / 100,\n    buckets,\n  };\n}\n\nexport function calculateBaselinePersistence(\n  commitStream: CommitStream,\n  isTarget: (commit: Commit) => boolean = (commit) => commit.tags.attribution === 'human'\n): Persistence {\n  return calculatePersistence(commitStream, isTarget);\n}\n","import { z } from 'zod';\n\n// Attribution coverage (#34): the headline metric. Every other number in this\n// file is only as trustworthy as this block says it is.\nexport const Attribution = z.object({\n  commitsTotal: z.number().int().nonnegative(),\n  ai: z.number().int().nonnegative(),\n  human: z.number().int().nonnegative(),\n  unknown: z.number().int().nonnegative(),\n  coverage: z.number().min(0).max(1), // (ai + human) / total\n  defaultAttribution: z.enum(['ai', 'human', 'unknown']), // prior applied to unknown commits\n  coverageThreshold: z.number().min(0).max(1),\n  belowThreshold: z.boolean(),\n});\n\nexport const MergeRatio = z.object({\n  aiCommitsTotal: z.number().int().nonnegative(),\n  aiCommitsMerged: z.number().int().nonnegative(),\n  mergeRatio: z.number().min(0).max(1),\n});\n\nexport const Persistence = z.object({\n  commitsConsidered: z.number().int().nonnegative(),\n  avgDays: z.number().nonnegative(),\n  medianDays: z.number().nonnegative(),\n  buckets: z.object({\n    d0_1: z.number().int().nonnegative(),\n    d2_7: z.number().int().nonnegative(),\n    d8_30: z.number().int().nonnegative(),\n    d31_90: z.number().int().nonnegative(),\n    d90_plus: z.number().int().nonnegative(),\n  }),\n});\n\nexport const CohortMergeRatio = z.object({\n  commitsTotal: z.number().int().nonnegative(),\n  commitsMerged: z.number().int().nonnegative(),\n  mergeRatio: z.number().min(0).max(1),\n});\n\nexport const Baseline = z.object({\n  // True when the cohort includes 'unknown' commits via defaultAttribution:\n  // the baseline is an assumption, not observed attribution.\n  assumed: z.boolean(),\n  mergeRatio: CohortMergeRatio,\n  persistence: Persistence,\n});\n\nexport const Delta = z.object({\n  mergeRatio: z.number(),\n  avgPersistenceDays: z.number(),\n  medianPersistenceDays: z.number(),\n});\n\nexport const Metrics = z.object({\n  generatedAt: z.string().datetime(),\n  window: z.object({\n    since: z.string().optional(),\n    until: z.string().optional(),\n  }),\n  repoPath: z.string(),\n  defaultBranch: z.string(),\n  attribution: Attribution,\n  mergeRatio: MergeRatio,\n  persistence: Persistence,\n  // Null when no commit is attributed 'human' and no defaultAttribution prior\n  // assigns the unknowns: AIDA does not invent a comparison cohort.\n  baseline: Baseline.nullable(),\n  delta: Delta.nullable(),\n  caveats: z.array(z.string()),\n});\n\nexport type Attribution = z.infer<typeof Attribution>;\nexport type MergeRatio = z.infer<typeof MergeRatio>;\nexport type Persistence = z.infer<typeof Persistence>;\nexport type CohortMergeRatio = z.infer<typeof CohortMergeRatio>;\nexport type Baseline = z.infer<typeof Baseline>;\nexport type Delta = z.infer<typeof Delta>;\nexport type Metrics = z.infer<typeof Metrics>;\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/index.ts","../src/cohort.ts","../src/merge-ratio.ts","../src/persistence.ts","../src/schema/metrics.ts"],"sourcesContent":["import { Commit, CommitStream, formatISODate } from '@aida-dev/core';\nimport { calculateAgeStats, calculateCategoryCounts } from './cohort.js';\nimport { calculateBaselineMergeRatio, calculateMergeRatio } from './merge-ratio.js';\nimport { calculateBaselinePersistence, calculatePersistence } from './persistence.js';\nimport { Attribution, Metrics } from './schema/metrics.js';\n\nexport * from './schema/metrics.js';\nexport * from './cohort.js';\nexport * from './merge-ratio.js';\nexport * from './persistence.js';\n\nexport interface MetricsOptions {\n  // Prior applied to 'unknown' commits: which cohort (if any) they join.\n  defaultAttribution?: 'ai' | 'human' | 'unknown';\n  coverageThreshold?: number;\n}\n\nfunction round(value: number, decimals: number): number {\n  const factor = 10 ** decimals;\n  return Math.round(value * factor) / factor;\n}\n\nexport function calculateMetrics(\n  commitStream: CommitStream,\n  options: MetricsOptions = {}\n): Metrics {\n  const { defaultAttribution = 'unknown', coverageThreshold = 0.7 } = options;\n\n  const counts = { ai: 0, human: 0, unknown: 0 };\n  const modes = { none: 0, autocomplete: 0, assisted: 0, agent: 0, unknown: 0 };\n  const modeEvidence = { declared: 0, inferred: 0, none: 0 };\n  for (const commit of commitStream.commits) {\n    counts[commit.tags.attribution]++;\n    modes[commit.tags.mode]++;\n    modeEvidence[commit.tags.modeEvidence]++;\n  }\n  const total = commitStream.commits.length;\n  const coverage = total > 0 ? (counts.ai + counts.human) / total : 0;\n\n  const attribution: Attribution = {\n    commitsTotal: total,\n    ai: counts.ai,\n    human: counts.human,\n    unknown: counts.unknown,\n    coverage: round(coverage, 4),\n    defaultAttribution,\n    coverageThreshold,\n    belowThreshold: coverage < coverageThreshold,\n    modes,\n    modeEvidence,\n  };\n\n  // Cohort membership: unknown commits join a cohort only via the prior.\n  // Manifest-excluded commits (release bots, merges) never do — they were\n  // excluded precisely to stay out of both cohorts.\n  const isExcluded = (commit: Commit) => commit.tags.sources.includes('manifest:excluded');\n  const isAI = (commit: Commit) =>\n    commit.tags.attribution === 'ai' ||\n    (defaultAttribution === 'ai' && commit.tags.attribution === 'unknown' && !isExcluded(commit));\n  const isBaseline = (commit: Commit) =>\n    commit.tags.attribution === 'human' ||\n    (defaultAttribution === 'human' &&\n      commit.tags.attribution === 'unknown' &&\n      !isExcluded(commit));\n\n  const mergeRatio = calculateMergeRatio(commitStream, isAI);\n  const persistence = calculatePersistence(commitStream, isAI);\n\n  // Fairness context (#29, #36): cohort age and task mix\n  const now = new Date();\n  const aiCommits = commitStream.commits.filter(isAI);\n  const baselineCommits = commitStream.commits.filter(isBaseline);\n  const cohorts = {\n    ai: {\n      age: calculateAgeStats(aiCommits, now),\n      taskMix: calculateCategoryCounts(aiCommits),\n    },\n    baseline: {\n      age: calculateAgeStats(baselineCommits, now),\n      taskMix: calculateCategoryCounts(baselineCommits),\n    },\n  };\n\n  // No baseline cohort → no baseline, no delta. AIDA does not invent a\n  // comparison out of unattributed commits.\n  const baselineSize = baselineCommits.length;\n  const baselineAssumed = defaultAttribution === 'human' && counts.unknown > 0;\n\n  const baseline =\n    baselineSize > 0\n      ? {\n          assumed: baselineAssumed,\n          mergeRatio: calculateBaselineMergeRatio(commitStream, isBaseline),\n          persistence: calculateBaselinePersistence(commitStream, isBaseline),\n        }\n      : null;\n\n  const delta = baseline\n    ? {\n        mergeRatio: round(mergeRatio.mergeRatio - baseline.mergeRatio.mergeRatio, 4),\n        avgPersistenceDays: round(persistence.avgDays - baseline.persistence.avgDays, 2),\n        medianPersistenceDays: round(\n          persistence.medianDays - baseline.persistence.medianDays,\n          2\n        ),\n      }\n    : null;\n\n  const caveats = [\n    `Attribution coverage is ${(coverage * 100).toFixed(1)}%: metrics only describe commits whose provenance is known.`,\n    'Persistence is file-level, not line-level.',\n    'Persistence comparisons are only meaningful between cohorts of similar age and task mix — check the cohorts section before reading the delta.',\n    'Merge ratio: commits from all branches checked against default branch ancestry. Squash merges may undercount unmerged commits.',\n    'Time-windowed collection (--since) also windows the ancestry check: commits merged into the default branch before the window may appear unmerged.',\n    'AI tagging uses heuristic patterns; false positives/negatives possible.',\n  ];\n  if (baseline?.assumed) {\n    caveats.push(\n      `Baseline includes ${counts.unknown} unattributed commit(s) assumed human via defaultAttribution — undetected AI usage may leak into it.`\n    );\n  }\n  if (!baseline) {\n    caveats.push(\n      'No baseline: no commits are attributed as human. Set defaultAttribution to \"human\" in .aida.json if unattributed commits in this repo are human-authored.'\n    );\n  }\n\n  return {\n    generatedAt: formatISODate(new Date()),\n    window: {\n      since: commitStream.since,\n      until: commitStream.until,\n    },\n    repoPath: commitStream.repoPath,\n    defaultBranch: commitStream.defaultBranch,\n    attribution,\n    mergeRatio,\n    persistence,\n    cohorts,\n    baseline,\n    delta,\n    caveats,\n  };\n}\n","import { Commit, daysBetween } from '@aida-dev/core';\nimport { AgeStats, CategoryCounts, FileCategory } from './schema/metrics.js';\n\n// Cohort age (#29): persistence comparisons between cohorts of different\n// ages are misleading — old commits have had more time to accumulate\n// survival. Reporting each cohort's age lets consumers judge fairness.\nexport function calculateAgeStats(commits: Commit[], now: Date): AgeStats | null {\n  if (commits.length === 0) {\n    return null;\n  }\n\n  const ages = commits\n    .map((commit) => daysBetween(new Date(commit.authorDate), now))\n    .sort((a, b) => a - b);\n\n  const avg = ages.reduce((sum, days) => sum + days, 0) / ages.length;\n  const median =\n    ages.length % 2 === 0\n      ? (ages[ages.length / 2 - 1] + ages[ages.length / 2]) / 2\n      : ages[Math.floor(ages.length / 2)];\n\n  return {\n    commits: commits.length,\n    avgAgeDays: Math.round(avg * 100) / 100,\n    medianAgeDays: Math.round(median * 100) / 100,\n  };\n}\n\n// File categorization (#36, step 1): AI is often pointed at boilerplate,\n// tests, and migrations, which survive longer because nobody touches them.\n// Reporting each cohort's category mix shows when an AI-vs-baseline\n// comparison is apples-to-oranges. Order matters: first match wins.\nexport function categorizeFile(path: string): FileCategory {\n  const lower = path.toLowerCase();\n  const base = lower.split('/').pop() ?? lower;\n\n  // Generated artifacts (lockfiles, changelogs, snapshots, build output)\n  if (\n    /^(pnpm-lock\\.yaml|package-lock\\.json|yarn\\.lock|bun\\.lockb?|composer\\.lock|cargo\\.lock|gemfile\\.lock|poetry\\.lock|changelog(\\.[a-z]+)?)$/.test(\n      base\n    ) ||\n    /\\.(snap|min\\.js|min\\.css)$/.test(base) ||\n    /(^|\\/)(dist|build|out|coverage|\\.next|node_modules)\\//.test(lower)\n  ) {\n    return 'generated';\n  }\n\n  if (\n    /(^|\\/)(__tests__|__mocks__|tests?|spec|e2e|cypress)\\//.test(lower) ||\n    /\\.(test|spec)\\.[a-z]+$/.test(base)\n  ) {\n    return 'tests';\n  }\n\n  if (/(^|\\/)migrations?\\//.test(lower)) {\n    return 'migrations';\n  }\n\n  if (/\\.(md|mdx|rst|adoc|txt)$/.test(base) || /(^|\\/)docs?\\//.test(lower)) {\n    return 'docs';\n  }\n\n  if (\n    base.startsWith('.') ||\n    /\\.(json|ya?ml|toml|ini|cfg|conf|env|properties)$/.test(base) ||\n    /\\.config\\.[a-z]+$/.test(base) ||\n    /(^|\\/)(\\.github|\\.circleci|\\.vscode|config)\\//.test(lower) ||\n    /^(dockerfile|makefile|tsconfig.*|eslint.*|prettier.*)/.test(base)\n  ) {\n    return 'config';\n  }\n\n  return 'source';\n}\n\nexport function calculateCategoryCounts(commits: Commit[]): CategoryCounts | null {\n  if (commits.length === 0) {\n    return null;\n  }\n\n  const counts: CategoryCounts = {\n    source: 0,\n    tests: 0,\n    migrations: 0,\n    config: 0,\n    docs: 0,\n    generated: 0,\n  };\n\n  for (const commit of commits) {\n    for (const file of commit.stats.files) {\n      counts[categorizeFile(file.path)]++;\n    }\n  }\n\n  return counts;\n}\n","import { Commit, CommitStream } from '@aida-dev/core';\nimport { CohortMergeRatio, MergeRatio } from './schema/metrics.js';\n\nfunction computeMergeRatio(commits: Commit[]): CohortMergeRatio {\n  const merged = commits.filter((commit) => commit.inDefaultBranchAncestry);\n\n  return {\n    commitsTotal: commits.length,\n    commitsMerged: merged.length,\n    mergeRatio: commits.length > 0 ? merged.length / commits.length : 0,\n  };\n}\n\nexport function calculateMergeRatio(\n  commitStream: CommitStream,\n  isTarget: (commit: Commit) => boolean = (commit) => commit.tags.attribution === 'ai'\n): MergeRatio {\n  const aiCommits = commitStream.commits.filter(isTarget);\n  const result = computeMergeRatio(aiCommits);\n\n  return {\n    aiCommitsTotal: result.commitsTotal,\n    aiCommitsMerged: result.commitsMerged,\n    mergeRatio: result.mergeRatio,\n  };\n}\n\nexport function calculateBaselineMergeRatio(\n  commitStream: CommitStream,\n  isTarget: (commit: Commit) => boolean = (commit) => commit.tags.attribution === 'human'\n): CohortMergeRatio {\n  const baselineCommits = commitStream.commits.filter(isTarget);\n  return computeMergeRatio(baselineCommits);\n}\n","import { Commit, CommitStream, daysBetween } from '@aida-dev/core';\nimport { Persistence } from './schema/metrics.js';\n\ninterface FileLifecycle {\n  path: string;\n  firstTargetCommitDate: Date;\n  lastSeenDate: Date;\n  persistenceDays: number;\n}\n\nexport function calculatePersistence(\n  commitStream: CommitStream,\n  isTarget: (commit: Commit) => boolean = (commit) => commit.tags.attribution === 'ai'\n): Persistence {\n  const targetCommits = commitStream.commits.filter(isTarget);\n\n  if (targetCommits.length === 0) {\n    return {\n      commitsConsidered: 0,\n      avgDays: 0,\n      medianDays: 0,\n      buckets: {\n        d0_1: 0,\n        d2_7: 0,\n        d8_30: 0,\n        d31_90: 0,\n        d90_plus: 0,\n      },\n    };\n  }\n\n  // Group files by path and track their lifecycle\n  const fileLifecycles = new Map<string, FileLifecycle>();\n\n  // Sort commits by date (oldest first)\n  const sortedCommits = [...commitStream.commits].sort(\n    (a, b) => new Date(a.authorDate).getTime() - new Date(b.authorDate).getTime()\n  );\n\n  // Track first target commit per file\n  for (const commit of sortedCommits) {\n    if (isTarget(commit)) {\n      const commitDate = new Date(commit.authorDate);\n\n      for (const file of commit.stats.files) {\n        if (!fileLifecycles.has(file.path)) {\n          fileLifecycles.set(file.path, {\n            path: file.path,\n            firstTargetCommitDate: commitDate,\n            lastSeenDate: commitDate,\n            persistenceDays: 0,\n          });\n        }\n      }\n    }\n  }\n\n  // Track last seen date for each file\n  for (const commit of sortedCommits) {\n    const commitDate = new Date(commit.authorDate);\n\n    for (const file of commit.stats.files) {\n      const lifecycle = fileLifecycles.get(file.path);\n      if (lifecycle) {\n        // Update last seen date if file is not deleted\n        if (file.status !== 'deleted') {\n          lifecycle.lastSeenDate = commitDate;\n        }\n      }\n    }\n  }\n\n  // Calculate persistence days for each file\n  const persistenceDays: number[] = [];\n\n  for (const lifecycle of fileLifecycles.values()) {\n    lifecycle.persistenceDays = daysBetween(lifecycle.firstTargetCommitDate, lifecycle.lastSeenDate);\n    persistenceDays.push(lifecycle.persistenceDays);\n  }\n\n  // Calculate statistics\n  const avgDays =\n    persistenceDays.length > 0\n      ? persistenceDays.reduce((sum, days) => sum + days, 0) / persistenceDays.length\n      : 0;\n\n  const sortedDays = [...persistenceDays].sort((a, b) => a - b);\n  const medianDays =\n    sortedDays.length > 0\n      ? sortedDays.length % 2 === 0\n        ? (sortedDays[sortedDays.length / 2 - 1] + sortedDays[sortedDays.length / 2]) / 2\n        : sortedDays[Math.floor(sortedDays.length / 2)]\n      : 0;\n\n  // Calculate buckets\n  const buckets = {\n    d0_1: persistenceDays.filter((days) => days <= 1).length,\n    d2_7: persistenceDays.filter((days) => days >= 2 && days <= 7).length,\n    d8_30: persistenceDays.filter((days) => days >= 8 && days <= 30).length,\n    d31_90: persistenceDays.filter((days) => days >= 31 && days <= 90).length,\n    d90_plus: persistenceDays.filter((days) => days > 90).length,\n  };\n\n  return {\n    commitsConsidered: targetCommits.length,\n    avgDays: Math.round(avgDays * 100) / 100, // Round to 2 decimal places\n    medianDays: Math.round(medianDays * 100) / 100,\n    buckets,\n  };\n}\n\nexport function calculateBaselinePersistence(\n  commitStream: CommitStream,\n  isTarget: (commit: Commit) => boolean = (commit) => commit.tags.attribution === 'human'\n): Persistence {\n  return calculatePersistence(commitStream, isTarget);\n}\n","import { z } from 'zod';\n\n// Attribution coverage (#34): the headline metric. Every other number in this\n// file is only as trustworthy as this block says it is.\nexport const Attribution = z.object({\n  commitsTotal: z.number().int().nonnegative(),\n  ai: z.number().int().nonnegative(),\n  human: z.number().int().nonnegative(),\n  unknown: z.number().int().nonnegative(),\n  coverage: z.number().min(0).max(1), // (ai + human) / total\n  defaultAttribution: z.enum(['ai', 'human', 'unknown']), // prior applied to unknown commits\n  coverageThreshold: z.number().min(0).max(1),\n  belowThreshold: z.boolean(),\n  // Autonomy axis (#25): commit counts per mode and per mode-evidence level\n  modes: z.object({\n    none: z.number().int().nonnegative(),\n    autocomplete: z.number().int().nonnegative(),\n    assisted: z.number().int().nonnegative(),\n    agent: z.number().int().nonnegative(),\n    unknown: z.number().int().nonnegative(),\n  }),\n  modeEvidence: z.object({\n    declared: z.number().int().nonnegative(),\n    inferred: z.number().int().nonnegative(),\n    none: z.number().int().nonnegative(),\n  }),\n});\n\nexport const MergeRatio = z.object({\n  aiCommitsTotal: z.number().int().nonnegative(),\n  aiCommitsMerged: z.number().int().nonnegative(),\n  mergeRatio: z.number().min(0).max(1),\n});\n\nexport const Persistence = z.object({\n  commitsConsidered: z.number().int().nonnegative(),\n  avgDays: z.number().nonnegative(),\n  medianDays: z.number().nonnegative(),\n  buckets: z.object({\n    d0_1: z.number().int().nonnegative(),\n    d2_7: z.number().int().nonnegative(),\n    d8_30: z.number().int().nonnegative(),\n    d31_90: z.number().int().nonnegative(),\n    d90_plus: z.number().int().nonnegative(),\n  }),\n});\n\n// Cohort age (#29): context for judging whether a persistence comparison\n// between cohorts is fair — older cohorts accumulate survival by default.\nexport const AgeStats = z.object({\n  commits: z.number().int().nonnegative(),\n  avgAgeDays: z.number().nonnegative(),\n  medianAgeDays: z.number().nonnegative(),\n});\n\n// Task mix (#36): what kind of files each cohort touched. A persistence\n// comparison is only meaningful when the mixes are similar.\nexport const FileCategory = z.enum([\n  'source',\n  'tests',\n  'migrations',\n  'config',\n  'docs',\n  'generated',\n]);\n\nexport const CategoryCounts = z.object({\n  source: z.number().int().nonnegative(),\n  tests: z.number().int().nonnegative(),\n  migrations: z.number().int().nonnegative(),\n  config: z.number().int().nonnegative(),\n  docs: z.number().int().nonnegative(),\n  generated: z.number().int().nonnegative(),\n});\n\nexport const CohortContext = z.object({\n  age: AgeStats.nullable(),\n  taskMix: CategoryCounts.nullable(),\n});\n\nexport const CohortMergeRatio = z.object({\n  commitsTotal: z.number().int().nonnegative(),\n  commitsMerged: z.number().int().nonnegative(),\n  mergeRatio: z.number().min(0).max(1),\n});\n\nexport const Baseline = z.object({\n  // True when the cohort includes 'unknown' commits via defaultAttribution:\n  // the baseline is an assumption, not observed attribution.\n  assumed: z.boolean(),\n  mergeRatio: CohortMergeRatio,\n  persistence: Persistence,\n});\n\nexport const Delta = z.object({\n  mergeRatio: z.number(),\n  avgPersistenceDays: z.number(),\n  medianPersistenceDays: z.number(),\n});\n\nexport const Metrics = z.object({\n  generatedAt: z.string().datetime(),\n  window: z.object({\n    since: z.string().optional(),\n    until: z.string().optional(),\n  }),\n  repoPath: z.string(),\n  defaultBranch: z.string(),\n  attribution: Attribution,\n  mergeRatio: MergeRatio,\n  persistence: Persistence,\n  // Fairness context (#29, #36): age and task mix per cohort, so consumers\n  // can judge whether the AI-vs-baseline comparison is apples-to-apples.\n  cohorts: z.object({\n    ai: CohortContext,\n    baseline: CohortContext,\n  }),\n  // Null when no commit is attributed 'human' and no defaultAttribution prior\n  // assigns the unknowns: AIDA does not invent a comparison cohort.\n  baseline: Baseline.nullable(),\n  delta: Delta.nullable(),\n  caveats: z.array(z.string()),\n});\n\nexport type Attribution = z.infer<typeof Attribution>;\nexport type AgeStats = z.infer<typeof AgeStats>;\nexport type FileCategory = z.infer<typeof FileCategory>;\nexport type CategoryCounts = z.infer<typeof CategoryCounts>;\nexport type CohortContext = z.infer<typeof CohortContext>;\nexport type MergeRatio = z.infer<typeof MergeRatio>;\nexport type Persistence = z.infer<typeof Persistence>;\nexport type CohortMergeRatio = z.infer<typeof CohortMergeRatio>;\nexport type Baseline = z.infer<typeof Baseline>;\nexport type Delta = z.infer<typeof Delta>;\nexport type Metrics = z.infer<typeof Metrics>;\n"],"mappings":"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","names":["daysBetween"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aida-dev/metrics",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "description": "Metrics engine for AIDA (AI Development Accounting) - Merge ratio, persistence, and AI impact analysis",
   "type": "module",
   "main": "dist/index.js",
@@ -11,7 +11,7 @@
   ],
   "dependencies": {
     "zod": "^3.22.4",
-    "@aida-dev/core": "0.9.0"
+    "@aida-dev/core": "0.10.0"
   },
   "devDependencies": {
     "tsup": "^8.0.0",