agentic-qe 2.6.2 → 2.6.4

package/dist/code-intelligence/inference/types.d.ts

@@ -0,0 +1,196 @@
+/**
+ * C4 Model Inference Types
+ *
+ * Consolidated type definitions for all C4 model inference components.
+ * All interfaces are defined here to ensure consistency across the module.
+ */
+export type SystemType = 'microservice' | 'monolith' | 'library' | 'cli';
+export type ContainerType = 'application' | 'database' | 'cache' | 'queue' | 'service' | 'api';
+export type ExternalSystemType = 'database' | 'api' | 'cache' | 'queue' | 'storage' | 'auth' | 'monitoring';
+export type RelationshipType = 'uses' | 'stores_data_in' | 'sends_messages_to' | 'authenticates_with' | 'depends_on' | 'calls' | 'imports';
+/**
+ * Project metadata for C4 Context and Container diagrams
+ */
+export interface ProjectMetadata {
+    /** System/project name */
+    name: string;
+    /** Human-readable description */
+    description?: string;
+    /** Type of system architecture */
+    systemType: SystemType;
+    /** Primary technology stack */
+    technology: string;
+    /** Containers within the system */
+    containers: Container[];
+    /** Detected architectural layers */
+    layers?: string[];
+    /** Version from package.json */
+    version?: string;
+    /** Repository URL */
+    repository?: string;
+}
+/**
+ * External system that the project interacts with
+ */
+export interface ExternalSystem {
+    /** Unique identifier */
+    id: string;
+    /** Display name */
+    name: string;
+    /** Type of external system */
+    type: ExternalSystemType;
+    /** Specific technology (e.g., "PostgreSQL", "Redis") */
+    technology?: string;
+    /** How the system relates to this external system */
+    relationship: 'uses' | 'stores_data_in' | 'sends_messages_to' | 'authenticates_with';
+    /** Human-readable description */
+    description?: string;
+}
+/**
+ * Mapping configuration for detecting external systems from package names
+ */
+export interface ExternalSystemMapping {
+    /** Regex pattern to match package names */
+    packagePattern: RegExp;
+    /** Type of system this package indicates */
+    systemType: ExternalSystemType;
+    /** Technology name */
+    technology: string;
+    /** Default relationship type */
+    relationship: ExternalSystem['relationship'];
+    /** Default description */
+    description?: string;
+}
+/**
+ * Container definition (C4 Level 2)
+ * Represents an application, database, or service within the system
+ */
+export interface Container {
+    /** Unique identifier */
+    id: string;
+    /** Display name */
+    name: string;
+    /** Type of container */
+    type: ContainerType;
+    /** Technology stack */
+    technology: string;
+    /** Human-readable description */
+    description?: string;
+    /** Exposed port (if applicable) */
+    port?: number;
+    /** IDs of containers this depends on */
+    dependencies?: string[];
+}
+/**
+ * Dependency relationship between containers
+ */
+export interface ContainerDependency {
+    /** Source container ID */
+    fromId: string;
+    /** Target container ID */
+    toId: string;
+    /** Type of dependency */
+    type: 'uses' | 'depends_on' | 'calls';
+    /** Communication protocol (e.g., "HTTP", "gRPC") */
+    protocol?: string;
+}
+/**
+ * Component within a container (C4 Level 3)
+ */
+export interface Component {
+    /** Unique identifier */
+    id: string;
+    /** Display name */
+    name: string;
+    /** Type of component */
+    type: 'layer' | 'module' | 'feature' | 'package';
+    /** Human-readable description */
+    description?: string;
+    /** Technology/framework */
+    technology?: string;
+    /** Files belonging to this component */
+    files: string[];
+    /** Component responsibilities */
+    responsibilities?: string[];
+    /** Boundary/container this belongs to */
+    boundary?: string;
+}
+/**
+ * Relationship between components
+ */
+export interface ComponentRelationship {
+    /** Source component ID */
+    sourceId: string;
+    /** Target component ID */
+    targetId: string;
+    /** Type of relationship */
+    type: 'imports' | 'calls' | 'uses' | 'depends_on';
+    /** Number of references (for weighting) */
+    count?: number;
+}
+/**
+ * Configuration for component boundary detection
+ */
+export interface ComponentBoundaryConfig {
+    /** Root directory to analyze */
+    rootDir: string;
+    /** Minimum files for a component */
+    minFilesPerComponent: number;
+    /** Whether to analyze import relationships */
+    analyzeImports: boolean;
+    /** Glob patterns to exclude */
+    excludePatterns: string[];
+    /** Maximum directory depth */
+    maxDepth: number;
+}
+/**
+ * Result of component boundary analysis
+ */
+export interface ComponentAnalysisResult {
+    /** Detected components */
+    components: Component[];
+    /** Relationships between components */
+    relationships: ComponentRelationship[];
+    /** Analysis metadata */
+    metadata: AnalysisMetadata;
+    /** Detected architecture pattern */
+    architecture?: 'layered' | 'modular' | 'feature' | 'mixed';
+}
+/**
+ * Metadata about an analysis run
+ */
+export interface AnalysisMetadata {
+    /** Timestamp of analysis */
+    timestamp: number;
+    /** Duration in milliseconds */
+    durationMs: number;
+    /** Number of files analyzed */
+    filesAnalyzed: number;
+    /** Number of containers detected */
+    containersDetected: number;
+    /** Number of layers detected */
+    layersDetected: number;
+}
+/**
+ * Technology detection configuration
+ */
+export interface TechnologyDetectionConfig {
+    enableFrameworkDetection: boolean;
+    enableDatabaseDetection: boolean;
+    enableInfrastructureDetection: boolean;
+    customTechnologies?: Record<string, string>;
+}
+/**
+ * C4 diagram generation options
+ */
+export interface C4DiagramOptions {
+    /** Include user personas */
+    includeUsers?: boolean;
+    /** Include external systems */
+    includeExternalSystems?: boolean;
+    /** Maximum components to show */
+    maxComponents?: number;
+    /** Show labels on relationships */
+    showRelationshipLabels?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/code-intelligence/inference/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/code-intelligence/inference/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,MAAM,MAAM,UAAU,GAAG,cAAc,GAAG,UAAU,GAAG,SAAS,GAAG,KAAK,CAAC;AAEzE,MAAM,MAAM,aAAa,GACrB,aAAa,GACb,UAAU,GACV,OAAO,GACP,OAAO,GACP,SAAS,GACT,KAAK,CAAC;AAEV,MAAM,MAAM,kBAAkB,GAC1B,UAAU,GACV,KAAK,GACL,OAAO,GACP,OAAO,GACP,SAAS,GACT,MAAM,GACN,YAAY,CAAC;AAEjB,MAAM,MAAM,gBAAgB,GACxB,MAAM,GACN,gBAAgB,GAChB,mBAAmB,GACnB,oBAAoB,GACpB,YAAY,GACZ,OAAO,GACP,SAAS,CAAC;AAMd;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,iCAAiC;IACjC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kCAAkC;IAClC,UAAU,EAAE,UAAU,CAAC;IACvB,+BAA+B;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,mCAAmC;IACnC,UAAU,EAAE,SAAS,EAAE,CAAC;IACxB,oCAAoC;IACpC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,gCAAgC;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qBAAqB;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,wBAAwB;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,8BAA8B;IAC9B,IAAI,EAAE,kBAAkB,CAAC;IACzB,wDAAwD;IACxD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qDAAqD;IACrD,YAAY,EAAE,MAAM,GAAG,gBAAgB,GAAG,mBAAmB,GAAG,oBAAoB,CAAC;IACrF,iCAAiC;IACjC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,2CAA2C;IAC3C,cAAc,EAAE,MAAM,CAAC;IACvB,4CAA4C;IAC5C,UAAU,EAAE,kBAAkB,CAAC;IAC/B,sBAAsB;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,gCAAgC;IAChC,YAAY,EAAE,cAAc,CAAC,cAAc,CAAC,CAAC;IAC7C,0BAA0B;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAMD;;;GAGG;AACH,MAAM,WAAW,SAAS;IACxB,wBAAwB;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,wBAAwB;IACxB,IAAI,EAAE,aAAa,CAAC;IACpB,uBAAuB;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,iCAAiC;IACjC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mCAAmC;IACnC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,wCAAwC;IACxC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,0BAA0B;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,yBAAyB;IACzB,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,OAAO,CAAC;IACtC,oDAAoD;IACpD,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAMD;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,wBAAwB;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,wBAAwB;IACxB,IAAI,EAAE,OAAO,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,CAAC;IACjD,iCAAiC;IACjC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2BAA2B;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,wCAAwC;IACxC,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,iCAAiC;IACjC,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,yCAAyC;IACzC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,0BAA0B;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,0BAA0B;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,2BAA2B;IAC3B,IAAI,EAAE,SAAS,GAAG,OAAO,GAAG,MAAM,GAAG,YAAY,CAAC;IAClD,2CAA2C;IAC3C,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,gCAAgC;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,oCAAoC;IACpC,oBAAoB,EAAE,MAAM,CAAC;IAC7B,8CAA8C;IAC9C,cAAc,EAAE,OAAO,CAAC;IACxB,+BAA+B;IAC/B,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,8BAA8B;IAC9B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,0BAA0B;IAC1B,UAAU,EAAE,SAAS,EAAE,CAAC;IACxB,uCAAuC;IACvC,aAAa,EAAE,qBAAqB,EAAE,CAAC;IACvC,wBAAwB;IACxB,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,oCAAoC;IACpC,YAAY,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC;CAC5D;AAMD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,4BAA4B;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,+BAA+B;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,+BAA+B;IAC/B,aAAa,EAAE,MAAM,CAAC;IACtB,oCAAoC;IACpC,kBAAkB,EAAE,MAAM,CAAC;IAC3B,gCAAgC;IAChC,cAAc,EAAE,MAAM,CAAC;CACxB;AAMD;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,wBAAwB,EAAE,OAAO,CAAC;IAClC,uBAAuB,EAAE,OAAO,CAAC;IACjC,6BAA6B,EAAE,OAAO,CAAC;IACvC,kBAAkB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC7C;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,4BAA4B;IAC5B,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,+BAA+B;IAC/B,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,iCAAiC;IACjC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,mCAAmC;IACnC,sBAAsB,CAAC,EAAE,OAAO,CAAC;CAClC"}

package/dist/code-intelligence/inference/types.js

@@ -0,0 +1,9 @@
+"use strict";
+/**
+ * C4 Model Inference Types
+ *
+ * Consolidated type definitions for all C4 model inference components.
+ * All interfaces are defined here to ensure consistency across the module.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/code-intelligence/inference/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/code-intelligence/inference/types.ts"],"names":[],"mappings":";AAAA;;;;;GAKG"}

package/dist/code-intelligence/visualization/C4ComponentDiagramBuilder.d.ts

@@ -0,0 +1,75 @@
+import type { Component, ComponentRelationship } from '../inference/types.js';
+/**
+ * Builds C4 Component diagrams in Mermaid syntax
+ *
+ * Component diagrams show the internal structure of a container, breaking it down
+ * into components and showing their relationships. Components are typically classes,
+ * modules, or services within a container.
+ *
+ * @example
+ * ```typescript
+ * const builder = new C4ComponentDiagramBuilder();
+ * const diagram = builder.build('API Application', components, relationships);
+ * ```
+ */
+export declare class C4ComponentDiagramBuilder {
+    /**
+     * Build a C4 Component diagram in Mermaid syntax
+     *
+     * @param containerName - Name of the container being detailed
+     * @param components - List of components within the container
+     * @param relationships - Relationships between components
+     * @returns Mermaid C4Component diagram as string
+     */
+    build(containerName: string, components: Component[], relationships: ComponentRelationship[]): string;
+    /**
+     * Group components by their boundary
+     *
+     * @param components - List of components
+     * @returns Map of boundary name to components
+     */
+    private groupByBoundary;
+    /**
+     * Format a component definition
+     *
+     * @param component - Component to format
+     * @returns Mermaid Component definition
+     */
+    private formatComponent;
+    /**
+     * Infer technology/type for component
+     *
+     * @param component - Component to analyze
+     * @returns Technology description
+     */
+    private inferTechnology;
+    /**
+     * Get description for component
+     *
+     * @param component - Component to describe
+     * @returns Description text
+     */
+    private getComponentDescription;
+    /**
+     * Generate relationships between components
+     *
+     * @param relationships - List of component relationships
+     * @returns Mermaid Rel definitions
+     */
+    private generateComponentRelationships;
+    /**
+     * Get description for relationship
+     *
+     * @param relationship - Component relationship
+     * @returns Relationship description
+     */
+    private getRelationshipDescription;
+    /**
+     * Sanitize name for Mermaid syntax
+     *
+     * @param name - Original name
+     * @returns Sanitized name
+     */
+    private sanitizeName;
+}
+//# sourceMappingURL=C4ComponentDiagramBuilder.d.ts.map

package/dist/code-intelligence/visualization/C4ComponentDiagramBuilder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"C4ComponentDiagramBuilder.d.ts","sourceRoot":"","sources":["../../../src/code-intelligence/visualization/C4ComponentDiagramBuilder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAE9E;;;;;;;;;;;;GAYG;AACH,qBAAa,yBAAyB;IACpC;;;;;;;OAOG;IACH,KAAK,CACH,aAAa,EAAE,MAAM,EACrB,UAAU,EAAE,SAAS,EAAE,EACvB,aAAa,EAAE,qBAAqB,EAAE,GACrC,MAAM;IA2CT;;;;;OAKG;IACH,OAAO,CAAC,eAAe;IAcvB;;;;;OAKG;IACH,OAAO,CAAC,eAAe;IAQvB;;;;;OAKG;IACH,OAAO,CAAC,eAAe;IAmEvB;;;;;OAKG;IACH,OAAO,CAAC,uBAAuB;IA6D/B;;;;;OAKG;IACH,OAAO,CAAC,8BAA8B;IAsBtC;;;;;OAKG;IACH,OAAO,CAAC,0BAA0B;IAmBlC;;;;;OAKG;IACH,OAAO,CAAC,YAAY;CAQrB"}

package/dist/code-intelligence/visualization/C4ComponentDiagramBuilder.js

@@ -0,0 +1,267 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.C4ComponentDiagramBuilder = void 0;
+/**
+ * Builds C4 Component diagrams in Mermaid syntax
+ *
+ * Component diagrams show the internal structure of a container, breaking it down
+ * into components and showing their relationships. Components are typically classes,
+ * modules, or services within a container.
+ *
+ * @example
+ * ```typescript
+ * const builder = new C4ComponentDiagramBuilder();
+ * const diagram = builder.build('API Application', components, relationships);
+ * ```
+ */
+class C4ComponentDiagramBuilder {
+    /**
+     * Build a C4 Component diagram in Mermaid syntax
+     *
+     * @param containerName - Name of the container being detailed
+     * @param components - List of components within the container
+     * @param relationships - Relationships between components
+     * @returns Mermaid C4Component diagram as string
+     */
+    build(containerName, components, relationships) {
+        const lines = [
+            'C4Component',
+            `  title Component diagram for ${containerName}`,
+            '',
+        ];
+        if (components.length === 0) {
+            lines.push('  Component(empty, "No Components", "N/A", "No components detected")');
+            return lines.join('\n');
+        }
+        // Group components by boundary if they have one
+        const grouped = this.groupByBoundary(components);
+        // Add components with boundaries
+        for (const [boundary, boundaryComponents] of grouped.entries()) {
+            if (boundary) {
+                const boundaryId = this.sanitizeName(boundary);
+                lines.push(`  Container_Boundary(${boundaryId}, "${boundary}") {`);
+                for (const component of boundaryComponents) {
+                    lines.push('  ' + this.formatComponent(component));
+                }
+                lines.push('  }');
+            }
+            else {
+                // Components without boundary
+                for (const component of boundaryComponents) {
+                    lines.push(this.formatComponent(component));
+                }
+            }
+        }
+        // Add relationships
+        if (relationships.length > 0) {
+            lines.push('');
+            lines.push(this.generateComponentRelationships(relationships));
+        }
+        return lines.filter(line => line !== undefined && line !== '').join('\n');
+    }
+    /**
+     * Group components by their boundary
+     *
+     * @param components - List of components
+     * @returns Map of boundary name to components
+     */
+    groupByBoundary(components) {
+        const grouped = new Map();
+        for (const component of components) {
+            const boundary = component.boundary || '';
+            if (!grouped.has(boundary)) {
+                grouped.set(boundary, []);
+            }
+            grouped.get(boundary).push(component);
+        }
+        return grouped;
+    }
+    /**
+     * Format a component definition
+     *
+     * @param component - Component to format
+     * @returns Mermaid Component definition
+     */
+    formatComponent(component) {
+        const id = this.sanitizeName(component.name);
+        const technology = this.inferTechnology(component);
+        const description = this.getComponentDescription(component);
+        return `  Component(${id}, "${component.name}", "${technology}", "${description}")`;
+    }
+    /**
+     * Infer technology/type for component
+     *
+     * @param component - Component to analyze
+     * @returns Technology description
+     */
+    inferTechnology(component) {
+        const name = component.name.toLowerCase();
+        // Controllers
+        if (name.includes('controller') || name.endsWith('ctrl')) {
+            return 'MVC Controller';
+        }
+        // Services
+        if (name.includes('service') || name.endsWith('svc')) {
+            return 'Service Component';
+        }
+        // Repositories/DAOs
+        if (name.includes('repository') || name.includes('dao') || name.includes('store')) {
+            return 'Data Access Object';
+        }
+        // Middleware
+        if (name.includes('middleware') || name.includes('guard') || name.includes('interceptor')) {
+            return 'Middleware';
+        }
+        // Validators
+        if (name.includes('validator') || name.includes('validation')) {
+            return 'Validator';
+        }
+        // Utilities
+        if (name.includes('util') || name.includes('helper') || name.includes('helper')) {
+            return 'Utility Component';
+        }
+        // Security
+        if (name.includes('auth') || name.includes('security') || name.includes('jwt')) {
+            return 'Security Component';
+        }
+        // Models/Entities
+        if (name.includes('model') || name.includes('entity') || name.includes('schema')) {
+            return 'Data Model';
+        }
+        // Handlers
+        if (name.includes('handler') || name.includes('processor')) {
+            return 'Event Handler';
+        }
+        // Adapters
+        if (name.includes('adapter') || name.includes('client')) {
+            return 'External Adapter';
+        }
+        // Default based on file extension or generic
+        if (component.type) {
+            const typeMap = {
+                class: 'Class Component',
+                interface: 'Interface',
+                function: 'Function Component',
+                module: 'Module',
+            };
+            return typeMap[component.type] || 'Component';
+        }
+        return 'Component';
+    }
+    /**
+     * Get description for component
+     *
+     * @param component - Component to describe
+     * @returns Description text
+     */
+    getComponentDescription(component) {
+        const name = component.name.toLowerCase();
+        // Controllers
+        if (name.includes('controller')) {
+            return 'Handles HTTP requests and responses';
+        }
+        // Services
+        if (name.includes('service')) {
+            return 'Implements business logic';
+        }
+        // Repositories
+        if (name.includes('repository') || name.includes('dao')) {
+            return 'Manages data persistence';
+        }
+        // Authentication
+        if (name.includes('auth')) {
+            return 'Provides authentication and authorization';
+        }
+        // Validation
+        if (name.includes('validator')) {
+            return 'Validates input data';
+        }
+        // Middleware
+        if (name.includes('middleware')) {
+            return 'Processes requests in pipeline';
+        }
+        // Utilities
+        if (name.includes('util') || name.includes('helper')) {
+            return 'Provides utility functions';
+        }
+        // Handlers
+        if (name.includes('handler')) {
+            return 'Handles events and messages';
+        }
+        // Adapters
+        if (name.includes('adapter')) {
+            return 'Adapts external interfaces';
+        }
+        // Models
+        if (name.includes('model') || name.includes('entity')) {
+            return 'Represents data structure';
+        }
+        // Default description
+        if (component.responsibilities && component.responsibilities.length > 0) {
+            return component.responsibilities[0];
+        }
+        return 'Application component';
+    }
+    /**
+     * Generate relationships between components
+     *
+     * @param relationships - List of component relationships
+     * @returns Mermaid Rel definitions
+     */
+    generateComponentRelationships(relationships) {
+        const lines = [];
+        const seen = new Set();
+        for (const rel of relationships) {
+            const fromId = this.sanitizeName(rel.sourceId);
+            const toId = this.sanitizeName(rel.targetId);
+            // Avoid duplicate relationships
+            const relKey = `${fromId}-${toId}-${rel.type}`;
+            if (seen.has(relKey)) {
+                continue;
+            }
+            seen.add(relKey);
+            const description = this.getRelationshipDescription(rel);
+            lines.push(`  Rel(${fromId}, ${toId}, "${description}")`);
+        }
+        return lines.join('\n');
+    }
+    /**
+     * Get description for relationship
+     *
+     * @param relationship - Component relationship
+     * @returns Relationship description
+     */
+    getRelationshipDescription(relationship) {
+        const typeDescriptions = {
+            depends_on: 'Depends on',
+            uses: 'Uses',
+            calls: 'Calls',
+            inherits: 'Inherits from',
+            implements: 'Implements',
+            contains: 'Contains',
+            imports: 'Imports',
+            injects: 'Injects',
+            configures: 'Configures',
+            validates: 'Validates with',
+            handles: 'Handles via',
+            delegates: 'Delegates to',
+        };
+        return typeDescriptions[relationship.type] || 'Uses';
+    }
+    /**
+     * Sanitize name for Mermaid syntax
+     *
+     * @param name - Original name
+     * @returns Sanitized name
+     */
+    sanitizeName(name) {
+        return name
+            .replace(/[^a-zA-Z0-9_\s-]/g, '')
+            .replace(/\s+/g, '_')
+            .replace(/-+/g, '_')
+            .replace(/^_+|_+$/g, '') // Remove leading/trailing underscores
+            .toLowerCase();
+    }
+}
+exports.C4ComponentDiagramBuilder = C4ComponentDiagramBuilder;
+//# sourceMappingURL=C4ComponentDiagramBuilder.js.map

package/dist/code-intelligence/visualization/C4ComponentDiagramBuilder.js.map

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