@ginkoai/cli 1.7.2 → 2.0.0-beta.2

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

@@ -0,0 +1,371 @@
+/**
+ * @fileType: analyzer
+ * @status: current
+ * @updated: 2025-12-15
+ * @tags: [insights, analyzer, quality, tasks, commits]
+ * @related: [../types.ts, ../data-collector.ts]
+ * @priority: high
+ * @complexity: medium
+ * @dependencies: []
+ */
+// ============================================================================
+// Configuration
+// ============================================================================
+const THRESHOLDS = {
+    // Task completion rate (percentage)
+    taskCompletion: {
+        excellent: 90, // > 90% is excellent
+        good: 70, // > 70% is good
+        warning: 50, // < 50% is warning
+    },
+    // Commits per session
+    commitsPerSession: {
+        excellent: 5, // > 5 is excellent
+        good: 2, // > 2 is good
+        warning: 0, // 0 is warning
+    },
+    // Average commit size (lines changed)
+    commitSize: {
+        optimal: { min: 20, max: 150 }, // 20-150 lines is optimal
+        warning: { max: 500 }, // > 500 lines is warning
+    },
+    // Event logging rate (events per session)
+    // Replaces handoff metric per PATTERN-001: Ephemeral Sessions
+    // Context is preserved via defensive logging, not handoffs
+    eventLoggingRate: {
+        excellent: 5, // > 5 events per session is excellent
+        good: 2, // > 2 is good
+        warning: 1, // < 1 is warning (silent sessions)
+    },
+};
+// ============================================================================
+// Collaboration Quality Analyzer
+// ============================================================================
+export class QualityAnalyzer {
+    category = 'quality';
+    async analyze(data) {
+        const insights = [];
+        // Analyze each metric
+        insights.push(...this.analyzeTaskCompletion(data));
+        insights.push(...this.analyzeCommitFrequency(data));
+        insights.push(...this.analyzeCommitSize(data));
+        insights.push(...this.analyzeHandoffQuality(data));
+        insights.push(...this.analyzeSprintVelocity(data));
+        return insights;
+    }
+    // ===========================================================================
+    // Task Completion Analysis
+    // ===========================================================================
+    analyzeTaskCompletion(data) {
+        const insights = [];
+        if (data.tasks.total === 0) {
+            insights.push({
+                category: this.category,
+                severity: 'info',
+                title: 'No tasks tracked',
+                description: 'Use sprint files to track task progress and get completion insights.',
+                scoreImpact: 0,
+                evidence: [],
+                recommendations: ['Create docs/sprints/CURRENT-SPRINT.md with tasks'],
+            });
+            return insights;
+        }
+        const completionRate = data.tasks.completionRate;
+        const evidence = data.tasks.completed.slice(0, 3).map(t => ({
+            type: 'task',
+            id: t.id,
+            description: `Completed: ${t.title}`,
+        }));
+        if (completionRate >= THRESHOLDS.taskCompletion.excellent) {
+            insights.push({
+                category: this.category,
+                severity: 'info',
+                title: 'Excellent task completion',
+                description: `${Math.round(completionRate)}% task completion rate. You're executing consistently.`,
+                metricName: 'task_completion_rate',
+                metricValue: completionRate,
+                metricTarget: THRESHOLDS.taskCompletion.excellent,
+                metricUnit: '%',
+                scoreImpact: 15,
+                evidence,
+                recommendations: [],
+            });
+        }
+        else if (completionRate >= THRESHOLDS.taskCompletion.good) {
+            insights.push({
+                category: this.category,
+                severity: 'info',
+                title: 'Good task completion',
+                description: `${Math.round(completionRate)}% task completion rate. Room for improvement.`,
+                metricName: 'task_completion_rate',
+                metricValue: completionRate,
+                metricTarget: THRESHOLDS.taskCompletion.good,
+                metricUnit: '%',
+                scoreImpact: 5,
+                evidence,
+                recommendations: ['Break large tasks into smaller, completable chunks'],
+            });
+        }
+        else if (completionRate < THRESHOLDS.taskCompletion.warning) {
+            const inProgressCount = data.tasks.inProgress.length + data.tasks.abandoned.length;
+            insights.push({
+                category: this.category,
+                severity: 'warning',
+                title: 'Low task completion',
+                description: `Only ${Math.round(completionRate)}% completion with ${inProgressCount} tasks stuck in progress.`,
+                metricName: 'task_completion_rate',
+                metricValue: completionRate,
+                metricTarget: THRESHOLDS.taskCompletion.good,
+                metricUnit: '%',
+                scoreImpact: -20,
+                evidence: data.tasks.inProgress.slice(0, 3).map(t => ({
+                    type: 'task',
+                    id: t.id,
+                    description: `In progress ${t.daysInProgress} days: ${t.title}`,
+                })),
+                recommendations: [
+                    'Review in-progress tasks and identify blockers',
+                    'Break large tasks into smaller deliverables',
+                    'Consider pausing or descoping stuck tasks',
+                ],
+            });
+        }
+        return insights;
+    }
+    // ===========================================================================
+    // Commit Frequency Analysis
+    // ===========================================================================
+    analyzeCommitFrequency(data) {
+        const insights = [];
+        if (data.sessions.length === 0)
+            return insights;
+        const commitsPerSession = data.commits.length / data.sessions.length;
+        const evidence = data.commits.slice(0, 3).map(c => ({
+            type: 'commit',
+            id: c.hash,
+            description: c.message.substring(0, 80),
+            timestamp: c.timestamp,
+        }));
+        if (commitsPerSession >= THRESHOLDS.commitsPerSession.excellent) {
+            insights.push({
+                category: this.category,
+                severity: 'info',
+                title: 'Strong commit frequency',
+                description: `${commitsPerSession.toFixed(1)} commits per session. Frequent commits improve traceability.`,
+                metricName: 'commits_per_session',
+                metricValue: commitsPerSession,
+                metricTarget: THRESHOLDS.commitsPerSession.excellent,
+                scoreImpact: 10,
+                evidence,
+                recommendations: [],
+            });
+        }
+        else if (commitsPerSession >= THRESHOLDS.commitsPerSession.good) {
+            insights.push({
+                category: this.category,
+                severity: 'info',
+                title: 'Good commit frequency',
+                description: `${commitsPerSession.toFixed(1)} commits per session.`,
+                metricName: 'commits_per_session',
+                metricValue: commitsPerSession,
+                scoreImpact: 5,
+                evidence,
+                recommendations: ['Consider committing more frequently'],
+            });
+        }
+        else if (commitsPerSession <= THRESHOLDS.commitsPerSession.warning) {
+            insights.push({
+                category: this.category,
+                severity: 'suggestion',
+                title: 'Low commit frequency',
+                description: `${commitsPerSession.toFixed(1)} commits per session. More frequent commits improve recovery and review.`,
+                metricName: 'commits_per_session',
+                metricValue: commitsPerSession,
+                metricTarget: THRESHOLDS.commitsPerSession.good,
+                scoreImpact: -10,
+                evidence: [],
+                recommendations: [
+                    'Commit after completing each logical change',
+                    'Use atomic commits for better git history',
+                    'Commit before major refactors or experiments',
+                ],
+            });
+        }
+        return insights;
+    }
+    // ===========================================================================
+    // Commit Size Analysis
+    // ===========================================================================
+    analyzeCommitSize(data) {
+        const insights = [];
+        if (data.commits.length === 0)
+            return insights;
+        const avgSize = Math.round(data.commits.reduce((sum, c) => sum + c.linesAdded + c.linesRemoved, 0) /
+            data.commits.length);
+        const largeCommits = data.commits.filter(c => c.linesAdded + c.linesRemoved > THRESHOLDS.commitSize.warning.max);
+        const evidence = largeCommits.slice(0, 3).map(c => ({
+            type: 'commit',
+            id: c.hash,
+            description: `${c.linesAdded + c.linesRemoved} lines changed: ${c.message.substring(0, 80)}${c.message.length > 80 ? '...' : ''}`,
+            timestamp: c.timestamp,
+        }));
+        if (avgSize >= THRESHOLDS.commitSize.optimal.min &&
+            avgSize <= THRESHOLDS.commitSize.optimal.max) {
+            insights.push({
+                category: this.category,
+                severity: 'info',
+                title: 'Optimal commit size',
+                description: `Average ${avgSize} lines per commit. This size is easy to review and revert.`,
+                metricName: 'avg_commit_size',
+                metricValue: avgSize,
+                metricUnit: 'lines',
+                scoreImpact: 10,
+                evidence: [],
+                recommendations: [],
+            });
+        }
+        else if (largeCommits.length > 0) {
+            insights.push({
+                category: this.category,
+                severity: 'suggestion',
+                title: 'Large commits detected',
+                description: `${largeCommits.length} commits exceed 500 lines. Smaller commits are easier to review.`,
+                metricName: 'large_commit_count',
+                metricValue: largeCommits.length,
+                scoreImpact: -5,
+                evidence,
+                recommendations: [
+                    'Break large changes into logical commits',
+                    'Commit refactors separately from features',
+                    'Use git add -p for partial staging',
+                ],
+            });
+        }
+        return insights;
+    }
+    // ===========================================================================
+    // Event Logging Quality Analysis (PATTERN-001: Ephemeral Sessions)
+    // ===========================================================================
+    /**
+     * Analyzes event logging rate instead of handoff rate.
+     *
+     * Per PATTERN-001: Sessions are ephemeral with 2-3 day validity.
+     * Context is preserved via defensive logging (events), not handoffs.
+     * Handoffs are optional - what matters is continuous event capture.
+     */
+    analyzeHandoffQuality(data) {
+        const insights = [];
+        if (data.sessions.length === 0)
+            return insights;
+        // Calculate events per session using session-level event counts
+        // Each session tracks its own events in the Timeline section
+        const totalSessionEvents = data.sessions.reduce((sum, s) => sum + s.eventCount, 0);
+        const eventsPerSession = totalSessionEvents / data.sessions.length;
+        // Find sessions with good logging
+        const wellLoggedSessions = data.sessions.filter(s => s.eventCount >= 2);
+        const loggingRate = Math.round((wellLoggedSessions.length / data.sessions.length) * 100);
+        const evidence = wellLoggedSessions.slice(0, 3).map(s => ({
+            type: 'session',
+            id: s.id,
+            description: `${s.eventCount} events logged (${s.hasHandoff ? 'with' : 'no'} handoff)`,
+            timestamp: s.startedAt,
+        }));
+        if (eventsPerSession >= THRESHOLDS.eventLoggingRate.excellent) {
+            insights.push({
+                category: this.category,
+                severity: 'info',
+                title: 'Strong defensive logging',
+                description: `${eventsPerSession.toFixed(1)} events per session. Context is well-captured.`,
+                metricName: 'events_per_session',
+                metricValue: eventsPerSession,
+                metricTarget: THRESHOLDS.eventLoggingRate.excellent,
+                scoreImpact: 10,
+                evidence,
+                recommendations: [],
+            });
+        }
+        else if (eventsPerSession >= THRESHOLDS.eventLoggingRate.good) {
+            insights.push({
+                category: this.category,
+                severity: 'info',
+                title: 'Good event logging',
+                description: `${eventsPerSession.toFixed(1)} events per session. Consider logging more insights.`,
+                metricName: 'events_per_session',
+                metricValue: eventsPerSession,
+                metricTarget: THRESHOLDS.eventLoggingRate.good,
+                scoreImpact: 5,
+                evidence,
+                recommendations: ['Log decisions and gotchas, not just completions'],
+            });
+        }
+        else if (eventsPerSession < THRESHOLDS.eventLoggingRate.warning) {
+            // Note: This differs from "Silent sessions detected" in anti-patterns:
+            // - Silent sessions = count of sessions with ZERO events (total context loss)
+            // - Low event logging = overall events/session ratio (insufficient logging)
+            const lowEventSessions = data.sessions.filter(s => s.eventCount < 2);
+            insights.push({
+                category: this.category,
+                severity: 'suggestion',
+                title: 'Low event logging',
+                description: `${eventsPerSession.toFixed(1)} events per session on average. This differs from silent sessions (zero events) - here sessions have some events but not enough for good context preservation.`,
+                metricName: 'events_per_session',
+                metricValue: eventsPerSession,
+                metricTarget: THRESHOLDS.eventLoggingRate.good,
+                scoreImpact: -10,
+                evidence: lowEventSessions.slice(0, 3).map(s => ({
+                    type: 'session',
+                    id: s.id,
+                    description: `Session with ${s.eventCount} event${s.eventCount === 1 ? '' : 's'} (target: 2+)`,
+                    timestamp: s.startedAt,
+                })),
+                recommendations: [
+                    'Use `ginko log` after fixes, features, and decisions',
+                    'Log insights while context is fresh (low pressure)',
+                    'Aim for 3-5 events per session for good continuity',
+                ],
+            });
+        }
+        return insights;
+    }
+    // ===========================================================================
+    // Sprint Velocity Analysis
+    // ===========================================================================
+    analyzeSprintVelocity(data) {
+        const insights = [];
+        // Calculate events per day as a velocity proxy
+        const eventsPerDay = data.events.length / data.period.days;
+        if (eventsPerDay >= 5) {
+            insights.push({
+                category: this.category,
+                severity: 'info',
+                title: 'High activity level',
+                description: `${eventsPerDay.toFixed(1)} logged events per day. Strong engagement with the project.`,
+                metricName: 'events_per_day',
+                metricValue: eventsPerDay,
+                scoreImpact: 5,
+                evidence: [],
+                recommendations: [],
+            });
+        }
+        else if (eventsPerDay < 1) {
+            insights.push({
+                category: this.category,
+                severity: 'suggestion',
+                title: 'Low activity logged',
+                description: `${eventsPerDay.toFixed(1)} events per day. Consider logging more insights.`,
+                metricName: 'events_per_day',
+                metricValue: eventsPerDay,
+                scoreImpact: -5,
+                evidence: [],
+                recommendations: [
+                    'Use `ginko log` after completing features or fixes',
+                    'Log decisions and insights, not just code changes',
+                    'Capture gotchas and patterns as you discover them',
+                ],
+            });
+        }
+        return insights;
+    }
+}
+export default QualityAnalyzer;
+//# sourceMappingURL=quality.js.map

package/dist/lib/insights/analyzers/quality.js.map

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

package/dist/lib/insights/data-collector.d.ts

@@ -0,0 +1,68 @@
+/**
+ * @fileType: utility
+ * @status: current
+ * @updated: 2025-12-15
+ * @tags: [insights, data-collection, events, tasks, commits]
+ * @related: [types.ts, ../event-logger.ts, ../sprint-parser.ts]
+ * @priority: high
+ * @complexity: high
+ * @dependencies: [fs, path, child_process]
+ */
+import { InsightData, EventData, TaskData, CommitData, SessionData, PatternData, GotchaData } from './types.js';
+export interface CollectorOptions {
+    days?: number;
+    projectRoot?: string;
+    userId?: string;
+    graphId?: string;
+}
+/**
+ * Collects and aggregates data from all sources for insight analysis.
+ * Uses findGinkoRoot to locate .ginko at monorepo root (like git finds .git).
+ */
+export declare function collectInsightData(options?: CollectorOptions): Promise<InsightData>;
+/**
+ * Collect events from local JSONL files.
+ */
+declare function collectEvents(projectRoot: string, userId: string, start: Date, end: Date): Promise<EventData[]>;
+/**
+ * Collect task data from sprint files.
+ */
+declare function collectTasks(projectRoot: string, start: Date, end: Date): Promise<TaskData>;
+/**
+ * Collect commit data from git log.
+ */
+declare function collectCommits(projectRoot: string, start: Date, end: Date): Promise<CommitData[]>;
+/**
+ * Collect session data from archive files.
+ */
+declare function collectSessions(projectRoot: string, userId: string, start: Date, end: Date): Promise<SessionData[]>;
+/**
+ * Collect pattern data from local docs.
+ */
+declare function collectPatterns(projectRoot: string): Promise<PatternData[]>;
+/**
+ * Collect gotcha data from local docs.
+ */
+declare function collectGotchas(projectRoot: string): Promise<GotchaData[]>;
+/**
+ * Detect user ID from git config or session files.
+ */
+declare function detectUserId(projectRoot: string): string;
+/**
+ * Detect project ID from directory name or package.json.
+ */
+declare function detectProjectId(projectRoot: string): string;
+/**
+ * Extract ADR references from text.
+ */
+declare function extractADRRefs(text: string): string[];
+/**
+ * Extract TASK references from text.
+ */
+declare function extractTaskRefs(text: string): string[];
+/**
+ * Extract pattern references from text.
+ */
+declare function extractPatternRefs(text: string): string[];
+export { collectEvents, collectTasks, collectCommits, collectSessions, collectPatterns, collectGotchas, detectUserId, detectProjectId, extractADRRefs, extractTaskRefs, extractPatternRefs, };
+//# sourceMappingURL=data-collector.d.ts.map

package/dist/lib/insights/data-collector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-collector.d.ts","sourceRoot":"","sources":["../../../src/lib/insights/data-collector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,OAAO,EACL,WAAW,EACX,SAAS,EACT,QAAQ,EAER,UAAU,EACV,WAAW,EACX,WAAW,EACX,UAAU,EACX,MAAM,YAAY,CAAC;AAgBpB,MAAM,WAAW,gBAAgB;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,WAAW,CAAC,CAoCtB;AAMD;;GAEG;AACH,iBAAe,aAAa,CAC1B,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,IAAI,EACX,GAAG,EAAE,IAAI,GACR,OAAO,CAAC,SAAS,EAAE,CAAC,CAkDtB;AAMD;;GAEG;AACH,iBAAe,YAAY,CACzB,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,IAAI,EACX,GAAG,EAAE,IAAI,GACR,OAAO,CAAC,QAAQ,CAAC,CAwDnB;AAuDD;;GAEG;AACH,iBAAe,cAAc,CAC3B,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,IAAI,EACX,GAAG,EAAE,IAAI,GACR,OAAO,CAAC,UAAU,EAAE,CAAC,CAwDvB;AAMD;;GAEG;AACH,iBAAe,eAAe,CAC5B,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,IAAI,EACX,GAAG,EAAE,IAAI,GACR,OAAO,CAAC,WAAW,EAAE,CAAC,CAgFxB;AAuED;;GAEG;AACH,iBAAe,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAkC1E;AAMD;;GAEG;AACH,iBAAe,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAmCxE;AAMD;;GAEG;AACH,iBAAS,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAUjD;AAED;;GAEG;AACH,iBAAS,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAWpD;AAED;;GAEG;AACH,iBAAS,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAG9C;AAED;;GAEG;AACH,iBAAS,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAG/C;AAED;;GAEG;AACH,iBAAS,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAGlD;AAMD,OAAO,EACL,aAAa,EACb,YAAY,EACZ,cAAc,EACd,eAAe,EACf,eAAe,EACf,cAAc,EACd,YAAY,EACZ,eAAe,EACf,cAAc,EACd,eAAe,EACf,kBAAkB,GACnB,CAAC"}