@ginkoai/cli 2.1.0 → 2.1.2

package/dist/lib/planning-menu.js

@@ -0,0 +1,342 @@
+/**
+ * @fileType: utility
+ * @status: current
+ * @updated: 2026-01-26
+ * @tags: [planning, menu, coaching, structure-detection, epic-016-s04]
+ * @related: [start-reflection.ts, user-sprint.ts, event-logger.ts]
+ * @priority: high
+ * @complexity: medium
+ * @dependencies: [prompts, chalk, event-logger]
+ */
+/**
+ * Guided Planning Menu (EPIC-016 Sprint 4 t02)
+ *
+ * Shows a menu when `ginko start` detects no structured work.
+ * Guides users toward Epic→Sprint→Task structure while allowing
+ * ad-hoc work when appropriate.
+ *
+ * Menu Options:
+ * [a] New Epic - Large initiative with multiple sprints
+ * [b] New Feature Sprint - Focused work with clear goals
+ * [c] Quick fix / Bug fix - Single task, minimal overhead
+ * [d] Something else - Explore, research, or work ad-hoc
+ */
+import prompts from 'prompts';
+import chalk from 'chalk';
+import { logEvent, logPlanningMenuEvent } from './event-logger.js';
+// EPIC-016 Sprint 4: Adoption-based quieting (t05)
+import { getAdoptionScore, recordAdoptionSignal, getPlanningMenuConfig, checkAdhocStreak } from './adoption-score.js';
+// EPIC-016 Sprint 5: Adaptive coaching based on insight scores (t01)
+import { getCoachingContext, PROMPT_VARIANTS, selectPrompt, getTargetedCoachingSuggestions, } from './coaching-level.js';
+import { getGraphId } from '../commands/graph/config.js';
+// =============================================================================
+// Constants
+// =============================================================================
+const PLANNING_MENU_CHOICES = [
+    {
+        title: 'New Epic',
+        description: 'Large initiative with multiple sprints (launches ginko epic)',
+        value: 'epic',
+    },
+    {
+        title: 'New Feature Sprint',
+        description: 'Focused work with clear goals (guides through sprint creation)',
+        value: 'sprint',
+    },
+    {
+        title: 'Quick fix / Bug fix',
+        description: 'Single task, minimal overhead (creates 1-task sprint)',
+        value: 'quick-fix',
+    },
+    {
+        title: 'Something else',
+        description: 'Explore, research, or work ad-hoc (tracked for coaching)',
+        value: 'adhoc',
+    },
+];
+// =============================================================================
+// Menu Display
+// =============================================================================
+/**
+ * Display the guided planning menu and get user selection
+ *
+ * Called when ginko start detects no structured work.
+ * Logs selection for coaching insights analysis (t05).
+ * Uses adoption-based quieting to adjust verbosity.
+ *
+ * @param status - Work structure status from checkWorkStructure()
+ * @returns Menu selection result
+ */
+export async function showPlanningMenu(status) {
+    // EPIC-016 Sprint 4 t05: Get quieting configuration based on adoption level
+    const menuConfig = await getPlanningMenuConfig();
+    const adoptionScore = await getAdoptionScore();
+    // EPIC-016 Sprint 5 t01: Get coaching context based on insight scores
+    const graphId = await getGraphId().catch(() => null);
+    const coachingContext = await getCoachingContext(graphId || undefined);
+    const coachingLevel = coachingContext.level;
+    console.log('');
+    // Check for ad-hoc streak (3+ consecutive sessions resets score)
+    if (status?.consecutiveAdhocSessions) {
+        await checkAdhocStreak(status.consecutiveAdhocSessions);
+    }
+    // EPIC-016 Sprint 5 t03: Show targeted coaching for low metrics
+    if (coachingLevel === 'supportive') {
+        const suggestions = getTargetedCoachingSuggestions(coachingContext);
+        if (suggestions.length > 0) {
+            console.log(chalk.cyan('💡 Coaching tip:'));
+            console.log(chalk.dim(`   ${suggestions[0]}`));
+            console.log('');
+        }
+    }
+    // Show context-appropriate header based on coaching level
+    if (menuConfig.showCelebration && adoptionScore.score >= 20) {
+        console.log(chalk.green('🌳 Great job staying organized!'));
+    }
+    if (status?.reason === 'all_tasks_complete') {
+        // Use coaching-level variant for sprint complete message
+        const message = selectPrompt(PROMPT_VARIANTS.sprintComplete, coachingLevel);
+        console.log(message);
+    }
+    else if (menuConfig.showCoachingTip && status?.consecutiveAdhocSessions && status.consecutiveAdhocSessions > 1) {
+        console.log(chalk.yellow(`💡 You've had ${status.consecutiveAdhocSessions} sessions without planned work.`));
+        console.log(chalk.white('Would you like to plan your work?'));
+    }
+    else {
+        // Use coaching-level variant for no structure message
+        const message = selectPrompt(PROMPT_VARIANTS.noStructure, coachingLevel);
+        console.log(message);
+    }
+    console.log('');
+    // Build menu choices based on quieting level
+    const choices = PLANNING_MENU_CHOICES.map((c, i) => ({
+        title: `${chalk.cyan(`[${String.fromCharCode(97 + i)}]`)} ${c.title}`,
+        description: menuConfig.showFullDescription ? chalk.dim(c.description) : undefined,
+        value: c.value,
+    }));
+    const response = await prompts({
+        type: 'select',
+        name: 'choice',
+        message: 'Select an option',
+        choices,
+        initial: 0,
+    });
+    // Handle cancellation (Ctrl+C or ESC)
+    if (response.choice === undefined) {
+        return { choice: null, cancelled: true };
+    }
+    // Log selection and record adoption signal (non-blocking)
+    // EPIC-016 Sprint 5 t05: Pass coaching context for feedback loop
+    logPlanningChoice(response.choice, coachingLevel, coachingContext.overallScore).catch(() => {
+        // Ignore logging errors
+    });
+    return { choice: response.choice, cancelled: false };
+}
+/**
+ * Log the planning menu selection for coaching analysis (t05)
+ *
+ * Enables the insights system to:
+ * - Track pattern adoption over time
+ * - Identify users who frequently choose ad-hoc
+ * - Measure effectiveness of planning prompts
+ *
+ * Also records adoption signals for quieting behavior.
+ */
+async function logPlanningChoice(choice, coachingLevel, overallScore) {
+    const descriptions = {
+        'epic': 'Started new epic creation from planning menu',
+        'sprint': 'Started new sprint creation from planning menu',
+        'quick-fix': 'Started quick-fix flow from planning menu',
+        'adhoc': 'Chose ad-hoc work from planning menu',
+    };
+    // Map menu choices to adoption signals
+    const adoptionSignals = {
+        'epic': 'created_epic',
+        'sprint': 'created_sprint',
+        'quick-fix': 'used_quick_fix',
+        'adhoc': 'chose_adhoc',
+    };
+    try {
+        // Log event for insights
+        await logEvent({
+            category: 'decision',
+            description: descriptions[choice],
+            tags: ['planning-menu', `choice-${choice}`, 'coaching-data'],
+            impact: choice === 'adhoc' ? 'low' : 'medium',
+        });
+        // EPIC-016 Sprint 5 t05: Log coaching interaction for feedback loop
+        if (coachingLevel) {
+            await logPlanningMenuEvent(choice, coachingLevel, overallScore);
+        }
+        // Record adoption signal for quieting behavior (t05)
+        const signal = adoptionSignals[choice];
+        if (signal) {
+            await recordAdoptionSignal(signal);
+        }
+    }
+    catch {
+        // Non-critical - don't fail startup if logging fails
+    }
+}
+// =============================================================================
+// Route Handlers
+// =============================================================================
+/**
+ * Route the planning menu choice to appropriate handler
+ *
+ * Routes:
+ * - epic → launches ginko epic command
+ * - sprint → launches sprint creation flow (t03)
+ * - quick-fix → launches quick-fix flow (t04)
+ * - adhoc → marks session as ad-hoc, continues to normal start
+ *
+ * @param choice - User's menu selection
+ * @returns Route result with success status and metadata
+ */
+export async function routePlanningChoice(choice) {
+    switch (choice) {
+        case 'epic':
+            return routeToEpicCreation();
+        case 'sprint':
+            return routeToSprintCreation();
+        case 'quick-fix':
+            return routeToQuickFix();
+        case 'adhoc':
+            return routeToAdhocWork();
+        default:
+            return { success: false, message: 'Unknown choice', shouldContinueStart: true };
+    }
+}
+/**
+ * Route to epic creation (ginko epic)
+ */
+async function routeToEpicCreation() {
+    console.log('');
+    console.log(chalk.cyan('🚀 Launching epic creation...'));
+    console.log('');
+    try {
+        // Import and execute epic command
+        const { epicCommand } = await import('../commands/epic.js');
+        await epicCommand({});
+        return {
+            success: true,
+            message: 'Epic creation flow completed',
+            shouldContinueStart: false // Epic command handles its own output
+        };
+    }
+    catch (error) {
+        console.error(chalk.red('Failed to launch epic creation:'), error);
+        return {
+            success: false,
+            message: 'Epic creation failed',
+            shouldContinueStart: true
+        };
+    }
+}
+/**
+ * Route to sprint creation flow (t03)
+ * Full implementation in packages/cli/src/commands/sprint/create.ts
+ */
+async function routeToSprintCreation() {
+    console.log('');
+    console.log(chalk.cyan('📋 Starting sprint creation...'));
+    console.log('');
+    try {
+        // Import and execute sprint create command
+        const { createSprintCommand } = await import('../commands/sprint/create.js');
+        const result = await createSprintCommand({ adhoc: true });
+        return {
+            success: result.success,
+            sprintId: result.sprintId,
+            message: result.message || 'Sprint creation completed',
+            shouldContinueStart: !result.success // Continue if creation failed
+        };
+    }
+    catch (error) {
+        // Fallback: Sprint creation not yet implemented (t03)
+        console.log(chalk.dim('Sprint creation flow launching...'));
+        console.log('');
+        console.log(chalk.white('To create a sprint, describe what you want to build:'));
+        console.log(chalk.dim('  The AI will break this down into tasks and create a sprint.'));
+        console.log('');
+        return {
+            success: true,
+            message: 'Sprint creation guidance displayed',
+            shouldContinueStart: true
+        };
+    }
+}
+/**
+ * Route to quick-fix flow (t04)
+ * Creates a single-task sprint with minimal ceremony
+ */
+async function routeToQuickFix() {
+    console.log('');
+    console.log(chalk.cyan('⚡ Quick fix mode'));
+    console.log('');
+    // Get quick description
+    const response = await prompts({
+        type: 'text',
+        name: 'description',
+        message: 'Describe the fix in one line:',
+        validate: (value) => value.trim().length > 5 ? true : 'Please provide a brief description',
+    });
+    if (!response.description) {
+        return { success: false, message: 'Quick fix cancelled', shouldContinueStart: false };
+    }
+    const description = response.description.trim();
+    try {
+        // Try to use the quick-fix implementation (t04)
+        const { createQuickFixTask } = await import('../commands/sprint/quick-fix.js');
+        const result = await createQuickFixTask(description);
+        console.log('');
+        console.log(chalk.green(`✓ Created: ${result.taskId} - ${description}`));
+        console.log(chalk.dim('  Ready to work. Run `ginko task complete` when done.'));
+        return {
+            success: true,
+            taskId: result.taskId,
+            sprintId: result.sprintId,
+            message: 'Quick fix task created',
+            shouldContinueStart: true
+        };
+    }
+    catch {
+        // Fallback: Log as an event for now
+        console.log('');
+        console.log(chalk.green(`✓ Ready to work on: ${description}`));
+        console.log(chalk.dim('  Tip: Run `ginko log "completed: ${description}"` when done.'));
+        // Log the quick fix start as an event
+        await logEvent({
+            category: 'feature',
+            description: `Quick fix started: ${description}`,
+            tags: ['quick-fix', 'unstructured'],
+            impact: 'medium',
+        }).catch(() => { });
+        return {
+            success: true,
+            message: 'Quick fix tracked (full sprint creation in t04)',
+            shouldContinueStart: true
+        };
+    }
+}
+/**
+ * Route to ad-hoc work mode
+ * User explicitly chooses unstructured work - track for coaching
+ */
+async function routeToAdhocWork() {
+    console.log('');
+    console.log(chalk.dim('Working ad-hoc. Use `ginko log` to track your progress.'));
+    return {
+        success: true,
+        message: 'Ad-hoc work mode - session will continue normally',
+        shouldContinueStart: true
+    };
+}
+// =============================================================================
+// Exports for Testing
+// =============================================================================
+export const __testing = {
+    PLANNING_MENU_CHOICES,
+    logPlanningChoice,
+};
+//# sourceMappingURL=planning-menu.js.map

package/dist/lib/planning-menu.js.map

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

package/dist/lib/targeted-coaching.d.ts

@@ -0,0 +1,71 @@
+/**
+ * @fileType: utility
+ * @status: current
+ * @updated: 2026-01-26
+ * @tags: [coaching, insights, targeted, adaptive, epic-016-s05]
+ * @related: [coaching-level.ts, start-reflection.ts, handoff.ts]
+ * @priority: medium
+ * @complexity: medium
+ * @dependencies: [fs-extra, path]
+ */
+import { CoachingContext } from './coaching-level.js';
+export type MetricType = 'sessionEfficiency' | 'patternAdoption' | 'collaborationQuality' | 'antiPatterns';
+export type CoachingContext_Type = 'start' | 'handoff' | 'task_complete' | 'planning';
+export interface CoachingTip {
+    id: string;
+    metric: MetricType;
+    context: CoachingContext_Type[];
+    message: string;
+    action?: string;
+    priority: number;
+}
+export interface ShownTipsRecord {
+    sessionId: string;
+    shownTipIds: string[];
+    lastUpdated: string;
+}
+/**
+ * All available coaching tips organized by metric
+ */
+export declare const COACHING_TIPS: CoachingTip[];
+declare function loadShownTips(): Promise<ShownTipsRecord>;
+declare function saveShownTips(record: ShownTipsRecord): Promise<void>;
+declare function markTipAsShown(tipId: string): Promise<void>;
+declare function isTipShown(tipId: string): Promise<boolean>;
+/**
+ * Get applicable tips for a given context and coaching context
+ *
+ * @param coachingCtx - Coaching context with metric scores
+ * @param context - Current context (start, handoff, etc.)
+ * @param limit - Maximum number of tips to return
+ * @returns Array of applicable tips, prioritized
+ */
+export declare function getApplicableTips(coachingCtx: CoachingContext, context: CoachingContext_Type, limit?: number): Promise<CoachingTip[]>;
+declare function getMetricValue(ctx: CoachingContext, metric: MetricType): number;
+/**
+ * Display a coaching tip to the console
+ */
+export declare function displayTip(tip: CoachingTip): void;
+/**
+ * Show targeted coaching tips for the current context
+ *
+ * @param coachingCtx - Coaching context with metric scores
+ * @param context - Current context
+ * @returns Number of tips shown
+ */
+export declare function showTargetedCoaching(coachingCtx: CoachingContext, context: CoachingContext_Type): Promise<number>;
+/**
+ * Get coaching tip for a specific metric (for inline use)
+ */
+export declare function getTipForMetric(coachingCtx: CoachingContext, metric: MetricType, context: CoachingContext_Type): Promise<string | null>;
+export declare const METRIC_DISPLAY_NAMES: Record<MetricType, string>;
+export declare const __testing: {
+    LOW_THRESHOLD: number;
+    loadShownTips: typeof loadShownTips;
+    saveShownTips: typeof saveShownTips;
+    markTipAsShown: typeof markTipAsShown;
+    isTipShown: typeof isTipShown;
+    getMetricValue: typeof getMetricValue;
+};
+export {};
+//# sourceMappingURL=targeted-coaching.d.ts.map

package/dist/lib/targeted-coaching.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"targeted-coaching.d.ts","sourceRoot":"","sources":["../../src/lib/targeted-coaching.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAyBH,OAAO,EAAE,eAAe,EAAe,MAAM,qBAAqB,CAAC;AAOnE,MAAM,MAAM,UAAU,GAAG,mBAAmB,GAAG,iBAAiB,GAAG,sBAAsB,GAAG,cAAc,CAAC;AAC3G,MAAM,MAAM,oBAAoB,GAAG,OAAO,GAAG,SAAS,GAAG,eAAe,GAAG,UAAU,CAAC;AAEtF,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,UAAU,CAAC;IACnB,OAAO,EAAE,oBAAoB,EAAE,CAAC;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;CACrB;AASD;;GAEG;AACH,eAAO,MAAM,aAAa,EAAE,WAAW,EAmGtC,CAAC;AAaF,iBAAe,aAAa,IAAI,OAAO,CAAC,eAAe,CAAC,CA0BvD;AAED,iBAAe,aAAa,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAKnE;AAMD,iBAAe,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAM1D;AAED,iBAAe,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAGzD;AAMD;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CACrC,WAAW,EAAE,eAAe,EAC5B,OAAO,EAAE,oBAAoB,EAC7B,KAAK,GAAE,MAAU,GAChB,OAAO,CAAC,WAAW,EAAE,CAAC,CAiCxB;AAED,iBAAS,cAAc,CAAC,GAAG,EAAE,eAAe,EAAE,MAAM,EAAE,UAAU,GAAG,MAAM,CAWxE;AAMD;;GAEG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI,CAQjD;AAED;;;;;;GAMG;AACH,wBAAsB,oBAAoB,CACxC,WAAW,EAAE,eAAe,EAC5B,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,MAAM,CAAC,CAcjB;AAED;;GAEG;AACH,wBAAsB,eAAe,CACnC,WAAW,EAAE,eAAe,EAC5B,MAAM,EAAE,UAAU,EAClB,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAIxB;AAmBD,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,UAAU,EAAE,MAAM,CAK3D,CAAC;AAMF,eAAO,MAAM,SAAS;;;;;;;CAOrB,CAAC"}