@ace-sdk/core 2.0.1 → 2.1.0

package/dist/types/bootstrap-events.js

@@ -0,0 +1,103 @@
+/**
+ * Bootstrap SSE Event Types
+ *
+ * Server sends these events during streaming bootstrap.
+ * Client displays progress to user.
+ *
+ * Updated to match ACE Server v3.13.0 response format.
+ *
+ * @package @ace-sdk/core
+ */
+/**
+ * Human-readable labels for stages
+ */
+export const BOOTSTRAP_STAGE_LABELS = {
+    received: 'Receiving code blocks',
+    analyzing: 'Analyzing patterns',
+    synthesizing: 'Synthesizing insights',
+    merging: 'Merging into playbook',
+    done: 'Bootstrap complete',
+    error: 'Error occurred'
+};
+// =============================================================================
+// Type Guards
+// =============================================================================
+/**
+ * Type guard for received stage
+ */
+export function isReceivedEvent(event) {
+    return event.stage === 'received';
+}
+/**
+ * Type guard for analyzing stage
+ */
+export function isAnalyzingEvent(event) {
+    return event.stage === 'analyzing';
+}
+/**
+ * Type guard for synthesizing stage
+ */
+export function isSynthesizingEvent(event) {
+    return event.stage === 'synthesizing';
+}
+/**
+ * Type guard for merging stage
+ */
+export function isMergingEvent(event) {
+    return event.stage === 'merging';
+}
+/**
+ * Type guard for done stage
+ */
+export function isDoneEvent(event) {
+    return event.stage === 'done';
+}
+/**
+ * Type guard for error stage
+ */
+export function isErrorEvent(event) {
+    return event.stage === 'error';
+}
+/**
+ * Check if event is a terminal event (done or error)
+ */
+export function isTerminalEvent(event) {
+    return event.stage === 'done' || event.stage === 'error';
+}
+/**
+ * @deprecated Use isDoneEvent instead
+ */
+export function isCompleteEvent(event) {
+    return event.stage === 'done';
+}
+/**
+ * @deprecated Use isReceivedEvent instead
+ */
+export function isStartedEvent(event) {
+    return event.stage === 'received';
+}
+/**
+ * @deprecated Use isAnalyzingEvent or isSynthesizingEvent instead
+ */
+export function isStageEvent(event) {
+    return ['analyzing', 'synthesizing', 'merging'].includes(event.stage);
+}
+/**
+ * @deprecated Progress is embedded in stage messages
+ */
+export function isProgressEvent(_event) {
+    return false;
+}
+/**
+ * @deprecated Patterns data is in done event
+ */
+export function isPatternsEvent(_event) {
+    return false;
+}
+/**
+ * @deprecated Health data is in done event
+ */
+export function isHealthEvent(_event) {
+    return false;
+}
+//# sourceMappingURL=bootstrap-events.js.map

package/dist/types/bootstrap-events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap-events.js","sourceRoot":"","sources":["../../src/types/bootstrap-events.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AA8BH;;GAEG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAmC;IACpE,QAAQ,EAAE,uBAAuB;IACjC,SAAS,EAAE,oBAAoB;IAC/B,YAAY,EAAE,uBAAuB;IACrC,OAAO,EAAE,uBAAuB;IAChC,IAAI,EAAE,oBAAoB;IAC1B,KAAK,EAAE,gBAAgB;CACxB,CAAC;AAyHF,gFAAgF;AAChF,cAAc;AACd,gFAAgF;AAEhF;;GAEG;AACH,MAAM,UAAU,eAAe,CAC7B,KAAwB;IAExB,OAAO,KAAK,CAAC,KAAK,KAAK,UAAU,CAAC;AACpC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAC9B,KAAwB;IAExB,OAAO,KAAK,CAAC,KAAK,KAAK,WAAW,CAAC;AACrC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CACjC,KAAwB;IAExB,OAAO,KAAK,CAAC,KAAK,KAAK,cAAc,CAAC;AACxC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAC5B,KAAwB;IAExB,OAAO,KAAK,CAAC,KAAK,KAAK,SAAS,CAAC;AACnC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CACzB,KAAwB;IAExB,OAAO,KAAK,CAAC,KAAK,KAAK,MAAM,CAAC;AAChC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAC1B,KAAwB;IAExB,OAAO,KAAK,CAAC,KAAK,KAAK,OAAO,CAAC;AACjC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,KAAwB;IACtD,OAAO,KAAK,CAAC,KAAK,KAAK,MAAM,IAAI,KAAK,CAAC,KAAK,KAAK,OAAO,CAAC;AAC3D,CAAC;AAkBD;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,KAAwB;IACtD,OAAO,KAAK,CAAC,KAAK,KAAK,MAAM,CAAC;AAChC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,KAAwB;IACrD,OAAO,KAAK,CAAC,KAAK,KAAK,UAAU,CAAC;AACpC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,KAAwB;IACnD,OAAO,CAAC,WAAW,EAAE,cAAc,EAAE,SAAS,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;AACxE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,MAAyB;IACvD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,MAAyB;IACvD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,MAAyB;IACrD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/types/project-dna.d.ts

@@ -0,0 +1,151 @@
+/**
+ * Project DNA - Fingerprint for intelligent pattern matching
+ *
+ * Shared schema between @ace-sdk/core and ACE Server.
+ * Server stores this in `projects.settings_json` field.
+ *
+ * @package @ace-sdk/core
+ */
+/**
+ * Language breakdown from linguist-js
+ */
+export interface LanguageStats {
+    /** Language name (e.g., "TypeScript", "Python", "Java") */
+    name: string;
+    /** Percentage of codebase (0-100) */
+    percentage: number;
+    /** Number of files with this language */
+    files: number;
+    /** Total bytes of code */
+    bytes: number;
+}
+/**
+ * Detected project type based on folder structure and dependencies
+ */
+export type ProjectType = 'library' | 'webapp' | 'api-server' | 'cli' | 'monorepo' | 'mobile' | 'unknown';
+/**
+ * Framework detected from dependencies
+ */
+export interface FrameworkInfo {
+    /** Framework name (e.g., "React", "Express", "FastAPI") */
+    name: string;
+    /** Semver version from package.json/requirements.txt */
+    version: string;
+    /** Framework category */
+    category: 'frontend' | 'backend' | 'testing' | 'build' | 'utility';
+}
+/**
+ * Metrics from import graph analysis
+ */
+export interface GraphMetrics {
+    /** Total files in the graph */
+    totalFiles: number;
+    /** Files with 5+ importers (max 20) */
+    hubFiles: string[];
+    /** Files with no dependents (max 10) */
+    entryPoints: string[];
+    /** Files with no dependencies (max 20) */
+    leafNodes: string[];
+    /** Circular dependency chains (max 10) */
+    circularDeps: string[][];
+}
+/**
+ * Code health indicators from static analysis
+ */
+export interface CodeHealthMetrics {
+    /** Percentage of files never imported */
+    deadCodePercentage: number;
+    /** Number of circular dependency chains */
+    circularDepsCount: number;
+    /** Number of unused package.json dependencies */
+    unusedDepsCount: number;
+    /** Average lines per file */
+    avgFileSize: number;
+    /** Largest file (lines) */
+    maxFileSize: number;
+}
+/**
+ * Detected architecture patterns
+ */
+export interface PatternDetection {
+    /** Error handling approach */
+    errorHandling?: 'centralized' | 'distributed' | 'mixed';
+    /** Testing approach */
+    testingApproach?: 'unit' | 'integration' | 'e2e' | 'mixed' | 'none';
+    /** API style */
+    apiStyle?: 'rest' | 'graphql' | 'trpc' | 'grpc' | 'mixed';
+    /** State management solution */
+    stateManagement?: string;
+}
+/**
+ * Recommendation from code analysis
+ */
+export interface Recommendation {
+    /** Priority level */
+    priority: 'high' | 'medium' | 'low';
+    /** Recommendation category */
+    category: 'architecture' | 'performance' | 'maintainability' | 'security';
+    /** Human-readable message */
+    message: string;
+    /** Affected files (optional) */
+    affectedFiles?: string[];
+}
+/**
+ * Complete Project DNA fingerprint
+ *
+ * This is the main data structure sent to the server for storage
+ * and used for cross-project pattern matching.
+ */
+export interface ProjectDNA {
+    /** Organization ID */
+    orgId: string;
+    /** Project ID */
+    projectId: string;
+    /** ISO 8601 timestamp when analyzed */
+    analyzedAt: string;
+    /** Git commit hash at analysis time */
+    gitCommit?: string;
+    /** Detected project type */
+    projectType: ProjectType;
+    /** Language breakdown (sorted by percentage desc) */
+    languages: LanguageStats[];
+    /** Primary language name */
+    primaryLanguage: string;
+    /** Detected frameworks */
+    frameworks: FrameworkInfo[];
+    /** Detected patterns */
+    patterns: PatternDetection;
+    /** Import graph metrics */
+    graph: GraphMetrics;
+    /** Code health metrics */
+    health: CodeHealthMetrics;
+    /** Analysis recommendations */
+    recommendations: Recommendation[];
+}
+/**
+ * Request to store Project DNA on server
+ */
+export interface StoreProjectDNARequest {
+    orgId: string;
+    projectId: string;
+    dna: ProjectDNA;
+}
+/**
+ * Response from server after storing DNA
+ */
+export interface StoreProjectDNAResponse {
+    /** Whether storage succeeded */
+    success: boolean;
+    /** Timestamp when stored */
+    storedAt: string;
+    /** Similar projects for cross-project learning (future) */
+    similarProjects?: {
+        projectId: string;
+        similarity: number;
+    }[];
+}
+/**
+ * Create a default empty ProjectDNA structure
+ */
+export declare function createEmptyProjectDNA(orgId: string, projectId: string): ProjectDNA;
+//# sourceMappingURL=project-dna.d.ts.map

package/dist/types/project-dna.d.ts.map

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

package/dist/types/project-dna.js

@@ -0,0 +1,42 @@
+/**
+ * Project DNA - Fingerprint for intelligent pattern matching
+ *
+ * Shared schema between @ace-sdk/core and ACE Server.
+ * Server stores this in `projects.settings_json` field.
+ *
+ * @package @ace-sdk/core
+ */
+// =============================================================================
+// Builder Helper
+// =============================================================================
+/**
+ * Create a default empty ProjectDNA structure
+ */
+export function createEmptyProjectDNA(orgId, projectId) {
+    return {
+        orgId,
+        projectId,
+        analyzedAt: new Date().toISOString(),
+        projectType: 'unknown',
+        languages: [],
+        primaryLanguage: 'Unknown',
+        frameworks: [],
+        patterns: {},
+        graph: {
+            totalFiles: 0,
+            hubFiles: [],
+            entryPoints: [],
+            leafNodes: [],
+            circularDeps: []
+        },
+        health: {
+            deadCodePercentage: 0,
+            circularDepsCount: 0,
+            unusedDepsCount: 0,
+            avgFileSize: 0,
+            maxFileSize: 0
+        },
+        recommendations: []
+    };
+}
+//# sourceMappingURL=project-dna.js.map

package/dist/types/project-dna.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-dna.js","sourceRoot":"","sources":["../../src/types/project-dna.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AA0MH,gFAAgF;AAChF,iBAAiB;AACjB,gFAAgF;AAEhF;;GAEG;AACH,MAAM,UAAU,qBAAqB,CACnC,KAAa,EACb,SAAiB;IAEjB,OAAO;QACL,KAAK;QACL,SAAS;QACT,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACpC,WAAW,EAAE,SAAS;QACtB,SAAS,EAAE,EAAE;QACb,eAAe,EAAE,SAAS;QAC1B,UAAU,EAAE,EAAE;QACd,QAAQ,EAAE,EAAE;QACZ,KAAK,EAAE;YACL,UAAU,EAAE,CAAC;YACb,QAAQ,EAAE,EAAE;YACZ,WAAW,EAAE,EAAE;YACf,SAAS,EAAE,EAAE;YACb,YAAY,EAAE,EAAE;SACjB;QACD,MAAM,EAAE;YACN,kBAAkB,EAAE,CAAC;YACrB,iBAAiB,EAAE,CAAC;YACpB,eAAe,EAAE,CAAC;YAClB,WAAW,EAAE,CAAC;YACd,WAAW,EAAE,CAAC;SACf;QACD,eAAe,EAAE,EAAE;KACpB,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ace-sdk/core",
-  "version": "2.0.1",
+  "version": "2.1.0",
   "description": "ACE Core - Shared library for ACE pattern learning (HTTP client, caching, config, types)",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -38,7 +38,8 @@
   },
   "dependencies": {
     "better-sqlite3": "^12.4.6",
-    "linguist-js": "^2.9.2"
+    "linguist-js": "^2.9.2",
+    "skott": "^0.35.6"
   },
   "devDependencies": {
     "@types/better-sqlite3": "^7.6.13",