@aida-dev/metrics 0.3.1 → 0.4.0

package/dist/index.d.ts

@@ -1,6 +1,35 @@
 import { CommitStream, Commit } from '@aida-dev/core';
 import { z } from 'zod';
 
+declare const Attribution: z.ZodObject<{
+    commitsTotal: z.ZodNumber;
+    ai: z.ZodNumber;
+    human: z.ZodNumber;
+    unknown: z.ZodNumber;
+    coverage: z.ZodNumber;
+    defaultAttribution: z.ZodEnum<["ai", "human", "unknown"]>;
+    coverageThreshold: z.ZodNumber;
+    belowThreshold: z.ZodBoolean;
+}, "strip", z.ZodTypeAny, {
+    ai: number;
+    human: number;
+    unknown: number;
+    commitsTotal: number;
+    coverage: number;
+    defaultAttribution: "ai" | "human" | "unknown";
+    coverageThreshold: number;
+    belowThreshold: boolean;
+}, {
+    ai: number;
+    human: number;
+    unknown: number;
+    commitsTotal: number;
+    coverage: number;
+    defaultAttribution: "ai" | "human" | "unknown";
+    coverageThreshold: number;
+    belowThreshold: boolean;
+}>;
+type Attribution = z.infer<typeof Attribution>;
 declare const MergeRatio: z.ZodObject<{
     aiCommitsTotal: z.ZodNumber;
     aiCommitsMerged: z.ZodNumber;
@@ -67,27 +96,28 @@ declare const CohortMergeRatio: z.ZodObject<{
     commitsMerged: z.ZodNumber;
     mergeRatio: z.ZodNumber;
 }, "strip", z.ZodTypeAny, {
-    mergeRatio: number;
     commitsTotal: number;
+    mergeRatio: number;
     commitsMerged: number;
 }, {
-    mergeRatio: number;
     commitsTotal: number;
+    mergeRatio: number;
     commitsMerged: number;
 }>;
 type CohortMergeRatio = z.infer<typeof CohortMergeRatio>;
 declare const Baseline: z.ZodObject<{
+    assumed: z.ZodBoolean;
     mergeRatio: z.ZodObject<{
         commitsTotal: z.ZodNumber;
         commitsMerged: z.ZodNumber;
         mergeRatio: z.ZodNumber;
     }, "strip", z.ZodTypeAny, {
-        mergeRatio: number;
         commitsTotal: number;
+        mergeRatio: number;
         commitsMerged: number;
     }, {
-        mergeRatio: number;
         commitsTotal: number;
+        mergeRatio: number;
         commitsMerged: number;
     }>;
     persistence: z.ZodObject<{
@@ -138,8 +168,8 @@ declare const Baseline: z.ZodObject<{
     }>;
 }, "strip", z.ZodTypeAny, {
     mergeRatio: {
-        mergeRatio: number;
         commitsTotal: number;
+        mergeRatio: number;
         commitsMerged: number;
     };
     persistence: {
@@ -154,10 +184,11 @@ declare const Baseline: z.ZodObject<{
             d90_plus: number;
         };
     };
+    assumed: boolean;
 }, {
     mergeRatio: {
-        mergeRatio: number;
         commitsTotal: number;
+        mergeRatio: number;
         commitsMerged: number;
     };
     persistence: {
@@ -172,6 +203,7 @@ declare const Baseline: z.ZodObject<{
             d90_plus: number;
         };
     };
+    assumed: boolean;
 }>;
 type Baseline = z.infer<typeof Baseline>;
 declare const Delta: z.ZodObject<{
@@ -202,6 +234,34 @@ declare const Metrics: z.ZodObject<{
     }>;
     repoPath: z.ZodString;
     defaultBranch: z.ZodString;
+    attribution: z.ZodObject<{
+        commitsTotal: z.ZodNumber;
+        ai: z.ZodNumber;
+        human: z.ZodNumber;
+        unknown: z.ZodNumber;
+        coverage: z.ZodNumber;
+        defaultAttribution: z.ZodEnum<["ai", "human", "unknown"]>;
+        coverageThreshold: z.ZodNumber;
+        belowThreshold: z.ZodBoolean;
+    }, "strip", z.ZodTypeAny, {
+        ai: number;
+        human: number;
+        unknown: number;
+        commitsTotal: number;
+        coverage: number;
+        defaultAttribution: "ai" | "human" | "unknown";
+        coverageThreshold: number;
+        belowThreshold: boolean;
+    }, {
+        ai: number;
+        human: number;
+        unknown: number;
+        commitsTotal: number;
+        coverage: number;
+        defaultAttribution: "ai" | "human" | "unknown";
+        coverageThreshold: number;
+        belowThreshold: boolean;
+    }>;
     mergeRatio: z.ZodObject<{
         aiCommitsTotal: z.ZodNumber;
         aiCommitsMerged: z.ZodNumber;
@@ -261,18 +321,19 @@ declare const Metrics: z.ZodObject<{
             d90_plus: number;
         };
     }>;
-    baseline: z.ZodObject<{
+    baseline: z.ZodNullable<z.ZodObject<{
+        assumed: z.ZodBoolean;
         mergeRatio: z.ZodObject<{
             commitsTotal: z.ZodNumber;
             commitsMerged: z.ZodNumber;
             mergeRatio: z.ZodNumber;
         }, "strip", z.ZodTypeAny, {
-            mergeRatio: number;
             commitsTotal: number;
+            mergeRatio: number;
             commitsMerged: number;
         }, {
-            mergeRatio: number;
             commitsTotal: number;
+            mergeRatio: number;
             commitsMerged: number;
         }>;
         persistence: z.ZodObject<{
@@ -323,8 +384,8 @@ declare const Metrics: z.ZodObject<{
         }>;
     }, "strip", z.ZodTypeAny, {
         mergeRatio: {
-            mergeRatio: number;
             commitsTotal: number;
+            mergeRatio: number;
             commitsMerged: number;
         };
         persistence: {
@@ -339,10 +400,11 @@ declare const Metrics: z.ZodObject<{
                 d90_plus: number;
             };
         };
+        assumed: boolean;
     }, {
         mergeRatio: {
-            mergeRatio: number;
             commitsTotal: number;
+            mergeRatio: number;
             commitsMerged: number;
         };
         persistence: {
@@ -357,8 +419,9 @@ declare const Metrics: z.ZodObject<{
                 d90_plus: number;
             };
         };
-    }>;
-    delta: z.ZodObject<{
+        assumed: boolean;
+    }>>;
+    delta: z.ZodNullable<z.ZodObject<{
         mergeRatio: z.ZodNumber;
         avgPersistenceDays: z.ZodNumber;
         medianPersistenceDays: z.ZodNumber;
@@ -370,7 +433,7 @@ declare const Metrics: z.ZodObject<{
         mergeRatio: number;
         avgPersistenceDays: number;
         medianPersistenceDays: number;
-    }>;
+    }>>;
     caveats: z.ZodArray<z.ZodString, "many">;
 }, "strip", z.ZodTypeAny, {
     generatedAt: string;
@@ -380,6 +443,16 @@ declare const Metrics: z.ZodObject<{
     };
     repoPath: string;
     defaultBranch: string;
+    attribution: {
+        ai: number;
+        human: number;
+        unknown: number;
+        commitsTotal: number;
+        coverage: number;
+        defaultAttribution: "ai" | "human" | "unknown";
+        coverageThreshold: number;
+        belowThreshold: boolean;
+    };
     mergeRatio: {
         aiCommitsTotal: number;
         aiCommitsMerged: number;
@@ -399,8 +472,8 @@ declare const Metrics: z.ZodObject<{
     };
     baseline: {
         mergeRatio: {
-            mergeRatio: number;
             commitsTotal: number;
+            mergeRatio: number;
             commitsMerged: number;
         };
         persistence: {
@@ -415,12 +488,13 @@ declare const Metrics: z.ZodObject<{
                 d90_plus: number;
             };
         };
-    };
+        assumed: boolean;
+    } | null;
     delta: {
         mergeRatio: number;
         avgPersistenceDays: number;
         medianPersistenceDays: number;
-    };
+    } | null;
     caveats: string[];
 }, {
     generatedAt: string;
@@ -430,6 +504,16 @@ declare const Metrics: z.ZodObject<{
     };
     repoPath: string;
     defaultBranch: string;
+    attribution: {
+        ai: number;
+        human: number;
+        unknown: number;
+        commitsTotal: number;
+        coverage: number;
+        defaultAttribution: "ai" | "human" | "unknown";
+        coverageThreshold: number;
+        belowThreshold: boolean;
+    };
     mergeRatio: {
         aiCommitsTotal: number;
         aiCommitsMerged: number;
@@ -449,8 +533,8 @@ declare const Metrics: z.ZodObject<{
     };
     baseline: {
         mergeRatio: {
-            mergeRatio: number;
             commitsTotal: number;
+            mergeRatio: number;
             commitsMerged: number;
         };
         persistence: {
@@ -465,22 +549,27 @@ declare const Metrics: z.ZodObject<{
                 d90_plus: number;
             };
         };
-    };
+        assumed: boolean;
+    } | null;
     delta: {
         mergeRatio: number;
         avgPersistenceDays: number;
         medianPersistenceDays: number;
-    };
+    } | null;
     caveats: string[];
 }>;
 type Metrics = z.infer<typeof Metrics>;
 
-declare function calculateMergeRatio(commitStream: CommitStream): MergeRatio;
-declare function calculateBaselineMergeRatio(commitStream: CommitStream): CohortMergeRatio;
+declare function calculateMergeRatio(commitStream: CommitStream, isTarget?: (commit: Commit) => boolean): MergeRatio;
+declare function calculateBaselineMergeRatio(commitStream: CommitStream, isTarget?: (commit: Commit) => boolean): CohortMergeRatio;
 
 declare function calculatePersistence(commitStream: CommitStream, isTarget?: (commit: Commit) => boolean): Persistence;
-declare function calculateBaselinePersistence(commitStream: CommitStream): Persistence;
+declare function calculateBaselinePersistence(commitStream: CommitStream, isTarget?: (commit: Commit) => boolean): Persistence;
 
-declare function calculateMetrics(commitStream: CommitStream): Metrics;
+interface MetricsOptions {
+    defaultAttribution?: 'ai' | 'human' | 'unknown';
+    coverageThreshold?: number;
+}
+declare function calculateMetrics(commitStream: CommitStream, options?: MetricsOptions): Metrics;
 
-export { Baseline, CohortMergeRatio, Delta, MergeRatio, Metrics, Persistence, calculateBaselineMergeRatio, calculateBaselinePersistence, calculateMergeRatio, calculateMetrics, calculatePersistence };
+export { Attribution, Baseline, CohortMergeRatio, Delta, MergeRatio, Metrics, type MetricsOptions, Persistence, calculateBaselineMergeRatio, calculateBaselinePersistence, calculateMergeRatio, calculateMetrics, calculatePersistence };

package/dist/index.js

@@ -10,8 +10,8 @@ function computeMergeRatio(commits) {
     mergeRatio: commits.length > 0 ? merged.length / commits.length : 0
   };
 }
-function calculateMergeRatio(commitStream) {
-  const aiCommits = commitStream.commits.filter((commit) => commit.tags.ai);
+function calculateMergeRatio(commitStream, isTarget = (commit) => commit.tags.attribution === "ai") {
+  const aiCommits = commitStream.commits.filter(isTarget);
   const result = computeMergeRatio(aiCommits);
   return {
     aiCommitsTotal: result.commitsTotal,
@@ -19,14 +19,14 @@ function calculateMergeRatio(commitStream) {
     mergeRatio: result.mergeRatio
   };
 }
-function calculateBaselineMergeRatio(commitStream) {
-  const nonAICommits = commitStream.commits.filter((commit) => !commit.tags.ai);
-  return computeMergeRatio(nonAICommits);
+function calculateBaselineMergeRatio(commitStream, isTarget = (commit) => commit.tags.attribution === "human") {
+  const baselineCommits = commitStream.commits.filter(isTarget);
+  return computeMergeRatio(baselineCommits);
 }
 
 // src/persistence.ts
 import { daysBetween } from "@aida-dev/core";
-function calculatePersistence(commitStream, isTarget = (commit) => commit.tags.ai) {
+function calculatePersistence(commitStream, isTarget = (commit) => commit.tags.attribution === "ai") {
   const targetCommits = commitStream.commits.filter(isTarget);
   if (targetCommits.length === 0) {
     return {
@@ -95,12 +95,24 @@ function calculatePersistence(commitStream, isTarget = (commit) => commit.tags.a
     buckets
   };
 }
-function calculateBaselinePersistence(commitStream) {
-  return calculatePersistence(commitStream, (commit) => !commit.tags.ai);
+function calculateBaselinePersistence(commitStream, isTarget = (commit) => commit.tags.attribution === "human") {
+  return calculatePersistence(commitStream, isTarget);
 }
 
 // src/schema/metrics.ts
 import { z } from "zod";
+var Attribution = z.object({
+  commitsTotal: z.number().int().nonnegative(),
+  ai: z.number().int().nonnegative(),
+  human: z.number().int().nonnegative(),
+  unknown: z.number().int().nonnegative(),
+  coverage: z.number().min(0).max(1),
+  // (ai + human) / total
+  defaultAttribution: z.enum(["ai", "human", "unknown"]),
+  // prior applied to unknown commits
+  coverageThreshold: z.number().min(0).max(1),
+  belowThreshold: z.boolean()
+});
 var MergeRatio = z.object({
   aiCommitsTotal: z.number().int().nonnegative(),
   aiCommitsMerged: z.number().int().nonnegative(),
@@ -124,6 +136,9 @@ var CohortMergeRatio = z.object({
   mergeRatio: z.number().min(0).max(1)
 });
 var Baseline = z.object({
+  // True when the cohort includes 'unknown' commits via defaultAttribution:
+  // the baseline is an assumption, not observed attribution.
+  assumed: z.boolean(),
   mergeRatio: CohortMergeRatio,
   persistence: Persistence
 });
@@ -140,10 +155,13 @@ var Metrics = z.object({
   }),
   repoPath: z.string(),
   defaultBranch: z.string(),
+  attribution: Attribution,
   mergeRatio: MergeRatio,
   persistence: Persistence,
-  baseline: Baseline,
-  delta: Delta,
+  // Null when no commit is attributed 'human' and no defaultAttribution prior
+  // assigns the unknowns: AIDA does not invent a comparison cohort.
+  baseline: Baseline.nullable(),
+  delta: Delta.nullable(),
   caveats: z.array(z.string())
 });
 
@@ -152,22 +170,60 @@ function round(value, decimals) {
   const factor = 10 ** decimals;
   return Math.round(value * factor) / factor;
 }
-function calculateMetrics(commitStream) {
-  const mergeRatio = calculateMergeRatio(commitStream);
-  const persistence = calculatePersistence(commitStream);
-  const baselineMergeRatio = calculateBaselineMergeRatio(commitStream);
-  const baselinePersistence = calculateBaselinePersistence(commitStream);
-  const delta = {
-    mergeRatio: round(mergeRatio.mergeRatio - baselineMergeRatio.mergeRatio, 4),
-    avgPersistenceDays: round(persistence.avgDays - baselinePersistence.avgDays, 2),
-    medianPersistenceDays: round(persistence.medianDays - baselinePersistence.medianDays, 2)
+function calculateMetrics(commitStream, options = {}) {
+  const { defaultAttribution = "unknown", coverageThreshold = 0.7 } = options;
+  const counts = { ai: 0, human: 0, unknown: 0 };
+  for (const commit of commitStream.commits) {
+    counts[commit.tags.attribution]++;
+  }
+  const total = commitStream.commits.length;
+  const coverage = total > 0 ? (counts.ai + counts.human) / total : 0;
+  const attribution = {
+    commitsTotal: total,
+    ai: counts.ai,
+    human: counts.human,
+    unknown: counts.unknown,
+    coverage: round(coverage, 4),
+    defaultAttribution,
+    coverageThreshold,
+    belowThreshold: coverage < coverageThreshold
   };
+  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 mergeRatio = calculateMergeRatio(commitStream, isAI);
+  const persistence = calculatePersistence(commitStream, isAI);
+  const baselineSize = commitStream.commits.filter(isBaseline).length;
+  const baselineAssumed = defaultAttribution === "human" && counts.unknown > 0;
+  const baseline = baselineSize > 0 ? {
+    assumed: baselineAssumed,
+    mergeRatio: calculateBaselineMergeRatio(commitStream, isBaseline),
+    persistence: calculateBaselinePersistence(commitStream, isBaseline)
+  } : null;
+  const delta = baseline ? {
+    mergeRatio: round(mergeRatio.mergeRatio - baseline.mergeRatio.mergeRatio, 4),
+    avgPersistenceDays: round(persistence.avgDays - baseline.persistence.avgDays, 2),
+    medianPersistenceDays: round(
+      persistence.medianDays - baseline.persistence.medianDays,
+      2
+    )
+  } : null;
   const caveats = [
+    `Attribution coverage is ${(coverage * 100).toFixed(1)}%: metrics only describe commits whose provenance is known.`,
     "Persistence is file-level, not line-level.",
     "Merge ratio: commits from all branches checked against default branch ancestry. Squash merges may undercount unmerged commits.",
-    "AI tagging uses heuristic patterns; false positives/negatives possible.",
-    "Baseline covers all non-AI-tagged commits; undetected AI usage may leak into the baseline."
+    "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."
   ];
+  if (baseline?.assumed) {
+    caveats.push(
+      `Baseline includes ${counts.unknown} unattributed commit(s) assumed human via defaultAttribution \u2014 undetected AI usage may leak into it.`
+    );
+  }
+  if (!baseline) {
+    caveats.push(
+      'No baseline: no commits are attributed as human. Set defaultAttribution to "human" in .aida.json if unattributed commits in this repo are human-authored.'
+    );
+  }
   return {
     generatedAt: formatISODate(/* @__PURE__ */ new Date()),
     window: {
@@ -176,17 +232,16 @@ function calculateMetrics(commitStream) {
     },
     repoPath: commitStream.repoPath,
     defaultBranch: commitStream.defaultBranch,
+    attribution,
     mergeRatio,
     persistence,
-    baseline: {
-      mergeRatio: baselineMergeRatio,
-      persistence: baselinePersistence
-    },
+    baseline,
     delta,
     caveats
   };
 }
 export {
+  Attribution,
   Baseline,
   CohortMergeRatio,
   Delta,

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 { CommitStream, formatISODate } from '@aida-dev/core';\nimport { calculateBaselineMergeRatio, calculateMergeRatio } from './merge-ratio.js';\nimport { calculateBaselinePersistence, calculatePersistence } from './persistence.js';\nimport { Metrics } from './schema/metrics.js';\n\nexport * from './schema/metrics.js';\nexport * from './merge-ratio.js';\nexport * from './persistence.js';\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(commitStream: CommitStream): Metrics {\n  const mergeRatio = calculateMergeRatio(commitStream);\n  const persistence = calculatePersistence(commitStream);\n  const baselineMergeRatio = calculateBaselineMergeRatio(commitStream);\n  const baselinePersistence = calculateBaselinePersistence(commitStream);\n\n  const delta = {\n    mergeRatio: round(mergeRatio.mergeRatio - baselineMergeRatio.mergeRatio, 4),\n    avgPersistenceDays: round(persistence.avgDays - baselinePersistence.avgDays, 2),\n    medianPersistenceDays: round(persistence.medianDays - baselinePersistence.medianDays, 2),\n  };\n\n  const caveats = [\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    'AI tagging uses heuristic patterns; false positives/negatives possible.',\n    'Baseline covers all non-AI-tagged commits; undetected AI usage may leak into the baseline.',\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    mergeRatio,\n    persistence,\n    baseline: {\n      mergeRatio: baselineMergeRatio,\n      persistence: baselinePersistence,\n    },\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(commitStream: CommitStream): MergeRatio {\n  const aiCommits = commitStream.commits.filter((commit) => commit.tags.ai);\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(commitStream: CommitStream): CohortMergeRatio {\n  const nonAICommits = commitStream.commits.filter((commit) => !commit.tags.ai);\n  return computeMergeRatio(nonAICommits);\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.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(commitStream: CommitStream): Persistence {\n  return calculatePersistence(commitStream, (commit) => !commit.tags.ai);\n}\n","import { z } from 'zod';\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  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  mergeRatio: MergeRatio,\n  persistence: Persistence,\n  baseline: Baseline,\n  delta: Delta,\n  caveats: z.array(z.string()),\n});\n\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/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":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aida-dev/metrics",
-  "version": "0.3.1",
+  "version": "0.4.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.8.0"
+    "@aida-dev/core": "0.9.0"
   },
   "devDependencies": {
     "tsup": "^8.0.0",