@codeledger/engine 0.7.2 → 0.7.5

package/dist/claims/claims.js

@@ -0,0 +1,125 @@
+/**
+ * Soft Claims — Social Coordination
+ *
+ * Advisory claims that signal active work on files.
+ * Claims are ephemeral, timestamped, and never block operations.
+ * Stored in .codeledger/claims/<sessionId>.json (git-ignored).
+ */
+import { readFileSync, writeFileSync, existsSync, mkdirSync, readdirSync, unlinkSync } from 'node:fs';
+import { join } from 'node:path';
+const CLAIMS_DIR = '.codeledger/claims';
+const DEFAULT_EXPIRY_MS = 2 * 60 * 60 * 1000; // 2 hours
+/** Ensure claims directory exists and is git-ignored */
+function ensureClaimsDir(repoRoot) {
+    const dir = join(repoRoot, CLAIMS_DIR);
+    if (!existsSync(dir)) {
+        mkdirSync(dir, { recursive: true });
+    }
+    // Ensure .gitignore includes claims
+    const gitignore = join(repoRoot, CLAIMS_DIR, '.gitignore');
+    if (!existsSync(gitignore)) {
+        writeFileSync(gitignore, '*\n!.gitignore\n', 'utf-8');
+    }
+    return dir;
+}
+/** Write a soft claim for a session */
+export function writeClaim(repoRoot, claim, expiryMs = DEFAULT_EXPIRY_MS) {
+    const dir = ensureClaimsDir(repoRoot);
+    const fullClaim = {
+        ...claim,
+        expiresAt: new Date(Date.now() + expiryMs).toISOString(),
+    };
+    const filePath = join(dir, `${claim.sessionId}.json`);
+    writeFileSync(filePath, JSON.stringify(fullClaim, null, 2) + '\n', 'utf-8');
+    return fullClaim;
+}
+/** Read all active (non-expired) claims */
+export function readActiveClaims(repoRoot) {
+    const dir = join(repoRoot, CLAIMS_DIR);
+    if (!existsSync(dir))
+        return [];
+    const claims = [];
+    const now = Date.now();
+    for (const file of readdirSync(dir)) {
+        if (!file.endsWith('.json') || file === '.gitignore')
+            continue;
+        try {
+            const raw = readFileSync(join(dir, file), 'utf-8');
+            const claim = JSON.parse(raw);
+            if (new Date(claim.expiresAt).getTime() > now) {
+                claims.push(claim);
+            }
+        }
+        catch {
+            // Skip corrupted claim files
+        }
+    }
+    return claims;
+}
+/** Remove expired claims */
+export function pruneExpiredClaims(repoRoot) {
+    const dir = join(repoRoot, CLAIMS_DIR);
+    if (!existsSync(dir))
+        return 0;
+    let pruned = 0;
+    const now = Date.now();
+    for (const file of readdirSync(dir)) {
+        if (!file.endsWith('.json') || file === '.gitignore')
+            continue;
+        try {
+            const raw = readFileSync(join(dir, file), 'utf-8');
+            const claim = JSON.parse(raw);
+            if (new Date(claim.expiresAt).getTime() <= now) {
+                unlinkSync(join(dir, file));
+                pruned++;
+            }
+        }
+        catch {
+            // Remove corrupted files too
+            try {
+                unlinkSync(join(dir, file));
+                pruned++;
+            }
+            catch { /* ignore */ }
+        }
+    }
+    return pruned;
+}
+/** Remove a specific session's claim */
+export function removeClaim(repoRoot, sessionId) {
+    const filePath = join(repoRoot, CLAIMS_DIR, `${sessionId}.json`);
+    if (existsSync(filePath)) {
+        unlinkSync(filePath);
+        return true;
+    }
+    return false;
+}
+/** Get presence information: which actors are working on which files */
+export function getPresence(repoRoot) {
+    const claims = readActiveClaims(repoRoot);
+    const fileMap = new Map();
+    for (const claim of claims) {
+        for (const file of claim.touchedFiles) {
+            if (!fileMap.has(file)) {
+                fileMap.set(file, []);
+            }
+            fileMap.get(file).push({
+                actorId: claim.actorId,
+                sessionId: claim.sessionId,
+                intentLabel: claim.intentLabel,
+                timestamp: claim.timestamp,
+            });
+        }
+    }
+    return [...fileMap.entries()]
+        .map(([file, actors]) => ({ file, actors }))
+        .sort((a, b) => b.actors.length - a.actors.length);
+}
+/** Format presence as human-readable strings */
+export function formatPresence(presence) {
+    return presence.map(p => {
+        const actors = p.actors.map(a => `${a.actorId} (${a.intentLabel})`).join(', ');
+        return `${p.file}: ${actors}`;
+    });
+}
+//# sourceMappingURL=claims.js.map

package/dist/claims/claims.js.map

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

package/dist/claims/index.d.ts

@@ -0,0 +1,2 @@
+export { writeClaim, readActiveClaims, pruneExpiredClaims, removeClaim, getPresence, formatPresence, } from './claims.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/claims/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EACV,gBAAgB,EAChB,kBAAkB,EAClB,WAAW,EACX,WAAW,EACX,cAAc,GACf,MAAM,aAAa,CAAC"}

package/dist/claims/index.js

@@ -0,0 +1,2 @@
+export { writeClaim, readActiveClaims, pruneExpiredClaims, removeClaim, getPresence, formatPresence, } from './claims.js';
+//# sourceMappingURL=index.js.map

package/dist/claims/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/claims/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EACV,gBAAgB,EAChB,kBAAkB,EAClB,WAAW,EACX,WAAW,EACX,cAAc,GACf,MAAM,aAAa,CAAC"}

package/dist/dashboard/index.d.ts

@@ -0,0 +1,3 @@
+export { computeDashboardMetrics, healthRating } from './metrics.js';
+export { appendDashboardSnapshot, readDashboardHistory, computeTrends, DASHBOARD_HISTORY_FILE, } from './store.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/dashboard/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACrE,OAAO,EACL,uBAAuB,EACvB,oBAAoB,EACpB,aAAa,EACb,sBAAsB,GACvB,MAAM,YAAY,CAAC"}

package/dist/dashboard/index.js

@@ -0,0 +1,3 @@
+export { computeDashboardMetrics, healthRating } from './metrics.js';
+export { appendDashboardSnapshot, readDashboardHistory, computeTrends, DASHBOARD_HISTORY_FILE, } from './store.js';
+//# sourceMappingURL=index.js.map

package/dist/dashboard/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/dashboard/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACrE,OAAO,EACL,uBAAuB,EACvB,oBAAoB,EACpB,aAAa,EACb,sBAAsB,GACvB,MAAM,YAAY,CAAC"}

package/dist/dashboard/metrics.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Dashboard Metrics Engine — Architecture Health Dashboard
+ *
+ * Computes 5 key metrics from existing subsystem data:
+ * - AHS: Architecture Health Score
+ * - DRI: Duplication Risk Index
+ * - EDS: Extension Discipline Score
+ * - STS: Source-of-Truth Stability
+ * - Override Frequency
+ *
+ * All scores are [0, 1]. Graceful degradation: missing data sources default to 0.5.
+ */
+import type { DashboardMetrics, HealthRating } from '@codeledger/types';
+/**
+ * Compute all 5 dashboard metrics from data stored under `dataDir` (.codeledger/).
+ *
+ * Each metric degrades gracefully: if its data source is missing, it uses 0.5 (neutral).
+ */
+export declare function computeDashboardMetrics(dataDir: string): Promise<DashboardMetrics>;
+/**
+ * Derive a qualitative health rating from the overall score.
+ */
+export declare function healthRating(overall: number): HealthRating;
+//# sourceMappingURL=metrics.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../../src/dashboard/metrics.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,OAAO,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAuBxE;;;;GAIG;AACH,wBAAsB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAwBxF;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,CAM1D"}

package/dist/dashboard/metrics.js

@@ -0,0 +1,358 @@
+/**
+ * Dashboard Metrics Engine — Architecture Health Dashboard
+ *
+ * Computes 5 key metrics from existing subsystem data:
+ * - AHS: Architecture Health Score
+ * - DRI: Duplication Risk Index
+ * - EDS: Extension Discipline Score
+ * - STS: Source-of-Truth Stability
+ * - Override Frequency
+ *
+ * All scores are [0, 1]. Graceful degradation: missing data sources default to 0.5.
+ */
+import { readFileSync, existsSync } from 'node:fs';
+import { join } from 'node:path';
+// ─── Weight Constants ────────────────────────────────────────────────────────
+// AHS sub-weights (sum = 1.0)
+const AHS_W_VIOLATIONS = 0.30;
+const AHS_W_CONFIDENCE = 0.25;
+const AHS_W_DRIFT = 0.15;
+const AHS_W_TEST_COVERAGE = 0.15;
+const AHS_W_CONFLICTS = 0.15;
+// Overall dashboard weights (sum = 1.0)
+const OVERALL_W_AHS = 0.35;
+const OVERALL_W_DRI = 0.20;
+const OVERALL_W_EDS = 0.20;
+const OVERALL_W_STS = 0.15;
+const OVERALL_W_OVERRIDE = 0.10;
+// Neutral default when data is missing
+const NEUTRAL = 0.5;
+// ─── Public API ──────────────────────────────────────────────────────────────
+/**
+ * Compute all 5 dashboard metrics from data stored under `dataDir` (.codeledger/).
+ *
+ * Each metric degrades gracefully: if its data source is missing, it uses 0.5 (neutral).
+ */
+export async function computeDashboardMetrics(dataDir) {
+    const ahs = computeAHS(dataDir);
+    const dri = computeDRI(dataDir);
+    const eds = computeEDS(dataDir);
+    const sts = computeSTS(dataDir);
+    const overrideFrequency = computeOverrideFrequency(dataDir);
+    const overall = clamp(OVERALL_W_AHS * ahs +
+        OVERALL_W_DRI * (1 - dri) + // DRI is a risk index — lower is better
+        OVERALL_W_EDS * eds +
+        OVERALL_W_STS * sts +
+        OVERALL_W_OVERRIDE * (1 - overrideFrequency));
+    return {
+        ahs,
+        dri,
+        eds,
+        sts,
+        override_frequency: overrideFrequency,
+        overall,
+        timestamp: Date.now(),
+    };
+}
+/**
+ * Derive a qualitative health rating from the overall score.
+ */
+export function healthRating(overall) {
+    if (overall >= 0.9)
+        return 'EXCELLENT';
+    if (overall >= 0.75)
+        return 'GOOD';
+    if (overall >= 0.6)
+        return 'FAIR';
+    if (overall >= 0.4)
+        return 'POOR';
+    return 'CRITICAL';
+}
+// ─── AHS: Architecture Health Score ──────────────────────────────────────────
+function computeAHS(dataDir) {
+    const violationScore = loadViolationDensity(dataDir);
+    const confidenceScore = loadConfidenceAverage(dataDir);
+    const driftScore = loadDriftAverage(dataDir);
+    const testCoverageScore = loadTestCoveragePresence(dataDir);
+    const conflictScore = loadConflictSeverityAverage(dataDir);
+    return clamp(AHS_W_VIOLATIONS * violationScore +
+        AHS_W_CONFIDENCE * confidenceScore +
+        AHS_W_DRIFT * (1 - driftScore) + // lower drift = higher score
+        AHS_W_TEST_COVERAGE * testCoverageScore +
+        AHS_W_CONFLICTS * (1 - conflictScore));
+}
+// ─── DRI: Duplication Risk Index ─────────────────────────────────────────────
+function computeDRI(dataDir) {
+    // DRI [0,1] where higher = more duplication risk
+    const overlapFrequency = loadOverlapFrequency(dataDir);
+    const ghostFileRatio = loadGhostFileRatio(dataDir);
+    const fragmentationSignal = loadFragmentationSignal(dataDir);
+    return clamp(0.40 * overlapFrequency +
+        0.30 * ghostFileRatio +
+        0.30 * fragmentationSignal);
+}
+// ─── EDS: Extension Discipline Score ─────────────────────────────────────────
+function computeEDS(dataDir) {
+    const extensionRatio = loadExtensionRatio(dataDir);
+    const insertionCompliance = loadInsertionCompliance(dataDir);
+    const reuseCompliance = loadReuseCompliance(dataDir);
+    return clamp(0.40 * extensionRatio +
+        0.30 * insertionCompliance +
+        0.30 * reuseCompliance);
+}
+// ─── STS: Source-of-Truth Stability ──────────────────────────────────────────
+function computeSTS(dataDir) {
+    const confidenceStability = loadConfidenceStability(dataDir);
+    const changeFrequency = loadSoTChangeFrequency(dataDir);
+    const fragFrequency = loadSoTFragmentationFrequency(dataDir);
+    return clamp(0.40 * confidenceStability +
+        0.30 * (1 - changeFrequency) + // fewer changes = more stable
+        0.30 * (1 - fragFrequency));
+}
+// ─── Override Frequency ──────────────────────────────────────────────────────
+function computeOverrideFrequency(dataDir) {
+    const policyPath = join(dataDir, 'policy-evaluations.json');
+    if (!existsSync(policyPath))
+        return NEUTRAL;
+    try {
+        const data = JSON.parse(readFileSync(policyPath, 'utf-8'));
+        const total = data.total_evaluations ?? 0;
+        const overrides = data.override_count ?? 0;
+        if (total === 0)
+            return NEUTRAL;
+        return clamp(overrides / total);
+    }
+    catch {
+        return NEUTRAL;
+    }
+}
+// ─── Data Loaders (graceful degradation) ─────────────────────────────────────
+function loadViolationDensity(dataDir) {
+    // Review Intelligence findings — fewer violations = higher score
+    const reportPath = join(dataDir, 'verify-report.json');
+    if (!existsSync(reportPath))
+        return NEUTRAL;
+    try {
+        const data = JSON.parse(readFileSync(reportPath, 'utf-8'));
+        const findings = data.review_intelligence?.total_findings ?? 0;
+        const filesScanned = data.review_intelligence?.files_scanned ?? 1;
+        if (filesScanned === 0)
+            return NEUTRAL;
+        // Density: findings per file. Cap at 1.0 and invert so fewer = higher score
+        const density = Math.min(findings / filesScanned, 1.0);
+        return clamp(1 - density);
+    }
+    catch {
+        return NEUTRAL;
+    }
+}
+function loadConfidenceAverage(dataDir) {
+    const metricsPath = join(dataDir, 'team-metrics.json');
+    if (!existsSync(metricsPath))
+        return NEUTRAL;
+    try {
+        const data = JSON.parse(readFileSync(metricsPath, 'utf-8'));
+        return typeof data.avgCcs === 'number' ? clamp(data.avgCcs) : NEUTRAL;
+    }
+    catch {
+        return NEUTRAL;
+    }
+}
+function loadDriftAverage(dataDir) {
+    const metricsPath = join(dataDir, 'team-metrics.json');
+    if (!existsSync(metricsPath))
+        return NEUTRAL;
+    try {
+        const data = JSON.parse(readFileSync(metricsPath, 'utf-8'));
+        return typeof data.avgDrift === 'number' ? clamp(data.avgDrift) : NEUTRAL;
+    }
+    catch {
+        return NEUTRAL;
+    }
+}
+function loadTestCoveragePresence(dataDir) {
+    const reportPath = join(dataDir, 'verify-report.json');
+    if (!existsSync(reportPath))
+        return NEUTRAL;
+    try {
+        const data = JSON.parse(readFileSync(reportPath, 'utf-8'));
+        if (data.coverage_attestation?.coverage_percent !== undefined) {
+            return clamp(data.coverage_attestation.coverage_percent / 100);
+        }
+        if (data.test_coverage_present !== undefined) {
+            return data.test_coverage_present ? 0.8 : 0.2;
+        }
+        return NEUTRAL;
+    }
+    catch {
+        return NEUTRAL;
+    }
+}
+function loadConflictSeverityAverage(dataDir) {
+    const conflictsPath = join(dataDir, 'layer-d-analysis.json');
+    if (!existsSync(conflictsPath))
+        return NEUTRAL;
+    try {
+        const data = JSON.parse(readFileSync(conflictsPath, 'utf-8'));
+        const conflicts = data.conflicts ?? [];
+        if (conflicts.length === 0)
+            return 0; // no conflicts = perfect
+        const avg = conflicts.reduce((sum, c) => sum + c.severity, 0) / conflicts.length;
+        return clamp(avg);
+    }
+    catch {
+        return NEUTRAL;
+    }
+}
+function loadOverlapFrequency(dataDir) {
+    // Look for discovery results
+    const discoveryPath = join(dataDir, 'discovery-results.json');
+    if (!existsSync(discoveryPath))
+        return NEUTRAL;
+    try {
+        const data = JSON.parse(readFileSync(discoveryPath, 'utf-8'));
+        const results = data.results ?? [];
+        if (results.length === 0)
+            return NEUTRAL;
+        const strongOverlaps = results.filter((r) => r.overlap === 'STRONG_OVERLAP' || r.overlap === 'FEATURE_ALREADY_EXISTS').length;
+        return clamp(strongOverlaps / results.length);
+    }
+    catch {
+        return NEUTRAL;
+    }
+}
+function loadGhostFileRatio(dataDir) {
+    const reportPath = join(dataDir, 'verify-report.json');
+    if (!existsSync(reportPath))
+        return NEUTRAL;
+    try {
+        const data = JSON.parse(readFileSync(reportPath, 'utf-8'));
+        const ghosts = data.ghost_files ?? 0;
+        const total = data.total_files ?? 1;
+        if (total === 0)
+            return NEUTRAL;
+        return clamp(ghosts / total);
+    }
+    catch {
+        return NEUTRAL;
+    }
+}
+function loadFragmentationSignal(dataDir) {
+    const sotPath = join(dataDir, 'sot-analysis.json');
+    if (!existsSync(sotPath))
+        return NEUTRAL;
+    try {
+        const data = JSON.parse(readFileSync(sotPath, 'utf-8'));
+        if (data.fragmented === true)
+            return 0.8;
+        if (data.fragmented === false)
+            return 0.1;
+        return NEUTRAL;
+    }
+    catch {
+        return NEUTRAL;
+    }
+}
+function loadExtensionRatio(dataDir) {
+    const statsPath = join(dataDir, 'commit-stats.json');
+    if (!existsSync(statsPath))
+        return NEUTRAL;
+    try {
+        const data = JSON.parse(readFileSync(statsPath, 'utf-8'));
+        const extensions = data.extensions ?? 0;
+        const newFiles = data.new_files ?? 0;
+        const total = extensions + newFiles;
+        if (total === 0)
+            return NEUTRAL;
+        return clamp(extensions / total);
+    }
+    catch {
+        return NEUTRAL;
+    }
+}
+function loadInsertionCompliance(dataDir) {
+    const compliancePath = join(dataDir, 'insertion-compliance.json');
+    if (!existsSync(compliancePath))
+        return NEUTRAL;
+    try {
+        const data = JSON.parse(readFileSync(compliancePath, 'utf-8'));
+        return typeof data.compliance_rate === 'number' ? clamp(data.compliance_rate) : NEUTRAL;
+    }
+    catch {
+        return NEUTRAL;
+    }
+}
+function loadReuseCompliance(dataDir) {
+    const compliancePath = join(dataDir, 'reuse-compliance.json');
+    if (!existsSync(compliancePath))
+        return NEUTRAL;
+    try {
+        const data = JSON.parse(readFileSync(compliancePath, 'utf-8'));
+        return typeof data.compliance_rate === 'number' ? clamp(data.compliance_rate) : NEUTRAL;
+    }
+    catch {
+        return NEUTRAL;
+    }
+}
+function loadConfidenceStability(dataDir) {
+    // Low variance in SoT confidence over time = high stability
+    const historyPath = join(dataDir, 'sot-history.json');
+    if (!existsSync(historyPath))
+        return NEUTRAL;
+    try {
+        const entries = JSON.parse(readFileSync(historyPath, 'utf-8'));
+        if (entries.length < 2)
+            return NEUTRAL;
+        const confidences = entries
+            .map((e) => e.confidence)
+            .filter((c) => typeof c === 'number');
+        if (confidences.length < 2)
+            return NEUTRAL;
+        const mean = confidences.reduce((s, v) => s + v, 0) / confidences.length;
+        const variance = confidences.reduce((s, v) => s + (v - mean) ** 2, 0) / confidences.length;
+        // Low variance = high stability. Variance of [0,1] values is at most 0.25.
+        return clamp(1 - variance * 4);
+    }
+    catch {
+        return NEUTRAL;
+    }
+}
+function loadSoTChangeFrequency(dataDir) {
+    const historyPath = join(dataDir, 'sot-history.json');
+    if (!existsSync(historyPath))
+        return NEUTRAL;
+    try {
+        const entries = JSON.parse(readFileSync(historyPath, 'utf-8'));
+        if (entries.length < 2)
+            return NEUTRAL;
+        let changes = 0;
+        for (let i = 1; i < entries.length; i++) {
+            if (entries[i].system !== entries[i - 1].system)
+                changes++;
+        }
+        return clamp(changes / (entries.length - 1));
+    }
+    catch {
+        return NEUTRAL;
+    }
+}
+function loadSoTFragmentationFrequency(dataDir) {
+    const historyPath = join(dataDir, 'sot-history.json');
+    if (!existsSync(historyPath))
+        return NEUTRAL;
+    try {
+        const entries = JSON.parse(readFileSync(historyPath, 'utf-8'));
+        if (entries.length === 0)
+            return NEUTRAL;
+        const fragCount = entries.filter((e) => e.fragmented === true).length;
+        return clamp(fragCount / entries.length);
+    }
+    catch {
+        return NEUTRAL;
+    }
+}
+// ─── Helpers ─────────────────────────────────────────────────────────────────
+function clamp(value) {
+    return Math.max(0, Math.min(1, value));
+}
+//# sourceMappingURL=metrics.js.map

package/dist/dashboard/metrics.js.map

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

package/dist/dashboard/store.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Dashboard Data Store — Append-only JSONL persistence for dashboard snapshots
+ *
+ * Storage: .codeledger/dashboard-history.jsonl
+ *
+ * Each line is a JSON-encoded DashboardSnapshot.
+ */
+import type { DashboardMetrics, DashboardSnapshot, DashboardTrends } from '@codeledger/types';
+export declare const DASHBOARD_HISTORY_FILE = "dashboard-history.jsonl";
+/**
+ * Append a dashboard metrics snapshot to the JSONL history file.
+ */
+export declare function appendDashboardSnapshot(dataDir: string, metrics: DashboardMetrics, source?: string): void;
+/**
+ * Read all dashboard snapshots from the JSONL history file.
+ * Returns an empty array if the file does not exist.
+ */
+export declare function readDashboardHistory(dataDir: string): DashboardSnapshot[];
+/**
+ * Compute trend directions from dashboard history.
+ *
+ * Uses the last 5 entries to determine if each metric is improving, stable, or degrading.
+ * For DRI and override_frequency, a decrease is "improving" (lower risk is better).
+ */
+export declare function computeTrends(history: DashboardSnapshot[]): DashboardTrends;
+//# sourceMappingURL=store.d.ts.map

package/dist/dashboard/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/dashboard/store.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EACV,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,EAChB,MAAM,mBAAmB,CAAC;AAE3B,eAAO,MAAM,sBAAsB,4BAA4B,CAAC;AAOhE;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,gBAAgB,EACzB,MAAM,GAAE,MAAc,GACrB,IAAI,CAQN;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,iBAAiB,EAAE,CAsBzE;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,iBAAiB,EAAE,GAAG,eAAe,CAyB3E"}