@ace-sdk/core 2.0.0 → 2.1.0

package/dist/services/bootstrap-stream.d.ts

@@ -0,0 +1,113 @@
+/**
+ * Bootstrap Streaming Client
+ *
+ * Connects to server SSE endpoint for streaming bootstrap progress.
+ * Handles event parsing, timeout, and error recovery.
+ *
+ * Updated to match ACE Server v3.13.0 response format.
+ *
+ * @package @ace-sdk/core
+ */
+import type { BootstrapSSEEvent, PlaybookSection, BootstrapStatistics } from '../types/bootstrap-events.js';
+import type { ProjectDNA } from '../types/project-dna.js';
+import type { BootstrapMode } from '../types/pattern.js';
+import type { VerbosityLevel } from '../types/config.js';
+export type { BootstrapMode, VerbosityLevel };
+/**
+ * Options for bootstrap streaming
+ */
+export interface BootstrapStreamOptions {
+    /** ACE Server URL (without trailing slash) */
+    serverUrl: string;
+    /** Organization ID */
+    orgId: string;
+    /** Project ID */
+    projectId: string;
+    /** Bootstrap mode (default: 'hybrid') */
+    mode?: BootstrapMode;
+    /** Code blocks to send for bootstrap */
+    codeBlocks: string[];
+    /** Metadata about the bootstrap request */
+    metadata?: {
+        files_scanned?: number;
+        blocks_extracted?: number;
+        thoroughness?: string;
+    };
+    /** Project DNA to store (optional) */
+    projectDNA?: ProjectDNA;
+    /** API token for authentication */
+    apiToken?: string;
+    /** Callback for each SSE event */
+    onEvent: (event: BootstrapSSEEvent) => void;
+    /** Callback for errors */
+    onError?: (error: Error) => void;
+    /** Timeout in milliseconds (default: 120000 = 2 minutes) */
+    timeout?: number;
+    /** Verbosity level for SSE events (default: 'compact') */
+    verbosity?: VerbosityLevel;
+}
+/**
+ * Result of bootstrap streaming
+ */
+export interface BootstrapStreamResult {
+    /** Whether bootstrap succeeded */
+    success: boolean;
+    /** Bootstrap statistics on success */
+    statistics?: BootstrapStatistics;
+    /** Playbook summary on success (derived from statistics) */
+    playbook?: {
+        totalPatterns: number;
+        bySection: Record<PlaybookSection, number>;
+    };
+    /** Error info on failure */
+    error?: {
+        code: string;
+        message: string;
+        retryable: boolean;
+    };
+    /** Processing time in seconds */
+    processingTime?: number;
+}
+/**
+ * Stream bootstrap progress from ACE Server
+ *
+ * Connects to the server's SSE endpoint and receives progress updates
+ * as the bootstrap processes code blocks.
+ *
+ * @param options - Bootstrap streaming options
+ * @returns Promise that resolves when bootstrap completes or fails
+ *
+ * @example
+ * ```typescript
+ * const result = await bootstrapWithStreaming({
+ *   serverUrl: 'https://ace-api.code-engine.app',
+ *   orgId: 'myorg',
+ *   projectId: 'myproject',
+ *   mode: 'hybrid',
+ *   codeBlocks: ['function foo() { ... }', '// STRATEGY: Use DI'],
+ *   onEvent: (event) => {
+ *     console.log(`[${event.stage}] ${event.message}`);
+ *     if (event.stage === 'done') {
+ *       const stats = event.data as DoneStageData;
+ *       console.log(`Patterns: ${stats.patterns_extracted}`);
+ *     }
+ *   }
+ * });
+ *
+ * if (result.success) {
+ *   console.log(`Bootstrap complete: ${result.playbook?.totalPatterns} patterns`);
+ * }
+ * ```
+ */
+export declare function bootstrapWithStreaming(options: BootstrapStreamOptions): Promise<BootstrapStreamResult>;
+/**
+ * Non-streaming bootstrap fallback
+ *
+ * For servers that don't support SSE streaming, this function
+ * makes a regular POST request and waits for the response.
+ *
+ * @param options - Bootstrap options (same as streaming but without onEvent)
+ * @returns Promise that resolves with bootstrap result
+ */
+export declare function bootstrapWithoutStreaming(options: Omit<BootstrapStreamOptions, 'onEvent'>): Promise<BootstrapStreamResult>;
+//# sourceMappingURL=bootstrap-stream.d.ts.map

package/dist/services/bootstrap-stream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap-stream.d.ts","sourceRoot":"","sources":["../../src/services/bootstrap-stream.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EACV,iBAAiB,EAGjB,eAAe,EACf,mBAAmB,EACpB,MAAM,8BAA8B,CAAC;AAEtC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAGzD,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,CAAC;AAM9C;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,8CAA8C;IAC9C,SAAS,EAAE,MAAM,CAAC;IAClB,sBAAsB;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,iBAAiB;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,yCAAyC;IACzC,IAAI,CAAC,EAAE,aAAa,CAAC;IACrB,wCAAwC;IACxC,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,2CAA2C;IAC3C,QAAQ,CAAC,EAAE;QACT,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,CAAC;IACF,sCAAsC;IACtC,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,mCAAmC;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kCAAkC;IAClC,OAAO,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,CAAC;IAC5C,0BAA0B;IAC1B,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACjC,4DAA4D;IAC5D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,0DAA0D;IAC1D,SAAS,CAAC,EAAE,cAAc,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,kCAAkC;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,sCAAsC;IACtC,UAAU,CAAC,EAAE,mBAAmB,CAAC;IACjC,4DAA4D;IAC5D,QAAQ,CAAC,EAAE;QACT,aAAa,EAAE,MAAM,CAAC;QACtB,SAAS,EAAE,MAAM,CAAC,eAAe,EAAE,MAAM,CAAC,CAAC;KAC5C,CAAC;IACF,4BAA4B;IAC5B,KAAK,CAAC,EAAE;QACN,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,OAAO,CAAC;KACpB,CAAC;IACF,iCAAiC;IACjC,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,qBAAqB,CAAC,CA4KhC;AAMD;;;;;;;;GAQG;AACH,wBAAsB,yBAAyB,CAC7C,OAAO,EAAE,IAAI,CAAC,sBAAsB,EAAE,SAAS,CAAC,GAC/C,OAAO,CAAC,qBAAqB,CAAC,CAoFhC"}

package/dist/services/bootstrap-stream.js

@@ -0,0 +1,261 @@
+/**
+ * Bootstrap Streaming Client
+ *
+ * Connects to server SSE endpoint for streaming bootstrap progress.
+ * Handles event parsing, timeout, and error recovery.
+ *
+ * Updated to match ACE Server v3.13.0 response format.
+ *
+ * @package @ace-sdk/core
+ */
+import { isTerminalEvent, isDoneEvent, isErrorEvent } from '../types/bootstrap-events.js';
+// =============================================================================
+// Bootstrap Stream Function
+// =============================================================================
+/**
+ * Stream bootstrap progress from ACE Server
+ *
+ * Connects to the server's SSE endpoint and receives progress updates
+ * as the bootstrap processes code blocks.
+ *
+ * @param options - Bootstrap streaming options
+ * @returns Promise that resolves when bootstrap completes or fails
+ *
+ * @example
+ * ```typescript
+ * const result = await bootstrapWithStreaming({
+ *   serverUrl: 'https://ace-api.code-engine.app',
+ *   orgId: 'myorg',
+ *   projectId: 'myproject',
+ *   mode: 'hybrid',
+ *   codeBlocks: ['function foo() { ... }', '// STRATEGY: Use DI'],
+ *   onEvent: (event) => {
+ *     console.log(`[${event.stage}] ${event.message}`);
+ *     if (event.stage === 'done') {
+ *       const stats = event.data as DoneStageData;
+ *       console.log(`Patterns: ${stats.patterns_extracted}`);
+ *     }
+ *   }
+ * });
+ *
+ * if (result.success) {
+ *   console.log(`Bootstrap complete: ${result.playbook?.totalPatterns} patterns`);
+ * }
+ * ```
+ */
+export async function bootstrapWithStreaming(options) {
+    const { serverUrl, orgId, projectId, mode = 'hybrid', codeBlocks, metadata, projectDNA, apiToken, onEvent, onError, timeout = 120000, verbosity = 'compact' } = options;
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), timeout);
+    let result = { success: false };
+    try {
+        // Build request headers
+        const headers = {
+            'Content-Type': 'application/json',
+            'Accept': 'text/event-stream',
+            'X-ACE-Org': orgId,
+            'X-ACE-Project': projectId
+        };
+        if (apiToken) {
+            headers['Authorization'] = `Bearer ${apiToken}`;
+        }
+        // Build request body (matches server v3.13.0 BootstrapStreamRequest)
+        const body = JSON.stringify({
+            mode,
+            code_blocks: codeBlocks,
+            metadata: metadata || {
+                project_dna: projectDNA
+            },
+            verbosity
+        });
+        // Make streaming request
+        const response = await fetch(`${serverUrl}/bootstrap/stream`, {
+            method: 'POST',
+            headers,
+            body,
+            signal: controller.signal
+        });
+        if (!response.ok) {
+            throw new Error(`Bootstrap request failed: ${response.status} ${response.statusText}`);
+        }
+        // Get response body reader
+        const reader = response.body?.getReader();
+        const decoder = new TextDecoder();
+        if (!reader) {
+            throw new Error('No response body available');
+        }
+        let buffer = '';
+        // Read SSE stream
+        while (true) {
+            const { done, value } = await reader.read();
+            if (done)
+                break;
+            // Append chunk to buffer
+            buffer += decoder.decode(value, { stream: true });
+            // Parse complete lines from buffer
+            const lines = buffer.split('\n');
+            buffer = lines.pop() || ''; // Keep incomplete line in buffer
+            for (const line of lines) {
+                // Skip empty lines and comments
+                if (!line || line.startsWith(':'))
+                    continue;
+                // Parse SSE data line
+                if (line.startsWith('data: ')) {
+                    const json = line.slice(6);
+                    try {
+                        const event = JSON.parse(json);
+                        // Call user's event handler
+                        onEvent(event);
+                        // Check for terminal events
+                        if (isTerminalEvent(event)) {
+                            if (isDoneEvent(event)) {
+                                const data = event.data;
+                                result = {
+                                    success: data.success,
+                                    statistics: data.bootstrap_statistics,
+                                    playbook: {
+                                        totalPatterns: data.patterns_extracted,
+                                        bySection: data.bootstrap_statistics.by_section
+                                    },
+                                    processingTime: data.analysis_time_seconds
+                                };
+                            }
+                            else if (isErrorEvent(event)) {
+                                const data = event.data;
+                                result = {
+                                    success: false,
+                                    error: {
+                                        code: data.error_code,
+                                        message: data.message,
+                                        retryable: data.retryable
+                                    }
+                                };
+                            }
+                            return result;
+                        }
+                    }
+                    catch (parseError) {
+                        console.warn('Failed to parse SSE event:', json, parseError);
+                    }
+                }
+            }
+        }
+        // Stream ended without terminal event
+        if (!result.success && !result.error) {
+            result = {
+                success: false,
+                error: {
+                    code: 'STREAM_ENDED',
+                    message: 'Stream ended without completion or error event',
+                    retryable: true
+                }
+            };
+        }
+        return result;
+    }
+    catch (error) {
+        const err = error;
+        // Handle abort (timeout)
+        if (err.name === 'AbortError') {
+            result = {
+                success: false,
+                error: {
+                    code: 'TIMEOUT',
+                    message: `Bootstrap timed out after ${timeout}ms`,
+                    retryable: true
+                }
+            };
+        }
+        else {
+            result = {
+                success: false,
+                error: {
+                    code: 'NETWORK_ERROR',
+                    message: err.message,
+                    retryable: true
+                }
+            };
+        }
+        // Call error handler if provided
+        if (onError) {
+            onError(err);
+        }
+        return result;
+    }
+    finally {
+        clearTimeout(timeoutId);
+    }
+}
+// =============================================================================
+// Fallback: Non-Streaming Bootstrap
+// =============================================================================
+/**
+ * Non-streaming bootstrap fallback
+ *
+ * For servers that don't support SSE streaming, this function
+ * makes a regular POST request and waits for the response.
+ *
+ * @param options - Bootstrap options (same as streaming but without onEvent)
+ * @returns Promise that resolves with bootstrap result
+ */
+export async function bootstrapWithoutStreaming(options) {
+    const { serverUrl, orgId, projectId, mode = 'hybrid', codeBlocks, metadata, projectDNA, apiToken, onError, timeout = 120000 } = options;
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), timeout);
+    try {
+        const headers = {
+            'Content-Type': 'application/json',
+            'X-ACE-Org': orgId,
+            'X-ACE-Project': projectId
+        };
+        if (apiToken) {
+            headers['Authorization'] = `Bearer ${apiToken}`;
+        }
+        const body = JSON.stringify({
+            mode,
+            code_blocks: codeBlocks,
+            metadata: metadata || {
+                project_dna: projectDNA
+            }
+        });
+        const response = await fetch(`${serverUrl}/bootstrap`, {
+            method: 'POST',
+            headers,
+            body,
+            signal: controller.signal
+        });
+        if (!response.ok) {
+            throw new Error(`Bootstrap request failed: ${response.status} ${response.statusText}`);
+        }
+        const data = await response.json();
+        // Handle both old and new response formats
+        const totalPatterns = data.patterns_extracted || data.total_patterns || 0;
+        const bySection = data.bootstrap_statistics?.by_section || data.by_section || {};
+        return {
+            success: true,
+            statistics: data.bootstrap_statistics,
+            playbook: {
+                totalPatterns,
+                bySection
+            }
+        };
+    }
+    catch (error) {
+        const err = error;
+        if (onError) {
+            onError(err);
+        }
+        return {
+            success: false,
+            error: {
+                code: err.name === 'AbortError' ? 'TIMEOUT' : 'NETWORK_ERROR',
+                message: err.message,
+                retryable: true
+            }
+        };
+    }
+    finally {
+        clearTimeout(timeoutId);
+    }
+}
+//# sourceMappingURL=bootstrap-stream.js.map

package/dist/services/bootstrap-stream.js.map

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

package/dist/services/import-graph.d.ts

@@ -0,0 +1,111 @@
+/**
+ * Import Graph Analysis Service
+ *
+ * Uses Skott for JS/TS dependency graph analysis with dead code detection.
+ * Routes to appropriate analyzer based on primary language.
+ *
+ * @package @ace-sdk/core
+ */
+import type { GraphMetrics, CodeHealthMetrics } from '../types/project-dna.js';
+/**
+ * Represents a node in the import graph
+ */
+export interface FileNode {
+    /** File path relative to repo root */
+    path: string;
+    /** Files this file imports */
+    imports: string[];
+    /** Files that import this file */
+    importedBy: string[];
+    /** Has no dependents (entry point) */
+    isEntryPoint: boolean;
+    /** Has 5+ importers */
+    isHub: boolean;
+    /** Has no dependencies */
+    isLeaf: boolean;
+}
+/**
+ * Complete import graph analysis result
+ */
+export interface ImportGraph {
+    /** All file nodes in the graph */
+    nodes: Map<string, FileNode>;
+    /** Files with no dependents */
+    entryPoints: string[];
+    /** Files with 5+ importers */
+    hubFiles: string[];
+    /** Files with no dependencies */
+    leafFiles: string[];
+    /** Circular dependency chains */
+    circularDeps: string[][];
+    /** Dead code files (never imported) */
+    deadCode: string[];
+    /** Unused dependencies from package.json */
+    unusedDeps: string[];
+}
+/**
+ * Options for building import graph
+ */
+export interface ImportGraphOptions {
+    /** Root path to analyze */
+    repoPath: string;
+    /** Entry points to start from (optional) */
+    entryPoints?: string[];
+    /** Paths to ignore */
+    ignorePaths?: string[];
+    /** Maximum files to analyze */
+    maxFiles?: number;
+}
+/**
+ * Default paths to ignore during analysis
+ */
+export declare const DEFAULT_IGNORE_PATHS: string[];
+/**
+ * Minimum number of importers to be considered a hub
+ */
+export declare const HUB_THRESHOLD = 5;
+/**
+ * Build import graph with language-based routing
+ *
+ * Routes to the best analyzer based on primary language:
+ * - TypeScript/JavaScript: Skott (fast, dead code detection)
+ * - Other languages: Git co-occurrence fallback
+ *
+ * @param options - Import graph options
+ * @returns Complete import graph analysis
+ *
+ * @example
+ * ```typescript
+ * const graph = await buildImportGraph({ repoPath: '/path/to/repo' });
+ *
+ * console.log(`Entry points: ${graph.entryPoints.length}`);
+ * console.log(`Hub files: ${graph.hubFiles.length}`);
+ * console.log(`Dead code: ${graph.deadCode.length}`);
+ * console.log(`Circular deps: ${graph.circularDeps.length}`);
+ * ```
+ */
+export declare function buildImportGraph(options: ImportGraphOptions): Promise<ImportGraph>;
+/**
+ * Select priority files from import graph for bootstrap
+ *
+ * Priority order:
+ * 1. Entry points (always include)
+ * 2. Hub files (most imported - high value)
+ * 3. Files in circular deps (need attention)
+ * 4. Leaf files with many exports (API surface)
+ * 5. Fill remaining with diverse sampling
+ *
+ * @param graph - Import graph to select from
+ * @param maxFiles - Maximum files to select
+ * @returns Array of priority file paths
+ */
+export declare function selectPriorityFiles(graph: ImportGraph, maxFiles: number): string[];
+/**
+ * Convert import graph to GraphMetrics for ProjectDNA
+ */
+export declare function graphToMetrics(graph: ImportGraph): GraphMetrics;
+/**
+ * Calculate code health metrics from import graph
+ */
+export declare function calculateHealthMetrics(graph: ImportGraph, totalFiles: number, avgFileSize: number, maxFileSize: number): CodeHealthMetrics;
+//# sourceMappingURL=import-graph.d.ts.map

package/dist/services/import-graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"import-graph.d.ts","sourceRoot":"","sources":["../../src/services/import-graph.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAM/E;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,8BAA8B;IAC9B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,kCAAkC;IAClC,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,sCAAsC;IACtC,YAAY,EAAE,OAAO,CAAC;IACtB,uBAAuB;IACvB,KAAK,EAAE,OAAO,CAAC;IACf,0BAA0B;IAC1B,MAAM,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,kCAAkC;IAClC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAC7B,+BAA+B;IAC/B,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,8BAA8B;IAC9B,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,iCAAiC;IACjC,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,iCAAiC;IACjC,YAAY,EAAE,MAAM,EAAE,EAAE,CAAC;IACzB,uCAAuC;IACvC,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,4CAA4C;IAC5C,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,2BAA2B;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,4CAA4C;IAC5C,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,sBAAsB;IACtB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,+BAA+B;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAMD;;GAEG;AACH,eAAO,MAAM,oBAAoB,UAWhC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,aAAa,IAAI,CAAC;AA+J/B;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,WAAW,CAAC,CAsBxF;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CA6ClF;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,WAAW,GAAG,YAAY,CAQ/D;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,WAAW,EAClB,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,GAClB,iBAAiB,CAYnB"}