@boshu2/vibe-check 1.7.0 → 1.8.1

package/claude-progress.txt

@@ -3,6 +3,54 @@ Created: 2025-11-29
 
 ## Session Log
 
+--- 2025-12-02 21:00 - Major Cleanup & Actionable Coaching Plan ---
+
+VIBE LEVEL: 3 (Balanced, verify key outputs)
+
+COMPLETED:
+- Major codebase cleanup:
+  - Cut learning system (10 files, 1755 lines)
+  - Cut advanced gamification (7 files, 1215 lines)
+  - Removed learn, lesson, intervene commands
+  - 78 → 58 source files, -3900 lines total
+- Published v1.7.0 to npm
+- Fixed all documentation:
+  - Makefile, CLAUDE.md, README.md
+  - docs/GAMIFICATION.md (full rewrite)
+  - docs/ARCHITECTURE.md, docs/VIBE-ECOSYSTEM.md
+- Created actionable coaching plan:
+  - 5 new features (VIBE-040 to VIBE-044)
+  - Spiral history storage, personalized alerts
+  - ~300-400 lines, lean implementation
+
+COMMITS:
+- 6c28204 refactor: remove learning system and advanced gamification
+- 1526f6d chore: bump version to 1.7.0
+- fbe6a89 docs: remove references to deleted commands
+- e77a6c9 docs: update GAMIFICATION.md and ARCHITECTURE.md
+- 8f77bda docs: update VIBE-ECOSYSTEM.md and ARCHITECTURE.md
+- e4515e8 feat(dashboard): enhanced visual dashboard
+- 5ec7758 chore: add session bundles
+- 871a0c4 plan: actionable coaching enhancement
+
+ARTIFACTS:
+- .agents/bundles/actionable-coaching-plan-2025-12-02.md
+- feature-list.json updated with VIBE-040 to VIBE-044
+
+REMAINING:
+- VIBE-040: Spiral history storage (NDJSON)
+- VIBE-041: Auto-record spirals during analyze/session
+- VIBE-042: Personalized watch alerts
+- VIBE-043: Session end coaching
+- VIBE-044: Insights command
+
+NEXT SESSION SHOULD:
+- Start with VIBE-040: Create src/storage/spiral-history.ts
+- Implement NDJSON append/query functions
+- Then VIBE-041: Wire into analyze.ts and session.ts
+
+================================================================================
+
 --- 2025-12-02 - Automatic Learning Cadence Research & Planning ---
 
 VIBE LEVEL: 4 (Research/Planning, exploratory)

package/dist/analyzers/patterns.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Pattern Detection Analyzer (VIBE-045)
+ *
+ * Analyzes git history to detect failure patterns:
+ * - Debug spirals ("take N" pattern)
+ * - Vague commits (<20 chars)
+ * - Context amnesia (repeated scope visits)
+ *
+ * Proven algorithm from release-engineering retrospective (475 commits analyzed).
+ */
+import { Commit } from '../types';
+export interface DebugSpiral {
+    count: number;
+    durationMinutes: number;
+    commits: string[];
+    dates: string[];
+}
+export interface VagueCommitInfo {
+    count: number;
+    percentage: number;
+    threshold: number;
+    examples: string[];
+}
+export interface ContextAmnesiaInfo {
+    scopes: {
+        name: string;
+        visits: number;
+    }[];
+}
+export interface PatternDetectionResult {
+    debugSpirals: DebugSpiral | null;
+    vagueCommits: VagueCommitInfo;
+    contextAmnesia: ContextAmnesiaInfo;
+}
+/**
+ * Detect "take N" pattern indicating debug spirals.
+ *
+ * A debug spiral is detected when 3+ commits match the pattern "take N" or similar
+ * retry patterns, indicating the developer is stuck in a fix-retry loop.
+ */
+export declare function detectDebugSpirals(commits: Commit[]): DebugSpiral | null;
+/**
+ * Detect vague commits - messages that are too short to be meaningful.
+ *
+ * Threshold: < 20 characters is considered vague.
+ * Examples: "ci", "v3", "blah", "take 2", "fix"
+ */
+export declare function detectVagueCommits(commits: Commit[], threshold?: number): VagueCommitInfo;
+/**
+ * Detect context amnesia - repeatedly returning to the same scope/component.
+ *
+ * This indicates the developer keeps revisiting the same area, possibly
+ * due to incomplete understanding or forgotten context.
+ *
+ * Reports scopes that appear in 5+ commits.
+ */
+export declare function detectContextAmnesia(commits: Commit[], minVisits?: number): ContextAmnesiaInfo;
+/**
+ * Run all pattern detection on a set of commits.
+ */
+export declare function detectPatterns(commits: Commit[]): PatternDetectionResult;
+//# sourceMappingURL=patterns.d.ts.map

package/dist/analyzers/patterns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"patterns.d.ts","sourceRoot":"","sources":["../../src/analyzers/patterns.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAElC,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAC5C;AAED,MAAM,WAAW,sBAAsB;IACrC,YAAY,EAAE,WAAW,GAAG,IAAI,CAAC;IACjC,YAAY,EAAE,eAAe,CAAC;IAC9B,cAAc,EAAE,kBAAkB,CAAC;CACpC;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,WAAW,GAAG,IAAI,CAoCxE;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,MAAM,EAAE,EACjB,SAAS,GAAE,MAAW,GACrB,eAAe,CAmBjB;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,MAAM,EAAE,EACjB,SAAS,GAAE,MAAU,GACpB,kBAAkB,CAiBpB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,sBAAsB,CAMxE"}

package/dist/analyzers/patterns.js

@@ -0,0 +1,103 @@
+"use strict";
+/**
+ * Pattern Detection Analyzer (VIBE-045)
+ *
+ * Analyzes git history to detect failure patterns:
+ * - Debug spirals ("take N" pattern)
+ * - Vague commits (<20 chars)
+ * - Context amnesia (repeated scope visits)
+ *
+ * Proven algorithm from release-engineering retrospective (475 commits analyzed).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.detectDebugSpirals = detectDebugSpirals;
+exports.detectVagueCommits = detectVagueCommits;
+exports.detectContextAmnesia = detectContextAmnesia;
+exports.detectPatterns = detectPatterns;
+/**
+ * Detect "take N" pattern indicating debug spirals.
+ *
+ * A debug spiral is detected when 3+ commits match the pattern "take N" or similar
+ * retry patterns, indicating the developer is stuck in a fix-retry loop.
+ */
+function detectDebugSpirals(commits) {
+    const takePattern = /^take\s*[0-9]+$/i;
+    const retryPatterns = [
+        /^(fix|try|attempt)\s*#?\d+$/i, // "fix 2", "try #3"
+        /^(wip|temp|test)\s*\d*$/i, // "wip", "wip2"
+        /^v\d+$/i, // "v2", "v3"
+        takePattern,
+    ];
+    const spiralCommits = commits.filter((c) => retryPatterns.some((pattern) => pattern.test(c.message.trim())));
+    if (spiralCommits.length < 3) {
+        return null;
+    }
+    // Sort by date to calculate duration
+    const sorted = [...spiralCommits].sort((a, b) => a.date.getTime() - b.date.getTime());
+    const first = sorted[0];
+    const last = sorted[sorted.length - 1];
+    const durationMinutes = (last.date.getTime() - first.date.getTime()) / (60 * 1000);
+    // Get unique dates
+    const dates = [...new Set(sorted.map((c) => c.date.toISOString().split('T')[0]))];
+    return {
+        count: spiralCommits.length,
+        durationMinutes: Math.round(durationMinutes * 10) / 10,
+        commits: spiralCommits.map((c) => c.hash),
+        dates,
+    };
+}
+/**
+ * Detect vague commits - messages that are too short to be meaningful.
+ *
+ * Threshold: < 20 characters is considered vague.
+ * Examples: "ci", "v3", "blah", "take 2", "fix"
+ */
+function detectVagueCommits(commits, threshold = 20) {
+    const vagueCommits = commits.filter((c) => c.message.trim().length < threshold);
+    // Get example vague messages (deduplicated, max 10)
+    const examples = [
+        ...new Set(vagueCommits.map((c) => c.message.trim())),
+    ].slice(0, 10);
+    return {
+        count: vagueCommits.length,
+        percentage: commits.length > 0
+            ? Math.round((vagueCommits.length / commits.length) * 1000) / 10
+            : 0,
+        threshold,
+        examples,
+    };
+}
+/**
+ * Detect context amnesia - repeatedly returning to the same scope/component.
+ *
+ * This indicates the developer keeps revisiting the same area, possibly
+ * due to incomplete understanding or forgotten context.
+ *
+ * Reports scopes that appear in 5+ commits.
+ */
+function detectContextAmnesia(commits, minVisits = 5) {
+    const scopeCounts = new Map();
+    for (const commit of commits) {
+        if (commit.scope) {
+            const current = scopeCounts.get(commit.scope) || 0;
+            scopeCounts.set(commit.scope, current + 1);
+        }
+    }
+    // Filter to scopes with high visit counts, sorted descending
+    const scopes = Array.from(scopeCounts.entries())
+        .filter(([, count]) => count >= minVisits)
+        .sort((a, b) => b[1] - a[1])
+        .map(([name, visits]) => ({ name, visits }));
+    return { scopes };
+}
+/**
+ * Run all pattern detection on a set of commits.
+ */
+function detectPatterns(commits) {
+    return {
+        debugSpirals: detectDebugSpirals(commits),
+        vagueCommits: detectVagueCommits(commits),
+        contextAmnesia: detectContextAmnesia(commits),
+    };
+}
+//# sourceMappingURL=patterns.js.map

package/dist/analyzers/patterns.js.map

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

package/dist/analyzers/quality.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Quality Metrics Analyzer (VIBE-045)
+ *
+ * Calculates commit message quality metrics:
+ * - Conventional commits percentage
+ * - Descriptive commits percentage
+ * - Vague commits percentage
+ *
+ * Proven algorithm from release-engineering retrospective.
+ */
+import { Commit } from '../types';
+export interface QualityMetrics {
+    totalCommits: number;
+    conventionalCommits: {
+        count: number;
+        percentage: number;
+    };
+    descriptiveCommits: {
+        count: number;
+        percentage: number;
+        minLength: number;
+    };
+    vagueCommits: {
+        count: number;
+        percentage: number;
+        threshold: number;
+    };
+}
+/**
+ * Check if a commit message follows conventional commit format.
+ *
+ * Format: type(scope?): description
+ * Examples: "feat: add login", "fix(auth): handle token expiry"
+ */
+export declare function isConventionalCommit(message: string): boolean;
+/**
+ * Check if a commit message is descriptive (meaningful length).
+ *
+ * A descriptive commit has at least 20 characters in the first line.
+ */
+export declare function isDescriptiveCommit(message: string, minLength?: number): boolean;
+/**
+ * Check if a commit message is vague (too short to be meaningful).
+ *
+ * Threshold: < 20 characters
+ */
+export declare function isVagueCommit(message: string, threshold?: number): boolean;
+/**
+ * Calculate quality metrics for a set of commits.
+ */
+export declare function calculateQualityMetrics(commits: Commit[], vagueThreshold?: number, descriptiveMinLength?: number): QualityMetrics;
+/**
+ * Generate a recommendation based on quality metrics.
+ *
+ * Returns 'sweep' if cleanup is recommended, 'maintain' if quality is acceptable.
+ */
+export declare function getRecommendation(metrics: QualityMetrics, hasSpirals: boolean): 'sweep' | 'maintain' | 'celebrate';
+//# sourceMappingURL=quality.d.ts.map

package/dist/analyzers/quality.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quality.d.ts","sourceRoot":"","sources":["../../src/analyzers/quality.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAElC,MAAM,WAAW,cAAc;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,mBAAmB,EAAE;QACnB,KAAK,EAAE,MAAM,CAAC;QACd,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,kBAAkB,EAAE;QAClB,KAAK,EAAE,MAAM,CAAC;QACd,UAAU,EAAE,MAAM,CAAC;QACnB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,YAAY,EAAE;QACZ,KAAK,EAAE,MAAM,CAAC;QACd,UAAU,EAAE,MAAM,CAAC;QACnB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;CACH;AAmBD;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAM7D;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,MAAM,EACf,SAAS,GAAE,MAAW,GACrB,OAAO,CAGT;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,MAAM,EACf,SAAS,GAAE,MAAW,GACrB,OAAO,CAGT;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,MAAM,EAAE,EACjB,cAAc,GAAE,MAAW,EAC3B,oBAAoB,GAAE,MAAW,GAChC,cAAc,CAyChB;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,cAAc,EACvB,UAAU,EAAE,OAAO,GAClB,OAAO,GAAG,UAAU,GAAG,WAAW,CAgBpC"}

package/dist/analyzers/quality.js

@@ -0,0 +1,114 @@
+"use strict";
+/**
+ * Quality Metrics Analyzer (VIBE-045)
+ *
+ * Calculates commit message quality metrics:
+ * - Conventional commits percentage
+ * - Descriptive commits percentage
+ * - Vague commits percentage
+ *
+ * Proven algorithm from release-engineering retrospective.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isConventionalCommit = isConventionalCommit;
+exports.isDescriptiveCommit = isDescriptiveCommit;
+exports.isVagueCommit = isVagueCommit;
+exports.calculateQualityMetrics = calculateQualityMetrics;
+exports.getRecommendation = getRecommendation;
+/**
+ * Conventional commit types as per spec.
+ */
+const CONVENTIONAL_TYPES = [
+    'feat',
+    'fix',
+    'docs',
+    'style',
+    'refactor',
+    'perf',
+    'test',
+    'build',
+    'ci',
+    'chore',
+    'revert',
+];
+/**
+ * Check if a commit message follows conventional commit format.
+ *
+ * Format: type(scope?): description
+ * Examples: "feat: add login", "fix(auth): handle token expiry"
+ */
+function isConventionalCommit(message) {
+    const conventionalPattern = new RegExp(`^(${CONVENTIONAL_TYPES.join('|')})(\\([^)]+\\))?:\\s*.+`, 'i');
+    return conventionalPattern.test(message.trim());
+}
+/**
+ * Check if a commit message is descriptive (meaningful length).
+ *
+ * A descriptive commit has at least 20 characters in the first line.
+ */
+function isDescriptiveCommit(message, minLength = 20) {
+    const firstLine = message.trim().split('\n')[0];
+    return firstLine.length >= minLength;
+}
+/**
+ * Check if a commit message is vague (too short to be meaningful).
+ *
+ * Threshold: < 20 characters
+ */
+function isVagueCommit(message, threshold = 20) {
+    const firstLine = message.trim().split('\n')[0];
+    return firstLine.length < threshold;
+}
+/**
+ * Calculate quality metrics for a set of commits.
+ */
+function calculateQualityMetrics(commits, vagueThreshold = 20, descriptiveMinLength = 20) {
+    const total = commits.length;
+    if (total === 0) {
+        return {
+            totalCommits: 0,
+            conventionalCommits: { count: 0, percentage: 0 },
+            descriptiveCommits: { count: 0, percentage: 0, minLength: descriptiveMinLength },
+            vagueCommits: { count: 0, percentage: 0, threshold: vagueThreshold },
+        };
+    }
+    const conventionalCount = commits.filter((c) => isConventionalCommit(c.message)).length;
+    const descriptiveCount = commits.filter((c) => isDescriptiveCommit(c.message, descriptiveMinLength)).length;
+    const vagueCount = commits.filter((c) => isVagueCommit(c.message, vagueThreshold)).length;
+    return {
+        totalCommits: total,
+        conventionalCommits: {
+            count: conventionalCount,
+            percentage: Math.round((conventionalCount / total) * 1000) / 10,
+        },
+        descriptiveCommits: {
+            count: descriptiveCount,
+            percentage: Math.round((descriptiveCount / total) * 1000) / 10,
+            minLength: descriptiveMinLength,
+        },
+        vagueCommits: {
+            count: vagueCount,
+            percentage: Math.round((vagueCount / total) * 1000) / 10,
+            threshold: vagueThreshold,
+        },
+    };
+}
+/**
+ * Generate a recommendation based on quality metrics.
+ *
+ * Returns 'sweep' if cleanup is recommended, 'maintain' if quality is acceptable.
+ */
+function getRecommendation(metrics, hasSpirals) {
+    // Sweep if: >50% vague commits OR any debug spirals
+    if (metrics.vagueCommits.percentage > 50 || hasSpirals) {
+        return 'sweep';
+    }
+    // Celebrate if: >80% conventional AND <10% vague
+    if (metrics.conventionalCommits.percentage > 80 &&
+        metrics.vagueCommits.percentage < 10) {
+        return 'celebrate';
+    }
+    // Otherwise maintain current practices
+    return 'maintain';
+}
+//# sourceMappingURL=quality.js.map

package/dist/analyzers/quality.js.map

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

package/dist/analyzers/sessions.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Session Detection Algorithm (VIBE-046)
+ *
+ * Identifies work sessions from git history using configurable time gap threshold.
+ * Proven algorithm from release-engineering retrospective (46 sessions detected from 475 commits).
+ *
+ * Default threshold: 90 minutes between commits starts a new session.
+ */
+import { Commit } from '../types';
+export interface DetectedSession {
+    sessionId: number;
+    startDate: Date;
+    endDate: Date;
+    durationMinutes: number;
+    commits: Commit[];
+    commitCount: number;
+}
+export interface SessionStats {
+    totalSessions: number;
+    totalCommits: number;
+    avgCommitsPerSession: number;
+    avgDurationMinutes: number;
+    medianDurationMinutes: number;
+    longestSessionMinutes: number;
+    shortestSessionMinutes: number;
+}
+export interface SessionDetectionResult {
+    sessions: DetectedSession[];
+    stats: SessionStats;
+    analysisRange: {
+        from: Date;
+        to: Date;
+    };
+}
+/**
+ * Detect work sessions from a list of commits.
+ *
+ * A new session starts when the gap between consecutive commits exceeds the threshold.
+ *
+ * @param commits List of commits (will be sorted by date)
+ * @param gapThresholdMinutes Minutes between commits to start new session (default: 90)
+ * @returns Session detection result with sessions and statistics
+ */
+export declare function detectSessions(commits: Commit[], gapThresholdMinutes?: number): SessionDetectionResult;
+//# sourceMappingURL=sessions.d.ts.map

package/dist/analyzers/sessions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessions.d.ts","sourceRoot":"","sources":["../../src/analyzers/sessions.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAElC,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,IAAI,CAAC;IAChB,OAAO,EAAE,IAAI,CAAC;IACd,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,YAAY;IAC3B,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,sBAAsB,EAAE,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,eAAe,EAAE,CAAC;IAC5B,KAAK,EAAE,YAAY,CAAC;IACpB,aAAa,EAAE;QACb,IAAI,EAAE,IAAI,CAAC;QACX,EAAE,EAAE,IAAI,CAAC;KACV,CAAC;CACH;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,MAAM,EAAE,EACjB,mBAAmB,GAAE,MAAW,GAC/B,sBAAsB,CAkExB"}

package/dist/analyzers/sessions.js

@@ -0,0 +1,123 @@
+"use strict";
+/**
+ * Session Detection Algorithm (VIBE-046)
+ *
+ * Identifies work sessions from git history using configurable time gap threshold.
+ * Proven algorithm from release-engineering retrospective (46 sessions detected from 475 commits).
+ *
+ * Default threshold: 90 minutes between commits starts a new session.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.detectSessions = detectSessions;
+/**
+ * Detect work sessions from a list of commits.
+ *
+ * A new session starts when the gap between consecutive commits exceeds the threshold.
+ *
+ * @param commits List of commits (will be sorted by date)
+ * @param gapThresholdMinutes Minutes between commits to start new session (default: 90)
+ * @returns Session detection result with sessions and statistics
+ */
+function detectSessions(commits, gapThresholdMinutes = 90) {
+    if (commits.length === 0) {
+        return {
+            sessions: [],
+            stats: {
+                totalSessions: 0,
+                totalCommits: 0,
+                avgCommitsPerSession: 0,
+                avgDurationMinutes: 0,
+                medianDurationMinutes: 0,
+                longestSessionMinutes: 0,
+                shortestSessionMinutes: 0,
+            },
+            analysisRange: {
+                from: new Date(),
+                to: new Date(),
+            },
+        };
+    }
+    // Sort commits by date (oldest first)
+    const sortedCommits = [...commits].sort((a, b) => a.date.getTime() - b.date.getTime());
+    const gapThresholdMs = gapThresholdMinutes * 60 * 1000;
+    const sessions = [];
+    let currentSessionCommits = [];
+    let sessionId = 1;
+    for (const commit of sortedCommits) {
+        if (currentSessionCommits.length === 0) {
+            // Start first session
+            currentSessionCommits = [commit];
+        }
+        else {
+            const lastCommit = currentSessionCommits[currentSessionCommits.length - 1];
+            const gap = commit.date.getTime() - lastCommit.date.getTime();
+            if (gap > gapThresholdMs) {
+                // Gap exceeded - save current session and start new one
+                sessions.push(createSession(sessionId, currentSessionCommits));
+                sessionId++;
+                currentSessionCommits = [commit];
+            }
+            else {
+                // Continue current session
+                currentSessionCommits.push(commit);
+            }
+        }
+    }
+    // Don't forget the last session
+    if (currentSessionCommits.length > 0) {
+        sessions.push(createSession(sessionId, currentSessionCommits));
+    }
+    // Calculate statistics
+    const stats = calculateStats(sessions);
+    return {
+        sessions,
+        stats,
+        analysisRange: {
+            from: sortedCommits[0].date,
+            to: sortedCommits[sortedCommits.length - 1].date,
+        },
+    };
+}
+function createSession(sessionId, commits) {
+    const startDate = commits[0].date;
+    const endDate = commits[commits.length - 1].date;
+    const durationMinutes = (endDate.getTime() - startDate.getTime()) / (60 * 1000);
+    return {
+        sessionId,
+        startDate,
+        endDate,
+        durationMinutes: Math.round(durationMinutes * 10) / 10, // Round to 1 decimal
+        commits,
+        commitCount: commits.length,
+    };
+}
+function calculateStats(sessions) {
+    if (sessions.length === 0) {
+        return {
+            totalSessions: 0,
+            totalCommits: 0,
+            avgCommitsPerSession: 0,
+            avgDurationMinutes: 0,
+            medianDurationMinutes: 0,
+            longestSessionMinutes: 0,
+            shortestSessionMinutes: 0,
+        };
+    }
+    const totalCommits = sessions.reduce((sum, s) => sum + s.commitCount, 0);
+    const durations = sessions.map((s) => s.durationMinutes).sort((a, b) => a - b);
+    // Calculate median
+    const mid = Math.floor(durations.length / 2);
+    const medianDuration = durations.length % 2 === 0
+        ? (durations[mid - 1] + durations[mid]) / 2
+        : durations[mid];
+    return {
+        totalSessions: sessions.length,
+        totalCommits,
+        avgCommitsPerSession: Math.round((totalCommits / sessions.length) * 10) / 10,
+        avgDurationMinutes: Math.round((durations.reduce((sum, d) => sum + d, 0) / durations.length) * 10) / 10,
+        medianDurationMinutes: Math.round(medianDuration * 10) / 10,
+        longestSessionMinutes: durations[durations.length - 1],
+        shortestSessionMinutes: durations[0],
+    };
+}
+//# sourceMappingURL=sessions.js.map

package/dist/analyzers/sessions.js.map

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

package/dist/cli.js

@@ -22,6 +22,10 @@ program.addCommand((0, commands_1.createTimelineCommand)());
 program.addCommand((0, commands_1.createCacheCommand)());
 program.addCommand((0, commands_1.createDashboardCommand)());
 program.addCommand((0, commands_1.createSessionCommand)());
+program.addCommand((0, commands_1.createInsightsCommand)());
+program.addCommand((0, commands_1.createPipelineCommand)());
+program.addCommand((0, commands_1.createSessionsCommand)());
+program.addCommand((0, commands_1.createForensicsCommand)());
 // Default behavior: if no subcommand, run analyze with passed options
 // This maintains backwards compatibility with v1.x usage
 program

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";;;AAEA,yCAAoC;AACpC,yCAA4O;AAE5O,8DAA8D;AAC9D,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;AAE/C,MAAM,OAAO,GAAG,IAAI,mBAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,YAAY,CAAC;KAClB,WAAW,CAAC,6CAA6C,CAAC;KAC1D,OAAO,CAAC,OAAO,CAAC;KAChB,uBAAuB,EAAE;KACzB,kBAAkB,EAAE,CAAC;AAExB,kBAAkB;AAClB,OAAO,CAAC,UAAU,CAAC,IAAA,+BAAoB,GAAE,CAAC,CAAC;AAC3C,OAAO,CAAC,UAAU,CAAC,IAAA,6BAAkB,GAAE,CAAC,CAAC;AACzC,OAAO,CAAC,UAAU,CAAC,IAAA,+BAAoB,GAAE,CAAC,CAAC;AAC3C,OAAO,CAAC,UAAU,CAAC,IAAA,gCAAqB,GAAE,CAAC,CAAC;AAC5C,OAAO,CAAC,UAAU,CAAC,IAAA,6BAAkB,GAAE,CAAC,CAAC;AACzC,OAAO,CAAC,UAAU,CAAC,IAAA,gCAAqB,GAAE,CAAC,CAAC;AAC5C,OAAO,CAAC,UAAU,CAAC,IAAA,6BAAkB,GAAE,CAAC,CAAC;AACzC,OAAO,CAAC,UAAU,CAAC,IAAA,iCAAsB,GAAE,CAAC,CAAC;AAC7C,OAAO,CAAC,UAAU,CAAC,IAAA,+BAAoB,GAAE,CAAC,CAAC;AAE3C,sEAAsE;AACtE,yDAAyD;AACzD,OAAO;KACJ,MAAM,CAAC,gBAAgB,EAAE,8CAA8C,CAAC;KACxE,MAAM,CAAC,gBAAgB,EAAE,sCAAsC,CAAC;KAChE,MAAM,CAAC,qBAAqB,EAAE,yCAAyC,EAAE,UAAU,CAAC;KACpF,MAAM,CAAC,mBAAmB,EAAE,iBAAiB,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC;KAC7D,MAAM,CAAC,eAAe,EAAE,qBAAqB,EAAE,KAAK,CAAC;KACrD,MAAM,CAAC,SAAS,EAAE,4CAA4C,EAAE,KAAK,CAAC;KACtE,MAAM,CAAC,qBAAqB,EAAE,4BAA4B,CAAC;KAC3D,MAAM,CAAC,cAAc,EAAE,mCAAmC,EAAE,KAAK,CAAC;KAClE,MAAM,CAAC,YAAY,EAAE,0DAA0D,CAAC;KAChF,MAAM,CAAC,iBAAiB,EAAE,yDAAyD,CAAC;KACpF,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;IACxB,wDAAwD;IACxD,MAAM,IAAA,qBAAU,EAAC;QACf,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,KAAK,EAAE,OAAO,CAAC,KAAK;KACrB,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEL,OAAO,CAAC,KAAK,EAAE,CAAC"}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";;;AAEA,yCAAoC;AACpC,yCAAyU;AAEzU,8DAA8D;AAC9D,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;AAE/C,MAAM,OAAO,GAAG,IAAI,mBAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,YAAY,CAAC;KAClB,WAAW,CAAC,6CAA6C,CAAC;KAC1D,OAAO,CAAC,OAAO,CAAC;KAChB,uBAAuB,EAAE;KACzB,kBAAkB,EAAE,CAAC;AAExB,kBAAkB;AAClB,OAAO,CAAC,UAAU,CAAC,IAAA,+BAAoB,GAAE,CAAC,CAAC;AAC3C,OAAO,CAAC,UAAU,CAAC,IAAA,6BAAkB,GAAE,CAAC,CAAC;AACzC,OAAO,CAAC,UAAU,CAAC,IAAA,+BAAoB,GAAE,CAAC,CAAC;AAC3C,OAAO,CAAC,UAAU,CAAC,IAAA,gCAAqB,GAAE,CAAC,CAAC;AAC5C,OAAO,CAAC,UAAU,CAAC,IAAA,6BAAkB,GAAE,CAAC,CAAC;AACzC,OAAO,CAAC,UAAU,CAAC,IAAA,gCAAqB,GAAE,CAAC,CAAC;AAC5C,OAAO,CAAC,UAAU,CAAC,IAAA,6BAAkB,GAAE,CAAC,CAAC;AACzC,OAAO,CAAC,UAAU,CAAC,IAAA,iCAAsB,GAAE,CAAC,CAAC;AAC7C,OAAO,CAAC,UAAU,CAAC,IAAA,+BAAoB,GAAE,CAAC,CAAC;AAC3C,OAAO,CAAC,UAAU,CAAC,IAAA,gCAAqB,GAAE,CAAC,CAAC;AAC5C,OAAO,CAAC,UAAU,CAAC,IAAA,gCAAqB,GAAE,CAAC,CAAC;AAC5C,OAAO,CAAC,UAAU,CAAC,IAAA,gCAAqB,GAAE,CAAC,CAAC;AAC5C,OAAO,CAAC,UAAU,CAAC,IAAA,iCAAsB,GAAE,CAAC,CAAC;AAE7C,sEAAsE;AACtE,yDAAyD;AACzD,OAAO;KACJ,MAAM,CAAC,gBAAgB,EAAE,8CAA8C,CAAC;KACxE,MAAM,CAAC,gBAAgB,EAAE,sCAAsC,CAAC;KAChE,MAAM,CAAC,qBAAqB,EAAE,yCAAyC,EAAE,UAAU,CAAC;KACpF,MAAM,CAAC,mBAAmB,EAAE,iBAAiB,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC;KAC7D,MAAM,CAAC,eAAe,EAAE,qBAAqB,EAAE,KAAK,CAAC;KACrD,MAAM,CAAC,SAAS,EAAE,4CAA4C,EAAE,KAAK,CAAC;KACtE,MAAM,CAAC,qBAAqB,EAAE,4BAA4B,CAAC;KAC3D,MAAM,CAAC,cAAc,EAAE,mCAAmC,EAAE,KAAK,CAAC;KAClE,MAAM,CAAC,YAAY,EAAE,0DAA0D,CAAC;KAChF,MAAM,CAAC,iBAAiB,EAAE,yDAAyD,CAAC;KACpF,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;IACxB,wDAAwD;IACxD,MAAM,IAAA,qBAAU,EAAC;QACf,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,KAAK,EAAE,OAAO,CAAC,KAAK;KACrB,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEL,OAAO,CAAC,KAAK,EAAE,CAAC"}

package/dist/commands/analyze.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"analyze.d.ts","sourceRoot":"","sources":["../../src/commands/analyze.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAgCpC,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,oBAAoB,IAAI,OAAO,CAkB9C;AAED,wBAAsB,UAAU,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAsXvE"}
+{"version":3,"file":"analyze.d.ts","sourceRoot":"","sources":["../../src/commands/analyze.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAiCpC,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,oBAAoB,IAAI,OAAO,CAkB9C;AAED,wBAAsB,UAAU,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAgYvE"}

package/dist/commands/analyze.js

@@ -22,6 +22,7 @@ const types_1 = require("../gamification/types");
 const start_1 = require("./start");
 const sessions_1 = require("../sessions");
 const analysis_1 = require("../analysis");
+const spiral_history_1 = require("../storage/spiral-history");
 function createAnalyzeCommand() {
     const cmd = new commander_1.Command('analyze')
         .description('Analyze git history for vibe coding metrics')
@@ -150,6 +151,10 @@ async function runAnalyze(options) {
         const trustPassRate = result.metrics.trustPassRate.value;
         const reworkRatio = result.metrics.reworkRatio.value;
         const spiralCount = result.fixChains.filter(fc => fc.isSpiral).length;
+        // Record detected spirals to history for personalized coaching
+        for (const chain of result.fixChains.filter(fc => fc.isSpiral)) {
+            (0, spiral_history_1.appendSpiral)(chain.pattern || 'OTHER', chain.component, chain.duration, chain.commits);
+        }
         // Session comparison (if manual session was active via `start`)
         if (session && format === 'terminal') {
             const levelInfo = start_1.LEVEL_INFO[session.level];