@buoy-design/core 0.1.9 → 0.1.10

package/dist/analysis/drift-aggregator.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Drift Aggregator
+ *
+ * Post-processing layer that groups raw drift signals for actionability
+ * while preserving total counts for severity scoring.
+ */
+import type { DriftSignal } from "../models/index.js";
+export interface DriftGroup {
+    /** Unique ID for this group */
+    id: string;
+    /** What grouped these signals together */
+    groupingKey: {
+        strategy: string;
+        value: string;
+    };
+    /** Human-readable summary */
+    summary: string;
+    /** All individual signals (preserved for scoring) */
+    signals: DriftSignal[];
+    /** Quick access counts */
+    totalCount: number;
+    bySeverity: {
+        critical: number;
+        warning: number;
+        info: number;
+    };
+    /** Unified suggestion if all signals share one */
+    commonSuggestion?: string;
+    /** Representative signal for display */
+    representative: DriftSignal;
+}
+export interface AggregationResult {
+    groups: DriftGroup[];
+    ungrouped: DriftSignal[];
+    totalSignals: number;
+    totalGroups: number;
+    /** Noise reduction metric: 100 signals → 5 groups = 20x */
+    reductionRatio: number;
+}
+export interface GroupingStrategy {
+    /** Unique identifier for this strategy */
+    type: string;
+    /**
+     * Extract a grouping key from a signal.
+     * @returns Grouping key string, or null if strategy doesn't apply
+     */
+    getKey(signal: DriftSignal): string | null;
+    /**
+     * Generate human-readable summary for a group.
+     */
+    summarize(signals: DriftSignal[], key: string): string;
+}
+export type BuiltInStrategyType = "value" | "suggestion" | "path" | "entity";
+export interface AggregatorOptions {
+    /** Strategies to apply, in priority order. First match wins. */
+    strategies?: Array<BuiltInStrategyType | GroupingStrategy>;
+    /** Minimum signals to form a group (default: 2) */
+    minGroupSize?: number;
+    /** Path patterns for path-based grouping */
+    pathPatterns?: string[];
+}
+export declare class DriftAggregator {
+    private strategies;
+    private options;
+    constructor(options?: AggregatorOptions);
+    private resolveStrategy;
+    /**
+     * Aggregate signals into groups.
+     * Returns both grouped and ungrouped for flexible consumption.
+     */
+    aggregate(signals: DriftSignal[]): AggregationResult;
+    private applyStrategy;
+    private createGroup;
+}
+export declare const builtInStrategies: {
+    readonly value: GroupingStrategy;
+    readonly suggestion: GroupingStrategy;
+    readonly path: GroupingStrategy;
+    readonly entity: GroupingStrategy;
+};
+export declare function createStrategy(config: GroupingStrategy): GroupingStrategy;
+//# sourceMappingURL=drift-aggregator.d.ts.map

package/dist/analysis/drift-aggregator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"drift-aggregator.d.ts","sourceRoot":"","sources":["../../src/analysis/drift-aggregator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAMtD,MAAM,WAAW,UAAU;IACzB,+BAA+B;IAC/B,EAAE,EAAE,MAAM,CAAC;IAEX,0CAA0C;IAC1C,WAAW,EAAE;QACX,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;IAEF,6BAA6B;IAC7B,OAAO,EAAE,MAAM,CAAC;IAEhB,qDAAqD;IACrD,OAAO,EAAE,WAAW,EAAE,CAAC;IAEvB,0BAA0B;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAEhE,kDAAkD;IAClD,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B,wCAAwC;IACxC,cAAc,EAAE,WAAW,CAAC;CAC7B;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,SAAS,EAAE,WAAW,EAAE,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,2DAA2D;IAC3D,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,gBAAgB;IAC/B,0CAA0C;IAC1C,IAAI,EAAE,MAAM,CAAC;IAEb;;;OAGG;IACH,MAAM,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,GAAG,IAAI,CAAC;IAE3C;;OAEG;IACH,SAAS,CAAC,OAAO,EAAE,WAAW,EAAE,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;CACxD;AAED,MAAM,MAAM,mBAAmB,GAAG,OAAO,GAAG,YAAY,GAAG,MAAM,GAAG,QAAQ,CAAC;AAE7E,MAAM,WAAW,iBAAiB;IAChC,gEAAgE;IAChE,UAAU,CAAC,EAAE,KAAK,CAAC,mBAAmB,GAAG,gBAAgB,CAAC,CAAC;IAE3D,mDAAmD;IACnD,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,4CAA4C;IAC5C,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAgJD,qBAAa,eAAe;IAC1B,OAAO,CAAC,UAAU,CAAqB;IACvC,OAAO,CAAC,OAAO,CAAkD;gBAErD,OAAO,GAAE,iBAAsB;IAgB3C,OAAO,CAAC,eAAe;IAqBvB;;;OAGG;IACH,SAAS,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,iBAAiB;IAgCpD,OAAO,CAAC,aAAa;IAgCrB,OAAO,CAAC,WAAW;CAoBpB;AAMD,eAAO,MAAM,iBAAiB;;;;;CAKpB,CAAC;AAEX,wBAAgB,cAAc,CAAC,MAAM,EAAE,gBAAgB,GAAG,gBAAgB,CAEzE"}

package/dist/analysis/drift-aggregator.js

@@ -0,0 +1,241 @@
+/**
+ * Drift Aggregator
+ *
+ * Post-processing layer that groups raw drift signals for actionability
+ * while preserving total counts for severity scoring.
+ */
+// ============================================================================
+// Built-in Strategies
+// ============================================================================
+const valueStrategy = {
+    type: "value",
+    getKey(signal) {
+        if (signal.type !== "hardcoded-value")
+            return null;
+        const actual = signal.details.actual;
+        if (typeof actual !== "string")
+            return null;
+        return `value:${actual}`;
+    },
+    summarize(signals, key) {
+        const value = key.replace("value:", "");
+        return `${signals.length} components use hardcoded value "${value}"`;
+    },
+};
+const suggestionStrategy = {
+    type: "suggestion",
+    getKey(signal) {
+        const suggestions = signal.details.tokenSuggestions;
+        if (!suggestions?.length)
+            return null;
+        // Parse: "value → tokenName (confidence)"
+        const first = suggestions[0];
+        if (!first)
+            return null;
+        const match = first.match(/→\s*([^\s(]+)/);
+        if (!match)
+            return null;
+        return `suggestion:${match[1]}`;
+    },
+    summarize(signals, key) {
+        const token = key.replace("suggestion:", "");
+        return `${signals.length} issues fixable by using ${token}`;
+    },
+};
+function createPathStrategy(patterns) {
+    return {
+        type: "path",
+        getKey(signal) {
+            const location = signal.source.location;
+            if (!location || !location.includes("/"))
+                return null;
+            // Check configured patterns first
+            for (const pattern of patterns) {
+                if (matchGlob(location, pattern)) {
+                    return `path:${pattern}`;
+                }
+            }
+            // Fallback: group by directory
+            const parts = location.split("/");
+            if (parts.length >= 2) {
+                const dir = parts.slice(0, -1).join("/");
+                return `path:${dir}`;
+            }
+            return null;
+        },
+        summarize(signals, key) {
+            const path = key.replace("path:", "");
+            const types = [...new Set(signals.map((s) => s.type))];
+            return `${signals.length} issues in ${path}/ (${types.join(", ")})`;
+        },
+    };
+}
+const entityStrategy = {
+    type: "entity",
+    getKey(signal) {
+        return `entity:${signal.source.entityId}`;
+    },
+    summarize(signals, _key) {
+        const entityName = signals[0]?.source.entityName ?? "Unknown";
+        const types = [...new Set(signals.map((s) => s.type))];
+        if (types.length === 1) {
+            return `${signals.length} ${types[0]} issues in ${entityName}`;
+        }
+        return `${signals.length} issues in ${entityName} (${types.join(", ")})`;
+    },
+};
+// ============================================================================
+// Helpers
+// ============================================================================
+function matchGlob(path, pattern) {
+    // Convert glob to regex
+    // Use placeholder for ** to avoid single-star replacement affecting it
+    const regex = new RegExp("^" +
+        pattern
+            .replace(/\*\*/g, "<<<GLOBSTAR>>>")
+            .replace(/\*/g, "[^/]*")
+            .replace(/<<<GLOBSTAR>>>/g, ".*") +
+        "$");
+    return regex.test(path);
+}
+function countBySeverity(signals) {
+    const counts = { critical: 0, warning: 0, info: 0 };
+    for (const signal of signals) {
+        counts[signal.severity]++;
+    }
+    return counts;
+}
+function generateGroupId(strategy, key) {
+    // Simple hash for stable IDs
+    const content = `${strategy}:${key}`;
+    let hash = 0;
+    for (let i = 0; i < content.length; i++) {
+        const char = content.charCodeAt(i);
+        hash = (hash << 5) - hash + char;
+        hash = hash & hash;
+    }
+    return `group:${strategy}:${Math.abs(hash).toString(16)}`;
+}
+// ============================================================================
+// DriftAggregator
+// ============================================================================
+export class DriftAggregator {
+    strategies;
+    options;
+    constructor(options = {}) {
+        this.options = {
+            minGroupSize: options.minGroupSize ?? 2,
+            pathPatterns: options.pathPatterns ?? [],
+        };
+        // Build strategy list
+        const strategyDefs = options.strategies ?? [
+            "value",
+            "suggestion",
+            "path",
+            "entity",
+        ];
+        this.strategies = strategyDefs.map((s) => this.resolveStrategy(s));
+    }
+    resolveStrategy(strategy) {
+        if (typeof strategy === "object") {
+            return strategy;
+        }
+        switch (strategy) {
+            case "value":
+                return valueStrategy;
+            case "suggestion":
+                return suggestionStrategy;
+            case "path":
+                return createPathStrategy(this.options.pathPatterns);
+            case "entity":
+                return entityStrategy;
+            default:
+                throw new Error(`Unknown strategy: ${strategy}`);
+        }
+    }
+    /**
+     * Aggregate signals into groups.
+     * Returns both grouped and ungrouped for flexible consumption.
+     */
+    aggregate(signals) {
+        if (signals.length === 0) {
+            return {
+                groups: [],
+                ungrouped: [],
+                totalSignals: 0,
+                totalGroups: 0,
+                reductionRatio: 1,
+            };
+        }
+        const groups = [];
+        let remaining = [...signals];
+        // Multi-pass: each strategy gets a shot at remaining signals
+        for (const strategy of this.strategies) {
+            const { formed, leftover } = this.applyStrategy(strategy, remaining);
+            groups.push(...formed);
+            remaining = leftover;
+        }
+        const outputCount = groups.length + remaining.length;
+        return {
+            groups,
+            ungrouped: remaining,
+            totalSignals: signals.length,
+            totalGroups: groups.length,
+            reductionRatio: outputCount > 0 ? signals.length / outputCount : 1,
+        };
+    }
+    applyStrategy(strategy, signals) {
+        const buckets = new Map();
+        const noKey = [];
+        for (const signal of signals) {
+            const key = strategy.getKey(signal);
+            if (key) {
+                const bucket = buckets.get(key) ?? [];
+                bucket.push(signal);
+                buckets.set(key, bucket);
+            }
+            else {
+                noKey.push(signal);
+            }
+        }
+        const formed = [];
+        const leftover = [...noKey];
+        for (const [key, bucket] of buckets) {
+            if (bucket.length >= this.options.minGroupSize) {
+                formed.push(this.createGroup(strategy, key, bucket));
+            }
+            else {
+                leftover.push(...bucket);
+            }
+        }
+        return { formed, leftover };
+    }
+    createGroup(strategy, key, signals) {
+        const keyValue = key.includes(":") ? key.split(":").slice(1).join(":") : key;
+        return {
+            id: generateGroupId(strategy.type, key),
+            groupingKey: {
+                strategy: strategy.type,
+                value: keyValue,
+            },
+            summary: strategy.summarize(signals, key),
+            signals,
+            totalCount: signals.length,
+            bySeverity: countBySeverity(signals),
+            representative: signals[0],
+        };
+    }
+}
+// ============================================================================
+// Exports for extensibility
+// ============================================================================
+export const builtInStrategies = {
+    value: valueStrategy,
+    suggestion: suggestionStrategy,
+    path: createPathStrategy([]),
+    entity: entityStrategy,
+};
+export function createStrategy(config) {
+    return config;
+}
+//# sourceMappingURL=drift-aggregator.js.map

package/dist/analysis/drift-aggregator.js.map

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

package/dist/analysis/index.d.ts

@@ -3,4 +3,5 @@ export { TokenSuggestionService, type TokenSuggestion, } from "./token-suggestio
 export { stringSimilarity, levenshteinDistance, normalizeForComparison, } from "./string-utils.js";
 export { MATCHING_CONFIG, NAMING_CONFIG, TOKEN_SUGGESTION_CONFIG, SCANNER_CONFIG, getOutlierThreshold, } from "./config.js";
 export { generateAuditReport, findCloseMatches, calculateHealthScore, type AuditValue, type AuditReport, type CategoryStats, type FileIssue, type CloseMatch, } from "./audit.js";
+export { DriftAggregator, createStrategy, builtInStrategies, type DriftGroup, type AggregationResult, type GroupingStrategy, type AggregatorOptions, type BuiltInStrategyType, } from "./drift-aggregator.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/analysis/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,KAAK,cAAc,EACnB,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,KAAK,eAAe,EACpB,KAAK,WAAW,EAChB,KAAK,eAAe,GACrB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,sBAAsB,EACtB,KAAK,eAAe,GACrB,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,sBAAsB,GACvB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,eAAe,EACf,aAAa,EACb,uBAAuB,EACvB,cAAc,EACd,mBAAmB,GACpB,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,mBAAmB,EACnB,gBAAgB,EAChB,oBAAoB,EACpB,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,SAAS,EACd,KAAK,UAAU,GAChB,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/analysis/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,KAAK,cAAc,EACnB,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,KAAK,eAAe,EACpB,KAAK,WAAW,EAChB,KAAK,eAAe,GACrB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,sBAAsB,EACtB,KAAK,eAAe,GACrB,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,sBAAsB,GACvB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,eAAe,EACf,aAAa,EACb,uBAAuB,EACvB,cAAc,EACd,mBAAmB,GACpB,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,mBAAmB,EACnB,gBAAgB,EAChB,oBAAoB,EACpB,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,SAAS,EACd,KAAK,UAAU,GAChB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,eAAe,EACf,cAAc,EACd,iBAAiB,EACjB,KAAK,UAAU,EACf,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,GACzB,MAAM,uBAAuB,CAAC"}

package/dist/analysis/index.js

@@ -7,4 +7,6 @@ export { stringSimilarity, levenshteinDistance, normalizeForComparison, } from "
 export { MATCHING_CONFIG, NAMING_CONFIG, TOKEN_SUGGESTION_CONFIG, SCANNER_CONFIG, getOutlierThreshold, } from "./config.js";
 // Audit report
 export { generateAuditReport, findCloseMatches, calculateHealthScore, } from "./audit.js";
+// Drift aggregation
+export { DriftAggregator, createStrategy, builtInStrategies, } from "./drift-aggregator.js";
 //# sourceMappingURL=index.js.map

package/dist/analysis/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/analysis/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,GAOnB,MAAM,oBAAoB,CAAC;AAE5B,6BAA6B;AAC7B,OAAO,EACL,sBAAsB,GAEvB,MAAM,wBAAwB,CAAC;AAEhC,mBAAmB;AACnB,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,sBAAsB,GACvB,MAAM,mBAAmB,CAAC;AAE3B,yBAAyB;AACzB,OAAO,EACL,eAAe,EACf,aAAa,EACb,uBAAuB,EACvB,cAAc,EACd,mBAAmB,GACpB,MAAM,aAAa,CAAC;AAErB,eAAe;AACf,OAAO,EACL,mBAAmB,EACnB,gBAAgB,EAChB,oBAAoB,GAMrB,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/analysis/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,GAOnB,MAAM,oBAAoB,CAAC;AAE5B,6BAA6B;AAC7B,OAAO,EACL,sBAAsB,GAEvB,MAAM,wBAAwB,CAAC;AAEhC,mBAAmB;AACnB,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,sBAAsB,GACvB,MAAM,mBAAmB,CAAC;AAE3B,yBAAyB;AACzB,OAAO,EACL,eAAe,EACf,aAAa,EACb,uBAAuB,EACvB,cAAc,EACd,mBAAmB,GACpB,MAAM,aAAa,CAAC;AAErB,eAAe;AACf,OAAO,EACL,mBAAmB,EACnB,gBAAgB,EAChB,oBAAoB,GAMrB,MAAM,YAAY,CAAC;AAEpB,oBAAoB;AACpB,OAAO,EACL,eAAe,EACf,cAAc,EACd,iBAAiB,GAMlB,MAAM,uBAAuB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@buoy-design/core",
-  "version": "0.1.9",
+  "version": "0.1.10",
   "description": "Core domain models and analysis for Buoy design drift detection",
   "type": "module",
   "license": "MIT",