@ginkoai/cli 1.7.2 → 1.8.0

package/dist/lib/insights/analyzers/anti-patterns.js

@@ -0,0 +1,302 @@
+/**
+ * @fileType: analyzer
+ * @status: current
+ * @updated: 2025-12-15
+ * @tags: [insights, analyzer, anti-patterns, detection]
+ * @related: [../types.ts, ../data-collector.ts]
+ * @priority: high
+ * @complexity: medium
+ * @dependencies: []
+ */
+// ============================================================================
+// Configuration
+// ============================================================================
+const THRESHOLDS = {
+    // Abandoned task detection (days in progress)
+    abandonedTask: {
+        warning: 5, // > 5 days without completion
+        critical: 10, // > 10 days
+    },
+    // Silent session detection (sessions without events)
+    // Per PATTERN-001: Context is preserved via events, not handoffs
+    silentSessions: {
+        warning: 2, // > 2 sessions without events
+        critical: 4, // > 4 sessions
+    },
+    // Long silent session (hours without events)
+    silentSession: {
+        warning: 2, // > 2 hours
+        critical: 4, // > 4 hours
+    },
+    // Repeated gotcha encounters
+    repeatedGotcha: {
+        warning: 2, // > 2 encounters of same gotcha
+        critical: 4, // > 4 encounters
+    },
+};
+// ============================================================================
+// Anti-Pattern Detector
+// ============================================================================
+export class AntiPatternDetector {
+    category = 'anti-patterns';
+    async analyze(data) {
+        const insights = [];
+        // Detect each anti-pattern
+        insights.push(...this.detectAbandonedTasks(data));
+        insights.push(...this.detectContextLoss(data));
+        insights.push(...this.detectLongSilentSessions(data));
+        insights.push(...this.detectRepeatedGotchas(data));
+        insights.push(...this.detectScopeCreep(data));
+        // If no anti-patterns found, add positive insight
+        if (insights.length === 0) {
+            insights.push({
+                category: this.category,
+                severity: 'info',
+                title: 'No anti-patterns detected',
+                description: 'Your workflow is clean. No concerning patterns found.',
+                scoreImpact: 10,
+                evidence: [],
+                recommendations: [],
+            });
+        }
+        return insights;
+    }
+    // ===========================================================================
+    // Abandoned Tasks Detection
+    // ===========================================================================
+    detectAbandonedTasks(data) {
+        const insights = [];
+        const abandonedTasks = data.tasks.abandoned;
+        const stuckTasks = data.tasks.inProgress.filter(t => t.daysInProgress > THRESHOLDS.abandonedTask.warning);
+        const allProblematicTasks = [...abandonedTasks, ...stuckTasks];
+        if (allProblematicTasks.length === 0)
+            return insights;
+        const criticalTasks = allProblematicTasks.filter(t => t.daysInProgress >= THRESHOLDS.abandonedTask.critical);
+        const evidence = allProblematicTasks.slice(0, 5).map(t => ({
+            type: 'task',
+            id: t.id,
+            description: `${t.title} - ${t.daysInProgress} days in progress`,
+        }));
+        if (criticalTasks.length > 0) {
+            insights.push({
+                category: this.category,
+                severity: 'critical',
+                title: 'Critical: Stuck tasks',
+                description: `${criticalTasks.length} tasks stuck for 10+ days. These may need to be descoped or unblocked.`,
+                metricName: 'stuck_task_count',
+                metricValue: criticalTasks.length,
+                scoreImpact: -25,
+                evidence: evidence.slice(0, 3),
+                recommendations: [
+                    'Review blockers for each stuck task',
+                    'Consider breaking into smaller tasks',
+                    'Descope if task is no longer relevant',
+                    'Mark as paused if blocked externally',
+                ],
+            });
+        }
+        else if (allProblematicTasks.length > 0) {
+            insights.push({
+                category: this.category,
+                severity: 'warning',
+                title: 'Tasks in progress too long',
+                description: `${allProblematicTasks.length} tasks have been in progress for 5+ days.`,
+                metricName: 'stuck_task_count',
+                metricValue: allProblematicTasks.length,
+                scoreImpact: -15,
+                evidence,
+                recommendations: [
+                    'Review task scope and break down if too large',
+                    'Check for blockers or missing information',
+                    'Update status if task is actually paused',
+                ],
+            });
+        }
+        return insights;
+    }
+    // ===========================================================================
+    // Silent Session Detection (PATTERN-001: Ephemeral Sessions)
+    // ===========================================================================
+    /**
+     * Detects sessions without event logging (silent sessions).
+     *
+     * Per PATTERN-001: Context is preserved via defensive logging (events),
+     * not handoffs. Handoffs are optional. What matters is whether events
+     * were captured during the session.
+     *
+     * A "silent session" with no events means context was lost.
+     * A session with events but no handoff is fine - context is in the events.
+     */
+    detectContextLoss(data) {
+        const insights = [];
+        // Silent sessions = no events logged (context truly lost)
+        const silentSessions = data.sessions.filter(s => s.eventCount === 0);
+        const count = silentSessions.length;
+        if (count === 0)
+            return insights;
+        const evidence = silentSessions.slice(0, 5).map(s => ({
+            type: 'session',
+            id: s.id,
+            description: `Silent session (${Math.round(s.durationMinutes)}min, no events)`,
+            timestamp: s.startedAt,
+        }));
+        if (count >= THRESHOLDS.silentSessions.critical) {
+            insights.push({
+                category: this.category,
+                severity: 'warning',
+                title: 'Silent sessions detected',
+                description: `${count} sessions had no events logged. Context from these sessions is lost.`,
+                metricName: 'silent_session_count',
+                metricValue: count,
+                scoreImpact: -15,
+                evidence,
+                recommendations: [
+                    'Use `ginko log` after completing fixes or features',
+                    'Log decisions and insights during the session',
+                    'Defensive logging captures context at low pressure',
+                ],
+            });
+        }
+        else if (count >= THRESHOLDS.silentSessions.warning) {
+            insights.push({
+                category: this.category,
+                severity: 'suggestion',
+                title: 'Some silent sessions',
+                description: `${count} sessions had no events logged. Consider logging more.`,
+                metricName: 'silent_session_count',
+                metricValue: count,
+                scoreImpact: -5,
+                evidence,
+                recommendations: [
+                    'Use `ginko log` to capture insights as you work',
+                    'Aim for 3-5 events per session',
+                ],
+            });
+        }
+        return insights;
+    }
+    // ===========================================================================
+    // Long Silent Sessions Detection
+    // ===========================================================================
+    detectLongSilentSessions(data) {
+        const insights = [];
+        // Sessions with long duration but few events
+        const silentSessions = data.sessions.filter(s => {
+            const eventsPerHour = s.eventCount / (s.durationMinutes / 60);
+            return s.durationMinutes > 120 && eventsPerHour < 1;
+        });
+        if (silentSessions.length === 0)
+            return insights;
+        const evidence = silentSessions.slice(0, 3).map(s => ({
+            type: 'session',
+            id: s.id,
+            description: `${Math.round(s.durationMinutes / 60)}h session with ${s.eventCount} events`,
+            timestamp: s.startedAt,
+        }));
+        insights.push({
+            category: this.category,
+            severity: 'suggestion',
+            title: 'Long sessions without logging',
+            description: `${silentSessions.length} sessions over 2 hours with minimal logging. Insights may be lost.`,
+            metricName: 'silent_session_count',
+            metricValue: silentSessions.length,
+            scoreImpact: -5,
+            evidence,
+            recommendations: [
+                'Use `ginko log` periodically during long sessions',
+                'Log decisions and insights as you work',
+                'Break into multiple focused sessions',
+            ],
+        });
+        return insights;
+    }
+    // ===========================================================================
+    // Repeated Gotchas Detection
+    // ===========================================================================
+    detectRepeatedGotchas(data) {
+        const insights = [];
+        const repeatedGotchas = data.gotchas.filter(g => g.encounters >= THRESHOLDS.repeatedGotcha.warning);
+        if (repeatedGotchas.length === 0)
+            return insights;
+        const criticalRepeats = repeatedGotchas.filter(g => g.encounters >= THRESHOLDS.repeatedGotcha.critical);
+        const evidence = repeatedGotchas.map(g => ({
+            type: 'gotcha',
+            id: g.id,
+            description: `${g.title} - encountered ${g.encounters} times`,
+        }));
+        if (criticalRepeats.length > 0) {
+            insights.push({
+                category: this.category,
+                severity: 'critical',
+                title: 'Critical: Gotchas not being avoided',
+                description: `${criticalRepeats.length} gotchas encountered 4+ times. Prevention isn't working.`,
+                metricName: 'critical_repeat_gotchas',
+                metricValue: criticalRepeats.length,
+                scoreImpact: -25,
+                evidence: evidence.slice(0, 3),
+                recommendations: [
+                    'Review gotcha documentation for clearer prevention steps',
+                    'Add automated checks or linting rules',
+                    'Consider refactoring to eliminate the gotcha source',
+                ],
+            });
+        }
+        else {
+            insights.push({
+                category: this.category,
+                severity: 'warning',
+                title: 'Repeated gotcha encounters',
+                description: `${repeatedGotchas.length} gotchas encountered multiple times.`,
+                metricName: 'repeat_gotcha_count',
+                metricValue: repeatedGotchas.length,
+                scoreImpact: -10,
+                evidence,
+                recommendations: [
+                    'Review gotcha docs before starting related work',
+                    'Update gotcha descriptions with better prevention',
+                    'Consider adding pre-commit checks',
+                ],
+            });
+        }
+        return insights;
+    }
+    // ===========================================================================
+    // Scope Creep Detection
+    // ===========================================================================
+    detectScopeCreep(data) {
+        const insights = [];
+        // Detect tasks added mid-sprint (tasks without IDs following naming convention)
+        // This is a heuristic - actual detection would need more context
+        const adhocTasks = data.tasks.inProgress.filter(t => t.id.includes('adhoc') || !t.id.match(/e\d+_s\d+_t\d+/));
+        if (adhocTasks.length === 0)
+            return insights;
+        // Only flag if significant
+        const adhocRatio = adhocTasks.length / data.tasks.total;
+        if (adhocRatio < 0.2)
+            return insights;
+        const evidence = adhocTasks.slice(0, 3).map(t => ({
+            type: 'task',
+            id: t.id,
+            description: `Ad-hoc: ${t.title}`,
+        }));
+        insights.push({
+            category: this.category,
+            severity: 'suggestion',
+            title: 'Scope creep detected',
+            description: `${adhocTasks.length} ad-hoc tasks added (${Math.round(adhocRatio * 100)}% of total). Sprint scope may be growing.`,
+            metricName: 'adhoc_task_ratio',
+            metricValue: Math.round(adhocRatio * 100),
+            metricUnit: '%',
+            scoreImpact: -5,
+            evidence,
+            recommendations: [
+                'Review if ad-hoc work should be in sprint scope',
+                'Consider deferring non-critical items',
+                'Track ad-hoc work separately for visibility',
+            ],
+        });
+        return insights;
+    }
+}
+export default AntiPatternDetector;
+//# sourceMappingURL=anti-patterns.js.map

package/dist/lib/insights/analyzers/anti-patterns.js.map

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

package/dist/lib/insights/analyzers/efficiency.d.ts

@@ -0,0 +1,22 @@
+/**
+ * @fileType: analyzer
+ * @status: current
+ * @updated: 2025-12-15
+ * @tags: [insights, analyzer, efficiency, sessions]
+ * @related: [../types.ts, ../data-collector.ts]
+ * @priority: high
+ * @complexity: medium
+ * @dependencies: []
+ */
+import { InsightAnalyzer, InsightData, RawInsight } from '../types.js';
+export declare class EfficiencyAnalyzer implements InsightAnalyzer {
+    category: "efficiency";
+    analyze(data: InsightData): Promise<RawInsight[]>;
+    private analyzeTimeToFlow;
+    private analyzeContextLoadTime;
+    private analyzeSessionDuration;
+    private analyzeColdStartRatio;
+    private estimateAverageTimeToFlow;
+}
+export default EfficiencyAnalyzer;
+//# sourceMappingURL=efficiency.d.ts.map

package/dist/lib/insights/analyzers/efficiency.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"efficiency.d.ts","sourceRoot":"","sources":["../../../../src/lib/insights/analyzers/efficiency.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EACL,eAAe,EACf,WAAW,EACX,UAAU,EAGX,MAAM,aAAa,CAAC;AAmCrB,qBAAa,kBAAmB,YAAW,eAAe;IACxD,QAAQ,EAAG,YAAY,CAAU;IAE3B,OAAO,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IA8BvD,OAAO,CAAC,iBAAiB;IAyEzB,OAAO,CAAC,sBAAsB;IA2D9B,OAAO,CAAC,sBAAsB;IA4D9B,OAAO,CAAC,qBAAqB;IA0D7B,OAAO,CAAC,yBAAyB;CAelC;AAED,eAAe,kBAAkB,CAAC"}

package/dist/lib/insights/analyzers/efficiency.js

@@ -0,0 +1,311 @@
+/**
+ * @fileType: analyzer
+ * @status: current
+ * @updated: 2025-12-15
+ * @tags: [insights, analyzer, efficiency, sessions]
+ * @related: [../types.ts, ../data-collector.ts]
+ * @priority: high
+ * @complexity: medium
+ * @dependencies: []
+ */
+// ============================================================================
+// Configuration
+// ============================================================================
+const THRESHOLDS = {
+    // Time-to-flow (seconds from session start to first event)
+    timeToFlow: {
+        excellent: 60, // < 60s is excellent
+        good: 120, // < 120s is good
+        warning: 300, // > 300s is warning
+    },
+    // Context load time (milliseconds)
+    contextLoadTime: {
+        excellent: 3000, // < 3s is excellent
+        good: 5000, // < 5s is good
+        warning: 10000, // > 10s is warning
+    },
+    // Session duration (minutes)
+    sessionDuration: {
+        optimal: { min: 60, max: 240 }, // 1-4 hours is optimal
+        warning: { max: 360 }, // > 6 hours is warning
+    },
+    // Cold start ratio (percentage)
+    coldStartRatio: {
+        good: 30, // < 30% cold starts is good
+        warning: 60, // > 60% cold starts is warning
+    },
+};
+// ============================================================================
+// Efficiency Analyzer
+// ============================================================================
+export class EfficiencyAnalyzer {
+    category = 'efficiency';
+    async analyze(data) {
+        const insights = [];
+        // Skip if no sessions
+        if (data.sessions.length === 0) {
+            insights.push({
+                category: this.category,
+                severity: 'info',
+                title: 'No session data available',
+                description: 'Start using `ginko start` to track your sessions and get efficiency insights.',
+                scoreImpact: 0,
+                evidence: [],
+                recommendations: ['Run `ginko start` at the beginning of each work session'],
+            });
+            return insights;
+        }
+        // Analyze each metric
+        insights.push(...this.analyzeTimeToFlow(data));
+        insights.push(...this.analyzeContextLoadTime(data));
+        insights.push(...this.analyzeSessionDuration(data));
+        insights.push(...this.analyzeColdStartRatio(data));
+        return insights;
+    }
+    // ===========================================================================
+    // Time-to-Flow Analysis
+    // ===========================================================================
+    analyzeTimeToFlow(data) {
+        const insights = [];
+        // Calculate average time-to-flow from session start to first event
+        const sessionsWithEvents = data.sessions.filter(s => s.eventCount > 0);
+        if (sessionsWithEvents.length === 0)
+            return insights;
+        // Estimate time-to-flow based on session data
+        // In reality, this would use actual timestamps from events
+        const avgTimeToFlow = this.estimateAverageTimeToFlow(sessionsWithEvents);
+        const evidence = sessionsWithEvents.slice(0, 3).map(s => ({
+            type: 'session',
+            id: s.id,
+            description: `Session with ${s.eventCount} events, ${s.flowState} start`,
+            timestamp: s.startedAt,
+        }));
+        if (avgTimeToFlow < THRESHOLDS.timeToFlow.excellent) {
+            insights.push({
+                category: this.category,
+                severity: 'info',
+                title: 'Excellent time-to-flow',
+                description: `Average ${avgTimeToFlow}s to first productive action. You're getting into flow quickly.`,
+                metricName: 'time_to_flow',
+                metricValue: avgTimeToFlow,
+                metricTarget: THRESHOLDS.timeToFlow.excellent,
+                metricUnit: 'seconds',
+                scoreImpact: 15,
+                evidence,
+                recommendations: [],
+            });
+        }
+        else if (avgTimeToFlow < THRESHOLDS.timeToFlow.good) {
+            insights.push({
+                category: this.category,
+                severity: 'info',
+                title: 'Good time-to-flow',
+                description: `Average ${avgTimeToFlow}s to first productive action.`,
+                metricName: 'time_to_flow',
+                metricValue: avgTimeToFlow,
+                metricTarget: THRESHOLDS.timeToFlow.good,
+                metricUnit: 'seconds',
+                scoreImpact: 5,
+                evidence,
+                recommendations: ['Use `ginko handoff` to reduce context rebuild time'],
+            });
+        }
+        else {
+            insights.push({
+                category: this.category,
+                severity: 'suggestion',
+                title: 'Slow time-to-flow',
+                description: `Average ${avgTimeToFlow}s to first productive action. Consider improving session handoffs.`,
+                metricName: 'time_to_flow',
+                metricValue: avgTimeToFlow,
+                metricTarget: THRESHOLDS.timeToFlow.good,
+                metricUnit: 'seconds',
+                scoreImpact: -10,
+                evidence,
+                recommendations: [
+                    'Use `ginko handoff` before ending sessions',
+                    'Review your CLAUDE.md for faster context loading',
+                    'Archive old events with `ginko archive`',
+                ],
+            });
+        }
+        return insights;
+    }
+    // ===========================================================================
+    // Context Load Time Analysis
+    // ===========================================================================
+    analyzeContextLoadTime(data) {
+        const insights = [];
+        const sessionsWithLoadTime = data.sessions.filter(s => s.contextLoadTimeMs);
+        if (sessionsWithLoadTime.length === 0)
+            return insights;
+        const avgLoadTime = Math.round(sessionsWithLoadTime.reduce((sum, s) => sum + (s.contextLoadTimeMs || 0), 0) /
+            sessionsWithLoadTime.length);
+        const evidence = sessionsWithLoadTime.slice(0, 3).map(s => ({
+            type: 'session',
+            id: s.id,
+            description: `Context loaded in ${s.contextLoadTimeMs}ms`,
+            timestamp: s.startedAt,
+        }));
+        if (avgLoadTime < THRESHOLDS.contextLoadTime.excellent) {
+            insights.push({
+                category: this.category,
+                severity: 'info',
+                title: 'Fast context loading',
+                description: `Average ${avgLoadTime}ms context load time. Event-based loading is working well.`,
+                metricName: 'context_load_time',
+                metricValue: avgLoadTime,
+                metricTarget: THRESHOLDS.contextLoadTime.excellent,
+                metricUnit: 'ms',
+                scoreImpact: 10,
+                evidence,
+                recommendations: [],
+            });
+        }
+        else if (avgLoadTime > THRESHOLDS.contextLoadTime.warning) {
+            insights.push({
+                category: this.category,
+                severity: 'warning',
+                title: 'Slow context loading',
+                description: `Average ${avgLoadTime}ms context load time. Consider archiving old events.`,
+                metricName: 'context_load_time',
+                metricValue: avgLoadTime,
+                metricTarget: THRESHOLDS.contextLoadTime.good,
+                metricUnit: 'ms',
+                scoreImpact: -15,
+                evidence,
+                recommendations: [
+                    'Run `ginko archive` to move old events',
+                    'Check network connectivity to graph API',
+                    'Review event stream size',
+                ],
+            });
+        }
+        return insights;
+    }
+    // ===========================================================================
+    // Session Duration Analysis
+    // ===========================================================================
+    analyzeSessionDuration(data) {
+        const insights = [];
+        const durations = data.sessions.map(s => s.durationMinutes);
+        const avgDuration = Math.round(durations.reduce((a, b) => a + b, 0) / durations.length);
+        const longSessions = data.sessions.filter(s => s.durationMinutes > THRESHOLDS.sessionDuration.warning.max);
+        const evidence = longSessions.slice(0, 3).map(s => ({
+            type: 'session',
+            id: s.id,
+            description: `${Math.round(s.durationMinutes / 60)}h session`,
+            timestamp: s.startedAt,
+        }));
+        if (longSessions.length > 0) {
+            insights.push({
+                category: this.category,
+                severity: 'suggestion',
+                title: 'Long sessions detected',
+                description: `${longSessions.length} sessions exceeded 6 hours. Long sessions may reduce productivity.`,
+                metricName: 'avg_session_duration',
+                metricValue: avgDuration,
+                metricTarget: THRESHOLDS.sessionDuration.optimal.max,
+                metricUnit: 'minutes',
+                scoreImpact: -5,
+                evidence,
+                recommendations: [
+                    'Consider taking breaks every 2-3 hours',
+                    'Use `ginko handoff` to save progress and start fresh',
+                    'Break large tasks into smaller chunks',
+                ],
+            });
+        }
+        else if (avgDuration >= THRESHOLDS.sessionDuration.optimal.min &&
+            avgDuration <= THRESHOLDS.sessionDuration.optimal.max) {
+            insights.push({
+                category: this.category,
+                severity: 'info',
+                title: 'Healthy session duration',
+                description: `Average ${Math.round(avgDuration / 60)}h sessions. This is in the optimal range for focused work.`,
+                metricName: 'avg_session_duration',
+                metricValue: avgDuration,
+                metricUnit: 'minutes',
+                scoreImpact: 5,
+                evidence: [],
+                recommendations: [],
+            });
+        }
+        return insights;
+    }
+    // ===========================================================================
+    // Cold Start Analysis
+    // ===========================================================================
+    analyzeColdStartRatio(data) {
+        const insights = [];
+        const coldStarts = data.sessions.filter(s => s.flowState === 'cold').length;
+        const totalSessions = data.sessions.length;
+        const coldRatio = Math.round((coldStarts / totalSessions) * 100);
+        const evidence = data.sessions
+            .filter(s => s.flowState === 'cold')
+            .slice(0, 3)
+            .map(s => ({
+            type: 'session',
+            id: s.id,
+            description: 'Cold start session',
+            timestamp: s.startedAt,
+        }));
+        if (coldRatio < THRESHOLDS.coldStartRatio.good) {
+            insights.push({
+                category: this.category,
+                severity: 'info',
+                title: 'Good session continuity',
+                description: `Only ${coldRatio}% cold starts. Your handoffs are preserving context effectively.`,
+                metricName: 'cold_start_ratio',
+                metricValue: coldRatio,
+                metricTarget: THRESHOLDS.coldStartRatio.good,
+                metricUnit: '%',
+                scoreImpact: 10,
+                evidence: [],
+                recommendations: [],
+            });
+        }
+        else if (coldRatio > THRESHOLDS.coldStartRatio.warning) {
+            insights.push({
+                category: this.category,
+                severity: 'warning',
+                title: 'High cold start ratio',
+                description: `${coldRatio}% of sessions are cold starts. Context is being lost between sessions.`,
+                metricName: 'cold_start_ratio',
+                metricValue: coldRatio,
+                metricTarget: THRESHOLDS.coldStartRatio.good,
+                metricUnit: '%',
+                scoreImpact: -15,
+                evidence,
+                recommendations: [
+                    'Always run `ginko handoff` before ending a session',
+                    'Review session logs for completeness',
+                    'Consider shorter, more focused sessions',
+                ],
+            });
+        }
+        return insights;
+    }
+    // ===========================================================================
+    // Helper Methods
+    // ===========================================================================
+    estimateAverageTimeToFlow(sessions) {
+        // Estimate based on flow state
+        // Hot/warm starts are faster than cold starts
+        let totalSeconds = 0;
+        for (const session of sessions) {
+            if (session.flowState === 'hot') {
+                totalSeconds += 30;
+            }
+            else if (session.flowState === 'warm') {
+                totalSeconds += 60;
+            }
+            else {
+                totalSeconds += 120;
+            }
+        }
+        return Math.round(totalSeconds / sessions.length);
+    }
+}
+export default EfficiencyAnalyzer;
+//# sourceMappingURL=efficiency.js.map