@ginkoai/cli 1.4.13 → 1.6.0

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,172 @@
+/**
+ * @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;
+        };
+        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 (6-8 lines max)
+ *
+ * Focuses on: What mode? What task? What to do next? Any blockers?
+ */
+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,219 @@
+/**
+ * @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 (6-8 lines max)
+ *
+ * Focuses on: What mode? What task? What to do next? Any blockers?
+ */
+export function formatHumanOutput(context, config = {}) {
+    const lines = [];
+    const { minimal = false, workMode = 'think-build' } = config;
+    // Line 1: Work Mode + Flow State
+    const flowEmoji = getFlowEmoji(context.session.flowScore);
+    lines.push(`${flowEmoji} ${chalk.cyan(context.session.workMode)} | Flow: ${context.session.flowScore}/10 | ${chalk.dim(context.session.branch)}`);
+    // Line 2-3: Sprint Progress (if active)
+    if (context.sprint && !minimal) {
+        const progress = typeof context.sprint.progress === 'number' ? context.sprint.progress : 0;
+        const progressBar = formatProgressBar(progress, 20);
+        const sprintName = context.sprint.name || 'Active Sprint';
+        lines.push(`📋 ${sprintName}: ${progressBar} ${progress}%`);
+        if (context.sprint.currentTask) {
+            lines.push(`   ${chalk.yellow('[@]')} ${context.sprint.currentTask.id}: ${context.sprint.currentTask.title}`);
+        }
+    }
+    // Line 4: Resume Point / Next Action (CRITICAL - most important)
+    if (context.synthesis?.resumePoint) {
+        const resumeShort = truncate(context.synthesis.resumePoint, 70);
+        lines.push(`⚡ ${chalk.green('Resume:')} ${resumeShort}`);
+    }
+    if (context.synthesis?.suggestedCommand) {
+        lines.push(`   ${chalk.dim('$')} ${chalk.cyan(context.synthesis.suggestedCommand)}`);
+    }
+    // Line 5: Blockers (if any - IMPORTANT)
+    if (context.synthesis?.blockedItems && context.synthesis.blockedItems.length > 0) {
+        lines.push(chalk.red(`🚫 Blocked: ${context.synthesis.blockedItems[0]}`));
+    }
+    // Line 6: Git warnings (if any)
+    if (context.git.warnings.length > 0) {
+        lines.push(chalk.yellow(`⚠️  ${context.git.warnings[0]}`));
+    }
+    else if (context.git.uncommittedChanges.modified.length > 0) {
+        const totalChanges = context.git.uncommittedChanges.modified.length +
+            context.git.uncommittedChanges.created.length +
+            context.git.uncommittedChanges.untracked.length;
+        lines.push(chalk.dim(`📝 ${totalChanges} uncommitted changes`));
+    }
+    // Final line: Ready message
+    lines.push('');
+    lines.push(chalk.green('Ready to build!') + chalk.dim(' Use ginko log to capture insights'));
+    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
+}
+/**
+ * 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

package/dist/lib/output-formatter.js.map

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

package/dist/lib/session-cursor.d.ts

@@ -1,12 +1,19 @@
 /**
  * @fileType: utility
- * @status: current
- * @updated: 2025-11-04
- * @tags: [session, cursor, event-stream, adr-043, multi-context]
- * @related: [commands/start/index.ts, utils/helpers.ts, lib/write-dispatcher/write-dispatcher.ts]
- * @priority: critical
+ * @status: deprecated
+ * @updated: 2025-11-19
+ * @tags: [session, cursor, event-stream, adr-043, multi-context, deprecated]
+ * @related: [commands/start/index.ts, utils/helpers.ts, lib/write-dispatcher/write-dispatcher.ts, context-loader-events.ts]
+ * @priority: low
  * @complexity: medium
  * @dependencies: [fs-extra, simple-git]
+ *
+ * @deprecated TASK-011: Cursors are over-engineered for our use case.
+ * We only need "last N events" queries, not stateful cursor tracking.
+ * Use loadRecentEvents() from context-loader-events.ts instead.
+ *
+ * Kept for backward compatibility during transition period.
+ * Will be removed in a future version after cloud-first refactor is complete.
  */
 /**
  * Session cursor interface (ADR-043)

package/dist/lib/session-cursor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session-cursor.d.ts","sourceRoot":"","sources":["../../src/lib/session-cursor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAQH;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,gBAAgB,EAAE,MAAM,CAAC;IACzB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,OAAO,EAAE,IAAI,CAAC;IACd,WAAW,EAAE,IAAI,CAAC;IAClB,MAAM,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAC5B,gBAAgB,CAAC,EAAE,GAAG,CAAC;CACxB;AA4GD;;GAEG;AACH,wBAAsB,YAAY,CAAC,MAAM,EAAE;IACzC,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,CAAC,EAAE,GAAG,CAAC;CACvB,GAAG,OAAO,CAAC,aAAa,CAAC,CAqBzB;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAe3E;AAED;;GAEG;AACH,wBAAsB,YAAY,CAChC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,OAAO,CAAC,aAAa,CAAC,GAC9B,OAAO,CAAC,aAAa,CAAC,CAgBxB;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,OAAO,EAAE;IACxC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;CAC9B,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CA6BhC;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAO3E;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAIlE;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CAAC,OAAO,EAAE;IAC/C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,OAAO,CAAC;IAAE,MAAM,EAAE,aAAa,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAAC,CA2BrD;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,EAAE;IAChD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAwBhC"}
+{"version":3,"file":"session-cursor.d.ts","sourceRoot":"","sources":["../../src/lib/session-cursor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAQH;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,gBAAgB,EAAE,MAAM,CAAC;IACzB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,OAAO,EAAE,IAAI,CAAC;IACd,WAAW,EAAE,IAAI,CAAC;IAClB,MAAM,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAC5B,gBAAgB,CAAC,EAAE,GAAG,CAAC;CACxB;AA4GD;;GAEG;AACH,wBAAsB,YAAY,CAAC,MAAM,EAAE;IACzC,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,CAAC,EAAE,GAAG,CAAC;CACvB,GAAG,OAAO,CAAC,aAAa,CAAC,CAqBzB;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAe3E;AAED;;GAEG;AACH,wBAAsB,YAAY,CAChC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,OAAO,CAAC,aAAa,CAAC,GAC9B,OAAO,CAAC,aAAa,CAAC,CAgBxB;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,OAAO,EAAE;IACxC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;CAC9B,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CA6BhC;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAO3E;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAIlE;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CAAC,OAAO,EAAE;IAC/C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,OAAO,CAAC;IAAE,MAAM,EAAE,aAAa,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAAC,CA2BrD;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,EAAE;IAChD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAwBhC"}