@ginkoai/cli 1.0.0

package/dist/utils/ginko-root.js

@@ -0,0 +1,96 @@
+/**
+ * @fileType: utility
+ * @status: current
+ * @updated: 2025-08-28
+ * @tags: [ginko, root, directory, git-style]
+ * @related: [init.ts, capture.ts, status.ts]
+ * @priority: critical
+ * @complexity: low
+ * @dependencies: [fs-extra, path]
+ */
+import fs from 'fs-extra';
+import path from 'path';
+/**
+ * Find the ginko root directory by walking up the directory tree
+ * Similar to how git finds the .git directory
+ *
+ * @param startDir - Directory to start searching from (defaults to cwd)
+ * @returns Path to ginko root directory, or null if not found
+ */
+export async function findGinkoRoot(startDir) {
+    let currentDir = startDir || process.cwd();
+    const root = path.parse(currentDir).root;
+    while (currentDir !== root) {
+        const ginkoPath = path.join(currentDir, '.ginko');
+        if (await fs.pathExists(ginkoPath)) {
+            const stats = await fs.stat(ginkoPath);
+            if (stats.isDirectory()) {
+                return currentDir;
+            }
+        }
+        // Move up one directory
+        const parentDir = path.dirname(currentDir);
+        if (parentDir === currentDir) {
+            // We've reached the root
+            break;
+        }
+        currentDir = parentDir;
+    }
+    // Check the root directory itself
+    const rootGinkoPath = path.join(root, '.ginko');
+    if (await fs.pathExists(rootGinkoPath)) {
+        const stats = await fs.stat(rootGinkoPath);
+        if (stats.isDirectory()) {
+            return root;
+        }
+    }
+    return null;
+}
+/**
+ * Get the ginko root directory or throw an error if not found
+ *
+ * @param startDir - Directory to start searching from
+ * @returns Path to ginko root directory
+ * @throws Error if ginko is not initialized
+ */
+export async function requireGinkoRoot(startDir) {
+    const root = await findGinkoRoot(startDir);
+    if (!root) {
+        throw new Error('Ginko not initialized. Run `ginko init` first.');
+    }
+    return root;
+}
+/**
+ * Check if we're in a ginko-initialized project
+ *
+ * @param startDir - Directory to start searching from
+ * @returns true if in a ginko project, false otherwise
+ */
+export async function isGinkoProject(startDir) {
+    const root = await findGinkoRoot(startDir);
+    return root !== null;
+}
+/**
+ * Get the path to a file within the .ginko directory
+ *
+ * @param relativePath - Path relative to .ginko directory
+ * @param startDir - Directory to start searching from
+ * @returns Full path to the file
+ * @throws Error if ginko is not initialized
+ */
+export async function getGinkoPath(relativePath, startDir) {
+    const root = await requireGinkoRoot(startDir);
+    return path.join(root, '.ginko', relativePath);
+}
+/**
+ * Get the path to the user's session directory
+ *
+ * @param userEmail - User email (will be slugified)
+ * @param startDir - Directory to start searching from
+ * @returns Full path to user session directory
+ */
+export async function getUserSessionPath(userEmail, startDir) {
+    const userSlug = userEmail.replace('@', '-at-').replace(/\./g, '-');
+    return getGinkoPath(path.join('sessions', userSlug), startDir);
+}
+//# sourceMappingURL=ginko-root.js.map

package/dist/utils/ginko-root.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ginko-root.js","sourceRoot":"","sources":["../../src/utils/ginko-root.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,MAAM,UAAU,CAAC;AAC1B,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,QAAiB;IACnD,IAAI,UAAU,GAAG,QAAQ,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IAC3C,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC;IAEzC,OAAO,UAAU,KAAK,IAAI,EAAE,CAAC;QAC3B,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;QAElD,IAAI,MAAM,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YACnC,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YACvC,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;gBACxB,OAAO,UAAU,CAAC;YACpB,CAAC;QACH,CAAC;QAED,wBAAwB;QACxB,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QAC3C,IAAI,SAAS,KAAK,UAAU,EAAE,CAAC;YAC7B,yBAAyB;YACzB,MAAM;QACR,CAAC;QACD,UAAU,GAAG,SAAS,CAAC;IACzB,CAAC;IAED,kCAAkC;IAClC,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAChD,IAAI,MAAM,EAAE,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;QACvC,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAC3C,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;YACxB,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,QAAiB;IACtD,MAAM,IAAI,GAAG,MAAM,aAAa,CAAC,QAAQ,CAAC,CAAC;IAE3C,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;IACpE,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,QAAiB;IACpD,MAAM,IAAI,GAAG,MAAM,aAAa,CAAC,QAAQ,CAAC,CAAC;IAC3C,OAAO,IAAI,KAAK,IAAI,CAAC;AACvB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,YAAoB,EAAE,QAAiB;IACxE,MAAM,IAAI,GAAG,MAAM,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IAC9C,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,YAAY,CAAC,CAAC;AACjD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,SAAiB,EAAE,QAAiB;IAC3E,MAAM,QAAQ,GAAG,SAAS,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACpE,OAAO,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,EAAE,QAAQ,CAAC,CAAC;AACjE,CAAC"}

package/dist/utils/helpers.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @fileType: utility
+ * @status: current
+ * @updated: 2025-08-28
+ * @tags: [cli, utils, helpers, git]
+ * @related: [ginko-root.ts]
+ * @priority: medium
+ * @complexity: low
+ */
+export declare function getGinkoDir(): Promise<string>;
+export declare function getUserEmail(): Promise<string>;
+export declare function formatTimeAgo(date: Date): string;
+export declare function detectWorkMode(gitStatus: any): Promise<string>;
+export declare function getProjectInfo(): Promise<{
+    name: string;
+    type: string;
+    language: string;
+}>;
+//# sourceMappingURL=helpers.d.ts.map

package/dist/utils/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/utils/helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAOH,wBAAsB,WAAW,IAAI,OAAO,CAAC,MAAM,CAAC,CAGnD;AAED,wBAAsB,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC,CAmBpD;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAWhD;AAED,wBAAsB,cAAc,CAAC,SAAS,EAAE,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC,CAkBpE;AAED,wBAAsB,cAAc,IAAI,OAAO,CAAC;IAC9C,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC,CAqCD"}

package/dist/utils/helpers.js

@@ -0,0 +1,107 @@
+/**
+ * @fileType: utility
+ * @status: current
+ * @updated: 2025-08-28
+ * @tags: [cli, utils, helpers, git]
+ * @related: [ginko-root.ts]
+ * @priority: medium
+ * @complexity: low
+ */
+import fs from 'fs-extra';
+import path from 'path';
+import { execSync } from 'child_process';
+import { requireGinkoRoot } from './ginko-root.js';
+export async function getGinkoDir() {
+    const root = await requireGinkoRoot();
+    return path.join(root, '.ginko');
+}
+export async function getUserEmail() {
+    try {
+        // Try git config first
+        const email = execSync('git config user.email', { encoding: 'utf8' }).trim();
+        if (email)
+            return email;
+    }
+    catch (e) {
+        // Git not configured
+    }
+    // Try config file
+    try {
+        const ginkoDir = await getGinkoDir();
+        const config = await fs.readJSON(path.join(ginkoDir, 'config.json'));
+        if (config.user?.email)
+            return config.user.email;
+    }
+    catch (e) {
+        // Config not found or invalid
+    }
+    return 'user@example.com';
+}
+export function formatTimeAgo(date) {
+    const now = new Date();
+    const diff = now.getTime() - date.getTime();
+    const minutes = Math.floor(diff / 60000);
+    const hours = Math.floor(minutes / 60);
+    const days = Math.floor(hours / 24);
+    if (days > 0)
+        return `${days} day${days === 1 ? '' : 's'} ago`;
+    if (hours > 0)
+        return `${hours} hour${hours === 1 ? '' : 's'} ago`;
+    if (minutes > 0)
+        return `${minutes} minute${minutes === 1 ? '' : 's'} ago`;
+    return 'just now';
+}
+export async function detectWorkMode(gitStatus) {
+    const { modified, staged, not_added } = gitStatus;
+    // Detect patterns
+    const hasTests = modified.some((f) => f.includes('test') || f.includes('spec'));
+    const hasMany = modified.length > 5;
+    const hasConfig = modified.some((f) => f.includes('config') || f.includes('package.json') || f.includes('tsconfig'));
+    // Heuristic mode detection
+    if (hasTests)
+        return 'Testing';
+    if (hasConfig)
+        return 'Configuring';
+    if (hasMany)
+        return 'Refactoring';
+    if (staged.length > 0)
+        return 'Implementing';
+    if (not_added.length > modified.length)
+        return 'Exploring';
+    return 'Developing';
+}
+export async function getProjectInfo() {
+    // Use ginko root if available, otherwise current directory
+    let projectRoot = process.cwd();
+    try {
+        projectRoot = await requireGinkoRoot();
+    }
+    catch (e) {
+        // Not in a ginko project, use current directory
+    }
+    // Check for package.json (Node project)
+    if (await fs.pathExists(path.join(projectRoot, 'package.json'))) {
+        const pkg = await fs.readJSON(path.join(projectRoot, 'package.json'));
+        return {
+            name: pkg.name || path.basename(projectRoot),
+            type: 'node',
+            language: 'javascript/typescript'
+        };
+    }
+    // Check for other project types
+    if (await fs.pathExists(path.join(projectRoot, 'Cargo.toml'))) {
+        return { name: path.basename(projectRoot), type: 'rust', language: 'rust' };
+    }
+    if (await fs.pathExists(path.join(projectRoot, 'go.mod'))) {
+        return { name: path.basename(projectRoot), type: 'go', language: 'go' };
+    }
+    if (await fs.pathExists(path.join(projectRoot, 'requirements.txt'))) {
+        return { name: path.basename(projectRoot), type: 'python', language: 'python' };
+    }
+    return {
+        name: path.basename(projectRoot),
+        type: 'unknown',
+        language: 'unknown'
+    };
+}
+//# sourceMappingURL=helpers.js.map

package/dist/utils/helpers.js.map

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

package/dist/utils/progressive-learning.d.ts

@@ -0,0 +1,42 @@
+/**
+ * @fileType: utility
+ * @status: current
+ * @updated: 2025-08-28
+ * @tags: [learning, hints, ux, flow-state]
+ * @related: [helpers.ts, init.ts]
+ * @priority: high
+ * @complexity: medium
+ * @dependencies: [fs-extra, chalk]
+ */
+interface UserProgress {
+    commandsUsed: Record<string, number>;
+    firstSeen: string;
+    lastSeen: string;
+    totalSessions: number;
+    hintsShown: string[];
+    preferences: {
+        showHints: boolean;
+        verbosity: 'minimal' | 'normal' | 'verbose';
+    };
+}
+interface HintContext {
+    command?: string;
+    args?: string[];
+    gitStatus?: any;
+    sessionAge?: number;
+    lastCommand?: string;
+    errorType?: string;
+    fileCount?: number;
+}
+export declare class ProgressiveLearning {
+    private static hints;
+    static getUserProgress(): Promise<UserProgress>;
+    static updateProgress(command: string, args?: string[]): Promise<void>;
+    static getContextualHint(context: HintContext): Promise<string | null>;
+    static showHint(context: HintContext): Promise<void>;
+    static getExperienceLevel(progress: UserProgress): 'beginner' | 'intermediate' | 'advanced';
+    static getSmartSuggestions(gitStatus?: any): Promise<string[]>;
+    static formatSuggestions(suggestions: string[]): string;
+}
+export {};
+//# sourceMappingURL=progressive-learning.d.ts.map

package/dist/utils/progressive-learning.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"progressive-learning.d.ts","sourceRoot":"","sources":["../../src/utils/progressive-learning.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAOH,UAAU,YAAY;IACpB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,WAAW,EAAE;QACX,SAAS,EAAE,OAAO,CAAC;QACnB,SAAS,EAAE,SAAS,GAAG,QAAQ,GAAG,SAAS,CAAC;KAC7C,CAAC;CACH;AAgBD,UAAU,WAAW;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,SAAS,CAAC,EAAE,GAAG,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,MAAM,CAAC,KAAK,CAsFlB;WAEW,eAAe,IAAI,OAAO,CAAC,YAAY,CAAC;WAyBxC,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;WAoB/D,iBAAiB,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;WAuD/D,QAAQ,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAW1D,MAAM,CAAC,kBAAkB,CAAC,QAAQ,EAAE,YAAY,GAAG,UAAU,GAAG,cAAc,GAAG,UAAU;WAa9E,mBAAmB,CAAC,SAAS,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAsCpE,MAAM,CAAC,iBAAiB,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,MAAM;CAMxD"}

package/dist/utils/progressive-learning.js

@@ -0,0 +1,248 @@
+/**
+ * @fileType: utility
+ * @status: current
+ * @updated: 2025-08-28
+ * @tags: [learning, hints, ux, flow-state]
+ * @related: [helpers.ts, init.ts]
+ * @priority: high
+ * @complexity: medium
+ * @dependencies: [fs-extra, chalk]
+ */
+import fs from 'fs-extra';
+import chalk from 'chalk';
+import { getGinkoPath } from './ginko-root.js';
+export class ProgressiveLearning {
+    static hints = [
+        // Beginner hints
+        {
+            id: 'first-handoff',
+            trigger: {
+                type: 'state',
+                condition: (ctx) => ctx.sessionAge !== undefined && ctx.sessionAge > 30,
+            },
+            message: chalk.dim('💡 Tip: Use ') + chalk.cyan('ginko handoff') + chalk.dim(' to save your progress'),
+            priority: 'high',
+            showOnce: true,
+        },
+        {
+            id: 'vibecheck-suggestion',
+            trigger: {
+                type: 'error',
+                condition: (ctx) => ctx.errorType === 'confusion' || ctx.command === 'status',
+            },
+            message: chalk.dim('💡 Feeling stuck? Try ') + chalk.cyan('ginko vibecheck') + chalk.dim(' for a quick recalibration'),
+            priority: 'medium',
+            showOnce: true,
+        },
+        {
+            id: 'capture-learning',
+            trigger: {
+                type: 'command',
+                condition: (ctx) => ctx.command === 'handoff' && Math.random() > 0.7,
+            },
+            message: chalk.dim('💡 Discovered something? Use ') + chalk.cyan('ginko capture') + chalk.dim(' to save learnings'),
+            priority: 'low',
+            showOnce: true,
+        },
+        {
+            id: 'ship-ready',
+            trigger: {
+                type: 'state',
+                condition: (ctx) => ctx.gitStatus && ctx.gitStatus.staged?.length > 3,
+            },
+            message: chalk.dim('💡 Ready to ship? ') + chalk.cyan('ginko ship') + chalk.dim(' creates PR-ready branches'),
+            priority: 'medium',
+            showOnce: true,
+        },
+        {
+            id: 'compact-suggestion',
+            trigger: {
+                type: 'state',
+                condition: (ctx) => ctx.fileCount !== undefined && ctx.fileCount > 20,
+            },
+            message: chalk.dim('💡 Context growing large? Use ') + chalk.cyan('ginko compact') + chalk.dim(' to clean up'),
+            priority: 'low',
+            showOnce: true,
+        },
+        // Advanced hints
+        {
+            id: 'explore-mode',
+            trigger: {
+                type: 'command',
+                condition: (ctx) => ctx.command === 'start' && Math.random() > 0.8,
+            },
+            message: chalk.dim('🚀 Try ') + chalk.cyan('ginko explore') + chalk.dim(' for collaborative problem-solving'),
+            priority: 'low',
+            showOnce: true,
+            dependencies: ['first-handoff'],
+        },
+        {
+            id: 'architecture-mode',
+            trigger: {
+                type: 'command',
+                condition: (ctx) => ctx.command === 'explore',
+            },
+            message: chalk.dim('🏗️  For technical decisions, use ') + chalk.cyan('ginko architecture') + chalk.dim(' to create ADRs'),
+            priority: 'low',
+            showOnce: true,
+            dependencies: ['explore-mode'],
+        },
+        {
+            id: 'plan-sprints',
+            trigger: {
+                type: 'command',
+                condition: (ctx) => ctx.command === 'architecture',
+            },
+            message: chalk.dim('📅 Plan implementation with ') + chalk.cyan('ginko plan') + chalk.dim(' for sprint planning'),
+            priority: 'low',
+            showOnce: true,
+            dependencies: ['architecture-mode'],
+        },
+    ];
+    static async getUserProgress() {
+        try {
+            const progressPath = await getGinkoPath('user-progress.json');
+            if (await fs.pathExists(progressPath)) {
+                return await fs.readJSON(progressPath);
+            }
+        }
+        catch (error) {
+            // Fall through to create new progress
+        }
+        // Create new progress
+        return {
+            commandsUsed: {},
+            firstSeen: new Date().toISOString(),
+            lastSeen: new Date().toISOString(),
+            totalSessions: 0,
+            hintsShown: [],
+            preferences: {
+                showHints: true,
+                verbosity: 'normal',
+            },
+        };
+    }
+    static async updateProgress(command, args) {
+        try {
+            const progress = await this.getUserProgress();
+            // Update command usage
+            progress.commandsUsed[command] = (progress.commandsUsed[command] || 0) + 1;
+            progress.lastSeen = new Date().toISOString();
+            if (command === 'start') {
+                progress.totalSessions++;
+            }
+            // Save progress
+            const progressPath = await getGinkoPath('user-progress.json');
+            await fs.writeJSON(progressPath, progress, { spaces: 2 });
+        }
+        catch (error) {
+            // Silently fail - don't interrupt user flow
+        }
+    }
+    static async getContextualHint(context) {
+        try {
+            const progress = await this.getUserProgress();
+            if (!progress.preferences.showHints) {
+                return null;
+            }
+            // Find applicable hints
+            const applicableHints = this.hints.filter(hint => {
+                // Check if already shown (for showOnce hints)
+                if (hint.showOnce && progress.hintsShown.includes(hint.id)) {
+                    return false;
+                }
+                // Check dependencies
+                if (hint.dependencies) {
+                    const allDepsShown = hint.dependencies.every(dep => progress.hintsShown.includes(dep));
+                    if (!allDepsShown) {
+                        return false;
+                    }
+                }
+                // Check trigger condition
+                return hint.trigger.condition(context);
+            });
+            if (applicableHints.length === 0) {
+                return null;
+            }
+            // Sort by priority and pick the highest
+            const sortedHints = applicableHints.sort((a, b) => {
+                const priorityOrder = { high: 3, medium: 2, low: 1 };
+                return priorityOrder[b.priority] - priorityOrder[a.priority];
+            });
+            const selectedHint = sortedHints[0];
+            // Mark as shown
+            if (selectedHint.showOnce) {
+                progress.hintsShown.push(selectedHint.id);
+                const progressPath = await getGinkoPath('user-progress.json');
+                await fs.writeJSON(progressPath, progress, { spaces: 2 });
+            }
+            return selectedHint.message;
+        }
+        catch (error) {
+            // Silently fail - don't interrupt user flow
+            return null;
+        }
+    }
+    static async showHint(context) {
+        const hint = await this.getContextualHint(context);
+        if (hint) {
+            // Add subtle delay to preserve flow
+            setTimeout(() => {
+                console.log('\n' + hint);
+            }, 100);
+        }
+    }
+    static getExperienceLevel(progress) {
+        const totalCommands = Object.values(progress.commandsUsed).reduce((a, b) => a + b, 0);
+        const uniqueCommands = Object.keys(progress.commandsUsed).length;
+        if (totalCommands < 10 || uniqueCommands < 3) {
+            return 'beginner';
+        }
+        else if (totalCommands < 50 || uniqueCommands < 7) {
+            return 'intermediate';
+        }
+        else {
+            return 'advanced';
+        }
+    }
+    static async getSmartSuggestions(gitStatus) {
+        const suggestions = [];
+        const progress = await this.getUserProgress();
+        const level = this.getExperienceLevel(progress);
+        // Beginner suggestions
+        if (level === 'beginner') {
+            if (!progress.commandsUsed['handoff']) {
+                suggestions.push('Try `ginko handoff` to save your progress');
+            }
+            if (!progress.commandsUsed['vibecheck']) {
+                suggestions.push('Use `ginko vibecheck` when you need to recalibrate');
+            }
+        }
+        // Intermediate suggestions
+        if (level === 'intermediate') {
+            if (!progress.commandsUsed['capture']) {
+                suggestions.push('Capture learnings with `ginko capture`');
+            }
+            if (!progress.commandsUsed['explore']) {
+                suggestions.push('Explore problems collaboratively with `ginko explore`');
+            }
+        }
+        // Context-based suggestions
+        if (gitStatus) {
+            if (gitStatus.modified?.length > 5) {
+                suggestions.push('Consider creating a handoff for this work');
+            }
+            if (gitStatus.staged?.length > 0) {
+                suggestions.push('Ready to ship? Use `ginko ship` for PR creation');
+            }
+        }
+        return suggestions.slice(0, 2); // Limit to 2 suggestions
+    }
+    static formatSuggestions(suggestions) {
+        if (suggestions.length === 0)
+            return '';
+        return '\n' + chalk.dim('💭 Suggestions:\n') +
+            suggestions.map(s => chalk.dim('  • ') + s).join('\n');
+    }
+}
+//# sourceMappingURL=progressive-learning.js.map

package/dist/utils/progressive-learning.js.map

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

package/dist/utils/session-collector.d.ts

@@ -0,0 +1,81 @@
+/**
+ * @fileType: utility
+ * @status: current
+ * @updated: 2025-09-09
+ * @tags: [session, data-collection, git, testing]
+ * @related: [../types/session.ts, ../commands/handoff-ai.ts]
+ * @priority: critical
+ * @complexity: medium
+ * @dependencies: [simple-git, fs-extra]
+ */
+import { SessionData } from '../types/session.js';
+/**
+ * Collects comprehensive session data for insight extraction
+ */
+export declare class SessionCollector {
+    private git;
+    private sessionStart;
+    private terminalBuffer;
+    constructor();
+    /**
+     * Collect all session data
+     */
+    collectSessionData(userEmail: string, previousHandoff?: string): Promise<SessionData>;
+    /**
+     * Collect git-related data
+     */
+    private collectGitData;
+    /**
+     * Get detailed information about changed files
+     */
+    private getDetailedFileChanges;
+    /**
+     * Parse git commits to our format
+     */
+    private parseGitCommits;
+    /**
+     * Detect work mode from git activity
+     */
+    private detectWorkMode;
+    /**
+     * Collect test results from common test runners
+     */
+    private collectTestResults;
+    /**
+     * Parse test results from file
+     */
+    private parseTestResults;
+    /**
+     * Parse test output from terminal buffer
+     */
+    private parseTerminalTestOutput;
+    /**
+     * Collect error logs from session
+     */
+    private collectErrorLogs;
+    /**
+     * Collect build output
+     */
+    private collectBuildOutput;
+    /**
+     * Parse diff stats from git output
+     */
+    private parseDiffStats;
+    /**
+     * Detect programming language from file extension
+     */
+    private detectLanguage;
+    /**
+     * Extract file path from error context
+     */
+    private extractFileFromContext;
+    /**
+     * Extract line number from error context
+     */
+    private extractLineNumberFromContext;
+    /**
+     * Add terminal output to buffer (for real-time capture)
+     */
+    addTerminalOutput(output: string): void;
+}
+//# sourceMappingURL=session-collector.d.ts.map

package/dist/utils/session-collector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-collector.d.ts","sourceRoot":"","sources":["../../src/utils/session-collector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAMH,OAAO,EACL,WAAW,EAOZ,MAAM,qBAAqB,CAAC;AAE7B;;GAEG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,GAAG,CAAY;IACvB,OAAO,CAAC,YAAY,CAAO;IAC3B,OAAO,CAAC,cAAc,CAAW;;IAQjC;;OAEG;IACG,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,eAAe,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAmC3F;;OAEG;YACW,cAAc;IA0B5B;;OAEG;YACW,sBAAsB;IAsCpC;;OAEG;IACH,OAAO,CAAC,eAAe;IAYvB;;OAEG;IACH,OAAO,CAAC,cAAc;IAkCtB;;OAEG;YACW,kBAAkB;IAiChC;;OAEG;YACW,gBAAgB;IAyB9B;;OAEG;IACH,OAAO,CAAC,uBAAuB;IA0B/B;;OAEG;YACW,gBAAgB;IAiC9B;;OAEG;YACW,kBAAkB;IA4BhC;;OAEG;IACH,OAAO,CAAC,cAAc;IAWtB;;OAEG;IACH,OAAO,CAAC,cAAc;IA+BtB;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAe9B;;OAEG;IACH,OAAO,CAAC,4BAA4B;IAcpC;;OAEG;IACI,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;CAO/C"}