@boshu2/vibe-check 1.6.2 → 1.8.0

package/dist/learning/types.js

@@ -0,0 +1,17 @@
+"use strict";
+/**
+ * Learning System Types
+ *
+ * Types for the automatic learning cadence system including:
+ * - Learning state persistence
+ * - Nudge queue management
+ * - Retrospective summaries
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PATTERN_WINDOW_DAYS = exports.PATTERN_REPEAT_THRESHOLD = exports.RETRO_CADENCE_DAYS = exports.MAX_PENDING_NUDGES = exports.NUDGE_TTL_DAYS = void 0;
+exports.NUDGE_TTL_DAYS = 7;
+exports.MAX_PENDING_NUDGES = 5;
+exports.RETRO_CADENCE_DAYS = 7;
+exports.PATTERN_REPEAT_THRESHOLD = 3;
+exports.PATTERN_WINDOW_DAYS = 7;
+//# sourceMappingURL=types.js.map

package/dist/learning/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/learning/types.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;AA6DU,QAAA,cAAc,GAAG,CAAC,CAAC;AACnB,QAAA,kBAAkB,GAAG,CAAC,CAAC;AACvB,QAAA,kBAAkB,GAAG,CAAC,CAAC;AACvB,QAAA,wBAAwB,GAAG,CAAC,CAAC;AAC7B,QAAA,mBAAmB,GAAG,CAAC,CAAC"}

package/dist/storage/index.d.ts

@@ -2,4 +2,5 @@ export { TimelineStore, StoredSession, StoredInsight, PatternStats, TrendData, W
 export { atomicWriteSync, appendLineSync, readNdjsonSync, readNdjsonWithErrors, safeReadJsonSync, ensureGitignore, NdjsonReadResult, } from './atomic';
 export { StoredCommit, getCommitLogPath, appendCommits, readCommitLog, getLastLoggedCommitHash, getCommitLogCount, } from './commit-log';
 export { SchemaVersion, CURRENT_SCHEMA_VERSION, VersionedStore, migrateStore, needsMigration, } from './schema';
+export { SpiralRecord, SpiralResolution, SpiralAdvice, getSpiralHistoryPath, appendSpiral, resolveSpiral, readSpiralHistory, getAdvice, getPatternStats, getPatternDisplayName, getResolutionDisplayName, } from './spiral-history';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,aAAa,EACb,aAAa,EACb,aAAa,EACb,YAAY,EACZ,SAAS,EACT,SAAS,EACT,UAAU,EACV,SAAS,EACT,SAAS,EACT,kBAAkB,EAClB,WAAW,EACX,iBAAiB,EACjB,YAAY,EACZ,WAAW,GACZ,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,eAAe,EACf,cAAc,EACd,cAAc,EACd,oBAAoB,EACpB,gBAAgB,EAChB,eAAe,EACf,gBAAgB,GACjB,MAAM,UAAU,CAAC;AAGlB,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,aAAa,EACb,aAAa,EACb,uBAAuB,EACvB,iBAAiB,GAClB,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,aAAa,EACb,sBAAsB,EACtB,cAAc,EACd,YAAY,EACZ,cAAc,GACf,MAAM,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,aAAa,EACb,aAAa,EACb,aAAa,EACb,YAAY,EACZ,SAAS,EACT,SAAS,EACT,UAAU,EACV,SAAS,EACT,SAAS,EACT,kBAAkB,EAClB,WAAW,EACX,iBAAiB,EACjB,YAAY,EACZ,WAAW,GACZ,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,eAAe,EACf,cAAc,EACd,cAAc,EACd,oBAAoB,EACpB,gBAAgB,EAChB,eAAe,EACf,gBAAgB,GACjB,MAAM,UAAU,CAAC;AAGlB,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,aAAa,EACb,aAAa,EACb,uBAAuB,EACvB,iBAAiB,GAClB,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,aAAa,EACb,sBAAsB,EACtB,cAAc,EACd,YAAY,EACZ,cAAc,GACf,MAAM,UAAU,CAAC;AAGlB,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,YAAY,EACZ,oBAAoB,EACpB,YAAY,EACZ,aAAa,EACb,iBAAiB,EACjB,SAAS,EACT,eAAe,EACf,qBAAqB,EACrB,wBAAwB,GACzB,MAAM,kBAAkB,CAAC"}

package/dist/storage/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.needsMigration = exports.migrateStore = exports.CURRENT_SCHEMA_VERSION = exports.getCommitLogCount = exports.getLastLoggedCommitHash = exports.readCommitLog = exports.appendCommits = exports.getCommitLogPath = exports.ensureGitignore = exports.safeReadJsonSync = exports.readNdjsonWithErrors = exports.readNdjsonSync = exports.appendLineSync = exports.atomicWriteSync = exports.getStoreDir = exports.getStorePath = exports.getLastCommitHash = exports.updateStore = exports.createInitialStore = exports.saveStore = exports.loadStore = void 0;
+exports.getResolutionDisplayName = exports.getPatternDisplayName = exports.getPatternStats = exports.getAdvice = exports.readSpiralHistory = exports.resolveSpiral = exports.appendSpiral = exports.getSpiralHistoryPath = exports.needsMigration = exports.migrateStore = exports.CURRENT_SCHEMA_VERSION = exports.getCommitLogCount = exports.getLastLoggedCommitHash = exports.readCommitLog = exports.appendCommits = exports.getCommitLogPath = exports.ensureGitignore = exports.safeReadJsonSync = exports.readNdjsonWithErrors = exports.readNdjsonSync = exports.appendLineSync = exports.atomicWriteSync = exports.getStoreDir = exports.getStorePath = exports.getLastCommitHash = exports.updateStore = exports.createInitialStore = exports.saveStore = exports.loadStore = void 0;
 // Timeline store (computed view)
 var timeline_store_1 = require("./timeline-store");
 Object.defineProperty(exports, "loadStore", { enumerable: true, get: function () { return timeline_store_1.loadStore; } });
@@ -30,4 +30,14 @@ var schema_1 = require("./schema");
 Object.defineProperty(exports, "CURRENT_SCHEMA_VERSION", { enumerable: true, get: function () { return schema_1.CURRENT_SCHEMA_VERSION; } });
 Object.defineProperty(exports, "migrateStore", { enumerable: true, get: function () { return schema_1.migrateStore; } });
 Object.defineProperty(exports, "needsMigration", { enumerable: true, get: function () { return schema_1.needsMigration; } });
+// Spiral history (coaching feature)
+var spiral_history_1 = require("./spiral-history");
+Object.defineProperty(exports, "getSpiralHistoryPath", { enumerable: true, get: function () { return spiral_history_1.getSpiralHistoryPath; } });
+Object.defineProperty(exports, "appendSpiral", { enumerable: true, get: function () { return spiral_history_1.appendSpiral; } });
+Object.defineProperty(exports, "resolveSpiral", { enumerable: true, get: function () { return spiral_history_1.resolveSpiral; } });
+Object.defineProperty(exports, "readSpiralHistory", { enumerable: true, get: function () { return spiral_history_1.readSpiralHistory; } });
+Object.defineProperty(exports, "getAdvice", { enumerable: true, get: function () { return spiral_history_1.getAdvice; } });
+Object.defineProperty(exports, "getPatternStats", { enumerable: true, get: function () { return spiral_history_1.getPatternStats; } });
+Object.defineProperty(exports, "getPatternDisplayName", { enumerable: true, get: function () { return spiral_history_1.getPatternDisplayName; } });
+Object.defineProperty(exports, "getResolutionDisplayName", { enumerable: true, get: function () { return spiral_history_1.getResolutionDisplayName; } });
 //# sourceMappingURL=index.js.map

package/dist/storage/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":";;;AAAA,iCAAiC;AACjC,mDAe0B;AAPxB,2GAAA,SAAS,OAAA;AACT,2GAAA,SAAS,OAAA;AACT,oHAAA,kBAAkB,OAAA;AAClB,6GAAA,WAAW,OAAA;AACX,mHAAA,iBAAiB,OAAA;AACjB,8GAAA,YAAY,OAAA;AACZ,6GAAA,WAAW,OAAA;AAGb,yBAAyB;AACzB,mCAQkB;AAPhB,yGAAA,eAAe,OAAA;AACf,wGAAA,cAAc,OAAA;AACd,wGAAA,cAAc,OAAA;AACd,8GAAA,oBAAoB,OAAA;AACpB,0GAAA,gBAAgB,OAAA;AAChB,yGAAA,eAAe,OAAA;AAIjB,sCAAsC;AACtC,2CAOsB;AALpB,8GAAA,gBAAgB,OAAA;AAChB,2GAAA,aAAa,OAAA;AACb,2GAAA,aAAa,OAAA;AACb,qHAAA,uBAAuB,OAAA;AACvB,+GAAA,iBAAiB,OAAA;AAGnB,oBAAoB;AACpB,mCAMkB;AAJhB,gHAAA,sBAAsB,OAAA;AAEtB,sGAAA,YAAY,OAAA;AACZ,wGAAA,cAAc,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":";;;AAAA,iCAAiC;AACjC,mDAe0B;AAPxB,2GAAA,SAAS,OAAA;AACT,2GAAA,SAAS,OAAA;AACT,oHAAA,kBAAkB,OAAA;AAClB,6GAAA,WAAW,OAAA;AACX,mHAAA,iBAAiB,OAAA;AACjB,8GAAA,YAAY,OAAA;AACZ,6GAAA,WAAW,OAAA;AAGb,yBAAyB;AACzB,mCAQkB;AAPhB,yGAAA,eAAe,OAAA;AACf,wGAAA,cAAc,OAAA;AACd,wGAAA,cAAc,OAAA;AACd,8GAAA,oBAAoB,OAAA;AACpB,0GAAA,gBAAgB,OAAA;AAChB,yGAAA,eAAe,OAAA;AAIjB,sCAAsC;AACtC,2CAOsB;AALpB,8GAAA,gBAAgB,OAAA;AAChB,2GAAA,aAAa,OAAA;AACb,2GAAA,aAAa,OAAA;AACb,qHAAA,uBAAuB,OAAA;AACvB,+GAAA,iBAAiB,OAAA;AAGnB,oBAAoB;AACpB,mCAMkB;AAJhB,gHAAA,sBAAsB,OAAA;AAEtB,sGAAA,YAAY,OAAA;AACZ,wGAAA,cAAc,OAAA;AAGhB,oCAAoC;AACpC,mDAY0B;AARxB,sHAAA,oBAAoB,OAAA;AACpB,8GAAA,YAAY,OAAA;AACZ,+GAAA,aAAa,OAAA;AACb,mHAAA,iBAAiB,OAAA;AACjB,2GAAA,SAAS,OAAA;AACT,iHAAA,eAAe,OAAA;AACf,uHAAA,qBAAqB,OAAA;AACrB,0HAAA,wBAAwB,OAAA"}

package/dist/storage/spiral-history.d.ts

@@ -0,0 +1,62 @@
+export type SpiralResolution = 'TEST' | 'BREAK' | 'DOCS' | 'HELP' | 'ROLLBACK' | 'OTHER';
+export interface SpiralRecord {
+    date: string;
+    pattern: string;
+    component: string;
+    duration: number;
+    commits: number;
+    resolution?: SpiralResolution;
+    resolvedAt?: string;
+}
+export interface SpiralAdvice {
+    yourHistory: {
+        times: number;
+        avgDuration: number;
+        totalMinutes: number;
+    };
+    whatWorked: Array<{
+        resolution: SpiralResolution;
+        times: number;
+        avgDuration: number;
+    }>;
+    suggestion: string;
+}
+/**
+ * Get spiral history file path (in user's home directory)
+ */
+export declare function getSpiralHistoryPath(): string;
+/**
+ * Append a spiral to history
+ */
+export declare function appendSpiral(pattern: string, component: string, duration: number, commits: number): void;
+/**
+ * Resolve the most recent unresolved spiral
+ */
+export declare function resolveSpiral(resolution: SpiralResolution): boolean;
+/**
+ * Read all spiral history
+ */
+export declare function readSpiralHistory(): SpiralRecord[];
+/**
+ * Get personalized advice for a pattern
+ */
+export declare function getAdvice(pattern: string, component?: string): SpiralAdvice | null;
+/**
+ * Get pattern statistics for insights command
+ */
+export declare function getPatternStats(days?: number): Array<{
+    pattern: string;
+    times: number;
+    avgDuration: number;
+    bestFix: SpiralResolution | null;
+    components: string[];
+}>;
+/**
+ * Friendly pattern names for display
+ */
+export declare function getPatternDisplayName(pattern: string): string;
+/**
+ * Friendly resolution names for display
+ */
+export declare function getResolutionDisplayName(resolution: SpiralResolution): string;
+//# sourceMappingURL=spiral-history.d.ts.map

package/dist/storage/spiral-history.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spiral-history.d.ts","sourceRoot":"","sources":["../../src/storage/spiral-history.ts"],"names":[],"mappings":"AAWA,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,UAAU,GAAG,OAAO,CAAC;AAGzF,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAGD,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE;QACX,KAAK,EAAE,MAAM,CAAC;QACd,WAAW,EAAE,MAAM,CAAC;QACpB,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,UAAU,EAAE,KAAK,CAAC;QAChB,UAAU,EAAE,gBAAgB,CAAC;QAC7B,KAAK,EAAE,MAAM,CAAC;QACd,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC,CAAC;IACH,UAAU,EAAE,MAAM,CAAC;CACpB;AAMD;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,CAE7C;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,GACd,IAAI,CAUN;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,gBAAgB,GAAG,OAAO,CAgBnE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,YAAY,EAAE,CAElD;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAiDlF;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,IAAI,SAAK,GACR,KAAK,CAAC;IACP,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAAC;IACjC,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB,CAAC,CA+DD;AA+DD;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAY7D;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,UAAU,EAAE,gBAAgB,GAAG,MAAM,CAW7E"}

package/dist/storage/spiral-history.js

@@ -0,0 +1,265 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getSpiralHistoryPath = getSpiralHistoryPath;
+exports.appendSpiral = appendSpiral;
+exports.resolveSpiral = resolveSpiral;
+exports.readSpiralHistory = readSpiralHistory;
+exports.getAdvice = getAdvice;
+exports.getPatternStats = getPatternStats;
+exports.getPatternDisplayName = getPatternDisplayName;
+exports.getResolutionDisplayName = getResolutionDisplayName;
+/**
+ * Spiral History Storage
+ *
+ * Append-only NDJSON log of spiral events with resolution tracking.
+ * Enables personalized coaching based on what worked before.
+ */
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+const atomic_1 = require("./atomic");
+const HISTORY_DIR = '.vibe-check';
+const HISTORY_FILE = 'spiral-history.ndjson';
+const MAX_RECORDS = 100; // Keep last 100 spirals
+/**
+ * Get spiral history file path (in user's home directory)
+ */
+function getSpiralHistoryPath() {
+    return path.join(os.homedir(), HISTORY_DIR, HISTORY_FILE);
+}
+/**
+ * Append a spiral to history
+ */
+function appendSpiral(pattern, component, duration, commits) {
+    const record = {
+        date: new Date().toISOString(),
+        pattern,
+        component,
+        duration,
+        commits,
+    };
+    (0, atomic_1.appendLineSync)(getSpiralHistoryPath(), JSON.stringify(record));
+}
+/**
+ * Resolve the most recent unresolved spiral
+ */
+function resolveSpiral(resolution) {
+    const records = readSpiralHistory();
+    // Find most recent unresolved spiral
+    for (let i = records.length - 1; i >= 0; i--) {
+        if (!records[i].resolution) {
+            records[i].resolution = resolution;
+            records[i].resolvedAt = new Date().toISOString();
+            // Rewrite entire file (since we're modifying existing record)
+            rewriteHistory(records);
+            return true;
+        }
+    }
+    return false; // No unresolved spiral found
+}
+/**
+ * Read all spiral history
+ */
+function readSpiralHistory() {
+    return (0, atomic_1.readNdjsonSync)(getSpiralHistoryPath());
+}
+/**
+ * Get personalized advice for a pattern
+ */
+function getAdvice(pattern, component) {
+    const records = readSpiralHistory();
+    // Filter to matching pattern (and optionally component)
+    const matching = records.filter((r) => r.pattern === pattern && (!component || r.component === component));
+    if (matching.length === 0) {
+        return null;
+    }
+    // Calculate history stats
+    const totalDuration = matching.reduce((sum, r) => sum + r.duration, 0);
+    const avgDuration = Math.round(totalDuration / matching.length);
+    // Group by resolution
+    const resolutionStats = new Map();
+    for (const record of matching) {
+        if (record.resolution) {
+            const stats = resolutionStats.get(record.resolution) || { times: 0, totalDuration: 0 };
+            stats.times++;
+            stats.totalDuration += record.duration;
+            resolutionStats.set(record.resolution, stats);
+        }
+    }
+    // Sort by frequency
+    const whatWorked = Array.from(resolutionStats.entries())
+        .map(([resolution, stats]) => ({
+        resolution,
+        times: stats.times,
+        avgDuration: Math.round(stats.totalDuration / stats.times),
+    }))
+        .sort((a, b) => b.times - a.times);
+    // Generate suggestion
+    const suggestion = generateSuggestion(pattern, whatWorked, matching.length);
+    return {
+        yourHistory: {
+            times: matching.length,
+            avgDuration,
+            totalMinutes: totalDuration,
+        },
+        whatWorked,
+        suggestion,
+    };
+}
+/**
+ * Get pattern statistics for insights command
+ */
+function getPatternStats(days = 30) {
+    const records = readSpiralHistory();
+    const cutoff = new Date();
+    cutoff.setDate(cutoff.getDate() - days);
+    // Filter to recent records
+    const recent = records.filter((r) => new Date(r.date) >= cutoff);
+    // Group by pattern
+    const patternStats = new Map();
+    for (const record of recent) {
+        const stats = patternStats.get(record.pattern) || {
+            times: 0,
+            totalDuration: 0,
+            resolutions: new Map(),
+            components: new Set(),
+        };
+        stats.times++;
+        stats.totalDuration += record.duration;
+        stats.components.add(record.component);
+        if (record.resolution) {
+            stats.resolutions.set(record.resolution, (stats.resolutions.get(record.resolution) || 0) + 1);
+        }
+        patternStats.set(record.pattern, stats);
+    }
+    // Convert to array and sort by frequency
+    return Array.from(patternStats.entries())
+        .map(([pattern, stats]) => {
+        // Find most common resolution
+        let bestFix = null;
+        let maxCount = 0;
+        for (const [resolution, count] of stats.resolutions) {
+            if (count > maxCount) {
+                maxCount = count;
+                bestFix = resolution;
+            }
+        }
+        return {
+            pattern,
+            times: stats.times,
+            avgDuration: Math.round(stats.totalDuration / stats.times),
+            bestFix,
+            components: Array.from(stats.components),
+        };
+    })
+        .sort((a, b) => b.times - a.times);
+}
+/**
+ * Rewrite entire history (used when modifying records)
+ */
+function rewriteHistory(records) {
+    const filePath = getSpiralHistoryPath();
+    // Trim to max records
+    const trimmed = records.slice(-MAX_RECORDS);
+    // Write each record as a line
+    const content = trimmed.map((r) => JSON.stringify(r)).join('\n') + '\n';
+    // Use atomic write for safety
+    (0, atomic_1.atomicWriteSync)(filePath, content);
+}
+/**
+ * Generate actionable suggestion based on history
+ */
+function generateSuggestion(pattern, whatWorked, totalTimes) {
+    // Pattern-specific base advice
+    const patternAdvice = {
+        SECRETS_AUTH: 'Write a test that validates your auth/token assumptions',
+        VOLUME_CONFIG: 'Check mount paths and permissions with a minimal test pod',
+        API_MISMATCH: 'Verify API version and schema against the docs',
+        SSL_TLS: 'Test certificate chain and FIPS compliance in isolation',
+        IMAGE_REGISTRY: 'Verify image exists and credentials are valid with docker pull',
+        GITOPS_DRIFT: 'Sync with ArgoCD and check for resource conflicts',
+    };
+    const baseAdvice = patternAdvice[pattern] || 'Take a step back and validate your assumptions';
+    // If we have history of what worked, personalize
+    if (whatWorked.length > 0) {
+        const best = whatWorked[0];
+        const resolutionText = {
+            TEST: 'writing a test',
+            BREAK: 'taking a break',
+            DOCS: 'reading the docs',
+            HELP: 'asking for help',
+            ROLLBACK: 'rolling back',
+            OTHER: 'trying something different',
+        };
+        if (best.times >= 2) {
+            return `Your go-to: ${resolutionText[best.resolution]} (worked ${best.times}x). ${baseAdvice}`;
+        }
+    }
+    // First time or no resolution data
+    if (totalTimes === 1) {
+        return baseAdvice;
+    }
+    return `You've hit this ${totalTimes}x. ${baseAdvice}`;
+}
+/**
+ * Friendly pattern names for display
+ */
+function getPatternDisplayName(pattern) {
+    const names = {
+        SECRETS_AUTH: 'OAuth/Token Issues',
+        VOLUME_CONFIG: 'Volume/Mount Issues',
+        API_MISMATCH: 'API Version/Schema Issues',
+        SSL_TLS: 'SSL/TLS/Certificate Issues',
+        IMAGE_REGISTRY: 'Image/Registry Issues',
+        GITOPS_DRIFT: 'GitOps Sync Issues',
+        OTHER: 'Other Issues',
+    };
+    return names[pattern] || pattern;
+}
+/**
+ * Friendly resolution names for display
+ */
+function getResolutionDisplayName(resolution) {
+    const names = {
+        TEST: 'Wrote a test',
+        BREAK: 'Took a break',
+        DOCS: 'Read the docs',
+        HELP: 'Asked for help',
+        ROLLBACK: 'Rolled back',
+        OTHER: 'Other',
+    };
+    return names[resolution];
+}
+//# sourceMappingURL=spiral-history.js.map

package/dist/storage/spiral-history.js.map

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

package/docs/ARCHITECTURE.md

@@ -77,15 +77,8 @@ src/
 │   ├── xp.ts              # XP calculation, levels
 │   ├── streaks.ts         # Streak tracking
 │   ├── achievements.ts    # Achievement definitions
-│   ├── challenges.ts      # Weekly challenges
-│   ├── leaderboards.ts    # Personal high scores
-│   ├── hall-of-fame.ts    # Personal records
 │   ├── stats.ts           # Weekly stats, sparklines
-│   ├── badges.ts          # Rank badges
-│   ├── share.ts           # Shareable profiles
-│   ├── profile.ts         # Profile persistence
-│   ├── pattern-memory.ts  # Spiral trigger tracking
-│   └── intervention-memory.ts # What breaks spirals
+│   └── profile.ts         # Profile persistence
 │
 └── output/                # Output formatters
     ├── index.ts           # Format router
@@ -345,8 +338,7 @@ const XP_REWARDS = {
 
 ```
 ~/.vibe-check/           # Global (cross-repo)
-├── profile.json         # User profile
-└── leaderboards.json    # Personal high scores
+└── profile.json         # User profile
 
 .vibe-check/             # Per-repo (optional)
 └── profile.json         # Repo-specific profile