@gitgov/core 1.0.0

package/dist/src/diagram_generator/mermaid_renderer.js

@@ -0,0 +1,306 @@
+export class RenderingError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'RenderingError';
+    }
+}
+export class ContentSanitizer {
+    sanitizeNodeTitle(title) {
+        // Remove potentially dangerous characters for Mermaid, but preserve <br/> tags
+        return title
+            .replace(/<(?!br\/?>)[^>]*>/g, '') // Remove HTML tags except <br/> and <br>
+            .replace(/["']/g, '') // Remove quotes that could break syntax
+            .substring(0, 150); // Increased limit to accommodate line breaks
+    }
+    sanitizeNodeId(id) {
+        // Ensure valid Mermaid node ID
+        return id.replace(/[^a-zA-Z0-9_-]/g, '_');
+    }
+    sanitizeStatus(status) {
+        const allowedStatuses = [
+            'pending', 'in-progress', 'done', 'blocked',
+            'cancelled', 'draft', 'planning', 'active',
+            'completed', 'archived', 'paused', 'discarded',
+            'validated', 'audit_oracle_create', 'audit_oracle_close',
+            'ready', 'review', 'in_progress'
+        ];
+        return allowedStatuses.includes(status) ? status : 'unknown';
+    }
+    sanitizeGraph(graph) {
+        return {
+            nodes: graph.nodes.map(node => {
+                const sanitizedNode = {
+                    id: this.sanitizeNodeId(node.id),
+                    type: node.type,
+                    title: this.sanitizeNodeTitle(node.title),
+                    originalId: node.originalId,
+                };
+                if (node.status) {
+                    sanitizedNode.status = this.sanitizeStatus(node.status);
+                }
+                if (node.tags) {
+                    sanitizedNode.tags = node.tags;
+                }
+                return sanitizedNode;
+            }),
+            edges: graph.edges.filter(edge => edge.from && edge.to),
+            metadata: graph.metadata,
+        };
+    }
+}
+export class MermaidValidator {
+    isValidMermaidSyntax(content) {
+        // Basic Mermaid syntax validation
+        const lines = content.split('\n');
+        // Must start with flowchart declaration
+        const flowchartLine = lines.find(line => line.trim().startsWith('flowchart'));
+        if (!flowchartLine) {
+            return false;
+        }
+        // Check for balanced brackets in node definitions
+        const nodeLines = lines.filter(line => line.includes('["') && line.includes('"]'));
+        for (const line of nodeLines) {
+            const openBrackets = (line.match(/\["/g) || []).length;
+            const closeBrackets = (line.match(/"\]/g) || []).length;
+            if (openBrackets !== closeBrackets) {
+                return false;
+            }
+        }
+        return true;
+    }
+}
+export class MermaidRenderer {
+    sanitizer;
+    validator;
+    constructor() {
+        this.sanitizer = new ContentSanitizer();
+        this.validator = new MermaidValidator();
+    }
+    /**
+     * Main rendering method with input sanitization and output validation
+     */
+    renderGraph(graph, options) {
+        if (!graph || !graph.nodes || !graph.edges) {
+            throw new RenderingError('Invalid graph structure');
+        }
+        const sanitizedGraph = this.sanitizer.sanitizeGraph(graph);
+        const content = this.generateMermaidContent(sanitizedGraph, options);
+        // Validate generated Mermaid syntax
+        if (!this.validator.isValidMermaidSyntax(content)) {
+            throw new RenderingError('Generated invalid Mermaid syntax');
+        }
+        return content;
+    }
+    /**
+     * Generates the complete Mermaid diagram content
+     */
+    generateMermaidContent(graph, options) {
+        const header = this.generateHeader(options);
+        const nodes = this.generateNodes(graph.nodes);
+        const edges = this.generateEdges(graph.edges);
+        const styling = this.generateStyling();
+        const statusClasses = this.generateStatusClasses(graph.nodes);
+        return [
+            '```mermaid',
+            header,
+            '',
+            nodes,
+            '',
+            edges,
+            '',
+            styling,
+            '',
+            statusClasses,
+            '```'
+        ].join('\n');
+    }
+    /**
+     * Generates the diagram header with metadata
+     */
+    generateHeader(options) {
+        const timestamp = new Date().toISOString();
+        return [
+            `flowchart ${options.layout}`,
+            `    %% Auto-generated on ${timestamp}`,
+            `    %% Source: .gitgov/ entities`,
+        ].join('\n');
+    }
+    /**
+     * Generates node syntax for all nodes
+     */
+    generateNodes(nodes) {
+        const nodeLines = nodes.map(node => this.generateNodeSyntax(node));
+        return nodeLines.join('\n');
+    }
+    /**
+     * Generates edge syntax for all relationships
+     */
+    generateEdges(edges) {
+        if (edges.length === 0) {
+            return '    %% No relationships found';
+        }
+        const edgeLines = [
+            '    %% ONLY hierarchical relationships from protocol',
+            '    %% Source: CycleRecord.childCycleIds and CycleRecord.taskIds',
+            ...edges.map(edge => this.generateEdgeSyntax(edge))
+        ];
+        return edgeLines.join('\n');
+    }
+    /**
+     * Wraps a title string to a specified max width, using <br/> for line breaks.
+     * Also sanitizes the title.
+     * @param title The title to wrap.
+     * @param maxWidth The maximum width of a line.
+     * @returns The wrapped and sanitized title string.
+     */
+    wrapTitle(title, maxWidth = 30) {
+        // The sanitizer already limits total length, so this is for readability.
+        const sanitizedTitle = this.sanitizer.sanitizeNodeTitle(title);
+        if (sanitizedTitle.length <= maxWidth) {
+            return sanitizedTitle;
+        }
+        const words = sanitizedTitle.split(' ');
+        const lines = [];
+        let currentLine = words.shift() || '';
+        for (const word of words) {
+            if ((currentLine + ' ' + word).length > maxWidth) {
+                lines.push(currentLine);
+                currentLine = word;
+            }
+            else {
+                currentLine += ` ${word}`;
+            }
+        }
+        lines.push(currentLine);
+        return lines.join('<br/>');
+    }
+    /**
+     * Node generation with word wrapping for better readability.
+     * Uses different shapes for different node types:
+     * - Cycles: Hexagonal shape {{text}} for strategic importance
+     * - Tasks: Rectangular shape [text] for implementation details
+     */
+    generateNodeSyntax(node) {
+        const wrappedTitle = this.wrapTitle(node.title);
+        const sanitizedId = this.sanitizer.sanitizeNodeId(node.id);
+        const icon = this.getNodeIcon(node.type);
+        // Use hexagonal shape for cycles (strategic level)
+        if (node.type === 'cycle') {
+            return `    ${sanitizedId}{{"${icon}<br/>${wrappedTitle}"}}`;
+        }
+        // Use rectangular shape for tasks (implementation level)
+        if (node.type === 'epic-task' && node.status === 'paused') {
+            return `    ${sanitizedId}["${icon}<br/>${wrappedTitle}<br/>(PAUSED)"]`;
+        }
+        return `    ${sanitizedId}["${icon}<br/>${wrappedTitle}"]`;
+    }
+    /**
+     * Edge generation with relationship validation
+     */
+    generateEdgeSyntax(edge) {
+        if (!edge.from || !edge.to) {
+            throw new RenderingError('Edge must have valid from and to nodes');
+        }
+        const sanitizedFrom = this.sanitizer.sanitizeNodeId(edge.from);
+        const sanitizedTo = this.sanitizer.sanitizeNodeId(edge.to);
+        return `    ${sanitizedFrom} --> ${sanitizedTo}`;
+    }
+    /**
+     * Gets the appropriate icon for each node type
+     */
+    getNodeIcon(type) {
+        const icons = {
+            'cycle': '🎯',
+            'epic-task': '📦',
+            'task': '📋',
+        };
+        return icons[type] || '📋';
+    }
+    /**
+     * Generates the mandatory color scheme CSS
+     */
+    generateStyling() {
+        return [
+            '    %% Status styling (mandatory color scheme)',
+            '    classDef statusDraft fill:#ffffff,stroke:#cccccc,stroke-width:2px,color:#666666',
+            '    classDef statusReady fill:#ffffeb,stroke:#cccc00,stroke-width:2px,color:#666600',
+            '    classDef statusInProgress fill:#ebf5ff,stroke:#0066cc,stroke-width:2px,color:#003366',
+            '    classDef statusDone fill:#ebffeb,stroke:#00cc00,stroke-width:2px,color:#006600',
+            '    classDef statusBlocked fill:#ffebeb,stroke:#cc0000,stroke-width:2px,color:#660000',
+            '    classDef statusEpicPaused fill:#f3e5f5,stroke:#9c27b0,stroke-width:2px,color:#4a148c',
+            '    classDef statusArchived fill:#f5f5f5,stroke:#666666,stroke-width:2px,color:#333333',
+        ].join('\n');
+    }
+    /**
+     * Applies status-based CSS classes to nodes
+     */
+    generateStatusClasses(nodes) {
+        const statusGroups = new Map();
+        // Group nodes by status
+        for (const node of nodes) {
+            const statusClass = this.getStatusClass(node.status || 'draft', node);
+            if (!statusGroups.has(statusClass)) {
+                statusGroups.set(statusClass, []);
+            }
+            statusGroups.get(statusClass).push(node.id);
+        }
+        // Generate class applications
+        const classLines = [];
+        for (const [statusClass, nodeIds] of statusGroups.entries()) {
+            if (nodeIds.length > 0) {
+                const sanitizedIds = nodeIds.map(id => this.sanitizer.sanitizeNodeId(id));
+                classLines.push(`    class ${sanitizedIds.join(',')} ${statusClass}`);
+            }
+        }
+        return [
+            '    %% Apply styles based on entity status',
+            ...classLines
+        ].join('\n');
+    }
+    /**
+     * Maps entity status to CSS class name with cycle and epic task special handling
+     */
+    getStatusClass(status, node) {
+        // Special case: Epic task paused (waiting for parent cycle)
+        if (status === 'paused' && node?.type === 'epic-task') {
+            return 'statusEpicPaused'; // Purple - not a real blockage
+        }
+        // Handle cycle statuses
+        if (node?.type === 'cycle') {
+            const cycleStatusMap = {
+                'planning': 'statusDraft', // White - being planned
+                'active': 'statusInProgress', // Blue - sprint/milestone running
+                'completed': 'statusDone', // Green - all tasks finished
+                'archived': 'statusArchived', // Gray - historical record
+            };
+            return cycleStatusMap[status] || 'statusDraft';
+        }
+        // Handle task statuses
+        const taskStatusMap = {
+            // Completed states - Green
+            'done': 'statusDone',
+            'validated': 'statusDone',
+            // Active states - Blue  
+            'active': 'statusInProgress',
+            'in_progress': 'statusInProgress',
+            // Ready states - Yellow (only for tasks)
+            'ready': 'statusReady',
+            'pending': 'statusReady',
+            // Preparation states - White
+            'draft': 'statusDraft',
+            'review': 'statusDraft',
+            // Real blockages - Red (only for NON-epic tasks)
+            'blocked': 'statusBlocked',
+            'paused': 'statusBlocked',
+            'cancelled': 'statusBlocked',
+            'discarded': 'statusBlocked',
+            // Archived states - Gray
+            'archived': 'statusArchived',
+            // Legacy oracle states - White (preparation)
+            'audit_oracle_create': 'statusDraft',
+            'audit_oracle_close': 'statusDraft',
+        };
+        return taskStatusMap[status] || 'statusDraft';
+    }
+}
+//# sourceMappingURL=mermaid_renderer.js.map

package/dist/src/diagram_generator/mermaid_renderer.js.map

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

package/dist/src/diagram_generator/relationship_analyzer.d.ts

@@ -0,0 +1,116 @@
+import type { TaskRecord } from '../types';
+import type { CycleRecord } from '../types';
+export interface DiagramNode {
+    id: string;
+    type: 'cycle' | 'epic-task' | 'task';
+    title: string;
+    status?: string;
+    tags?: string[];
+    originalId: string;
+}
+export interface DiagramEdge {
+    from: string;
+    to: string;
+    type: 'hierarchy';
+}
+export interface RelationshipGraph {
+    nodes: DiagramNode[];
+    edges: DiagramEdge[];
+    metadata: {
+        nodeCount: number;
+        edgeCount: number;
+        generatedAt: string;
+        duplicatesRemoved?: {
+            nodes: number;
+            edges: number;
+        };
+    };
+}
+export declare class CircularDependencyError extends Error {
+    constructor(message: string);
+}
+export declare class RelationshipAnalyzer {
+    /**
+     * Analyzes relationships between cycles and tasks to build a complete graph
+     */
+    analyzeRelationships(cycles: CycleRecord[], tasks: TaskRecord[]): RelationshipGraph;
+    /**
+     * Builds the initial graph with potential duplicates
+     */
+    private buildRawGraph;
+    /**
+     * Processes raw graph to remove duplicates and validate structure
+     */
+    private processAndValidateGraph;
+    /**
+     * Creates the final RelationshipGraph with metadata
+     */
+    private createRelationshipGraph;
+    /**
+     * Generates clean node ID for Mermaid syntax (removes timestamp, converts hyphens)
+     */
+    generateNodeId(record: CycleRecord | TaskRecord): string;
+    /**
+     * Builds all nodes from cycles and tasks
+     */
+    private buildNodes;
+    /**
+     * Builds all hierarchical edges from protocol relationships
+     */
+    private buildEdges;
+    /**
+     * Checks if a task is an epic based on tags
+     */
+    private isEpicTask;
+    /**
+     * Detects circular dependencies in the graph
+     */
+    private detectCircularDependencies;
+    /**
+     * DFS helper for circular dependency detection with path tracking
+     */
+    private findCycleDFS;
+    /**
+     * Formats a circular dependency error with helpful context
+     */
+    private formatCycleError;
+    /**
+     * Reports duplicate nodes and edges as console warnings
+     */
+    private reportDuplicateWarnings;
+    /**
+     * Removes duplicate nodes based on their ID (O(n) performance)
+     */
+    private deduplicateNodes;
+    /**
+     * Removes duplicate edges based on from-to combination (O(n) performance)
+     */
+    private deduplicateEdges;
+    /**
+     * Detects and reports duplicate nodes/edges for diagnostic purposes
+     * Useful for testing and debugging data quality issues
+     */
+    detectDuplicates(cycles: CycleRecord[], tasks: TaskRecord[]): {
+        duplicateNodes: Array<{
+            id: string;
+            count: number;
+            sources: string[];
+        }>;
+        duplicateEdges: Array<{
+            edge: string;
+            count: number;
+        }>;
+    };
+    /**
+     * Filters cycles and tasks based on specified criteria
+     */
+    filterEntities(cycles: CycleRecord[], tasks: TaskRecord[], filters: {
+        cycleId?: string;
+        taskId?: string;
+        packageName?: string;
+    }): {
+        filteredCycles: CycleRecord[];
+        filteredTasks: TaskRecord[];
+    };
+}
+//# sourceMappingURL=relationship_analyzer.d.ts.map

package/dist/src/diagram_generator/relationship_analyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relationship_analyzer.d.ts","sourceRoot":"","sources":["../../../src/diagram_generator/relationship_analyzer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAC3C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAG5C,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,OAAO,GAAG,WAAW,GAAG,MAAM,CAAC;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,WAAW,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,QAAQ,EAAE;QACR,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;QAClB,WAAW,EAAE,MAAM,CAAC;QACpB,iBAAiB,CAAC,EAAE;YAClB,KAAK,EAAE,MAAM,CAAC;YACd,KAAK,EAAE,MAAM,CAAC;SACf,CAAC;KACH,CAAC;CACH;AAED,qBAAa,uBAAwB,SAAQ,KAAK;gBACpC,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,oBAAoB;IAE/B;;OAEG;IACH,oBAAoB,CAAC,MAAM,EAAE,WAAW,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,GAAG,iBAAiB;IAUnF;;OAEG;IACH,OAAO,CAAC,aAAa;IAMrB;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAc/B;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAqB/B;;OAEG;IACH,cAAc,CAAC,MAAM,EAAE,WAAW,GAAG,UAAU,GAAG,MAAM;IAQxD;;OAEG;IACH,OAAO,CAAC,UAAU;IAmClB;;OAEG;IACH,OAAO,CAAC,UAAU;IAyClB;;OAEG;IACH,OAAO,CAAC,UAAU;IAIlB;;OAEG;IACH,OAAO,CAAC,0BAA0B;IA2BlC;;OAEG;IACH,OAAO,CAAC,YAAY;IA8BpB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IA6BxB;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAuD/B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAaxB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAaxB;;;OAGG;IACH,gBAAgB,CAAC,MAAM,EAAE,WAAW,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,GAAG;QAC5D,cAAc,EAAE,KAAK,CAAC;YAAE,EAAE,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,EAAE,CAAA;SAAE,CAAC,CAAC;QACxE,cAAc,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KACxD;IA+BD;;OAEG;IACH,cAAc,CACZ,MAAM,EAAE,WAAW,EAAE,EACrB,KAAK,EAAE,UAAU,EAAE,EACnB,OAAO,EAAE;QACP,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,GACA;QAAE,cAAc,EAAE,WAAW,EAAE,CAAC;QAAC,aAAa,EAAE,UAAU,EAAE,CAAA;KAAE;CAoElE"}