@ace-sdk/core 2.0.1 → 2.1.0

package/dist/cache/project-index.d.ts

@@ -0,0 +1,152 @@
+/**
+ * Project Index Cache using SQLite
+ *
+ * Lightweight persistent index of project files for smart file selection.
+ * Uses git commits for invalidation instead of time-based TTL.
+ *
+ * @package @ace-sdk/core
+ */
+import type { ImportGraph } from '../services/import-graph.js';
+/**
+ * Entry for a file in the project index
+ */
+export interface ProjectIndexEntry {
+    /** File path relative to repo root */
+    path: string;
+    /** Detected programming language */
+    language: string | null;
+    /** Number of imports */
+    imports: number;
+    /** Number of files importing this */
+    importedBy: number;
+    /** Is a hub file (5+ importers) */
+    isHub: boolean;
+    /** Is an entry point (no dependents) */
+    isEntryPoint: boolean;
+    /** File last modified timestamp */
+    lastModified: number;
+}
+/**
+ * Project metadata stored in the index
+ */
+export interface ProjectMetadata {
+    /** Last indexed git commit */
+    lastCommit: string | null;
+    /** Last indexed timestamp */
+    lastIndexed: number;
+    /** Primary language */
+    primaryLanguage: string | null;
+    /** Total files indexed */
+    totalFiles: number;
+}
+/**
+ * Configuration for project index
+ */
+export interface ProjectIndexConfig {
+    /** Organization ID */
+    orgId: string;
+    /** Project ID */
+    projectId: string;
+    /** Cache directory (defaults to ~/.ace-cache) */
+    cacheDir?: string;
+}
+/**
+ * SQLite-based project file index
+ *
+ * Stores file metadata for smart bootstrap file selection.
+ * Uses git commits for cache invalidation.
+ *
+ * @example
+ * ```typescript
+ * const index = new ProjectIndex({ orgId: 'myorg', projectId: 'myproject' });
+ *
+ * // Check if reindex needed
+ * if (index.needsReindex('/path/to/repo')) {
+ *   const graph = await buildImportGraph({ repoPath: '/path/to/repo' });
+ *   await index.updateFromGraph(graph, '/path/to/repo');
+ * }
+ *
+ * // Get priority files
+ * const hubs = index.getHubFiles(20);
+ * const entries = index.getEntryPoints();
+ * ```
+ */
+export declare class ProjectIndex {
+    private db;
+    private readonly orgId;
+    private readonly projectId;
+    constructor(config: ProjectIndexConfig);
+    /**
+     * Initialize database schema
+     */
+    private initSchema;
+    /**
+     * Update index from import graph analysis
+     */
+    updateFromGraph(graph: ImportGraph, repoPath: string): Promise<void>;
+    /**
+     * Get hub files (most imported)
+     */
+    getHubFiles(limit?: number): string[];
+    /**
+     * Get entry point files
+     */
+    getEntryPoints(): string[];
+    /**
+     * Get files by language
+     */
+    getFilesByLanguage(language: string, limit?: number): string[];
+    /**
+     * Get most imported files (top N by importedBy count)
+     */
+    getMostImported(limit?: number): ProjectIndexEntry[];
+    /**
+     * Get all indexed files
+     */
+    getAllFiles(): string[];
+    /**
+     * Check if reindex is needed based on git commit
+     */
+    needsReindex(repoPath: string): {
+        needsReindex: boolean;
+        changedFiles?: string[];
+    };
+    /**
+     * Get project metadata
+     */
+    getProjectMetadata(): ProjectMetadata;
+    /**
+     * Get metadata value
+     */
+    getMetadata(key: string): string | null;
+    /**
+     * Set metadata value
+     */
+    setMetadata(key: string, value: string): void;
+    /**
+     * Get current git commit hash
+     */
+    private getGitCommit;
+    /**
+     * Get files changed since a commit
+     */
+    private getChangedFilesSince;
+    /**
+     * Close database connection
+     */
+    close(): void;
+    /**
+     * Clear all data from the index
+     */
+    clear(): void;
+    /**
+     * Get index statistics
+     */
+    getStats(): {
+        totalFiles: number;
+        hubFiles: number;
+        entryPoints: number;
+        languages: Record<string, number>;
+    };
+}
+//# sourceMappingURL=project-index.d.ts.map

package/dist/cache/project-index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-index.d.ts","sourceRoot":"","sources":["../../src/cache/project-index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAOH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAM/D;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,oCAAoC;IACpC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,wBAAwB;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,qCAAqC;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,mCAAmC;IACnC,KAAK,EAAE,OAAO,CAAC;IACf,wCAAwC;IACxC,YAAY,EAAE,OAAO,CAAC;IACtB,mCAAmC;IACnC,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,8BAA8B;IAC9B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,6BAA6B;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,uBAAuB;IACvB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,0BAA0B;IAC1B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,sBAAsB;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,iBAAiB;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,iDAAiD;IACjD,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAMD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,EAAE,CAAoB;IAC9B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAEvB,MAAM,EAAE,kBAAkB;IAwBtC;;OAEG;IACH,OAAO,CAAC,UAAU;IA4BlB;;OAEG;IACG,eAAe,CAAC,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAmC1E;;OAEG;IACH,WAAW,CAAC,KAAK,GAAE,MAAW,GAAG,MAAM,EAAE;IAWzC;;OAEG;IACH,cAAc,IAAI,MAAM,EAAE;IAQ1B;;OAEG;IACH,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE;IAY9D;;OAEG;IACH,eAAe,CAAC,KAAK,GAAE,MAAW,GAAG,iBAAiB,EAAE;IAmBxD;;OAEG;IACH,WAAW,IAAI,MAAM,EAAE;IAKvB;;OAEG;IACH,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG;QAAE,YAAY,EAAE,OAAO,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE;IAuBlF;;OAEG;IACH,kBAAkB,IAAI,eAAe;IASrC;;OAEG;IACH,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAQvC;;OAEG;IACH,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAM7C;;OAEG;IACH,OAAO,CAAC,YAAY;IAapB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAa5B;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACH,KAAK,IAAI,IAAI;IAKb;;OAEG;IACH,QAAQ,IAAI;QACV,UAAU,EAAE,MAAM,CAAC;QACnB,QAAQ,EAAE,MAAM,CAAC;QACjB,WAAW,EAAE,MAAM,CAAC;QACpB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KACnC;CAmBF"}

package/dist/cache/project-index.js

@@ -0,0 +1,290 @@
+/**
+ * Project Index Cache using SQLite
+ *
+ * Lightweight persistent index of project files for smart file selection.
+ * Uses git commits for invalidation instead of time-based TTL.
+ *
+ * @package @ace-sdk/core
+ */
+import Database from 'better-sqlite3';
+import { join } from 'path';
+import { homedir } from 'os';
+import { existsSync, mkdirSync } from 'fs';
+import { execSync } from 'child_process';
+// =============================================================================
+// Project Index Class
+// =============================================================================
+/**
+ * SQLite-based project file index
+ *
+ * Stores file metadata for smart bootstrap file selection.
+ * Uses git commits for cache invalidation.
+ *
+ * @example
+ * ```typescript
+ * const index = new ProjectIndex({ orgId: 'myorg', projectId: 'myproject' });
+ *
+ * // Check if reindex needed
+ * if (index.needsReindex('/path/to/repo')) {
+ *   const graph = await buildImportGraph({ repoPath: '/path/to/repo' });
+ *   await index.updateFromGraph(graph, '/path/to/repo');
+ * }
+ *
+ * // Get priority files
+ * const hubs = index.getHubFiles(20);
+ * const entries = index.getEntryPoints();
+ * ```
+ */
+export class ProjectIndex {
+    db;
+    orgId;
+    projectId;
+    constructor(config) {
+        // Store for future use (cross-project features)
+        this.orgId = config.orgId;
+        this.projectId = config.projectId;
+        void this.orgId; // Mark as intentionally unused for now
+        void this.projectId; // Mark as intentionally unused for now
+        // Ensure cache directory exists
+        const cacheDir = config.cacheDir || join(homedir(), '.ace-cache');
+        if (!existsSync(cacheDir)) {
+            mkdirSync(cacheDir, { recursive: true });
+        }
+        // Create database for this org/project
+        const dbPath = join(cacheDir, `${config.orgId}_${config.projectId}_index.db`);
+        this.db = new Database(dbPath);
+        // Enable WAL mode for better performance
+        this.db.pragma('journal_mode = WAL');
+        // Initialize schema
+        this.initSchema();
+    }
+    /**
+     * Initialize database schema
+     */
+    initSchema() {
+        this.db.exec(`
+      -- Files table
+      CREATE TABLE IF NOT EXISTS files (
+        path TEXT PRIMARY KEY,
+        language TEXT,
+        imports INTEGER DEFAULT 0,
+        imported_by INTEGER DEFAULT 0,
+        is_hub INTEGER DEFAULT 0,
+        is_entry_point INTEGER DEFAULT 0,
+        last_modified INTEGER,
+        indexed_at INTEGER
+      );
+
+      -- Project metadata table
+      CREATE TABLE IF NOT EXISTS project_meta (
+        key TEXT PRIMARY KEY,
+        value TEXT
+      );
+
+      -- Indexes for common queries
+      CREATE INDEX IF NOT EXISTS idx_hub ON files(is_hub) WHERE is_hub = 1;
+      CREATE INDEX IF NOT EXISTS idx_entry ON files(is_entry_point) WHERE is_entry_point = 1;
+      CREATE INDEX IF NOT EXISTS idx_language ON files(language);
+      CREATE INDEX IF NOT EXISTS idx_imported_by ON files(imported_by DESC);
+    `);
+    }
+    /**
+     * Update index from import graph analysis
+     */
+    async updateFromGraph(graph, repoPath) {
+        const now = Date.now();
+        const gitCommit = this.getGitCommit(repoPath);
+        const insert = this.db.prepare(`
+      INSERT OR REPLACE INTO files
+      (path, imports, imported_by, is_hub, is_entry_point, indexed_at)
+      VALUES (?, ?, ?, ?, ?, ?)
+    `);
+        const transaction = this.db.transaction(() => {
+            // Clear existing files
+            this.db.exec('DELETE FROM files');
+            // Insert all nodes
+            for (const [path, node] of graph.nodes) {
+                insert.run(path, node.imports.length, node.importedBy.length, node.isHub ? 1 : 0, node.isEntryPoint ? 1 : 0, now);
+            }
+            // Update metadata
+            this.setMetadata('last_commit', gitCommit || '');
+            this.setMetadata('last_indexed', String(now));
+            this.setMetadata('total_files', String(graph.nodes.size));
+        });
+        transaction();
+    }
+    /**
+     * Get hub files (most imported)
+     */
+    getHubFiles(limit = 50) {
+        const rows = this.db.prepare(`
+      SELECT path FROM files
+      WHERE is_hub = 1
+      ORDER BY imported_by DESC
+      LIMIT ?
+    `).all(limit);
+        return rows.map(r => r.path);
+    }
+    /**
+     * Get entry point files
+     */
+    getEntryPoints() {
+        const rows = this.db.prepare(`
+      SELECT path FROM files WHERE is_entry_point = 1
+    `).all();
+        return rows.map(r => r.path);
+    }
+    /**
+     * Get files by language
+     */
+    getFilesByLanguage(language, limit) {
+        const query = limit
+            ? this.db.prepare(`SELECT path FROM files WHERE language = ? LIMIT ?`)
+            : this.db.prepare(`SELECT path FROM files WHERE language = ?`);
+        const rows = (limit
+            ? query.all(language, limit)
+            : query.all(language));
+        return rows.map(r => r.path);
+    }
+    /**
+     * Get most imported files (top N by importedBy count)
+     */
+    getMostImported(limit = 50) {
+        const rows = this.db.prepare(`
+      SELECT path, language, imports, imported_by, is_hub, is_entry_point, last_modified
+      FROM files
+      ORDER BY imported_by DESC
+      LIMIT ?
+    `).all(limit);
+        return rows.map(r => ({
+            path: r.path,
+            language: r.language,
+            imports: r.imports,
+            importedBy: r.imported_by,
+            isHub: Boolean(r.is_hub),
+            isEntryPoint: Boolean(r.is_entry_point),
+            lastModified: r.last_modified
+        }));
+    }
+    /**
+     * Get all indexed files
+     */
+    getAllFiles() {
+        const rows = this.db.prepare(`SELECT path FROM files`).all();
+        return rows.map(r => r.path);
+    }
+    /**
+     * Check if reindex is needed based on git commit
+     */
+    needsReindex(repoPath) {
+        const lastCommit = this.getMetadata('last_commit');
+        const currentCommit = this.getGitCommit(repoPath);
+        // No previous index
+        if (!lastCommit) {
+            return { needsReindex: true };
+        }
+        // Same commit, no changes
+        if (lastCommit === currentCommit) {
+            return { needsReindex: false };
+        }
+        // Get changed files since last index
+        const changedFiles = this.getChangedFilesSince(repoPath, lastCommit);
+        return {
+            needsReindex: true,
+            changedFiles
+        };
+    }
+    /**
+     * Get project metadata
+     */
+    getProjectMetadata() {
+        return {
+            lastCommit: this.getMetadata('last_commit'),
+            lastIndexed: parseInt(this.getMetadata('last_indexed') || '0', 10),
+            primaryLanguage: this.getMetadata('primary_language'),
+            totalFiles: parseInt(this.getMetadata('total_files') || '0', 10)
+        };
+    }
+    /**
+     * Get metadata value
+     */
+    getMetadata(key) {
+        const row = this.db.prepare(`
+      SELECT value FROM project_meta WHERE key = ?
+    `).get(key);
+        return row?.value || null;
+    }
+    /**
+     * Set metadata value
+     */
+    setMetadata(key, value) {
+        this.db.prepare(`
+      INSERT OR REPLACE INTO project_meta (key, value) VALUES (?, ?)
+    `).run(key, value);
+    }
+    /**
+     * Get current git commit hash
+     */
+    getGitCommit(repoPath) {
+        try {
+            const result = execSync('git rev-parse HEAD', {
+                cwd: repoPath,
+                encoding: 'utf8',
+                stdio: ['pipe', 'pipe', 'pipe']
+            });
+            return result.trim();
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Get files changed since a commit
+     */
+    getChangedFilesSince(repoPath, commit) {
+        try {
+            const result = execSync(`git diff --name-only ${commit}..HEAD`, {
+                cwd: repoPath,
+                encoding: 'utf8',
+                stdio: ['pipe', 'pipe', 'pipe']
+            });
+            return result.trim().split('\n').filter(Boolean);
+        }
+        catch {
+            return [];
+        }
+    }
+    /**
+     * Close database connection
+     */
+    close() {
+        this.db.close();
+    }
+    /**
+     * Clear all data from the index
+     */
+    clear() {
+        this.db.exec('DELETE FROM files');
+        this.db.exec('DELETE FROM project_meta');
+    }
+    /**
+     * Get index statistics
+     */
+    getStats() {
+        const totalFiles = this.db.prepare('SELECT COUNT(*) as count FROM files').get().count;
+        const hubFiles = this.db.prepare('SELECT COUNT(*) as count FROM files WHERE is_hub = 1').get().count;
+        const entryPoints = this.db.prepare('SELECT COUNT(*) as count FROM files WHERE is_entry_point = 1').get().count;
+        const langRows = this.db.prepare(`
+      SELECT language, COUNT(*) as count
+      FROM files
+      WHERE language IS NOT NULL
+      GROUP BY language
+    `).all();
+        const languages = {};
+        for (const row of langRows) {
+            languages[row.language] = row.count;
+        }
+        return { totalFiles, hubFiles, entryPoints, languages };
+    }
+}
+//# sourceMappingURL=project-index.js.map

package/dist/cache/project-index.js.map

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

package/dist/index.d.ts

@@ -29,4 +29,16 @@ export type { SemanticVersion } from './utils/semver.js';
 export { parseVersion, compareVersions, satisfiesVersion } from './utils/semver.js';
 export type { CodeBlock } from './utils/code-extractor.js';
 export { extractFunctionBodies, isInteresting, extractCodeBlocksFromMarkdown, extractAddedLinesFromDiff } from './utils/code-extractor.js';
+export type { LanguageStats as ProjectLanguageStats, ProjectType, FrameworkInfo, GraphMetrics, CodeHealthMetrics, PatternDetection, Recommendation, ProjectDNA, StoreProjectDNARequest, StoreProjectDNAResponse } from './types/project-dna.js';
+export { createEmptyProjectDNA } from './types/project-dna.js';
+export type { PlaybookSection, BootstrapStage, BootstrapStatistics, ReceivedStageData, AnalyzingStageData, SynthesizingStageData, MergingStageData, DoneStageData, ErrorStageData, BootstrapStageData, BootstrapSSEEvent, BootstrapEventType, BootstrapStartedData, BootstrapProgressData, BootstrapPatternsData, BootstrapHealthData, BootstrapCompleteData, BootstrapErrorData, BootstrapEventData } from './types/bootstrap-events.js';
+export { BOOTSTRAP_STAGE_LABELS, isReceivedEvent, isAnalyzingEvent, isSynthesizingEvent, isMergingEvent, isDoneEvent, isErrorEvent, isTerminalEvent, isStartedEvent, isStageEvent, isProgressEvent, isPatternsEvent, isHealthEvent, isCompleteEvent } from './types/bootstrap-events.js';
+export type { LanguageStats, LanguageAnalysisOptions } from './services/language-detector.js';
+export { LanguageDetector, DEFAULT_IGNORED_PATTERNS, DEFAULT_CATEGORIES } from './services/language-detector.js';
+export type { FileNode, ImportGraph, ImportGraphOptions } from './services/import-graph.js';
+export { buildImportGraph, selectPriorityFiles, graphToMetrics, calculateHealthMetrics, DEFAULT_IGNORE_PATHS, HUB_THRESHOLD } from './services/import-graph.js';
+export type { ProjectIndexEntry, ProjectMetadata, ProjectIndexConfig } from './cache/project-index.js';
+export { ProjectIndex } from './cache/project-index.js';
+export type { BootstrapStreamOptions, BootstrapStreamResult } from './services/bootstrap-stream.js';
+export { bootstrapWithStreaming, bootstrapWithoutStreaming } from './services/bootstrap-stream.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,YAAY,EAEV,cAAc,EACd,aAAa,EACb,cAAc,EACd,cAAc,EACd,kBAAkB,EAClB,kBAAkB,EAClB,cAAc,EACd,UAAU,EACV,cAAc,EACd,aAAa,EAGb,aAAa,EACb,0BAA0B,EAC1B,4BAA4B,EAG5B,iBAAiB,EACjB,aAAa,EACb,iBAAiB,EACjB,kBAAkB,EAGlB,kBAAkB,EAClB,gBAAgB,EAGhB,mBAAmB,EACnB,mBAAmB,EACnB,sBAAsB,EACtB,aAAa,EACd,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAEhF,YAAY,EAEV,SAAS,EACT,SAAS,EACT,UAAU,EACV,YAAY,EACZ,kBAAkB,EAClB,eAAe,EACf,qBAAqB,EACrB,cAAc,EACf,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAM7D,YAAY,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAM9C,OAAO,EAEL,UAAU,EACV,aAAa,EACb,YAAY,EACb,MAAM,oBAAoB,CAAC;AAE5B,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE5E,OAAO,EAEL,UAAU,EACV,sBAAsB,EACtB,mBAAmB,EACnB,gBAAgB,EAChB,iBAAiB,EACjB,qBAAqB,EACrB,oBAAoB,EACrB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAEL,aAAa,EACb,eAAe,EACf,WAAW,EACZ,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAEL,cAAc,EACd,UAAU,EACV,iBAAiB,EACjB,mBAAmB,EACnB,qBAAqB,EACrB,iBAAiB,EACjB,cAAc,EACd,cAAc,EACf,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAEL,cAAc,EACd,YAAY,EACZ,gBAAgB,EAChB,aAAa,EACd,MAAM,qBAAqB,CAAC;AAM7B,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,YAAY,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAM/D,OAAO,EAEL,iBAAiB,EAClB,MAAM,wBAAwB,CAAC;AAEhC,YAAY,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAE1D,OAAO,EAEL,cAAc,EACf,MAAM,4BAA4B,CAAC;AAEpC,YAAY,EACV,oBAAoB,EACpB,UAAU,EACV,gBAAgB,EACjB,MAAM,4BAA4B,CAAC;AAMpC,YAAY,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEzD,OAAO,EAEL,YAAY,EACZ,eAAe,EACf,gBAAgB,EACjB,MAAM,mBAAmB,CAAC;AAE3B,YAAY,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAE3D,OAAO,EAEL,qBAAqB,EACrB,aAAa,EACb,6BAA6B,EAC7B,yBAAyB,EAC1B,MAAM,2BAA2B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -47,4 +47,14 @@ parseVersion, compareVersions, satisfiesVersion } from './utils/semver.js';
 export { 
 // Code extraction
 extractFunctionBodies, isInteresting, extractCodeBlocksFromMarkdown, extractAddedLinesFromDiff } from './utils/code-extractor.js';
+export { createEmptyProjectDNA } from './types/project-dna.js';
+export { BOOTSTRAP_STAGE_LABELS, 
+// New type guards (v3.13.0)
+isReceivedEvent, isAnalyzingEvent, isSynthesizingEvent, isMergingEvent, isDoneEvent, isErrorEvent, isTerminalEvent, 
+// Legacy type guards (deprecated)
+isStartedEvent, isStageEvent, isProgressEvent, isPatternsEvent, isHealthEvent, isCompleteEvent } from './types/bootstrap-events.js';
+export { LanguageDetector, DEFAULT_IGNORED_PATTERNS, DEFAULT_CATEGORIES } from './services/language-detector.js';
+export { buildImportGraph, selectPriorityFiles, graphToMetrics, calculateHealthMetrics, DEFAULT_IGNORE_PATHS, HUB_THRESHOLD } from './services/import-graph.js';
+export { ProjectIndex } from './cache/project-index.js';
+export { bootstrapWithStreaming, bootstrapWithoutStreaming } from './services/bootstrap-stream.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAyCH,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAchF,OAAO,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAO7D,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,gFAAgF;AAChF,gBAAgB;AAChB,gFAAgF;AAEhF,OAAO;AACL,gBAAgB;AAChB,UAAU,EACV,aAAa,EACb,YAAY,EACb,MAAM,oBAAoB,CAAC;AAI5B,OAAO;AACL,oBAAoB;AACpB,UAAU,EACV,sBAAsB,EACtB,mBAAmB,EACnB,gBAAgB,EAChB,iBAAiB,EACjB,qBAAqB,EACrB,oBAAoB,EACrB,MAAM,iBAAiB,CAAC;AAEzB,OAAO;AACL,mBAAmB;AACnB,aAAa,EACb,eAAe,EACf,WAAW,EACZ,MAAM,uBAAuB,CAAC;AAE/B,OAAO;AACL,iBAAiB;AACjB,cAAc,EACd,UAAU,EACV,iBAAiB,EACjB,mBAAmB,EACnB,qBAAqB,EACrB,iBAAiB,EACjB,cAAc,EACd,cAAc,EACf,MAAM,qBAAqB,CAAC;AAE7B,OAAO;AACL,qBAAqB;AACrB,cAAc,EACd,YAAY,EACZ,gBAAgB,EAChB,aAAa,EACd,MAAM,qBAAqB,CAAC;AAE7B,gFAAgF;AAChF,SAAS;AACT,gFAAgF;AAEhF,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAGnD,gFAAgF;AAChF,QAAQ;AACR,gFAAgF;AAEhF,OAAO;AACL,qBAAqB;AACrB,iBAAiB,EAClB,MAAM,wBAAwB,CAAC;AAIhC,OAAO;AACL,sCAAsC;AACtC,cAAc,EACf,MAAM,4BAA4B,CAAC;AAcpC,OAAO;AACL,sBAAsB;AACtB,YAAY,EACZ,eAAe,EACf,gBAAgB,EACjB,MAAM,mBAAmB,CAAC;AAI3B,OAAO;AACL,kBAAkB;AAClB,qBAAqB,EACrB,aAAa,EACb,6BAA6B,EAC7B,yBAAyB,EAC1B,MAAM,2BAA2B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAyCH,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAchF,OAAO,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAO7D,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,gFAAgF;AAChF,gBAAgB;AAChB,gFAAgF;AAEhF,OAAO;AACL,gBAAgB;AAChB,UAAU,EACV,aAAa,EACb,YAAY,EACb,MAAM,oBAAoB,CAAC;AAI5B,OAAO;AACL,oBAAoB;AACpB,UAAU,EACV,sBAAsB,EACtB,mBAAmB,EACnB,gBAAgB,EAChB,iBAAiB,EACjB,qBAAqB,EACrB,oBAAoB,EACrB,MAAM,iBAAiB,CAAC;AAEzB,OAAO;AACL,mBAAmB;AACnB,aAAa,EACb,eAAe,EACf,WAAW,EACZ,MAAM,uBAAuB,CAAC;AAE/B,OAAO;AACL,iBAAiB;AACjB,cAAc,EACd,UAAU,EACV,iBAAiB,EACjB,mBAAmB,EACnB,qBAAqB,EACrB,iBAAiB,EACjB,cAAc,EACd,cAAc,EACf,MAAM,qBAAqB,CAAC;AAE7B,OAAO;AACL,qBAAqB;AACrB,cAAc,EACd,YAAY,EACZ,gBAAgB,EAChB,aAAa,EACd,MAAM,qBAAqB,CAAC;AAE7B,gFAAgF;AAChF,SAAS;AACT,gFAAgF;AAEhF,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAGnD,gFAAgF;AAChF,QAAQ;AACR,gFAAgF;AAEhF,OAAO;AACL,qBAAqB;AACrB,iBAAiB,EAClB,MAAM,wBAAwB,CAAC;AAIhC,OAAO;AACL,sCAAsC;AACtC,cAAc,EACf,MAAM,4BAA4B,CAAC;AAcpC,OAAO;AACL,sBAAsB;AACtB,YAAY,EACZ,eAAe,EACf,gBAAgB,EACjB,MAAM,mBAAmB,CAAC;AAI3B,OAAO;AACL,kBAAkB;AAClB,qBAAqB,EACrB,aAAa,EACb,6BAA6B,EAC7B,yBAAyB,EAC1B,MAAM,2BAA2B,CAAC;AAmBnC,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AA8B/D,OAAO,EACL,sBAAsB;AACtB,4BAA4B;AAC5B,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,cAAc,EACd,WAAW,EACX,YAAY,EACZ,eAAe;AACf,kCAAkC;AAClC,cAAc,EACd,YAAY,EACZ,eAAe,EACf,eAAe,EACf,aAAa,EACb,eAAe,EAChB,MAAM,6BAA6B,CAAC;AAWrC,OAAO,EACL,gBAAgB,EAChB,wBAAwB,EACxB,kBAAkB,EACnB,MAAM,iCAAiC,CAAC;AAYzC,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,cAAc,EACd,sBAAsB,EACtB,oBAAoB,EACpB,aAAa,EACd,MAAM,4BAA4B,CAAC;AAYpC,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAWxD,OAAO,EACL,sBAAsB,EACtB,yBAAyB,EAC1B,MAAM,gCAAgC,CAAC"}

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"}