@buoy-design/core 0.1.3 → 0.1.4

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Buoy
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/fix/confidence.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Confidence scoring for fix suggestions
+ *
+ * Determines how confident we are that a fix is correct and safe to apply.
+ */
+import type { DesignToken } from '../models/index.js';
+import type { ConfidenceLevel } from '../models/fix.js';
+export interface ConfidenceResult {
+    level: ConfidenceLevel;
+    score: number;
+    reason: string;
+}
+/**
+ * Score confidence for a color replacement
+ */
+export declare function scoreColorConfidence(original: string, token: DesignToken): ConfidenceResult;
+/**
+ * Score confidence for a spacing replacement
+ */
+export declare function scoreSpacingConfidence(original: string, token: DesignToken): ConfidenceResult;
+/**
+ * Score confidence for any fix type
+ */
+export declare function scoreConfidence(original: string, token: DesignToken, fixType: string): ConfidenceResult;
+//# sourceMappingURL=confidence.d.ts.map

package/dist/fix/confidence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"confidence.d.ts","sourceRoot":"","sources":["../../src/fix/confidence.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAExD,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,eAAe,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,WAAW,GACjB,gBAAgB,CA+DlB;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,WAAW,GACjB,gBAAgB,CAmElB;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,WAAW,EAClB,OAAO,EAAE,MAAM,GACd,gBAAgB,CAWlB"}

package/dist/fix/confidence.js

@@ -0,0 +1,221 @@
+/**
+ * Confidence scoring for fix suggestions
+ *
+ * Determines how confident we are that a fix is correct and safe to apply.
+ */
+/**
+ * Score confidence for a color replacement
+ */
+export function scoreColorConfidence(original, token) {
+    if (token.value.type !== 'color') {
+        return { level: 'low', score: 0, reason: 'Token is not a color' };
+    }
+    const normalizedOriginal = normalizeColor(original);
+    const tokenHex = token.value.hex.toLowerCase();
+    // Exact match
+    if (normalizedOriginal === tokenHex) {
+        return {
+            level: 'high',
+            score: 100,
+            reason: `Exact match to ${token.name}`,
+        };
+    }
+    // Calculate color distance
+    const distance = colorDistance(normalizedOriginal, tokenHex);
+    if (distance === 0) {
+        return {
+            level: 'high',
+            score: 100,
+            reason: `Exact match to ${token.name}`,
+        };
+    }
+    if (distance <= 5) {
+        // Very close colors (imperceptible difference)
+        const score = 98 - distance;
+        return {
+            level: 'high',
+            score,
+            reason: `Near-exact match to ${token.name} (deltaE: ${distance.toFixed(1)})`,
+        };
+    }
+    if (distance <= 15) {
+        // Close colors (slight difference)
+        const score = 90 - distance * 2;
+        return {
+            level: 'medium',
+            score: Math.max(70, score),
+            reason: `Close match to ${token.name} (deltaE: ${distance.toFixed(1)})`,
+        };
+    }
+    if (distance <= 30) {
+        // Somewhat similar colors
+        const score = 70 - distance;
+        return {
+            level: 'low',
+            score: Math.max(40, score),
+            reason: `Possible match to ${token.name} (deltaE: ${distance.toFixed(1)})`,
+        };
+    }
+    return {
+        level: 'low',
+        score: 20,
+        reason: `Weak match to ${token.name} (deltaE: ${distance.toFixed(1)})`,
+    };
+}
+/**
+ * Score confidence for a spacing replacement
+ */
+export function scoreSpacingConfidence(original, token) {
+    if (token.value.type !== 'spacing') {
+        return { level: 'low', score: 0, reason: 'Token is not a spacing value' };
+    }
+    const originalPx = parseSpacingToPx(original);
+    if (originalPx === null) {
+        return { level: 'low', score: 0, reason: 'Could not parse original spacing' };
+    }
+    const tokenPx = convertToPx(token.value.value, token.value.unit);
+    // Exact match
+    if (originalPx === tokenPx) {
+        return {
+            level: 'high',
+            score: 100,
+            reason: `Exact match to ${token.name}`,
+        };
+    }
+    const diff = Math.abs(originalPx - tokenPx);
+    const percentDiff = (diff / Math.max(originalPx, tokenPx, 1)) * 100;
+    if (diff <= 1) {
+        // Within 1px (likely rounding)
+        return {
+            level: 'high',
+            score: 98,
+            reason: `Near-exact match to ${token.name} (${diff}px difference)`,
+        };
+    }
+    if (diff <= 2) {
+        // Within 2px
+        return {
+            level: 'high',
+            score: 95,
+            reason: `Close match to ${token.name} (${diff}px difference)`,
+        };
+    }
+    if (percentDiff <= 10) {
+        // Within 10% difference
+        const score = 90 - percentDiff;
+        return {
+            level: 'medium',
+            score: Math.max(70, score),
+            reason: `Approximate match to ${token.name} (${diff}px / ${percentDiff.toFixed(0)}% difference)`,
+        };
+    }
+    if (percentDiff <= 25) {
+        // Within 25% difference
+        const score = 70 - percentDiff;
+        return {
+            level: 'low',
+            score: Math.max(40, score),
+            reason: `Possible match to ${token.name} (${diff}px / ${percentDiff.toFixed(0)}% difference)`,
+        };
+    }
+    return {
+        level: 'low',
+        score: 20,
+        reason: `Weak match to ${token.name} (${diff}px difference)`,
+    };
+}
+/**
+ * Score confidence for any fix type
+ */
+export function scoreConfidence(original, token, fixType) {
+    switch (fixType) {
+        case 'hardcoded-color':
+            return scoreColorConfidence(original, token);
+        case 'hardcoded-spacing':
+        case 'hardcoded-radius':
+        case 'hardcoded-font-size':
+            return scoreSpacingConfidence(original, token);
+        default:
+            return { level: 'low', score: 0, reason: 'Unknown fix type' };
+    }
+}
+// Helper functions
+/**
+ * Normalize color to lowercase hex
+ */
+function normalizeColor(color) {
+    const trimmed = color.trim().toLowerCase();
+    // Already hex
+    if (/^#[0-9a-f]{6}$/i.test(trimmed)) {
+        return trimmed;
+    }
+    if (/^#[0-9a-f]{3}$/i.test(trimmed)) {
+        // Expand shorthand
+        return `#${trimmed[1]}${trimmed[1]}${trimmed[2]}${trimmed[2]}${trimmed[3]}${trimmed[3]}`;
+    }
+    if (/^#[0-9a-f]{8}$/i.test(trimmed)) {
+        // Strip alpha
+        return trimmed.slice(0, 7);
+    }
+    // RGB/RGBA
+    const rgbMatch = trimmed.match(/rgba?\s*\(\s*(\d+)\s*,\s*(\d+)\s*,\s*(\d+)/);
+    if (rgbMatch) {
+        const r = parseInt(rgbMatch[1], 10).toString(16).padStart(2, '0');
+        const g = parseInt(rgbMatch[2], 10).toString(16).padStart(2, '0');
+        const b = parseInt(rgbMatch[3], 10).toString(16).padStart(2, '0');
+        return `#${r}${g}${b}`;
+    }
+    return trimmed;
+}
+/**
+ * Calculate color distance (simplified deltaE)
+ */
+function colorDistance(hex1, hex2) {
+    const rgb1 = hexToRgb(hex1);
+    const rgb2 = hexToRgb(hex2);
+    if (!rgb1 || !rgb2)
+        return 100;
+    // Simple Euclidean distance in RGB space
+    const distance = Math.sqrt(Math.pow(rgb1.r - rgb2.r, 2) +
+        Math.pow(rgb1.g - rgb2.g, 2) +
+        Math.pow(rgb1.b - rgb2.b, 2));
+    // Normalize to 0-100 scale (max distance is ~441)
+    return (distance / 441) * 100;
+}
+/**
+ * Convert hex to RGB
+ */
+function hexToRgb(hex) {
+    const match = hex.match(/^#([0-9a-f]{2})([0-9a-f]{2})([0-9a-f]{2})$/i);
+    if (!match)
+        return null;
+    return {
+        r: parseInt(match[1], 16),
+        g: parseInt(match[2], 16),
+        b: parseInt(match[3], 16),
+    };
+}
+/**
+ * Parse spacing value to pixels
+ */
+function parseSpacingToPx(value) {
+    const match = value.trim().match(/^(-?[\d.]+)\s*(px|rem|em)?$/i);
+    if (!match)
+        return null;
+    const num = parseFloat(match[1]);
+    const unit = (match[2] || 'px').toLowerCase();
+    return convertToPx(num, unit);
+}
+/**
+ * Convert value to pixels
+ */
+function convertToPx(value, unit) {
+    switch (unit) {
+        case 'rem':
+        case 'em':
+            return value * 16; // Assume 16px base
+        default:
+            return value;
+    }
+}
+//# sourceMappingURL=confidence.js.map

package/dist/fix/confidence.js.map

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

package/dist/fix/generator.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Fix Generator
+ *
+ * Generates Fix objects from DriftSignals by matching hardcoded values to design tokens.
+ */
+import type { DriftSignal, DesignToken } from '../models/index.js';
+import type { Fix, FixGeneratorOptions, ConfidenceLevel } from '../models/fix.js';
+/**
+ * Generate fixes from drift signals
+ */
+export declare function generateFixes(drifts: DriftSignal[], tokens: DesignToken[], options?: FixGeneratorOptions): Fix[];
+/**
+ * Get summary of fixes grouped by type and confidence
+ */
+export declare function summarizeFixes(fixes: Fix[]): {
+    total: number;
+    byConfidence: Record<ConfidenceLevel, number>;
+    byType: Record<string, number>;
+    highConfidenceCount: number;
+};
+//# sourceMappingURL=generator.d.ts.map

package/dist/fix/generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../../src/fix/generator.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACnE,OAAO,KAAK,EAAE,GAAG,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAgBlF;;GAEG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,WAAW,EAAE,EACrB,MAAM,EAAE,WAAW,EAAE,EACrB,OAAO,GAAE,mBAAwB,GAChC,GAAG,EAAE,CAoCP;AA6ND;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG;IAC5C,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC,eAAe,EAAE,MAAM,CAAC,CAAC;IAC9C,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,mBAAmB,EAAE,MAAM,CAAC;CAC7B,CAqBA"}

package/dist/fix/generator.js

@@ -0,0 +1,250 @@
+/**
+ * Fix Generator
+ *
+ * Generates Fix objects from DriftSignals by matching hardcoded values to design tokens.
+ */
+import { createFixId, meetsConfidenceThreshold } from '../models/fix.js';
+import { scoreConfidence } from './confidence.js';
+/**
+ * Supported fix types for V1
+ */
+const SUPPORTED_FIX_TYPES = [
+    'hardcoded-color',
+    'hardcoded-spacing',
+    'hardcoded-radius',
+    'hardcoded-font-size',
+];
+/**
+ * Generate fixes from drift signals
+ */
+export function generateFixes(drifts, tokens, options = {}) {
+    const { types = [...SUPPORTED_FIX_TYPES], minConfidence = 'low', includeFiles = [], excludeFiles = [], } = options;
+    const fixes = [];
+    for (const drift of drifts) {
+        // Filter by drift type
+        if (!isSupportedFixType(drift.type))
+            continue;
+        if (!types.includes(drift.type))
+            continue;
+        // Filter by file patterns
+        const file = drift.source.location?.split(':')[0] || '';
+        if (!matchesFilePatterns(file, includeFiles, excludeFiles))
+            continue;
+        // Try to generate a fix
+        const fix = generateFixForDrift(drift, tokens);
+        if (!fix)
+            continue;
+        // Filter by confidence
+        if (!meetsConfidenceThreshold(fix.confidence, minConfidence))
+            continue;
+        fixes.push(fix);
+    }
+    // Sort by confidence (high first) then by file
+    return fixes.sort((a, b) => {
+        const confidenceOrder = { high: 0, medium: 1, low: 2 };
+        const confDiff = confidenceOrder[a.confidence] - confidenceOrder[b.confidence];
+        if (confDiff !== 0)
+            return confDiff;
+        return a.file.localeCompare(b.file);
+    });
+}
+/**
+ * Generate a fix for a single drift signal
+ */
+function generateFixForDrift(drift, tokens) {
+    // Extract the hardcoded value from drift details
+    const hardcodedValue = getHardcodedValue(drift);
+    if (!hardcodedValue)
+        return null;
+    // Find the best matching token
+    const match = findBestTokenMatch(hardcodedValue, drift.type, tokens);
+    if (!match)
+        return null;
+    // Parse location
+    const location = parseLocation(drift.source.location);
+    if (!location)
+        return null;
+    // Generate replacement
+    const replacement = generateReplacement(match.token, drift.type);
+    if (!replacement)
+        return null;
+    return {
+        id: createFixId(location.file, location.line, location.column),
+        driftSignalId: drift.id,
+        confidence: match.confidence.level,
+        confidenceScore: match.confidence.score,
+        file: location.file,
+        line: location.line,
+        column: location.column,
+        original: hardcodedValue,
+        replacement,
+        reason: match.confidence.reason,
+        fixType: drift.type,
+        tokenName: match.token.name,
+    };
+}
+/**
+ * Check if drift type is supported for fixing
+ */
+function isSupportedFixType(type) {
+    return SUPPORTED_FIX_TYPES.includes(type);
+}
+/**
+ * Check if file matches include/exclude patterns
+ */
+function matchesFilePatterns(file, includePatterns, excludePatterns) {
+    // If no include patterns, include all
+    if (includePatterns.length > 0) {
+        const included = includePatterns.some((pattern) => simpleGlobMatch(file, pattern));
+        if (!included)
+            return false;
+    }
+    // Check exclude patterns
+    if (excludePatterns.length > 0) {
+        const excluded = excludePatterns.some((pattern) => simpleGlobMatch(file, pattern));
+        if (excluded)
+            return false;
+    }
+    return true;
+}
+/**
+ * Simple glob-like pattern matching
+ * Supports * (any chars except /) and ** (any chars including /)
+ */
+function simpleGlobMatch(file, pattern) {
+    // Convert glob pattern to regex
+    const regexStr = pattern
+        .replace(/[.+^${}()|[\]\\]/g, '\\$&') // Escape special regex chars
+        .replace(/\*\*/g, '{{GLOBSTAR}}') // Placeholder for **
+        .replace(/\*/g, '[^/]*') // * matches anything except /
+        .replace(/{{GLOBSTAR}}/g, '.*'); // ** matches anything including /
+    const regex = new RegExp(`^${regexStr}$|/${regexStr}$|^${regexStr}/`);
+    return regex.test(file);
+}
+/**
+ * Extract hardcoded value from drift signal
+ */
+function getHardcodedValue(drift) {
+    // Check details.actual first (the hardcoded value found)
+    if (drift.details?.actual && typeof drift.details.actual === 'string') {
+        return drift.details.actual;
+    }
+    // Try to extract from message
+    // Common patterns: "Found hardcoded color #ffffff", "value '#3b82f6'"
+    const hexMatch = drift.message.match(/#[0-9a-fA-F]{3,8}\b/);
+    if (hexMatch)
+        return hexMatch[0];
+    const rgbMatch = drift.message.match(/rgba?\s*\([^)]+\)/i);
+    if (rgbMatch)
+        return rgbMatch[0];
+    const pxMatch = drift.message.match(/\b\d+(?:\.\d+)?px\b/);
+    if (pxMatch)
+        return pxMatch[0];
+    return null;
+}
+/**
+ * Find the best matching token for a hardcoded value
+ */
+function findBestTokenMatch(value, driftType, tokens) {
+    const relevantTokens = filterTokensByType(tokens, driftType);
+    if (relevantTokens.length === 0)
+        return null;
+    let bestMatch = null;
+    for (const token of relevantTokens) {
+        const confidence = scoreConfidence(value, token, driftType);
+        if (!bestMatch || confidence.score > bestMatch.confidence.score) {
+            bestMatch = { token, confidence };
+        }
+    }
+    // Only return if we have a reasonable match
+    if (bestMatch && bestMatch.confidence.score >= 40) {
+        return bestMatch;
+    }
+    return null;
+}
+/**
+ * Filter tokens by drift type
+ */
+function filterTokensByType(tokens, driftType) {
+    switch (driftType) {
+        case 'hardcoded-color':
+            return tokens.filter((t) => t.category === 'color');
+        case 'hardcoded-spacing':
+        case 'hardcoded-radius':
+            return tokens.filter((t) => t.category === 'spacing');
+        case 'hardcoded-font-size':
+            return tokens.filter((t) => t.category === 'typography' || t.category === 'sizing');
+        default:
+            return [];
+    }
+}
+/**
+ * Generate replacement string for a token
+ */
+function generateReplacement(token, driftType) {
+    // Default to CSS custom property
+    const cssVarName = tokenToCssVar(token.name);
+    switch (driftType) {
+        case 'hardcoded-color':
+            return `var(${cssVarName})`;
+        case 'hardcoded-spacing':
+        case 'hardcoded-radius':
+        case 'hardcoded-font-size':
+            return `var(${cssVarName})`;
+        default:
+            return null;
+    }
+}
+/**
+ * Convert token name to CSS custom property name
+ */
+function tokenToCssVar(name) {
+    // If already has -- prefix, use as-is
+    if (name.startsWith('--'))
+        return name;
+    // Convert camelCase or dot notation to kebab-case
+    const kebab = name
+        .replace(/\./g, '-')
+        .replace(/([a-z])([A-Z])/g, '$1-$2')
+        .toLowerCase();
+    return `--${kebab}`;
+}
+/**
+ * Parse location string into file, line, column
+ */
+function parseLocation(location) {
+    if (!location)
+        return null;
+    // Format: "file/path.tsx:10:5" or "file/path.tsx:10"
+    const match = location.match(/^(.+?):(\d+)(?::(\d+))?$/);
+    if (!match)
+        return null;
+    return {
+        file: match[1],
+        line: parseInt(match[2], 10),
+        column: match[3] ? parseInt(match[3], 10) : 1,
+    };
+}
+/**
+ * Get summary of fixes grouped by type and confidence
+ */
+export function summarizeFixes(fixes) {
+    const byConfidence = {
+        high: 0,
+        medium: 0,
+        low: 0,
+    };
+    const byType = {};
+    for (const fix of fixes) {
+        const conf = fix.confidence;
+        byConfidence[conf] = (byConfidence[conf] || 0) + 1;
+        byType[fix.fixType] = (byType[fix.fixType] || 0) + 1;
+    }
+    return {
+        total: fixes.length,
+        byConfidence,
+        byType,
+        highConfidenceCount: byConfidence.high || 0,
+    };
+}
+//# sourceMappingURL=generator.js.map

package/dist/fix/generator.js.map

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

package/dist/fix/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Fix module - generates and applies fixes for drift signals
+ */
+export { scoreConfidence, scoreColorConfidence, scoreSpacingConfidence } from './confidence.js';
+export type { ConfidenceResult } from './confidence.js';
+export { generateFixes, summarizeFixes } from './generator.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/fix/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAChG,YAAY,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAGxD,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/fix/index.js

@@ -0,0 +1,8 @@
+/**
+ * Fix module - generates and applies fixes for drift signals
+ */
+// Re-export confidence scoring
+export { scoreConfidence, scoreColorConfidence, scoreSpacingConfidence } from './confidence.js';
+// Re-export fix generator
+export { generateFixes, summarizeFixes } from './generator.js';
+//# sourceMappingURL=index.js.map

package/dist/fix/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/fix/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,+BAA+B;AAC/B,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAGhG,0BAA0B;AAC1B,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/index.d.ts

@@ -5,4 +5,5 @@ export * from './tokenization/index.js';
 export * from './plugins/index.js';
 export * from './tokens/index.js';
 export * from './graph/index.js';
+export * from './fix/index.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,mBAAmB,CAAC;AAGlC,cAAc,qBAAqB,CAAC;AAGpC,cAAc,uBAAuB,CAAC;AAGtC,cAAc,yBAAyB,CAAC;AAGxC,cAAc,oBAAoB,CAAC;AAGnC,cAAc,mBAAmB,CAAC;AAGlC,cAAc,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,mBAAmB,CAAC;AAGlC,cAAc,qBAAqB,CAAC;AAGpC,cAAc,uBAAuB,CAAC;AAGtC,cAAc,yBAAyB,CAAC;AAGxC,cAAc,oBAAoB,CAAC;AAGnC,cAAc,mBAAmB,CAAC;AAGlC,cAAc,kBAAkB,CAAC;AAGjC,cAAc,gBAAgB,CAAC"}

package/dist/index.js

@@ -12,4 +12,6 @@ export * from './plugins/index.js';
 export * from './tokens/index.js';
 // Re-export graph
 export * from './graph/index.js';
+// Re-export fix
+export * from './fix/index.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,uBAAuB;AACvB,cAAc,mBAAmB,CAAC;AAElC,qBAAqB;AACrB,cAAc,qBAAqB,CAAC;AAEpC,uBAAuB;AACvB,cAAc,uBAAuB,CAAC;AAEtC,yBAAyB;AACzB,cAAc,yBAAyB,CAAC;AAExC,oBAAoB;AACpB,cAAc,oBAAoB,CAAC;AAEnC,0BAA0B;AAC1B,cAAc,mBAAmB,CAAC;AAElC,kBAAkB;AAClB,cAAc,kBAAkB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,uBAAuB;AACvB,cAAc,mBAAmB,CAAC;AAElC,qBAAqB;AACrB,cAAc,qBAAqB,CAAC;AAEpC,uBAAuB;AACvB,cAAc,uBAAuB,CAAC;AAEtC,yBAAyB;AACzB,cAAc,yBAAyB,CAAC;AAExC,oBAAoB;AACpB,cAAc,oBAAoB,CAAC;AAEnC,0BAA0B;AAC1B,cAAc,mBAAmB,CAAC;AAElC,kBAAkB;AAClB,cAAc,kBAAkB,CAAC;AAEjC,gBAAgB;AAChB,cAAc,gBAAgB,CAAC"}

package/dist/models/fix.d.ts

@@ -0,0 +1,270 @@
+import { z } from 'zod';
+/**
+ * Confidence level for a fix
+ */
+export declare const ConfidenceLevelSchema: z.ZodEnum<["high", "medium", "low"]>;
+export type ConfidenceLevel = z.infer<typeof ConfidenceLevelSchema>;
+/**
+ * A proposed fix for a drift signal
+ */
+export declare const FixSchema: z.ZodObject<{
+    /** Unique identifier for this fix */
+    id: z.ZodString;
+    /** The drift signal this fix addresses */
+    driftSignalId: z.ZodString;
+    /** Confidence level (high = 95%+, medium = 70-94%, low = <70%) */
+    confidence: z.ZodEnum<["high", "medium", "low"]>;
+    /** Numeric confidence score (0-100) */
+    confidenceScore: z.ZodNumber;
+    /** File path where the fix will be applied */
+    file: z.ZodString;
+    /** Line number (1-indexed) */
+    line: z.ZodNumber;
+    /** Column number (1-indexed) */
+    column: z.ZodNumber;
+    /** Original text to replace */
+    original: z.ZodString;
+    /** Replacement text */
+    replacement: z.ZodString;
+    /** Human-readable reason for this fix */
+    reason: z.ZodString;
+    /** The type of fix */
+    fixType: z.ZodEnum<["hardcoded-color", "hardcoded-spacing", "hardcoded-radius", "hardcoded-font-size"]>;
+    /** Token name being applied (if applicable) */
+    tokenName: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    line: number;
+    id: string;
+    reason: string;
+    driftSignalId: string;
+    confidence: "high" | "medium" | "low";
+    confidenceScore: number;
+    file: string;
+    column: number;
+    original: string;
+    replacement: string;
+    fixType: "hardcoded-color" | "hardcoded-spacing" | "hardcoded-radius" | "hardcoded-font-size";
+    tokenName?: string | undefined;
+}, {
+    line: number;
+    id: string;
+    reason: string;
+    driftSignalId: string;
+    confidence: "high" | "medium" | "low";
+    confidenceScore: number;
+    file: string;
+    column: number;
+    original: string;
+    replacement: string;
+    fixType: "hardcoded-color" | "hardcoded-spacing" | "hardcoded-radius" | "hardcoded-font-size";
+    tokenName?: string | undefined;
+}>;
+export type Fix = z.infer<typeof FixSchema>;
+/**
+ * Result of applying a single fix
+ */
+export declare const FixResultSchema: z.ZodObject<{
+    fixId: z.ZodString;
+    status: z.ZodEnum<["applied", "skipped", "failed"]>;
+    error: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    status: "applied" | "skipped" | "failed";
+    fixId: string;
+    error?: string | undefined;
+}, {
+    status: "applied" | "skipped" | "failed";
+    fixId: string;
+    error?: string | undefined;
+}>;
+export type FixResult = z.infer<typeof FixResultSchema>;
+/**
+ * A fix session tracks all fixes applied in one run
+ */
+export declare const FixSessionSchema: z.ZodObject<{
+    /** Unique session identifier */
+    id: z.ZodString;
+    /** When the session started */
+    startedAt: z.ZodDate;
+    /** When the session completed */
+    completedAt: z.ZodOptional<z.ZodDate>;
+    /** All fixes that were considered */
+    fixes: z.ZodArray<z.ZodObject<{
+        /** Unique identifier for this fix */
+        id: z.ZodString;
+        /** The drift signal this fix addresses */
+        driftSignalId: z.ZodString;
+        /** Confidence level (high = 95%+, medium = 70-94%, low = <70%) */
+        confidence: z.ZodEnum<["high", "medium", "low"]>;
+        /** Numeric confidence score (0-100) */
+        confidenceScore: z.ZodNumber;
+        /** File path where the fix will be applied */
+        file: z.ZodString;
+        /** Line number (1-indexed) */
+        line: z.ZodNumber;
+        /** Column number (1-indexed) */
+        column: z.ZodNumber;
+        /** Original text to replace */
+        original: z.ZodString;
+        /** Replacement text */
+        replacement: z.ZodString;
+        /** Human-readable reason for this fix */
+        reason: z.ZodString;
+        /** The type of fix */
+        fixType: z.ZodEnum<["hardcoded-color", "hardcoded-spacing", "hardcoded-radius", "hardcoded-font-size"]>;
+        /** Token name being applied (if applicable) */
+        tokenName: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        line: number;
+        id: string;
+        reason: string;
+        driftSignalId: string;
+        confidence: "high" | "medium" | "low";
+        confidenceScore: number;
+        file: string;
+        column: number;
+        original: string;
+        replacement: string;
+        fixType: "hardcoded-color" | "hardcoded-spacing" | "hardcoded-radius" | "hardcoded-font-size";
+        tokenName?: string | undefined;
+    }, {
+        line: number;
+        id: string;
+        reason: string;
+        driftSignalId: string;
+        confidence: "high" | "medium" | "low";
+        confidenceScore: number;
+        file: string;
+        column: number;
+        original: string;
+        replacement: string;
+        fixType: "hardcoded-color" | "hardcoded-spacing" | "hardcoded-radius" | "hardcoded-font-size";
+        tokenName?: string | undefined;
+    }>, "many">;
+    /** Results for each fix */
+    results: z.ZodArray<z.ZodObject<{
+        fixId: z.ZodString;
+        status: z.ZodEnum<["applied", "skipped", "failed"]>;
+        error: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        status: "applied" | "skipped" | "failed";
+        fixId: string;
+        error?: string | undefined;
+    }, {
+        status: "applied" | "skipped" | "failed";
+        fixId: string;
+        error?: string | undefined;
+    }>, "many">;
+    /** Summary statistics */
+    summary: z.ZodObject<{
+        total: z.ZodNumber;
+        applied: z.ZodNumber;
+        skipped: z.ZodNumber;
+        failed: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        applied: number;
+        skipped: number;
+        failed: number;
+        total: number;
+    }, {
+        applied: number;
+        skipped: number;
+        failed: number;
+        total: number;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    startedAt: Date;
+    fixes: {
+        line: number;
+        id: string;
+        reason: string;
+        driftSignalId: string;
+        confidence: "high" | "medium" | "low";
+        confidenceScore: number;
+        file: string;
+        column: number;
+        original: string;
+        replacement: string;
+        fixType: "hardcoded-color" | "hardcoded-spacing" | "hardcoded-radius" | "hardcoded-font-size";
+        tokenName?: string | undefined;
+    }[];
+    results: {
+        status: "applied" | "skipped" | "failed";
+        fixId: string;
+        error?: string | undefined;
+    }[];
+    summary: {
+        applied: number;
+        skipped: number;
+        failed: number;
+        total: number;
+    };
+    completedAt?: Date | undefined;
+}, {
+    id: string;
+    startedAt: Date;
+    fixes: {
+        line: number;
+        id: string;
+        reason: string;
+        driftSignalId: string;
+        confidence: "high" | "medium" | "low";
+        confidenceScore: number;
+        file: string;
+        column: number;
+        original: string;
+        replacement: string;
+        fixType: "hardcoded-color" | "hardcoded-spacing" | "hardcoded-radius" | "hardcoded-font-size";
+        tokenName?: string | undefined;
+    }[];
+    results: {
+        status: "applied" | "skipped" | "failed";
+        fixId: string;
+        error?: string | undefined;
+    }[];
+    summary: {
+        applied: number;
+        skipped: number;
+        failed: number;
+        total: number;
+    };
+    completedAt?: Date | undefined;
+}>;
+export type FixSession = z.infer<typeof FixSessionSchema>;
+/**
+ * Options for generating fixes
+ */
+export interface FixGeneratorOptions {
+    /** Filter to specific fix types */
+    types?: Array<Fix['fixType']>;
+    /** Minimum confidence level to include */
+    minConfidence?: ConfidenceLevel;
+    /** File glob patterns to include */
+    includeFiles?: string[];
+    /** File glob patterns to exclude */
+    excludeFiles?: string[];
+}
+/**
+ * Options for applying fixes
+ */
+export interface FixApplyOptions {
+    /** Only show what would be done, don't modify files */
+    dryRun?: boolean;
+    /** Create .bak backup files before modifying */
+    backup?: boolean;
+    /** Minimum confidence level to apply */
+    minConfidence?: ConfidenceLevel;
+}
+/**
+ * Create a unique fix ID
+ */
+export declare function createFixId(file: string, line: number, column: number): string;
+/**
+ * Get confidence level from numeric score
+ */
+export declare function getConfidenceLevel(score: number): ConfidenceLevel;
+/**
+ * Check if a confidence level meets the minimum threshold
+ */
+export declare function meetsConfidenceThreshold(level: ConfidenceLevel, minimum: ConfidenceLevel): boolean;
+//# sourceMappingURL=fix.d.ts.map

package/dist/models/fix.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fix.d.ts","sourceRoot":"","sources":["../../src/models/fix.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,eAAO,MAAM,qBAAqB,sCAAoC,CAAC;AACvE,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE;;GAEG;AACH,eAAO,MAAM,SAAS;IACpB,qCAAqC;;IAGrC,0CAA0C;;IAG1C,kEAAkE;;IAGlE,uCAAuC;;IAGvC,8CAA8C;;IAG9C,8BAA8B;;IAG9B,gCAAgC;;IAGhC,+BAA+B;;IAG/B,uBAAuB;;IAGvB,yCAAyC;;IAGzC,sBAAsB;;IAQtB,+CAA+C;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAE/C,CAAC;AAEH,MAAM,MAAM,GAAG,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,SAAS,CAAC,CAAC;AAE5C;;GAEG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;EAI1B,CAAC;AAEH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAExD;;GAEG;AACH,eAAO,MAAM,gBAAgB;IAC3B,gCAAgC;;IAGhC,+BAA+B;;IAG/B,iCAAiC;;IAGjC,qCAAqC;;QApErC,qCAAqC;;QAGrC,0CAA0C;;QAG1C,kEAAkE;;QAGlE,uCAAuC;;QAGvC,8CAA8C;;QAG9C,8BAA8B;;QAG9B,gCAAgC;;QAGhC,+BAA+B;;QAG/B,uBAAuB;;QAGvB,yCAAyC;;QAGzC,sBAAsB;;QAQtB,+CAA+C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAiC/C,2BAA2B;;;;;;;;;;;;;;IAG3B,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAOzB,CAAC;AAEH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,mCAAmC;IACnC,KAAK,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC;IAE9B,0CAA0C;IAC1C,aAAa,CAAC,EAAE,eAAe,CAAC;IAEhC,oCAAoC;IACpC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IAExB,oCAAoC;IACpC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,uDAAuD;IACvD,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB,gDAAgD;IAChD,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB,wCAAwC;IACxC,aAAa,CAAC,EAAE,eAAe,CAAC;CACjC;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAE9E;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,eAAe,CAIjE;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,eAAe,EACtB,OAAO,EAAE,eAAe,GACvB,OAAO,CAOT"}

package/dist/models/fix.js

@@ -0,0 +1,97 @@
+import { z } from 'zod';
+/**
+ * Confidence level for a fix
+ */
+export const ConfidenceLevelSchema = z.enum(['high', 'medium', 'low']);
+/**
+ * A proposed fix for a drift signal
+ */
+export const FixSchema = z.object({
+    /** Unique identifier for this fix */
+    id: z.string(),
+    /** The drift signal this fix addresses */
+    driftSignalId: z.string(),
+    /** Confidence level (high = 95%+, medium = 70-94%, low = <70%) */
+    confidence: ConfidenceLevelSchema,
+    /** Numeric confidence score (0-100) */
+    confidenceScore: z.number().min(0).max(100),
+    /** File path where the fix will be applied */
+    file: z.string(),
+    /** Line number (1-indexed) */
+    line: z.number().int().positive(),
+    /** Column number (1-indexed) */
+    column: z.number().int().positive(),
+    /** Original text to replace */
+    original: z.string(),
+    /** Replacement text */
+    replacement: z.string(),
+    /** Human-readable reason for this fix */
+    reason: z.string(),
+    /** The type of fix */
+    fixType: z.enum([
+        'hardcoded-color',
+        'hardcoded-spacing',
+        'hardcoded-radius',
+        'hardcoded-font-size',
+    ]),
+    /** Token name being applied (if applicable) */
+    tokenName: z.string().optional(),
+});
+/**
+ * Result of applying a single fix
+ */
+export const FixResultSchema = z.object({
+    fixId: z.string(),
+    status: z.enum(['applied', 'skipped', 'failed']),
+    error: z.string().optional(),
+});
+/**
+ * A fix session tracks all fixes applied in one run
+ */
+export const FixSessionSchema = z.object({
+    /** Unique session identifier */
+    id: z.string(),
+    /** When the session started */
+    startedAt: z.date(),
+    /** When the session completed */
+    completedAt: z.date().optional(),
+    /** All fixes that were considered */
+    fixes: z.array(FixSchema),
+    /** Results for each fix */
+    results: z.array(FixResultSchema),
+    /** Summary statistics */
+    summary: z.object({
+        total: z.number(),
+        applied: z.number(),
+        skipped: z.number(),
+        failed: z.number(),
+    }),
+});
+/**
+ * Create a unique fix ID
+ */
+export function createFixId(file, line, column) {
+    return `fix:${file}:${line}:${column}`;
+}
+/**
+ * Get confidence level from numeric score
+ */
+export function getConfidenceLevel(score) {
+    if (score >= 95)
+        return 'high';
+    if (score >= 70)
+        return 'medium';
+    return 'low';
+}
+/**
+ * Check if a confidence level meets the minimum threshold
+ */
+export function meetsConfidenceThreshold(level, minimum) {
+    const order = {
+        low: 0,
+        medium: 1,
+        high: 2,
+    };
+    return order[level] >= order[minimum];
+}
+//# sourceMappingURL=fix.js.map

package/dist/models/fix.js.map

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

package/dist/models/index.d.ts

@@ -6,4 +6,6 @@ export { DriftSignalSchema, DriftTypeSchema, SeveritySchema, DriftSourceSchema,
 export type { DriftSignal, DriftType, Severity, DriftSource, GitContext, DriftDetails, DriftResolution, DriftResolutionType, } from './drift.js';
 export { IntentSchema, IntentDecisionSchema, IntentDecisionTypeSchema, IntentStatusSchema, IntentAttachmentSchema, IntentAttachmentTypeSchema, IntentContextSchema, createIntentId, isIntentExpired, intentApplies, DECISION_TYPE_LABELS, STATUS_LABELS, } from './intent.js';
 export type { Intent, IntentDecision, IntentDecisionType, IntentStatus, IntentAttachment, IntentAttachmentType, IntentContext, } from './intent.js';
+export { FixSchema, FixResultSchema, FixSessionSchema, ConfidenceLevelSchema, createFixId, getConfidenceLevel, meetsConfidenceThreshold, } from './fix.js';
+export type { Fix, FixResult, FixSession, ConfidenceLevel, FixGeneratorOptions, FixApplyOptions, } from './fix.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/models/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,eAAe,EACf,qBAAqB,EACrB,iBAAiB,EACjB,iBAAiB,EACjB,qBAAqB,EACrB,eAAe,EACf,kBAAkB,EAClB,oBAAoB,EACpB,uBAAuB,EACvB,oBAAoB,EACpB,uBAAuB,EACvB,oBAAoB,EACpB,uBAAuB,EACvB,iBAAiB,EACjB,sBAAsB,GACvB,MAAM,gBAAgB,CAAC;AAExB,YAAY,EACV,SAAS,EACT,eAAe,EACf,WAAW,EACX,WAAW,EACX,eAAe,EACf,SAAS,EACT,YAAY,EACZ,cAAc,EACd,iBAAiB,EACjB,cAAc,EACd,iBAAiB,EACjB,cAAc,EACd,iBAAiB,GAClB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,EAClB,qBAAqB,EACrB,iBAAiB,EACjB,iBAAiB,EACjB,cAAc,EACd,iBAAiB,EACjB,oBAAoB,EACpB,qBAAqB,EACrB,qBAAqB,EACrB,sBAAsB,EACtB,2BAA2B,EAC3B,mBAAmB,EACnB,mBAAmB,EACnB,aAAa,EACb,kBAAkB,EAClB,WAAW,GACZ,MAAM,YAAY,CAAC;AAEpB,YAAY,EACV,WAAW,EACX,UAAU,EACV,UAAU,EACV,YAAY,EACZ,eAAe,EACf,WAAW,EACX,WAAW,EACX,QAAQ,EACR,WAAW,EACX,cAAc,EACd,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,qBAAqB,EACrB,aAAa,EACb,aAAa,GACd,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,cAAc,EACd,iBAAiB,EACjB,gBAAgB,EAChB,kBAAkB,EAClB,qBAAqB,EACrB,yBAAyB,EACzB,aAAa,EACb,mBAAmB,EACnB,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,EACjB,uBAAuB,EACvB,eAAe,GAChB,MAAM,YAAY,CAAC;AAEpB,YAAY,EACV,WAAW,EACX,SAAS,EACT,QAAQ,EACR,WAAW,EACX,UAAU,EACV,YAAY,EACZ,eAAe,EACf,mBAAmB,GACpB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,YAAY,EACZ,oBAAoB,EACpB,wBAAwB,EACxB,kBAAkB,EAClB,sBAAsB,EACtB,0BAA0B,EAC1B,mBAAmB,EACnB,cAAc,EACd,eAAe,EACf,aAAa,EACb,oBAAoB,EACpB,aAAa,GACd,MAAM,aAAa,CAAC;AAErB,YAAY,EACV,MAAM,EACN,cAAc,EACd,kBAAkB,EAClB,YAAY,EACZ,gBAAgB,EAChB,oBAAoB,EACpB,aAAa,GACd,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/models/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,eAAe,EACf,qBAAqB,EACrB,iBAAiB,EACjB,iBAAiB,EACjB,qBAAqB,EACrB,eAAe,EACf,kBAAkB,EAClB,oBAAoB,EACpB,uBAAuB,EACvB,oBAAoB,EACpB,uBAAuB,EACvB,oBAAoB,EACpB,uBAAuB,EACvB,iBAAiB,EACjB,sBAAsB,GACvB,MAAM,gBAAgB,CAAC;AAExB,YAAY,EACV,SAAS,EACT,eAAe,EACf,WAAW,EACX,WAAW,EACX,eAAe,EACf,SAAS,EACT,YAAY,EACZ,cAAc,EACd,iBAAiB,EACjB,cAAc,EACd,iBAAiB,EACjB,cAAc,EACd,iBAAiB,GAClB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,EAClB,qBAAqB,EACrB,iBAAiB,EACjB,iBAAiB,EACjB,cAAc,EACd,iBAAiB,EACjB,oBAAoB,EACpB,qBAAqB,EACrB,qBAAqB,EACrB,sBAAsB,EACtB,2BAA2B,EAC3B,mBAAmB,EACnB,mBAAmB,EACnB,aAAa,EACb,kBAAkB,EAClB,WAAW,GACZ,MAAM,YAAY,CAAC;AAEpB,YAAY,EACV,WAAW,EACX,UAAU,EACV,UAAU,EACV,YAAY,EACZ,eAAe,EACf,WAAW,EACX,WAAW,EACX,QAAQ,EACR,WAAW,EACX,cAAc,EACd,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,qBAAqB,EACrB,aAAa,EACb,aAAa,GACd,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,cAAc,EACd,iBAAiB,EACjB,gBAAgB,EAChB,kBAAkB,EAClB,qBAAqB,EACrB,yBAAyB,EACzB,aAAa,EACb,mBAAmB,EACnB,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,EACjB,uBAAuB,EACvB,eAAe,GAChB,MAAM,YAAY,CAAC;AAEpB,YAAY,EACV,WAAW,EACX,SAAS,EACT,QAAQ,EACR,WAAW,EACX,UAAU,EACV,YAAY,EACZ,eAAe,EACf,mBAAmB,GACpB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,YAAY,EACZ,oBAAoB,EACpB,wBAAwB,EACxB,kBAAkB,EAClB,sBAAsB,EACtB,0BAA0B,EAC1B,mBAAmB,EACnB,cAAc,EACd,eAAe,EACf,aAAa,EACb,oBAAoB,EACpB,aAAa,GACd,MAAM,aAAa,CAAC;AAErB,YAAY,EACV,MAAM,EACN,cAAc,EACd,kBAAkB,EAClB,YAAY,EACZ,gBAAgB,EAChB,oBAAoB,EACpB,aAAa,GACd,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,SAAS,EACT,eAAe,EACf,gBAAgB,EAChB,qBAAqB,EACrB,WAAW,EACX,kBAAkB,EAClB,wBAAwB,GACzB,MAAM,UAAU,CAAC;AAElB,YAAY,EACV,GAAG,EACH,SAAS,EACT,UAAU,EACV,eAAe,EACf,mBAAmB,EACnB,eAAe,GAChB,MAAM,UAAU,CAAC"}

package/dist/models/index.js

@@ -6,4 +6,6 @@ export { DesignTokenSchema, TokenValueSchema, ColorValueSchema, SpacingValueSche
 export { DriftSignalSchema, DriftTypeSchema, SeveritySchema, DriftSourceSchema, GitContextSchema, DriftDetailsSchema, DriftResolutionSchema, DriftResolutionTypeSchema, createDriftId, createStableDriftId, getSeverityWeight, getDefaultSeverity, DRIFT_TYPE_LABELS, DRIFT_TYPE_DESCRIPTIONS, SEVERITY_LABELS, } from './drift.js';
 // Intent models
 export { IntentSchema, IntentDecisionSchema, IntentDecisionTypeSchema, IntentStatusSchema, IntentAttachmentSchema, IntentAttachmentTypeSchema, IntentContextSchema, createIntentId, isIntentExpired, intentApplies, DECISION_TYPE_LABELS, STATUS_LABELS, } from './intent.js';
+// Fix models
+export { FixSchema, FixResultSchema, FixSessionSchema, ConfidenceLevelSchema, createFixId, getConfidenceLevel, meetsConfidenceThreshold, } from './fix.js';
 //# sourceMappingURL=index.js.map

package/dist/models/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/models/index.ts"],"names":[],"mappings":"AAAA,mBAAmB;AACnB,OAAO,EACL,eAAe,EACf,qBAAqB,EACrB,iBAAiB,EACjB,iBAAiB,EACjB,qBAAqB,EACrB,eAAe,EACf,kBAAkB,EAClB,oBAAoB,EACpB,uBAAuB,EACvB,oBAAoB,EACpB,uBAAuB,EACvB,oBAAoB,EACpB,uBAAuB,EACvB,iBAAiB,EACjB,sBAAsB,GACvB,MAAM,gBAAgB,CAAC;AAkBxB,eAAe;AACf,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,EAClB,qBAAqB,EACrB,iBAAiB,EACjB,iBAAiB,EACjB,cAAc,EACd,iBAAiB,EACjB,oBAAoB,EACpB,qBAAqB,EACrB,qBAAqB,EACrB,sBAAsB,EACtB,2BAA2B,EAC3B,mBAAmB,EACnB,mBAAmB,EACnB,aAAa,EACb,kBAAkB,EAClB,WAAW,GACZ,MAAM,YAAY,CAAC;AAqBpB,eAAe;AACf,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,cAAc,EACd,iBAAiB,EACjB,gBAAgB,EAChB,kBAAkB,EAClB,qBAAqB,EACrB,yBAAyB,EACzB,aAAa,EACb,mBAAmB,EACnB,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,EACjB,uBAAuB,EACvB,eAAe,GAChB,MAAM,YAAY,CAAC;AAapB,gBAAgB;AAChB,OAAO,EACL,YAAY,EACZ,oBAAoB,EACpB,wBAAwB,EACxB,kBAAkB,EAClB,sBAAsB,EACtB,0BAA0B,EAC1B,mBAAmB,EACnB,cAAc,EACd,eAAe,EACf,aAAa,EACb,oBAAoB,EACpB,aAAa,GACd,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/models/index.ts"],"names":[],"mappings":"AAAA,mBAAmB;AACnB,OAAO,EACL,eAAe,EACf,qBAAqB,EACrB,iBAAiB,EACjB,iBAAiB,EACjB,qBAAqB,EACrB,eAAe,EACf,kBAAkB,EAClB,oBAAoB,EACpB,uBAAuB,EACvB,oBAAoB,EACpB,uBAAuB,EACvB,oBAAoB,EACpB,uBAAuB,EACvB,iBAAiB,EACjB,sBAAsB,GACvB,MAAM,gBAAgB,CAAC;AAkBxB,eAAe;AACf,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,EAClB,qBAAqB,EACrB,iBAAiB,EACjB,iBAAiB,EACjB,cAAc,EACd,iBAAiB,EACjB,oBAAoB,EACpB,qBAAqB,EACrB,qBAAqB,EACrB,sBAAsB,EACtB,2BAA2B,EAC3B,mBAAmB,EACnB,mBAAmB,EACnB,aAAa,EACb,kBAAkB,EAClB,WAAW,GACZ,MAAM,YAAY,CAAC;AAqBpB,eAAe;AACf,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,cAAc,EACd,iBAAiB,EACjB,gBAAgB,EAChB,kBAAkB,EAClB,qBAAqB,EACrB,yBAAyB,EACzB,aAAa,EACb,mBAAmB,EACnB,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,EACjB,uBAAuB,EACvB,eAAe,GAChB,MAAM,YAAY,CAAC;AAapB,gBAAgB;AAChB,OAAO,EACL,YAAY,EACZ,oBAAoB,EACpB,wBAAwB,EACxB,kBAAkB,EAClB,sBAAsB,EACtB,0BAA0B,EAC1B,mBAAmB,EACnB,cAAc,EACd,eAAe,EACf,aAAa,EACb,oBAAoB,EACpB,aAAa,GACd,MAAM,aAAa,CAAC;AAYrB,aAAa;AACb,OAAO,EACL,SAAS,EACT,eAAe,EACf,gBAAgB,EAChB,qBAAqB,EACrB,WAAW,EACX,kBAAkB,EAClB,wBAAwB,GACzB,MAAM,UAAU,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@buoy-design/core",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "description": "Core domain models and analysis for Buoy design drift detection",
   "type": "module",
   "license": "MIT",
@@ -40,14 +40,6 @@
       "import": "./dist/analysis/index.js"
     }
   },
-  "scripts": {
-    "build": "tsc",
-    "dev": "tsc --watch",
-    "typecheck": "tsc --noEmit",
-    "clean": "rm -rf dist",
-    "test": "vitest run",
-    "test:watch": "vitest"
-  },
   "dependencies": {
     "glob": "^11.0.0",
     "graphology": "^0.26.0",
@@ -57,5 +49,13 @@
   },
   "devDependencies": {
     "typescript": "^5.7.2"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist",
+    "test": "vitest run",
+    "test:watch": "vitest"
   }
-}
+}