@ginkoai/cli 1.6.1 → 1.7.0

package/dist/utils/pattern-confidence.js

@@ -0,0 +1,172 @@
+/**
+ * @fileType: utility
+ * @status: current
+ * @updated: 2025-11-25
+ * @tags: [pattern, confidence, scoring, epic-002, task-3]
+ * @related: [sprint-loader.ts, ../lib/output-formatter.ts]
+ * @priority: medium
+ * @complexity: low
+ * @dependencies: []
+ */
+/**
+ * Thresholds for confidence calculation
+ */
+const THRESHOLDS = {
+    // Usage count thresholds
+    HIGH_USAGE: 5, // 5+ usages = high confidence
+    MEDIUM_USAGE: 2, // 2-4 usages = medium confidence
+    // Age thresholds (in days)
+    HIGH_AGE: 14, // 14+ days = high age score
+    MEDIUM_AGE: 3, // 3-13 days = medium age score
+    // Score weights
+    USAGE_WEIGHT: 0.6, // Usage is most important
+    AGE_WEIGHT: 0.3, // Age contributes to trust
+    RESOLUTION_WEIGHT: 0.1, // Resolution rate (for gotchas)
+    // Confidence level boundaries
+    HIGH_THRESHOLD: 70,
+    MEDIUM_THRESHOLD: 40,
+};
+/**
+ * Calculate confidence level for a pattern
+ *
+ * @param metrics - Pattern usage metrics
+ * @returns Confidence result with level, score, and contributing factors
+ *
+ * @example
+ * const confidence = calculateConfidence({
+ *   usageCount: 8,
+ *   createdAt: '2025-11-01',
+ *   lastUsedAt: '2025-11-24'
+ * });
+ * // { level: 'high', score: 85, factors: { usage: 100, age: 75 } }
+ */
+export function calculateConfidence(metrics) {
+    const usageScore = calculateUsageScore(metrics.usageCount);
+    const ageScore = calculateAgeScore(metrics.createdAt);
+    const resolutionScore = metrics.encounters
+        ? calculateResolutionScore(metrics.encounters, metrics.resolutions || 0)
+        : undefined;
+    // Calculate weighted score
+    let totalScore;
+    if (resolutionScore !== undefined) {
+        // Gotcha: include resolution rate
+        totalScore =
+            usageScore * THRESHOLDS.USAGE_WEIGHT +
+                ageScore * THRESHOLDS.AGE_WEIGHT +
+                resolutionScore * THRESHOLDS.RESOLUTION_WEIGHT;
+    }
+    else {
+        // Pattern: usage and age only, rebalance weights
+        const adjustedUsageWeight = THRESHOLDS.USAGE_WEIGHT /
+            (THRESHOLDS.USAGE_WEIGHT + THRESHOLDS.AGE_WEIGHT);
+        const adjustedAgeWeight = THRESHOLDS.AGE_WEIGHT /
+            (THRESHOLDS.USAGE_WEIGHT + THRESHOLDS.AGE_WEIGHT);
+        totalScore = usageScore * adjustedUsageWeight + ageScore * adjustedAgeWeight;
+    }
+    // Determine confidence level
+    let level;
+    if (totalScore >= THRESHOLDS.HIGH_THRESHOLD) {
+        level = 'high';
+    }
+    else if (totalScore >= THRESHOLDS.MEDIUM_THRESHOLD) {
+        level = 'medium';
+    }
+    else {
+        level = 'low';
+    }
+    return {
+        level,
+        score: Math.round(totalScore),
+        factors: {
+            usage: usageScore,
+            age: ageScore,
+            ...(resolutionScore !== undefined && { resolution: resolutionScore }),
+        },
+    };
+}
+/**
+ * Calculate usage score (0-100)
+ * Higher usage = higher score
+ */
+function calculateUsageScore(usageCount) {
+    if (usageCount >= THRESHOLDS.HIGH_USAGE) {
+        return 100;
+    }
+    else if (usageCount >= THRESHOLDS.MEDIUM_USAGE) {
+        // Linear interpolation between medium and high
+        return 50 + ((usageCount - THRESHOLDS.MEDIUM_USAGE) / (THRESHOLDS.HIGH_USAGE - THRESHOLDS.MEDIUM_USAGE)) * 50;
+    }
+    else if (usageCount >= 1) {
+        // Linear interpolation between 1 and medium
+        return (usageCount / THRESHOLDS.MEDIUM_USAGE) * 50;
+    }
+    return 0;
+}
+/**
+ * Calculate age score (0-100)
+ * Older patterns with sustained use have higher trust
+ */
+function calculateAgeScore(createdAt) {
+    const created = typeof createdAt === 'string' ? new Date(createdAt) : createdAt;
+    const now = new Date();
+    const ageInDays = Math.floor((now.getTime() - created.getTime()) / (1000 * 60 * 60 * 24));
+    if (ageInDays >= THRESHOLDS.HIGH_AGE) {
+        return 100;
+    }
+    else if (ageInDays >= THRESHOLDS.MEDIUM_AGE) {
+        // Linear interpolation
+        return 50 + ((ageInDays - THRESHOLDS.MEDIUM_AGE) / (THRESHOLDS.HIGH_AGE - THRESHOLDS.MEDIUM_AGE)) * 50;
+    }
+    else if (ageInDays >= 1) {
+        return (ageInDays / THRESHOLDS.MEDIUM_AGE) * 50;
+    }
+    return 25; // Same-day patterns get base score (not zero - they exist for a reason)
+}
+/**
+ * Calculate resolution score for gotchas (0-100)
+ * Higher resolution rate = more confident the gotcha warning is useful
+ */
+function calculateResolutionScore(encounters, resolutions) {
+    if (encounters === 0)
+        return 50; // No data, assume medium
+    const rate = resolutions / encounters;
+    return Math.round(rate * 100);
+}
+/**
+ * Get default confidence for new patterns
+ * New patterns start at medium to avoid cold-start issues
+ */
+export function getDefaultConfidence() {
+    return {
+        level: 'medium',
+        score: 50,
+        factors: {
+            usage: 25,
+            age: 25,
+        },
+    };
+}
+/**
+ * Sort patterns by confidence (highest first)
+ *
+ * @param patterns - Array of patterns with confidence scores
+ * @returns Sorted array (descending by score)
+ */
+export function sortByConfidence(patterns) {
+    return [...patterns].sort((a, b) => {
+        const scoreA = a.confidence?.score ?? 50;
+        const scoreB = b.confidence?.score ?? 50;
+        return scoreB - scoreA;
+    });
+}
+/**
+ * Format confidence for display
+ *
+ * @param confidence - Confidence result
+ * @returns Human-readable string
+ */
+export function formatConfidence(confidence) {
+    const emoji = confidence.level === 'high' ? '✓' : confidence.level === 'medium' ? '~' : '?';
+    return `${emoji} ${confidence.level} (${confidence.score}%)`;
+}
+//# sourceMappingURL=pattern-confidence.js.map

package/dist/utils/pattern-confidence.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ginkoai/cli",
-  "version": "1.6.1",
+  "version": "1.7.0",
   "description": "Git-native session management and cloud context for AI-mediated development. AI Collaboration for Vibe Tribes.",
   "main": "dist/index.js",
   "bin": {