@ginkoai/cli 1.0.0 → 1.4.1

package/dist/lib/context-loader-events.js

@@ -0,0 +1,475 @@
+/**
+ * @fileType: utility
+ * @status: current
+ * @updated: 2025-11-04
+ * @tags: [context-loading, events, adr-043, session-cursor, graph]
+ * @related: [context-loader.ts, session-logger.ts, CloudGraphClient]
+ * @priority: critical
+ * @complexity: high
+ * @dependencies: [fs-extra, path]
+ */
+/**
+ * Event-Based Context Loader (ADR-043)
+ *
+ * Loads context by reading backwards through event stream from cursor position,
+ * replacing handoff-based context loading with continuous event history.
+ *
+ * Key differences from handoff-based loading:
+ * - Reads raw events instead of synthesized summaries
+ * - Loads my events + team high-signal events
+ * - Extracts document references from event descriptions
+ * - Follows graph relationships to load related documents
+ * - Target: <30K tokens total (vs 88K with handoff approach)
+ *
+ * Based on ADR-043 Event Stream Session Model
+ */
+import fs from 'fs-extra';
+import path from 'path';
+/**
+ * Load context using consolidated API endpoint (performance optimized)
+ *
+ * Single API call that performs all operations server-side:
+ * - Read events backward
+ * - Load team events
+ * - Extract & load documents
+ * - Follow relationships
+ * - Get active sprint
+ *
+ * Performance: ~2-3s vs ~10-15s (4-5 sequential calls)
+ */
+async function loadContextConsolidated(cursor, options = {}) {
+    const { eventLimit = 50, includeTeam = false, teamEventLimit = 20, categories, documentDepth = 2, teamDays = 7 } = options;
+    try {
+        const { GraphApiClient } = await import('../commands/graph/api-client.js');
+        const client = new GraphApiClient();
+        // Build query parameters
+        const params = new URLSearchParams({
+            cursorId: cursor.current_event_id,
+            userId: cursor.user_id,
+            projectId: cursor.project_id,
+            eventLimit: eventLimit.toString(),
+            includeTeam: includeTeam.toString(),
+            teamEventLimit: teamEventLimit.toString(),
+            teamDays: teamDays.toString(),
+            documentDepth: documentDepth.toString(),
+        });
+        if (categories && categories.length > 0) {
+            params.append('categories', categories.join(','));
+        }
+        if (cursor.branch) {
+            params.append('branch', cursor.branch);
+        }
+        console.log('📡 Using consolidated API endpoint (single call)');
+        // Single API call for all context loading
+        const response = await client.request('GET', `/api/v1/context/initial-load?${params.toString()}`);
+        console.log(`⚡ Consolidated load: ${response.performance.queryTimeMs}ms (${response.event_count} events, ${response.performance.documentsLoaded} docs)`);
+        return {
+            cursor,
+            myEvents: normalizeEvents(response.myEvents || []),
+            teamEvents: response.teamEvents ? normalizeEvents(response.teamEvents) : undefined,
+            documents: response.documents,
+            relatedDocs: response.relatedDocs,
+            sprint: response.sprint,
+            loaded_at: new Date(response.loaded_at),
+            event_count: response.event_count,
+            token_estimate: response.token_estimate,
+        };
+    }
+    catch (error) {
+        console.log(`⚠️  Consolidated endpoint failed: ${error.message}`);
+        throw error; // Re-throw to trigger fallback
+    }
+}
+/**
+ * Load context from cursor position by reading events backwards
+ *
+ * @param cursor - Session cursor with current position
+ * @param options - Loading options
+ * @returns Loaded context with events, documents, and metadata
+ */
+export async function loadContextFromCursor(cursor, options = {}) {
+    const startTime = Date.now();
+    const { eventLimit = 50, includeTeam = false, teamEventLimit = 20, categories, documentDepth = 2, teamDays = 7 } = options;
+    // Try consolidated endpoint first (performance optimized)
+    try {
+        return await loadContextConsolidated(cursor, options);
+    }
+    catch (error) {
+        console.log('⚠️  Falling back to multi-call approach');
+    }
+    // Fallback: Multi-call approach (original behavior)
+    // 1. Read my events backwards from cursor
+    const myEvents = await readEventsBackward(cursor.current_event_id, cursor.user_id, cursor.project_id, eventLimit, { categories, branch: cursor.branch });
+    // 2. Load team events (optional)
+    let teamEvents = [];
+    if (includeTeam) {
+        teamEvents = await loadTeamEvents(cursor.project_id, cursor.user_id, teamEventLimit, teamDays);
+    }
+    // 3. Extract document references from events
+    const allEvents = [...myEvents, ...teamEvents];
+    const documentRefs = extractDocumentReferences(allEvents);
+    // 4. Load mentioned documents from graph
+    const documents = await loadDocuments(documentRefs);
+    // 5. Follow typed relationships (ADR-042)
+    const relatedDocs = await followTypedRelationships(documents, documentDepth);
+    // 6. Get active sprint context
+    const sprint = await getActiveSprint(cursor.project_id);
+    // 7. Calculate token estimate
+    const tokenEstimate = estimateTokens({
+        myEvents,
+        teamEvents,
+        documents,
+        relatedDocs,
+        sprint
+    });
+    const loadedContext = {
+        cursor,
+        myEvents,
+        teamEvents: includeTeam ? teamEvents : undefined,
+        documents,
+        relatedDocs,
+        sprint,
+        loaded_at: new Date(),
+        event_count: allEvents.length,
+        token_estimate: tokenEstimate
+    };
+    console.log(`⏱️  Context loaded in ${Date.now() - startTime}ms`);
+    return loadedContext;
+}
+/**
+ * Read events backwards from cursor position (Git log style)
+ *
+ * @param fromEventId - Starting event ID (cursor position)
+ * @param userId - Filter by user
+ * @param projectId - Filter by project (multi-tenant)
+ * @param limit - Number of events to read
+ * @param filters - Additional filters
+ * @returns Array of events in reverse chronological order
+ */
+async function readEventsBackward(fromEventId, userId, projectId, limit = 50, filters) {
+    console.log(`📖 Reading ${limit} events backwards from ${fromEventId} for user ${userId}`);
+    try {
+        const { GraphApiClient } = await import('../commands/graph/api-client.js');
+        const client = new GraphApiClient();
+        // Build query parameters
+        const params = new URLSearchParams({
+            cursorId: fromEventId,
+            limit: limit.toString(),
+        });
+        if (filters?.categories && filters.categories.length > 0) {
+            params.append('categories', filters.categories.join(','));
+        }
+        if (filters?.branch) {
+            params.append('branch', filters.branch);
+        }
+        // Call API endpoint
+        const response = await client.request('GET', `/api/v1/events?${params.toString()}`);
+        return normalizeEvents(response.events || []);
+    }
+    catch (error) {
+        console.error('Failed to read events:', error);
+        return [];
+    }
+}
+/**
+ * Load team high-signal events (decisions, achievements, git)
+ *
+ * @param projectId - Project ID for multi-tenant filtering
+ * @param excludeUserId - Exclude events from this user
+ * @param limit - Number of team events to load
+ * @param days - Load events from last N days
+ * @returns Array of high-signal team events
+ */
+async function loadTeamEvents(projectId, excludeUserId, limit = 20, days = 7) {
+    console.log(`👥 Loading ${limit} team events from last ${days} days (excluding ${excludeUserId})`);
+    try {
+        const { GraphApiClient } = await import('../commands/graph/api-client.js');
+        const client = new GraphApiClient();
+        // Build query parameters
+        const params = new URLSearchParams({
+            projectId,
+            graphId: '', // Will be populated from context
+            limit: limit.toString(),
+            days: days.toString(),
+            categories: 'decision,achievement,git',
+        });
+        // Call API endpoint
+        const response = await client.request('GET', `/api/v1/events/team?${params.toString()}`);
+        return normalizeEvents(response.events || []);
+    }
+    catch (error) {
+        console.error('Failed to load team events:', error);
+        return [];
+    }
+}
+/**
+ * Extract document references from event descriptions
+ *
+ * Parses event descriptions for references to:
+ * - ADR-XXX (Architecture Decision Records)
+ * - PRD-XXX (Product Requirements Documents)
+ * - Pattern-XXX (Design Patterns)
+ * - TASK-XXX (Task references)
+ *
+ * @param events - Events to parse
+ * @returns Array of document IDs referenced in events
+ */
+function extractDocumentReferences(events) {
+    const refs = new Set();
+    // Regex patterns for document references
+    const patterns = [
+        /ADR-(\d+)/gi,
+        /PRD-(\d+)/gi,
+        /Pattern-(\d+)/gi,
+        /TASK-(\d+)/gi,
+    ];
+    for (const event of events) {
+        const text = event.description;
+        for (const pattern of patterns) {
+            const matches = text.matchAll(pattern);
+            for (const match of matches) {
+                refs.add(match[0]); // e.g., "ADR-043"
+            }
+        }
+    }
+    console.log(`📎 Extracted ${refs.size} document references from ${events.length} events`);
+    return Array.from(refs);
+}
+/**
+ * Load documents from graph by ID
+ *
+ * @param documentIds - Document IDs to load (e.g., ["ADR-043", "PRD-009"])
+ * @returns Array of knowledge nodes
+ */
+async function loadDocuments(documentIds) {
+    if (documentIds.length === 0) {
+        return [];
+    }
+    console.log(`📚 Loading ${documentIds.length} documents: ${documentIds.slice(0, 5).join(', ')}...`);
+    try {
+        const { GraphApiClient } = await import('../commands/graph/api-client.js');
+        const client = new GraphApiClient();
+        // Get graphId from environment or config
+        const graphId = process.env.GINKO_GRAPH_ID || '';
+        // Call batch documents API
+        const response = await client.request('POST', '/api/v1/graph/documents/batch', {
+            graphId,
+            documentIds,
+        });
+        if (response.notFound && response.notFound.length > 0) {
+            console.log(`⚠️  ${response.notFound.length} documents not found: ${response.notFound.slice(0, 3).join(', ')}...`);
+        }
+        return response.documents;
+    }
+    catch (error) {
+        console.error('Failed to load documents:', error);
+        return [];
+    }
+}
+/**
+ * Follow typed relationships to discover related documents
+ *
+ * Uses ADR-042 relationship types:
+ * - IMPLEMENTS (PRD -> ADR)
+ * - REFERENCES (ADR -> ADR, Pattern -> ADR)
+ * - DEPENDS_ON (Feature -> Feature)
+ *
+ * @param documents - Starting documents
+ * @param depth - How many hops to follow
+ * @returns Array of related documents
+ */
+async function followTypedRelationships(documents, depth = 2) {
+    if (documents.length === 0 || depth === 0) {
+        return [];
+    }
+    console.log(`🔗 Following relationships ${depth} hops from ${documents.length} documents`);
+    try {
+        const { GraphApiClient } = await import('../commands/graph/api-client.js');
+        const client = new GraphApiClient();
+        const relatedDocs = new Set();
+        // For each starting document, explore its relationships
+        for (const doc of documents.slice(0, 10)) { // Limit to first 10 to avoid too many API calls
+            try {
+                const response = await client.request('GET', `/api/v1/graph/explore/${doc.id}`);
+                // Collect all related documents from typed relationships
+                const relationships = response.relationships;
+                if (relationships.implements) {
+                    relationships.implements.forEach((rel) => {
+                        relatedDocs.add({
+                            id: rel.id,
+                            type: rel.type,
+                            title: rel.title,
+                        });
+                    });
+                }
+                if (relationships.referencedBy) {
+                    relationships.referencedBy.forEach((rel) => {
+                        relatedDocs.add({
+                            id: rel.id,
+                            type: rel.type,
+                            title: rel.title,
+                        });
+                    });
+                }
+                // Skip SIMILAR_TO as these are lower signal
+            }
+            catch (error) {
+                console.log(`  ⚠️  Could not explore ${doc.id}:`, error.message);
+            }
+        }
+        return Array.from(relatedDocs);
+    }
+    catch (error) {
+        console.error('Failed to follow relationships:', error);
+        return [];
+    }
+}
+/**
+ * Get active sprint for project
+ *
+ * @param projectId - Project ID
+ * @returns Active sprint or undefined
+ */
+async function getActiveSprint(projectId) {
+    console.log(`🎯 Loading active sprint for project ${projectId}`);
+    try {
+        // Look for sprint files in docs/sprints/
+        const sprintDir = path.join(process.cwd(), 'docs', 'sprints');
+        if (!await fs.pathExists(sprintDir)) {
+            return undefined;
+        }
+        // Read CURRENT-SPRINT.md first (optimized for readiness - ADR-043)
+        const currentSprintPath = path.join(sprintDir, 'CURRENT-SPRINT.md');
+        if (await fs.pathExists(currentSprintPath)) {
+            const content = await fs.readFile(currentSprintPath, 'utf-8');
+            // CURRENT-SPRINT.md contains all readiness info (WHY, WHAT, HOW, status)
+            // No need to read the full sprint file during startup
+            // Extract sprint reference (e.g., "**Sprint**: SPRINT-2025-10-27-cloud-knowledge-graph")
+            const sprintMatch = content.match(/\*\*Sprint\*\*:\s*(SPRINT-[\w-]+)/);
+            const sprintId = sprintMatch ? sprintMatch[1] : 'unknown';
+            // Extract title from "Sprint Goal" section
+            const titleMatch = content.match(/##\s+Sprint Goal\s+(.+?)(?=\n\n|\*\*|$)/s);
+            const title = titleMatch ? titleMatch[1].trim() : 'Active Sprint';
+            // Extract progress if available
+            const progressMatch = content.match(/\*\*Progress\*\*:\s*(\d+)%/);
+            const progress = progressMatch ? parseInt(progressMatch[1], 10) : 0;
+            return {
+                id: sprintId,
+                title,
+                goals: [], // Available in CURRENT-SPRINT.md if needed
+                progress,
+                started: new Date(), // Could parse from CURRENT-SPRINT.md if needed
+            };
+        }
+        // Fallback: scan all sprint files (legacy behavior)
+        const files = await fs.readdir(sprintDir);
+        const sprintFiles = files.filter(f => f.startsWith('SPRINT-') && f.endsWith('.md'));
+        for (const file of sprintFiles) {
+            const filePath = path.join(sprintDir, file);
+            const content = await fs.readFile(filePath, 'utf-8');
+            if (content.toLowerCase().includes('status**: active') ||
+                content.toLowerCase().includes('sprint status: active')) {
+                const titleMatch = content.match(/^#\s+(.+)$/m);
+                const title = titleMatch ? titleMatch[1] : file.replace('.md', '');
+                return {
+                    id: file.replace('.md', ''),
+                    title,
+                    goals: [],
+                    progress: 0,
+                    started: new Date(),
+                };
+            }
+        }
+        return undefined;
+    }
+    catch (error) {
+        console.log('Could not load sprint:', error.message);
+        return undefined;
+    }
+}
+/**
+ * Estimate total token count for loaded context
+ *
+ * Token estimation:
+ * - Events: ~100 tokens each
+ * - Documents: ~1000 tokens each (average)
+ * - Sprint: ~500 tokens
+ *
+ * Target: <30K tokens total
+ *
+ * @param context - Context components
+ * @returns Estimated token count
+ */
+function estimateTokens(context) {
+    const eventTokens = (context.myEvents.length + (context.teamEvents?.length || 0)) * 100;
+    const docTokens = context.documents.length * 1000;
+    const relatedDocTokens = context.relatedDocs.length * 1000;
+    const sprintTokens = context.sprint ? 500 : 0;
+    return eventTokens + docTokens + relatedDocTokens + sprintTokens;
+}
+/**
+ * Format context summary for display
+ *
+ * @param context - Loaded context
+ * @returns Formatted summary string
+ */
+export function formatContextSummary(context) {
+    const lines = [];
+    lines.push('📊 Context Loaded:');
+    lines.push(`   - ${context.myEvents.length} my events (last ${daysAgo(context.myEvents[0]?.timestamp)} days)`);
+    if (context.teamEvents && context.teamEvents.length > 0) {
+        lines.push(`   - ${context.teamEvents.length} team events (decisions + achievements)`);
+    }
+    // Group documents by type
+    const docsByType = groupByType(context.documents);
+    const totalDocs = context.documents.length;
+    const docSummary = Object.entries(docsByType)
+        .map(([type, count]) => `${count} ${type}${count > 1 ? 's' : ''}`)
+        .join(', ');
+    lines.push(`   - ${totalDocs} documents (${docSummary})`);
+    if (context.relatedDocs.length > 0) {
+        lines.push(`   - ${context.relatedDocs.length} related documents`);
+    }
+    if (context.sprint) {
+        lines.push(`   - Sprint: ${context.sprint.title} (${context.sprint.progress}% complete)`);
+    }
+    lines.push(`   - Estimated tokens: ${context.token_estimate.toLocaleString()}`);
+    return lines.join('\n');
+}
+/**
+ * Normalize event data from API (convert timestamp strings to Date objects)
+ */
+function normalizeEvent(event) {
+    return {
+        ...event,
+        timestamp: event.timestamp ? new Date(event.timestamp) : new Date(),
+    };
+}
+/**
+ * Normalize array of events from API
+ */
+function normalizeEvents(events) {
+    return events.map(normalizeEvent);
+}
+/**
+ * Calculate days ago from timestamp
+ */
+function daysAgo(timestamp) {
+    if (!timestamp)
+        return 0;
+    const now = new Date();
+    const diff = now.getTime() - timestamp.getTime();
+    return Math.round(diff / (1000 * 60 * 60 * 24));
+}
+/**
+ * Group documents by type
+ */
+function groupByType(documents) {
+    const groups = {};
+    for (const doc of documents) {
+        const type = doc.type || 'unknown';
+        groups[type] = (groups[type] || 0) + 1;
+    }
+    return groups;
+}
+//# sourceMappingURL=context-loader-events.js.map

package/dist/lib/context-loader-events.js.map

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

package/dist/lib/event-logger.d.ts

@@ -0,0 +1,64 @@
+/**
+ * @fileType: utility
+ * @status: current
+ * @updated: 2025-11-04
+ * @tags: [event-logging, dual-write, adr-043, session-events]
+ * @related: [event-queue.ts, ../commands/log.ts, ../utils/session-logger.ts]
+ * @priority: critical
+ * @complexity: medium
+ * @dependencies: [fs-extra, uuid]
+ */
+/**
+ * Event entry structure (aligned with ADR-043)
+ */
+export interface EventEntry {
+    category: 'fix' | 'feature' | 'decision' | 'insight' | 'git' | 'achievement';
+    description: string;
+    files?: string[];
+    impact?: 'high' | 'medium' | 'low';
+    branch?: string;
+    tags?: string[];
+    shared?: boolean;
+    commit_hash?: string;
+}
+/**
+ * Internal event structure with metadata
+ */
+export interface Event extends EventEntry {
+    id: string;
+    user_id: string;
+    organization_id: string;
+    project_id: string;
+    timestamp: string;
+    pressure?: number;
+    synced_to_graph?: boolean;
+}
+/**
+ * Log an event with dual-write pattern
+ *
+ * Pattern (ADR-043):
+ * 1. Write to local file immediately (blocking, must succeed)
+ * 2. Add to async queue for Neo4j sync (non-blocking)
+ * 3. Return immediately (don't wait for sync)
+ *
+ * @param entry - Event entry data
+ * @returns Promise<Event> - The logged event with metadata
+ */
+export declare function logEvent(entry: EventEntry): Promise<Event>;
+/**
+ * Load all events from local file
+ */
+export declare function loadEvents(): Promise<Event[]>;
+/**
+ * Mark events as synced to graph
+ */
+export declare function markEventsSynced(eventIds: string[]): Promise<void>;
+/**
+ * Get events that need syncing (not yet synced to graph)
+ */
+export declare function getUnsyncedEvents(): Promise<Event[]>;
+/**
+ * Clear events file (for testing)
+ */
+export declare function clearEvents(): Promise<void>;
+//# sourceMappingURL=event-logger.d.ts.map

package/dist/lib/event-logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-logger.d.ts","sourceRoot":"","sources":["../../src/lib/event-logger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAQH;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,KAAK,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,GAAG,KAAK,GAAG,aAAa,CAAC;IAC7E,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IACnC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,KAAM,SAAQ,UAAU;IACvC,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAgGD;;;;;;;;;;GAUG;AACH,wBAAsB,QAAQ,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,KAAK,CAAC,CAqChE;AAED;;GAEG;AACH,wBAAsB,UAAU,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC,CAgBnD;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAoBxE;AAED;;GAEG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC,CAG1D;AAED;;GAEG;AACH,wBAAsB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAOjD"}