@codeledger/aggregations 0.8.9

package/dist/store.js

@@ -0,0 +1,125 @@
+import Database from 'better-sqlite3';
+import { existsSync, mkdirSync, readFileSync } from 'node:fs';
+import { join, dirname } from 'node:path';
+const DB_NAME = 'insight.db';
+const DB_CACHE = new Map();
+function dbPath(repoRoot) {
+    return join(repoRoot, '.codeledger', 'insight', DB_NAME);
+}
+function ensureDb(repoRoot) {
+    if (DB_CACHE.has(repoRoot)) {
+        return DB_CACHE.get(repoRoot);
+    }
+    const path = dbPath(repoRoot);
+    mkdirSync(dirname(path), { recursive: true });
+    const db = new Database(path);
+    db.exec(`
+    CREATE TABLE IF NOT EXISTS events (
+      id TEXT PRIMARY KEY,
+      type TEXT,
+      timestamp TEXT,
+      repo TEXT,
+      team TEXT,
+      payload TEXT
+    );
+    CREATE TABLE IF NOT EXISTS snapshots (
+      generated_at TEXT PRIMARY KEY,
+      metrics TEXT,
+      value TEXT,
+      recommendations TEXT,
+      event_count INTEGER,
+      team TEXT,
+      filters TEXT
+    );
+  `);
+    DB_CACHE.set(repoRoot, db);
+    return db;
+}
+export function persistEvent(repoRoot, event) {
+    const db = ensureDb(repoRoot);
+    try {
+        const stmt = db.prepare(`
+      INSERT OR IGNORE INTO events (id, type, timestamp, repo, team, payload)
+      VALUES (?, ?, ?, ?, ?, ?)
+    `);
+        stmt.run(event.id, event.type, event.timestamp, event.repo, event.team ?? null, JSON.stringify(event));
+    }
+    catch {
+        // Non-fatal: telemetry should stay resilient
+    }
+}
+export function readEvents(repoRoot) {
+    const db = ensureDb(repoRoot);
+    const rows = db.prepare('SELECT payload FROM events ORDER BY timestamp').all();
+    const parsed = rows
+        .map((row) => {
+        try {
+            return JSON.parse(row.payload);
+        }
+        catch {
+            return undefined;
+        }
+    })
+        .filter((event) => Boolean(event));
+    if (parsed.length === 0) {
+        const legacy = readLegacyEvents(repoRoot);
+        for (const event of legacy) {
+            persistEvent(repoRoot, event);
+        }
+        return legacy;
+    }
+    return parsed;
+}
+function readLegacyEvents(repoRoot) {
+    const path = join(repoRoot, '.codeledger', 'insight', 'events.jsonl');
+    if (!existsSync(path))
+        return [];
+    return readFileSync(path, 'utf-8')
+        .split('\n')
+        .filter(Boolean)
+        .flatMap((line) => {
+        try {
+            return [JSON.parse(line)];
+        }
+        catch {
+            return [];
+        }
+    });
+}
+export function persistSnapshot(repoRoot, snapshot) {
+    const db = ensureDb(repoRoot);
+    try {
+        const stmt = db.prepare(`
+      INSERT OR REPLACE INTO snapshots
+      (generated_at, metrics, value, recommendations, event_count, team, filters)
+      VALUES (?, ?, ?, ?, ?, ?, ?)
+    `);
+        stmt.run(snapshot.generatedAt, JSON.stringify(snapshot.metrics), JSON.stringify(snapshot.value), JSON.stringify(snapshot.recommendations), snapshot.eventCount, snapshot.team ?? 'unattributed', JSON.stringify(snapshot.filters));
+    }
+    catch {
+        // non-fatal
+    }
+}
+export function readLatestSnapshot(repoRoot) {
+    const db = ensureDb(repoRoot);
+    const row = db
+        .prepare('SELECT * FROM snapshots ORDER BY generated_at DESC LIMIT 1')
+        .get();
+    if (!row)
+        return null;
+    try {
+        return {
+            generatedAt: row.generated_at,
+            eventCount: row.event_count,
+            filters: JSON.parse(row.filters),
+            metrics: JSON.parse(row.metrics),
+            value: JSON.parse(row.value),
+            recommendations: JSON.parse(row.recommendations),
+            team: row.team,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=store.js.map

package/dist/store.js.map

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

package/dist/team-attribution.d.ts

@@ -0,0 +1,9 @@
+import type { InsightEvent, AttributionSource } from '@codeledger/types';
+interface AttributionResult {
+    team?: string;
+    source: AttributionSource;
+}
+export declare function resolveTeamAttribution(repoRoot: string, event: InsightEvent): AttributionResult;
+export declare function determineTeam(repoRoot: string, event: InsightEvent): string | undefined;
+export {};
+//# sourceMappingURL=team-attribution.d.ts.map

package/dist/team-attribution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"team-attribution.d.ts","sourceRoot":"","sources":["../src/team-attribution.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAyB,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAuDhG,UAAU,iBAAiB;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,iBAAiB,CAAC;CAC3B;AAED,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,GAAG,iBAAiB,CAgB/F;AAED,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,GAAG,MAAM,GAAG,SAAS,CAEvF"}

package/dist/team-attribution.js

@@ -0,0 +1,73 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { matchOwnershipTeam, loadOwnershipMap } from './ownership.js';
+const CONFIG_CACHE = new Map();
+function loadConfig(repoRoot) {
+    if (CONFIG_CACHE.has(repoRoot)) {
+        return CONFIG_CACHE.get(repoRoot);
+    }
+    const configPath = join(repoRoot, '.codeledger', 'config.json');
+    let config = {};
+    if (existsSync(configPath)) {
+        try {
+            const raw = JSON.parse(readFileSync(configPath, 'utf-8'));
+            if (raw?.attribution) {
+                config = raw.attribution;
+            }
+        }
+        catch {
+            // ignore malformed config; attribution stays empty
+        }
+    }
+    CONFIG_CACHE.set(repoRoot, config);
+    return config;
+}
+function matchPath(paths, mapping) {
+    if (!paths.length)
+        return undefined;
+    const prefixes = Object.keys(mapping).sort((a, b) => b.length - a.length);
+    for (const path of paths) {
+        for (const prefix of prefixes) {
+            if (path.startsWith(prefix)) {
+                return mapping[prefix];
+            }
+        }
+    }
+    return undefined;
+}
+function eventPaths(event) {
+    switch (event.type) {
+        case 'CONTEXT_EVALUATION':
+            return event.files;
+        case 'PATTERN_REUSE':
+            return [...event.sourceFiles, ...event.targetFiles];
+        case 'GOLDEN_PATH_ADHERENCE':
+            return [event.path];
+        case 'SHADOW_KNOWLEDGE_SIGNAL':
+            return event.files;
+        default:
+            return [];
+    }
+}
+export function resolveTeamAttribution(repoRoot, event) {
+    if (event.team)
+        return { team: event.team, source: 'explicit' };
+    const attribution = loadConfig(repoRoot);
+    if (attribution.repo_team)
+        return { team: attribution.repo_team, source: 'repoConfig' };
+    const paths = eventPaths(event);
+    if (attribution.path_map) {
+        const matched = matchPath(paths, attribution.path_map);
+        if (matched)
+            return { team: matched, source: 'pathMap' };
+    }
+    const ownershipMap = loadOwnershipMap(repoRoot, attribution);
+    const fromOwnership = matchOwnershipTeam(paths, ownershipMap);
+    if (fromOwnership)
+        return { team: fromOwnership, source: 'ownershipFile' };
+    return { source: 'fallback' };
+}
+export function determineTeam(repoRoot, event) {
+    return resolveTeamAttribution(repoRoot, event).team;
+}
+//# sourceMappingURL=team-attribution.js.map

package/dist/team-attribution.js.map

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

package/dist/value.d.ts

@@ -0,0 +1,11 @@
+import type { InsightMetrics, ValueAssumptions, ValueConfidence, ValueSummary } from '@codeledger/types';
+/**
+ * computeValue captures the value model:
+ * estimatedSavings = cost_per_hour × (Rework avoided hours + Context recovery hours + Pattern leverage hours)
+ */
+export declare function computeValue(metrics: InsightMetrics, assumptions?: ValueAssumptions): ValueSummary;
+export declare function computeReworkAvoidedHours(base: number, reworkRatio: number, multiplier: number): number;
+export declare function computeContextRecoveryHours(base: number, timeToContext: number): number;
+export declare function computePatternLeverageHours(base: number, patternReuseRate: number): number;
+export declare function deriveValueConfidence(eventCount: number): ValueConfidence;
+//# sourceMappingURL=value.d.ts.map

package/dist/value.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"value.d.ts","sourceRoot":"","sources":["../src/value.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,gBAAgB,EAEhB,eAAe,EAEf,YAAY,EACb,MAAM,mBAAmB,CAAC;AA4B3B;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,cAAc,EACvB,WAAW,GAAE,gBAAsC,GAClD,YAAY,CAwDd;AAED,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,GACjB,MAAM,CAER;AAED,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM,CAGvF;AAED,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,GAAG,MAAM,CAE1F;AAED,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,MAAM,GAAG,eAAe,CAIzE"}

package/dist/value.js

@@ -0,0 +1,113 @@
+const DEFAULT_ASSUMPTIONS = {
+    cost_per_hour: 150,
+    rework_multiplier: 1.2,
+};
+/**
+ * Component multipliers convert base executions into estimated developer-hours saved.
+ *
+ * REWORK_HOURS_MULTIPLIER (0.20):
+ *   Each non-reworked execution saves ~12 minutes (0.2h) of developer time on average.
+ *   Derived from empirical rework cost studies: a rework cycle consumes 20-30% of
+ *   original effort. We use the conservative lower bound after applying the rework_multiplier.
+ *
+ * CONTEXT_HOURS_MULTIPLIER (0.08):
+ *   Each execution with fast context recovery saves ~5 minutes (0.08h). Represents
+ *   the reduction in context-switching overhead when timeToContext is low relative
+ *   to the 10-minute baseline (a full manual context rebuild).
+ *
+ * PATTERN_HOURS_MULTIPLIER (0.12):
+ *   Each execution leveraging an existing pattern saves ~7 minutes (0.12h). Captures
+ *   the value of not re-inventing solutions: lookup + adapt vs. design + implement.
+ */
+const REWORK_HOURS_MULTIPLIER = 0.2;
+const CONTEXT_HOURS_MULTIPLIER = 0.08;
+const PATTERN_HOURS_MULTIPLIER = 0.12;
+/**
+ * computeValue captures the value model:
+ * estimatedSavings = cost_per_hour × (Rework avoided hours + Context recovery hours + Pattern leverage hours)
+ */
+export function computeValue(metrics, assumptions = DEFAULT_ASSUMPTIONS) {
+    const baseExecutions = Math.max(1, metrics.quality.executionReliability.denominator);
+    const reworkAvoidedHours = computeReworkAvoidedHours(baseExecutions, metrics.quality.reworkRatio.value, assumptions.rework_multiplier);
+    const contextRecoveryHours = computeContextRecoveryHours(baseExecutions, metrics.knowledge.timeToContext.value);
+    const patternLeverageHours = computePatternLeverageHours(baseExecutions, metrics.knowledge.patternReuseRate.value);
+    const estimatedSavings = (reworkAvoidedHours + contextRecoveryHours + patternLeverageHours) * assumptions.cost_per_hour;
+    const derivation = [
+        {
+            label: 'Rework reduction',
+            hours: reworkAvoidedHours,
+            formula: 'executions × (1 - reworkRatio) × rework_multiplier × 0.20',
+            inputs: {
+                executions: baseExecutions,
+                reworkRatio: metrics.quality.reworkRatio.value,
+                rework_multiplier: assumptions.rework_multiplier,
+                multiplier: REWORK_HOURS_MULTIPLIER,
+            },
+        },
+        {
+            label: 'Context recovery',
+            hours: contextRecoveryHours,
+            formula: 'executions × max(0, 1 - timeToContext / 10) × 0.08',
+            inputs: {
+                executions: baseExecutions,
+                timeToContext: metrics.knowledge.timeToContext.value,
+                baseline_minutes: 10,
+                multiplier: CONTEXT_HOURS_MULTIPLIER,
+            },
+        },
+        {
+            label: 'Pattern leverage',
+            hours: patternLeverageHours,
+            formula: 'executions × patternReuseRate × 0.12',
+            inputs: {
+                executions: baseExecutions,
+                patternReuseRate: metrics.knowledge.patternReuseRate.value,
+                multiplier: PATTERN_HOURS_MULTIPLIER,
+            },
+        },
+    ];
+    return {
+        estimatedSavings,
+        reworkAvoidedHours,
+        contextRecoveryHours,
+        patternLeverageHours,
+        assumptions,
+        confidence: deriveValueConfidence(metrics.overview.eventCount),
+        scope: buildScopeContext(metrics.overview),
+        derivation,
+    };
+}
+export function computeReworkAvoidedHours(base, reworkRatio, multiplier) {
+    return base * (1 - reworkRatio) * multiplier * REWORK_HOURS_MULTIPLIER;
+}
+export function computeContextRecoveryHours(base, timeToContext) {
+    const contextFactor = Math.max(0, 1 - timeToContext / 10);
+    return base * contextFactor * CONTEXT_HOURS_MULTIPLIER;
+}
+export function computePatternLeverageHours(base, patternReuseRate) {
+    return base * patternReuseRate * PATTERN_HOURS_MULTIPLIER;
+}
+export function deriveValueConfidence(eventCount) {
+    if (eventCount >= 40)
+        return 'high';
+    if (eventCount >= 15)
+        return 'medium';
+    return 'low';
+}
+function buildScopeContext(overview) {
+    let range = 'Rolling 30-day window';
+    if (overview.trend.length > 1) {
+        const first = overview.trend[0];
+        const last = overview.trend[overview.trend.length - 1];
+        if (first && last) {
+            range = `${first.date} ↔ ${last.date}`;
+        }
+    }
+    return {
+        windowLabel: range,
+        executions: overview.eventCount,
+        repos: overview.repos.length,
+        teams: overview.teams,
+    };
+}
+//# sourceMappingURL=value.js.map

package/dist/value.js.map

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

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@codeledger/aggregations",
+  "version": "0.8.9",
+  "type": "module",
+  "description": "Insight aggregation engine for CodeLedger",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/codeledgerECF/codeledger.git",
+    "directory": "packages/aggregations"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist"
+  ],
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "better-sqlite3": "^11.10.0",
+    "@codeledger/types": "0.8.9"
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.0",
+    "typescript": "^5.4.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  }
+}