agentic-qe 2.6.1 → 2.6.3

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

@@ -0,0 +1,138 @@
+import type { ProjectMetadata, ExternalSystem } from '../inference/types.js';
+/**
+ * Builds C4 Container diagrams in Mermaid syntax
+ *
+ * Container diagrams show the high-level technology choices and how containers
+ * communicate with each other. Containers represent applications or data stores.
+ *
+ * @example
+ * ```typescript
+ * const builder = new C4ContainerDiagramBuilder();
+ * const diagram = builder.build(metadata, externalSystems);
+ * ```
+ */
+export declare class C4ContainerDiagramBuilder {
+    /**
+     * Build a C4 Container diagram in Mermaid syntax
+     *
+     * @param metadata - Project metadata containing container information
+     * @param externalSystems - Detected external systems
+     * @returns Mermaid C4Container diagram as string
+     */
+    build(metadata: ProjectMetadata, externalSystems: ExternalSystem[]): string;
+    /**
+     * Format a container definition
+     *
+     * @param container - Container to format
+     * @returns Mermaid Container definition
+     */
+    private formatContainer;
+    /**
+     * Format a database container definition
+     *
+     * @param container - Database container to format
+     * @returns Mermaid ContainerDb definition
+     */
+    private formatContainerDb;
+    /**
+     * Format external database as ContainerDb
+     *
+     * @param external - External database system
+     * @returns Mermaid ContainerDb definition
+     */
+    private formatExternalDb;
+    /**
+     * Format external system as Container
+     *
+     * @param external - External system
+     * @returns Mermaid Container definition
+     */
+    private formatExternalContainer;
+    /**
+     * Check if container is a database
+     *
+     * @param container - Container to check
+     * @returns True if container is a database
+     */
+    private isDatabase;
+    /**
+     * Check if external system should be shown in container diagram
+     *
+     * @param external - External system to check
+     * @returns True if relevant for container diagram
+     */
+    private isRelevantExternal;
+    /**
+     * Infer technology stack for container
+     *
+     * @param container - Container to analyze
+     * @returns Technology description
+     */
+    private inferTechnology;
+    /**
+     * Infer database technology
+     *
+     * @param container - Database container
+     * @returns Database technology
+     */
+    private inferDatabaseTechnology;
+    /**
+     * Get external system technology
+     *
+     * @param external - External system
+     * @returns Technology description
+     */
+    private getExternalTechnology;
+    /**
+     * Get container description
+     *
+     * @param container - Container to describe
+     * @returns Description text
+     */
+    private getContainerDescription;
+    /**
+     * Get database description
+     *
+     * @param container - Database container
+     * @returns Description text
+     */
+    private getDatabaseDescription;
+    /**
+     * Generate relationships between containers
+     *
+     * @param containers - List of containers
+     * @returns Mermaid Rel definitions
+     */
+    private generateContainerRelationships;
+    /**
+     * Generate relationships to external systems
+     *
+     * @param containers - Internal containers
+     * @param externals - External systems
+     * @returns Mermaid Rel definitions
+     */
+    private generateExternalRelationships;
+    /**
+     * Infer relationship between two containers
+     *
+     * @param from - Source container
+     * @param to - Target container
+     * @returns Relationship description or null
+     */
+    private inferRelationship;
+    /**
+     * Get relationship description for external system
+     *
+     * @param external - External system
+     * @returns Relationship description
+     */
+    private getExternalRelationship;
+    /**
+     * Sanitize name for Mermaid syntax
+     *
+     * @param name - Original name
+     * @returns Sanitized name
+     */
+    private sanitizeName;
+}
+//# sourceMappingURL=C4ContainerDiagramBuilder.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"C4ContainerDiagramBuilder.d.ts","sourceRoot":"","sources":["../../../src/code-intelligence/visualization/C4ContainerDiagramBuilder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAa,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAExF;;;;;;;;;;;GAWG;AACH,qBAAa,yBAAyB;IACpC;;;;;;OAMG;IACH,KAAK,CAAC,QAAQ,EAAE,eAAe,EAAE,eAAe,EAAE,cAAc,EAAE,GAAG,MAAM;IA2C3E;;;;;OAKG;IACH,OAAO,CAAC,eAAe;IAQvB;;;;;OAKG;IACH,OAAO,CAAC,iBAAiB;IAQzB;;;;;OAKG;IACH,OAAO,CAAC,gBAAgB;IAQxB;;;;;OAKG;IACH,OAAO,CAAC,uBAAuB;IAQ/B;;;;;OAKG;IACH,OAAO,CAAC,UAAU;IAMlB;;;;;OAKG;IACH,OAAO,CAAC,kBAAkB;IAK1B;;;;;OAKG;IACH,OAAO,CAAC,eAAe;IAmBvB;;;;;OAKG;IACH,OAAO,CAAC,uBAAuB;IAa/B;;;;;OAKG;IACH,OAAO,CAAC,qBAAqB;IAgB7B;;;;;OAKG;IACH,OAAO,CAAC,uBAAuB;IAY/B;;;;;OAKG;IACH,OAAO,CAAC,sBAAsB;IAI9B;;;;;OAKG;IACH,OAAO,CAAC,8BAA8B;IA2BtC;;;;;;OAMG;IACH,OAAO,CAAC,6BAA6B;IAoBrC;;;;;;OAMG;IACH,OAAO,CAAC,iBAAiB;IA2BzB;;;;;OAKG;IACH,OAAO,CAAC,uBAAuB;IAa/B;;;;;OAKG;IACH,OAAO,CAAC,YAAY;CAOrB"}

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

@@ -0,0 +1,343 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.C4ContainerDiagramBuilder = void 0;
+/**
+ * Builds C4 Container diagrams in Mermaid syntax
+ *
+ * Container diagrams show the high-level technology choices and how containers
+ * communicate with each other. Containers represent applications or data stores.
+ *
+ * @example
+ * ```typescript
+ * const builder = new C4ContainerDiagramBuilder();
+ * const diagram = builder.build(metadata, externalSystems);
+ * ```
+ */
+class C4ContainerDiagramBuilder {
+    /**
+     * Build a C4 Container diagram in Mermaid syntax
+     *
+     * @param metadata - Project metadata containing container information
+     * @param externalSystems - Detected external systems
+     * @returns Mermaid C4Container diagram as string
+     */
+    build(metadata, externalSystems) {
+        const lines = [
+            'C4Container',
+            `  title Container diagram for ${metadata.name}`,
+            '',
+        ];
+        // Add containers
+        if (metadata.containers.length > 0) {
+            for (const container of metadata.containers) {
+                if (this.isDatabase(container)) {
+                    lines.push(this.formatContainerDb(container));
+                }
+                else {
+                    lines.push(this.formatContainer(container));
+                }
+            }
+            lines.push('');
+        }
+        // Add external systems as containers
+        if (externalSystems.length > 0) {
+            for (const external of externalSystems) {
+                if (external.type === 'database') {
+                    lines.push(this.formatExternalDb(external));
+                }
+                else if (this.isRelevantExternal(external)) {
+                    lines.push(this.formatExternalContainer(external));
+                }
+            }
+            lines.push('');
+        }
+        // Add relationships
+        lines.push(this.generateContainerRelationships(metadata.containers));
+        // Add relationships to external systems
+        if (externalSystems.length > 0) {
+            lines.push('');
+            lines.push(this.generateExternalRelationships(metadata.containers, externalSystems));
+        }
+        return lines.filter(line => line !== undefined && line !== '').join('\n');
+    }
+    /**
+     * Format a container definition
+     *
+     * @param container - Container to format
+     * @returns Mermaid Container definition
+     */
+    formatContainer(container) {
+        const id = this.sanitizeName(container.name);
+        const technology = this.inferTechnology(container);
+        const description = this.getContainerDescription(container);
+        return `  Container(${id}, "${container.name}", "${technology}", "${description}")`;
+    }
+    /**
+     * Format a database container definition
+     *
+     * @param container - Database container to format
+     * @returns Mermaid ContainerDb definition
+     */
+    formatContainerDb(container) {
+        const id = this.sanitizeName(container.name);
+        const technology = this.inferDatabaseTechnology(container);
+        const description = this.getDatabaseDescription(container);
+        return `  ContainerDb(${id}, "${container.name}", "${technology}", "${description}")`;
+    }
+    /**
+     * Format external database as ContainerDb
+     *
+     * @param external - External database system
+     * @returns Mermaid ContainerDb definition
+     */
+    formatExternalDb(external) {
+        const id = this.sanitizeName(external.name);
+        const technology = this.getExternalTechnology(external);
+        const description = external.description || 'External database system';
+        return `  ContainerDb(${id}, "${external.name}", "${technology}", "${description}")`;
+    }
+    /**
+     * Format external system as Container
+     *
+     * @param external - External system
+     * @returns Mermaid Container definition
+     */
+    formatExternalContainer(external) {
+        const id = this.sanitizeName(external.name);
+        const technology = this.getExternalTechnology(external);
+        const description = external.description || 'External system';
+        return `  Container(${id}, "${external.name}", "${technology}", "${description}")`;
+    }
+    /**
+     * Check if container is a database
+     *
+     * @param container - Container to check
+     * @returns True if container is a database
+     */
+    isDatabase(container) {
+        const dbKeywords = ['database', 'db', 'postgres', 'mysql', 'mongo', 'redis', 'cache'];
+        const name = container.name.toLowerCase();
+        return dbKeywords.some(keyword => name.includes(keyword));
+    }
+    /**
+     * Check if external system should be shown in container diagram
+     *
+     * @param external - External system to check
+     * @returns True if relevant for container diagram
+     */
+    isRelevantExternal(external) {
+        const relevantTypes = ['database', 'api', 'service', 'messageQueue', 'cache', 'storage'];
+        return relevantTypes.includes(external.type);
+    }
+    /**
+     * Infer technology stack for container
+     *
+     * @param container - Container to analyze
+     * @returns Technology description
+     */
+    inferTechnology(container) {
+        const name = container.name.toLowerCase();
+        if (name.includes('api') || name.includes('backend')) {
+            return 'Node.js, TypeScript';
+        }
+        if (name.includes('frontend') || name.includes('ui') || name.includes('web')) {
+            return 'React, TypeScript';
+        }
+        if (name.includes('service') || name.includes('worker')) {
+            return 'Node.js';
+        }
+        if (name.includes('gateway') || name.includes('proxy')) {
+            return 'NGINX, Node.js';
+        }
+        return 'Application';
+    }
+    /**
+     * Infer database technology
+     *
+     * @param container - Database container
+     * @returns Database technology
+     */
+    inferDatabaseTechnology(container) {
+        const name = container.name.toLowerCase();
+        if (name.includes('postgres') || name.includes('pg'))
+            return 'PostgreSQL';
+        if (name.includes('mysql'))
+            return 'MySQL';
+        if (name.includes('mongo'))
+            return 'MongoDB';
+        if (name.includes('redis'))
+            return 'Redis';
+        if (name.includes('elastic'))
+            return 'Elasticsearch';
+        if (name.includes('dynamodb'))
+            return 'DynamoDB';
+        return 'Database';
+    }
+    /**
+     * Get external system technology
+     *
+     * @param external - External system
+     * @returns Technology description
+     */
+    getExternalTechnology(external) {
+        const name = external.name.toLowerCase();
+        if (name.includes('postgres'))
+            return 'PostgreSQL';
+        if (name.includes('mysql'))
+            return 'MySQL';
+        if (name.includes('mongo'))
+            return 'MongoDB';
+        if (name.includes('redis'))
+            return 'Redis';
+        if (name.includes('rabbitmq'))
+            return 'RabbitMQ';
+        if (name.includes('kafka'))
+            return 'Apache Kafka';
+        if (name.includes('aws'))
+            return 'AWS Service';
+        if (name.includes('gcp'))
+            return 'GCP Service';
+        if (name.includes('azure'))
+            return 'Azure Service';
+        return 'External Service';
+    }
+    /**
+     * Get container description
+     *
+     * @param container - Container to describe
+     * @returns Description text
+     */
+    getContainerDescription(container) {
+        const name = container.name.toLowerCase();
+        if (name.includes('api'))
+            return 'Provides application functionality via REST API';
+        if (name.includes('frontend'))
+            return 'Delivers web interface to users';
+        if (name.includes('service'))
+            return 'Handles business logic and processing';
+        if (name.includes('worker'))
+            return 'Processes background tasks';
+        if (name.includes('gateway'))
+            return 'Routes and manages API traffic';
+        return 'Application component';
+    }
+    /**
+     * Get database description
+     *
+     * @param container - Database container
+     * @returns Description text
+     */
+    getDatabaseDescription(container) {
+        return 'Stores application data and state';
+    }
+    /**
+     * Generate relationships between containers
+     *
+     * @param containers - List of containers
+     * @returns Mermaid Rel definitions
+     */
+    generateContainerRelationships(containers) {
+        const lines = [];
+        const relationships = new Set();
+        for (const container of containers) {
+            const fromId = this.sanitizeName(container.name);
+            // Find likely relationships based on naming patterns
+            for (const other of containers) {
+                if (container === other)
+                    continue;
+                const toId = this.sanitizeName(other.name);
+                const relationship = this.inferRelationship(container, other);
+                if (relationship) {
+                    const relKey = `${fromId}-${toId}`;
+                    if (!relationships.has(relKey)) {
+                        relationships.add(relKey);
+                        lines.push(`  Rel(${fromId}, ${toId}, "${relationship}")`);
+                    }
+                }
+            }
+        }
+        return lines.join('\n');
+    }
+    /**
+     * Generate relationships to external systems
+     *
+     * @param containers - Internal containers
+     * @param externals - External systems
+     * @returns Mermaid Rel definitions
+     */
+    generateExternalRelationships(containers, externals) {
+        const lines = [];
+        for (const container of containers) {
+            const fromId = this.sanitizeName(container.name);
+            for (const external of externals) {
+                if (!this.isRelevantExternal(external) && external.type !== 'database') {
+                    continue;
+                }
+                const toId = this.sanitizeName(external.name);
+                const relationship = this.getExternalRelationship(external);
+                lines.push(`  Rel(${fromId}, ${toId}, "${relationship}")`);
+            }
+        }
+        return lines.join('\n');
+    }
+    /**
+     * Infer relationship between two containers
+     *
+     * @param from - Source container
+     * @param to - Target container
+     * @returns Relationship description or null
+     */
+    inferRelationship(from, to) {
+        const fromName = from.name.toLowerCase();
+        const toName = to.name.toLowerCase();
+        // Frontend -> Backend/API
+        if (fromName.includes('frontend') && (toName.includes('api') || toName.includes('backend'))) {
+            return 'Makes API calls to';
+        }
+        // API/Backend -> Database
+        if ((fromName.includes('api') || fromName.includes('backend')) && this.isDatabase(to)) {
+            return 'Reads from and writes to';
+        }
+        // Service -> Database
+        if (fromName.includes('service') && this.isDatabase(to)) {
+            return 'Reads from and writes to';
+        }
+        // Gateway -> API/Service
+        if (fromName.includes('gateway') && (toName.includes('api') || toName.includes('service'))) {
+            return 'Routes requests to';
+        }
+        return null;
+    }
+    /**
+     * Get relationship description for external system
+     *
+     * @param external - External system
+     * @returns Relationship description
+     */
+    getExternalRelationship(external) {
+        const typeRelationships = {
+            database: 'Reads from and writes to',
+            api: 'Makes API calls to',
+            service: 'Sends requests to',
+            messageQueue: 'Publishes to and consumes from',
+            cache: 'Reads from and writes to',
+            storage: 'Stores files in',
+        };
+        return typeRelationships[external.type] || 'Communicates with';
+    }
+    /**
+     * 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, '_')
+            .toLowerCase();
+    }
+}
+exports.C4ContainerDiagramBuilder = C4ContainerDiagramBuilder;
+//# sourceMappingURL=C4ContainerDiagramBuilder.js.map

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

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

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

@@ -0,0 +1,67 @@
+import type { ProjectMetadata, ExternalSystem } from '../inference/types.js';
+/**
+ * Builds C4 Context diagrams in Mermaid syntax
+ *
+ * Context diagrams show the system in its environment with users and external systems.
+ * This is the highest level of abstraction in C4 modeling.
+ *
+ * @example
+ * ```typescript
+ * const builder = new C4ContextDiagramBuilder();
+ * const diagram = builder.build(metadata, externalSystems);
+ * ```
+ */
+export declare class C4ContextDiagramBuilder {
+    /**
+     * Build a C4 Context diagram in Mermaid syntax
+     *
+     * @param metadata - Project metadata containing system information
+     * @param externalSystems - Detected external systems and dependencies
+     * @returns Mermaid C4Context diagram as string
+     */
+    build(metadata: ProjectMetadata, externalSystems: ExternalSystem[]): string;
+    /**
+     * Sanitize system name for Mermaid syntax
+     * Removes special characters and replaces spaces with underscores
+     *
+     * @param name - Original system name
+     * @returns Sanitized name safe for Mermaid
+     */
+    private formatSystemName;
+    /**
+     * Generate default user/person actors
+     *
+     * @returns Mermaid Person definitions
+     */
+    private generatePersons;
+    /**
+     * Generate external system definitions
+     *
+     * @param systems - Detected external systems
+     * @returns Mermaid System_Ext definitions
+     */
+    private generateExternalSystems;
+    /**
+     * Get description for external system based on type
+     *
+     * @param system - External system
+     * @returns Human-readable description
+     */
+    private getSystemDescription;
+    /**
+     * Generate relationships between system and external systems
+     *
+     * @param metadata - Project metadata
+     * @param externals - External systems
+     * @returns Mermaid Rel definitions
+     */
+    private generateRelationships;
+    /**
+     * Get relationship label based on external system type
+     *
+     * @param system - External system
+     * @returns Relationship description
+     */
+    private getRelationshipLabel;
+}
+//# sourceMappingURL=C4ContextDiagramBuilder.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"C4ContextDiagramBuilder.d.ts","sourceRoot":"","sources":["../../../src/code-intelligence/visualization/C4ContextDiagramBuilder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAa,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAExF;;;;;;;;;;;GAWG;AACH,qBAAa,uBAAuB;IAClC;;;;;;OAMG;IACH,KAAK,CAAC,QAAQ,EAAE,eAAe,EAAE,eAAe,EAAE,cAAc,EAAE,GAAG,MAAM;IAyB3E;;;;;;OAMG;IACH,OAAO,CAAC,gBAAgB;IAQxB;;;;OAIG;IACH,OAAO,CAAC,eAAe;IASvB;;;;;OAKG;IACH,OAAO,CAAC,uBAAuB;IAoB/B;;;;;OAKG;IACH,OAAO,CAAC,oBAAoB;IAe5B;;;;;;OAMG;IACH,OAAO,CAAC,qBAAqB;IAkB7B;;;;;OAKG;IACH,OAAO,CAAC,oBAAoB;CAc7B"}