@ginkoai/cli 1.4.13 → 1.6.1

package/dist/lib/event-task-linker.d.ts

@@ -0,0 +1,81 @@
+/**
+ * @fileType: utility
+ * @status: current
+ * @updated: 2025-11-21
+ * @tags: [event-linking, task-detection, graph-relationships, epic-001]
+ * @related: [event-logger.ts, sprint-parser.ts, event-queue.ts]
+ * @priority: high
+ * @complexity: low
+ * @dependencies: []
+ */
+/**
+ * Event-Task Linker (EPIC-001 TASK-4)
+ *
+ * Extracts task mentions (TASK-XXX patterns) from event descriptions
+ * to enable hot/cold task detection via RECENT_ACTIVITY relationships.
+ *
+ * Usage in graph sync:
+ * 1. Extract task IDs from event description
+ * 2. Create (Task)<-[:RECENT_ACTIVITY]-(Event) relationships
+ * 3. Query recent activity to determine task "hotness"
+ *
+ * Enables momentum awareness:
+ * - Hot tasks: Many recent events (actively being worked on)
+ * - Cold tasks: No recent events (stale, needs attention)
+ * - Priority surfacing: Show hot tasks first in sprint views
+ */
+/**
+ * Extract task IDs from text
+ *
+ * Matches patterns like:
+ * - "TASK-1"
+ * - "TASK-123"
+ * - "task-5" (case insensitive)
+ * - "Completed TASK-4, started TASK-5"
+ *
+ * @param text - Event description or any text content
+ * @returns Array of unique task IDs (normalized to uppercase)
+ *
+ * @example
+ * extractTaskMentions("Completed TASK-4, started TASK-5")
+ * // Returns: ["TASK-4", "TASK-5"]
+ */
+export declare function extractTaskMentions(text: string): string[];
+/**
+ * Check if text mentions any tasks
+ *
+ * @param text - Event description or any text content
+ * @returns True if text contains at least one task mention
+ */
+export declare function hasTasksMentions(text: string): boolean;
+/**
+ * Calculate task hotness score based on recent activity
+ *
+ * Hotness formula:
+ * - Events in last 4h: Weight 3x
+ * - Events in last 24h: Weight 2x
+ * - Events in last 7d: Weight 1x
+ *
+ * @param events - Array of event timestamps (ISO format)
+ * @param now - Current timestamp (for testing)
+ * @returns Hotness score (0-100)
+ *
+ * @example
+ * calculateHotness([
+ *   "2025-11-21T10:00:00Z", // 2h ago
+ *   "2025-11-21T08:00:00Z", // 4h ago
+ *   "2025-11-20T10:00:00Z"  // 1d ago
+ * ])
+ * // Returns: ~85 (high hotness)
+ */
+export declare function calculateHotness(events: Array<{
+    timestamp: string;
+}>, now?: Date): number;
+/**
+ * Classify hotness level for UI display
+ *
+ * @param hotness - Hotness score (0-100)
+ * @returns Level classification
+ */
+export declare function getHotnessLevel(hotness: number): 'cold' | 'warm' | 'hot' | 'blazing';
+//# sourceMappingURL=event-task-linker.d.ts.map

package/dist/lib/event-task-linker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-task-linker.d.ts","sourceRoot":"","sources":["../../src/lib/event-task-linker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;;;;;;;;;;;;;;GAeG;AAEH;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAiB1D;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEtD;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,KAAK,CAAC;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC,EACpC,GAAG,GAAE,IAAiB,GACrB,MAAM,CAiCR;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,GAAG,SAAS,CAKpF"}

package/dist/lib/event-task-linker.js

@@ -0,0 +1,132 @@
+/**
+ * @fileType: utility
+ * @status: current
+ * @updated: 2025-11-21
+ * @tags: [event-linking, task-detection, graph-relationships, epic-001]
+ * @related: [event-logger.ts, sprint-parser.ts, event-queue.ts]
+ * @priority: high
+ * @complexity: low
+ * @dependencies: []
+ */
+/**
+ * Event-Task Linker (EPIC-001 TASK-4)
+ *
+ * Extracts task mentions (TASK-XXX patterns) from event descriptions
+ * to enable hot/cold task detection via RECENT_ACTIVITY relationships.
+ *
+ * Usage in graph sync:
+ * 1. Extract task IDs from event description
+ * 2. Create (Task)<-[:RECENT_ACTIVITY]-(Event) relationships
+ * 3. Query recent activity to determine task "hotness"
+ *
+ * Enables momentum awareness:
+ * - Hot tasks: Many recent events (actively being worked on)
+ * - Cold tasks: No recent events (stale, needs attention)
+ * - Priority surfacing: Show hot tasks first in sprint views
+ */
+/**
+ * Extract task IDs from text
+ *
+ * Matches patterns like:
+ * - "TASK-1"
+ * - "TASK-123"
+ * - "task-5" (case insensitive)
+ * - "Completed TASK-4, started TASK-5"
+ *
+ * @param text - Event description or any text content
+ * @returns Array of unique task IDs (normalized to uppercase)
+ *
+ * @example
+ * extractTaskMentions("Completed TASK-4, started TASK-5")
+ * // Returns: ["TASK-4", "TASK-5"]
+ */
+export function extractTaskMentions(text) {
+    if (!text || typeof text !== 'string') {
+        return [];
+    }
+    // Match TASK-XXX pattern (case insensitive)
+    const taskPattern = /TASK-(\d+)/gi;
+    const matches = text.matchAll(taskPattern);
+    // Extract unique task IDs, normalize to uppercase
+    const taskIds = new Set();
+    for (const match of matches) {
+        const taskId = `TASK-${match[1]}`;
+        taskIds.add(taskId);
+    }
+    return Array.from(taskIds);
+}
+/**
+ * Check if text mentions any tasks
+ *
+ * @param text - Event description or any text content
+ * @returns True if text contains at least one task mention
+ */
+export function hasTasksMentions(text) {
+    return extractTaskMentions(text).length > 0;
+}
+/**
+ * Calculate task hotness score based on recent activity
+ *
+ * Hotness formula:
+ * - Events in last 4h: Weight 3x
+ * - Events in last 24h: Weight 2x
+ * - Events in last 7d: Weight 1x
+ *
+ * @param events - Array of event timestamps (ISO format)
+ * @param now - Current timestamp (for testing)
+ * @returns Hotness score (0-100)
+ *
+ * @example
+ * calculateHotness([
+ *   "2025-11-21T10:00:00Z", // 2h ago
+ *   "2025-11-21T08:00:00Z", // 4h ago
+ *   "2025-11-20T10:00:00Z"  // 1d ago
+ * ])
+ * // Returns: ~85 (high hotness)
+ */
+export function calculateHotness(events, now = new Date()) {
+    if (!events || events.length === 0) {
+        return 0;
+    }
+    const nowMs = now.getTime();
+    const hour4Ms = 4 * 60 * 60 * 1000;
+    const hour24Ms = 24 * 60 * 60 * 1000;
+    const day7Ms = 7 * 24 * 60 * 60 * 1000;
+    let score = 0;
+    for (const event of events) {
+        const eventTime = new Date(event.timestamp).getTime();
+        const ageMs = nowMs - eventTime;
+        if (ageMs < 0) {
+            // Future event (clock skew), ignore
+            continue;
+        }
+        if (ageMs <= hour4Ms) {
+            score += 30; // Very recent: 3x weight
+        }
+        else if (ageMs <= hour24Ms) {
+            score += 20; // Recent: 2x weight
+        }
+        else if (ageMs <= day7Ms) {
+            score += 10; // This week: 1x weight
+        }
+        // Events older than 7 days don't contribute
+    }
+    // Cap at 100
+    return Math.min(score, 100);
+}
+/**
+ * Classify hotness level for UI display
+ *
+ * @param hotness - Hotness score (0-100)
+ * @returns Level classification
+ */
+export function getHotnessLevel(hotness) {
+    if (hotness === 0)
+        return 'cold';
+    if (hotness < 30)
+        return 'warm';
+    if (hotness < 70)
+        return 'hot';
+    return 'blazing';
+}
+//# sourceMappingURL=event-task-linker.js.map

package/dist/lib/event-task-linker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-task-linker.js","sourceRoot":"","sources":["../../src/lib/event-task-linker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;;;;;;;;;;;;;;GAeG;AAEH;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAY;IAC9C,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QACtC,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,4CAA4C;IAC5C,MAAM,WAAW,GAAG,cAAc,CAAC;IACnC,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;IAE3C,kDAAkD;IAClD,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAClC,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,MAAM,GAAG,QAAQ,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;QAClC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACtB,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AAC7B,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,OAAO,mBAAmB,CAAC,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;AAC9C,CAAC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,gBAAgB,CAC9B,MAAoC,EACpC,MAAY,IAAI,IAAI,EAAE;IAEtB,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACnC,OAAO,CAAC,CAAC;IACX,CAAC;IAED,MAAM,KAAK,GAAG,GAAG,CAAC,OAAO,EAAE,CAAC;IAC5B,MAAM,OAAO,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;IACnC,MAAM,QAAQ,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;IACrC,MAAM,MAAM,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;IAEvC,IAAI,KAAK,GAAG,CAAC,CAAC;IAEd,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,CAAC;QACtD,MAAM,KAAK,GAAG,KAAK,GAAG,SAAS,CAAC;QAEhC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;YACd,oCAAoC;YACpC,SAAS;QACX,CAAC;QAED,IAAI,KAAK,IAAI,OAAO,EAAE,CAAC;YACrB,KAAK,IAAI,EAAE,CAAC,CAAC,yBAAyB;QACxC,CAAC;aAAM,IAAI,KAAK,IAAI,QAAQ,EAAE,CAAC;YAC7B,KAAK,IAAI,EAAE,CAAC,CAAC,oBAAoB;QACnC,CAAC;aAAM,IAAI,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,KAAK,IAAI,EAAE,CAAC,CAAC,uBAAuB;QACtC,CAAC;QACD,4CAA4C;IAC9C,CAAC;IAED,aAAa;IACb,OAAO,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;AAC9B,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,OAAe;IAC7C,IAAI,OAAO,KAAK,CAAC;QAAE,OAAO,MAAM,CAAC;IACjC,IAAI,OAAO,GAAG,EAAE;QAAE,OAAO,MAAM,CAAC;IAChC,IAAI,OAAO,GAAG,EAAE;QAAE,OAAO,KAAK,CAAC;IAC/B,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/lib/output-formatter.d.ts

@@ -0,0 +1,182 @@
+/**
+ * @fileType: utility
+ * @status: current
+ * @updated: 2025-11-24
+ * @tags: [output, formatting, human-ux, ai-ux, task-11, dual-output]
+ * @related: [start-reflection.ts, context-loader-events.ts]
+ * @priority: high
+ * @complexity: medium
+ * @dependencies: [chalk]
+ */
+/**
+ * Session output containing both human and AI formats
+ */
+export interface SessionOutput {
+    /** Concise console display for humans (6-8 lines) */
+    humanOutput: string;
+    /** Rich structured data for AI context */
+    aiContext: AISessionContext;
+}
+/**
+ * Full AI context structure - everything the AI needs to understand the session
+ */
+export interface AISessionContext {
+    /** Session metadata */
+    session: {
+        id: string;
+        branch: string;
+        startedAt: string;
+        flowScore: number;
+        flowState: string;
+        workMode: string;
+    };
+    /** Project charter (mission, goals, success criteria) */
+    charter?: {
+        purpose: string;
+        goals: string[];
+        successCriteria: string[];
+        scope?: {
+            inScope: string[];
+            outOfScope: string[];
+            tbd: string[];
+        };
+    };
+    /** Team activity from last 7 days */
+    teamActivity?: {
+        decisions: Array<{
+            user: string;
+            description: string;
+            timestamp: string;
+            impact?: string;
+        }>;
+        achievements: Array<{
+            user: string;
+            description: string;
+            timestamp: string;
+        }>;
+    };
+    /** Relevant patterns and gotchas */
+    patterns?: Array<{
+        title: string;
+        content: string;
+        tags: string[];
+        category?: string;
+    }>;
+    /** Current sprint context */
+    sprint?: {
+        id: string;
+        name: string;
+        goal: string;
+        progress: number;
+        currentTask?: {
+            id: string;
+            title: string;
+            status: string;
+            files: string[];
+            priority: string;
+            /** ADR constraints this task must follow (EPIC-002 Phase 1) */
+            constraints?: Array<{
+                adr: {
+                    id: string;
+                    title: string;
+                    summary?: string;
+                };
+                source: string;
+            }>;
+        };
+        tasks: Array<{
+            id: string;
+            title: string;
+            status: 'pending' | 'in_progress' | 'completed';
+        }>;
+    };
+    /** Recent work synthesis */
+    synthesis?: {
+        completedWork: string[];
+        inProgressWork: string[];
+        blockedItems: string[];
+        keyDecisions: string[];
+        gotchas: string[];
+        resumePoint?: string;
+        nextAction?: string;
+        suggestedCommand?: string;
+    };
+    /** Git status */
+    git: {
+        branch: string;
+        commitsAhead: number;
+        uncommittedChanges: {
+            modified: string[];
+            created: string[];
+            untracked: string[];
+        };
+        warnings: string[];
+    };
+    /** Context loading metrics */
+    metrics: {
+        eventsLoaded: number;
+        documentsLoaded: number;
+        tokenEstimate: number;
+        tokenReduction?: string;
+        loadTimeMs: number;
+    };
+}
+/**
+ * Configuration for output formatting
+ */
+export interface OutputConfig {
+    /** Show verbose AI context in console */
+    verbose?: boolean;
+    /** Minimal output for quick starts */
+    minimal?: boolean;
+    /** Disable colors (for piping) */
+    noColor?: boolean;
+    /** Work mode affects output verbosity */
+    workMode?: 'hack-ship' | 'think-build' | 'full-planning';
+}
+/**
+ * Format session output for both human and AI consumers
+ *
+ * Human output is concise (6-8 lines), AI context is rich (full JSON)
+ */
+export declare function formatSessionOutput(context: AISessionContext, config?: OutputConfig): SessionOutput;
+/**
+ * Format concise human-readable output (≤20 lines, typically 6-12)
+ *
+ * Focuses on: Flow state, resume point, sprint, branch, warnings, next action
+ * Format matches CLAUDE.md specification (TASK-P2)
+ */
+export declare function formatHumanOutput(context: AISessionContext, config?: OutputConfig): string;
+/**
+ * Format verbose output showing AI context (for debugging)
+ */
+export declare function formatVerboseOutput(context: AISessionContext): string;
+/**
+ * Format AI context as JSON for file storage or MCP
+ */
+export declare function formatAIContextJSON(context: AISessionContext): string;
+/**
+ * Format AI context as compact JSONL (for append-only logs)
+ */
+export declare function formatAIContextJSONL(context: AISessionContext): string;
+/**
+ * Format list of items with optional limit
+ */
+export declare function formatList(items: string[], options?: {
+    limit?: number;
+    prefix?: string;
+    emptyMessage?: string;
+}): string;
+/**
+ * Format success message
+ */
+export declare function formatSuccess(message: string, details?: string): string;
+/**
+ * Format error message
+ */
+export declare function formatError(message: string, details?: string): string;
+/**
+ * Format warning message
+ */
+export declare function formatWarning(message: string): string;
+//# sourceMappingURL=output-formatter.d.ts.map

package/dist/lib/output-formatter.d.ts.map

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

package/dist/lib/output-formatter.js

@@ -0,0 +1,263 @@
+/**
+ * @fileType: utility
+ * @status: current
+ * @updated: 2025-11-24
+ * @tags: [output, formatting, human-ux, ai-ux, task-11, dual-output]
+ * @related: [start-reflection.ts, context-loader-events.ts]
+ * @priority: high
+ * @complexity: medium
+ * @dependencies: [chalk]
+ */
+/**
+ * Dual Output Formatter (TASK-11)
+ *
+ * Separates human-readable console output from AI-optimized context data.
+ *
+ * Key Principles (AI-UX):
+ * 1. Human output: Concise, scannable, action-oriented (6-8 lines max)
+ * 2. AI context: Rich, structured, complete (JSON with full details)
+ * 3. Both outputs reflect the SAME underlying data
+ * 4. --verbose flag shows AI context in console for debugging
+ */
+import chalk from 'chalk';
+/**
+ * Format session output for both human and AI consumers
+ *
+ * Human output is concise (6-8 lines), AI context is rich (full JSON)
+ */
+export function formatSessionOutput(context, config = {}) {
+    const humanOutput = formatHumanOutput(context, config);
+    const aiContext = context;
+    return { humanOutput, aiContext };
+}
+/**
+ * Format concise human-readable output (≤20 lines, typically 6-12)
+ *
+ * Focuses on: Flow state, resume point, sprint, branch, warnings, next action
+ * Format matches CLAUDE.md specification (TASK-P2)
+ */
+export function formatHumanOutput(context, config = {}) {
+    const lines = [];
+    const { minimal = false } = config;
+    // Line 1: Ready | Flow State | Work Mode
+    const flowState = getFlowStateLabel(context.session.flowScore);
+    lines.push(chalk.green('Ready') + chalk.dim(' | ') +
+        chalk.cyan(`${flowState} (${context.session.flowScore}/10)`) + chalk.dim(' | ') +
+        chalk.white(`${context.session.workMode} mode`));
+    // Line 2: Resume point (most important!)
+    if (context.synthesis?.resumePoint) {
+        const resumeShort = truncate(context.synthesis.resumePoint, 80);
+        lines.push(chalk.white('Resume: ') + chalk.dim(resumeShort));
+    }
+    // Empty line for spacing
+    lines.push('');
+    // Line 3-4: Sprint + Branch context
+    if (context.sprint && !minimal) {
+        const progress = typeof context.sprint.progress === 'number' ? context.sprint.progress : 0;
+        const sprintName = context.sprint.name || 'Active Sprint';
+        const progressDisplay = progress >= 100
+            ? chalk.green('Completed (100%)')
+            : chalk.dim(`(${progress}%)`);
+        lines.push(chalk.white('Sprint: ') + chalk.cyan(sprintName) + ' ' + progressDisplay);
+        // Show current task if available
+        if (context.sprint.currentTask) {
+            lines.push(chalk.dim('  [@] ') + chalk.yellow(`${context.sprint.currentTask.id}: ${context.sprint.currentTask.title}`));
+            // Show ADR constraints for current task (EPIC-002 Phase 1)
+            if (context.sprint.currentTask.constraints && context.sprint.currentTask.constraints.length > 0) {
+                const adrList = context.sprint.currentTask.constraints
+                    .map(c => c.adr.id)
+                    .join(', ');
+                lines.push(chalk.dim('      Follow: ') + chalk.magenta(adrList));
+            }
+        }
+    }
+    // Branch + uncommitted files count
+    const totalChanges = context.git.uncommittedChanges.modified.length +
+        context.git.uncommittedChanges.created.length +
+        context.git.uncommittedChanges.untracked.length;
+    if (totalChanges > 0) {
+        lines.push(chalk.white('Branch: ') +
+            chalk.cyan(context.git.branch) +
+            chalk.dim(` (${totalChanges} uncommitted files)`));
+    }
+    else {
+        lines.push(chalk.white('Branch: ') + chalk.cyan(context.git.branch) + chalk.dim(' (clean)'));
+    }
+    // Warnings section (1-2 key warnings)
+    const warnings = [];
+    // Priority 1: Blockers
+    if (context.synthesis?.blockedItems && context.synthesis.blockedItems.length > 0) {
+        warnings.push(chalk.red(`⚠️  Blocked: ${truncate(context.synthesis.blockedItems[0], 70)}`));
+    }
+    // Priority 2: Git warnings
+    if (context.git.warnings.length > 0 && warnings.length < 2) {
+        warnings.push(chalk.yellow(`⚠️  ${context.git.warnings[0]}`));
+    }
+    // Show warnings with spacing if any
+    if (warnings.length > 0) {
+        lines.push('');
+        warnings.forEach(w => lines.push(w));
+    }
+    // Next action / ready message
+    lines.push('');
+    if (context.synthesis?.nextAction) {
+        lines.push(chalk.white('Next: ') + chalk.dim(context.synthesis.nextAction));
+    }
+    else {
+        lines.push(chalk.white('Next: ') + chalk.dim('What would you like to work on?'));
+    }
+    return lines.join('\n');
+}
+/**
+ * Format verbose output showing AI context (for debugging)
+ */
+export function formatVerboseOutput(context) {
+    const lines = [];
+    lines.push(chalk.cyan.bold('\n📊 AI Context (--verbose mode)\n'));
+    // Charter
+    if (context.charter) {
+        lines.push(chalk.yellow('📜 Charter:'));
+        lines.push(`   Purpose: ${truncate(context.charter.purpose, 100)}`);
+        lines.push(`   Goals: ${context.charter.goals.length} defined`);
+        lines.push('');
+    }
+    // Team Activity
+    if (context.teamActivity) {
+        const decisions = context.teamActivity.decisions?.length || 0;
+        const achievements = context.teamActivity.achievements?.length || 0;
+        lines.push(chalk.yellow('👥 Team Activity (7d):'));
+        lines.push(`   Decisions: ${decisions}, Achievements: ${achievements}`);
+        lines.push('');
+    }
+    // Patterns
+    if (context.patterns && context.patterns.length > 0) {
+        lines.push(chalk.yellow('🧠 Patterns:'));
+        for (const pattern of context.patterns.slice(0, 3)) {
+            lines.push(`   - ${pattern.title} [${pattern.tags.join(', ')}]`);
+        }
+        lines.push('');
+    }
+    // Synthesis Details
+    if (context.synthesis) {
+        lines.push(chalk.yellow('📝 Synthesis:'));
+        lines.push(`   Completed: ${context.synthesis.completedWork?.length || 0} items`);
+        lines.push(`   In Progress: ${context.synthesis.inProgressWork?.length || 0} items`);
+        lines.push(`   Decisions: ${context.synthesis.keyDecisions?.length || 0}`);
+        lines.push(`   Gotchas: ${context.synthesis.gotchas?.length || 0}`);
+        lines.push('');
+    }
+    // Metrics
+    lines.push(chalk.yellow('📈 Metrics:'));
+    lines.push(`   Events: ${context.metrics.eventsLoaded}`);
+    lines.push(`   Documents: ${context.metrics.documentsLoaded}`);
+    lines.push(`   Tokens: ${context.metrics.tokenEstimate.toLocaleString()}`);
+    if (context.metrics.tokenReduction) {
+        lines.push(`   Reduction: ${context.metrics.tokenReduction}`);
+    }
+    lines.push(`   Load time: ${context.metrics.loadTimeMs}ms`);
+    return lines.join('\n');
+}
+/**
+ * Format AI context as JSON for file storage or MCP
+ */
+export function formatAIContextJSON(context) {
+    return JSON.stringify(context, null, 2);
+}
+/**
+ * Format AI context as compact JSONL (for append-only logs)
+ */
+export function formatAIContextJSONL(context) {
+    return JSON.stringify({
+        timestamp: new Date().toISOString(),
+        type: 'session-context',
+        ...context,
+    });
+}
+// ============================================================================
+// Helper Functions
+// ============================================================================
+/**
+ * Get flow state emoji based on score
+ */
+function getFlowEmoji(score) {
+    if (score >= 8)
+        return '🔥'; // Hot
+    if (score >= 6)
+        return '⚡'; // Energized
+    if (score >= 4)
+        return '🌊'; // Flowing
+    if (score >= 2)
+        return '🌱'; // Growing
+    return '❄️'; // Cold
+}
+/**
+ * Get flow state label based on score (for concise output)
+ */
+function getFlowStateLabel(score) {
+    if (score >= 8)
+        return 'Hot';
+    if (score >= 6)
+        return 'Warm';
+    if (score >= 4)
+        return 'Flowing';
+    if (score >= 2)
+        return 'Warming Up';
+    return 'Cold';
+}
+/**
+ * Format a progress bar
+ */
+function formatProgressBar(progress, width = 20) {
+    const filled = Math.round((progress / 100) * width);
+    const empty = width - filled;
+    return chalk.green('█'.repeat(filled)) + chalk.dim('░'.repeat(empty));
+}
+/**
+ * Truncate string with ellipsis
+ */
+function truncate(str, maxLength) {
+    if (str.length <= maxLength)
+        return str;
+    return str.substring(0, maxLength - 3) + '...';
+}
+/**
+ * Format list of items with optional limit
+ */
+export function formatList(items, options = {}) {
+    const { limit = 5, prefix = '  - ', emptyMessage = '(none)' } = options;
+    if (items.length === 0)
+        return emptyMessage;
+    const displayed = items.slice(0, limit);
+    const lines = displayed.map((item) => `${prefix}${item}`);
+    if (items.length > limit) {
+        lines.push(chalk.dim(`${prefix}... and ${items.length - limit} more`));
+    }
+    return lines.join('\n');
+}
+/**
+ * Format success message
+ */
+export function formatSuccess(message, details) {
+    let output = chalk.green(`✓ ${message}`);
+    if (details) {
+        output += '\n' + chalk.dim(`  ${details}`);
+    }
+    return output;
+}
+/**
+ * Format error message
+ */
+export function formatError(message, details) {
+    let output = chalk.red(`✗ ${message}`);
+    if (details) {
+        output += '\n' + chalk.dim(`  ${details}`);
+    }
+    return output;
+}
+/**
+ * Format warning message
+ */
+export function formatWarning(message) {
+    return chalk.yellow(`⚠️  ${message}`);
+}
+//# sourceMappingURL=output-formatter.js.map