@buoy-design/core 0.1.1 → 0.1.2

package/dist/graph/builder.d.ts

@@ -0,0 +1,118 @@
+/**
+ * Graph Builder
+ *
+ * Constructs the design system knowledge graph from SQLite data.
+ * Uses graphology for in-memory graph operations.
+ */
+import type { AbstractGraph } from 'graphology-types';
+import type { NodeType, EdgeType, NodeAttributes, EdgeAttributes, GraphBuildOptions, GraphStats } from './types.js';
+export type DesignSystemGraph = AbstractGraph<NodeAttributes, EdgeAttributes>;
+/**
+ * Create an empty directed multigraph for the design system
+ */
+export declare function createGraph(): DesignSystemGraph;
+/**
+ * Generate a unique node ID
+ */
+export declare function nodeId(type: NodeType, id: string): string;
+/**
+ * Generate a unique edge ID
+ */
+export declare function edgeId(type: EdgeType, sourceId: string, targetId: string): string;
+/**
+ * Add a node to the graph if it doesn't exist
+ */
+export declare function addNode(graph: DesignSystemGraph, type: NodeType, id: string, attributes: Omit<NodeAttributes, 'type'>): string;
+/**
+ * Update node attributes
+ */
+export declare function updateNode(graph: DesignSystemGraph, nid: string, attributes: Partial<NodeAttributes>): void;
+/**
+ * Get all nodes of a specific type
+ */
+export declare function getNodesByType(graph: DesignSystemGraph, type: NodeType): string[];
+/**
+ * Add an edge to the graph
+ */
+export declare function addEdge(graph: DesignSystemGraph, type: EdgeType, sourceId: string, targetId: string, attributes?: Omit<EdgeAttributes, 'type'>): string | null;
+/**
+ * Get all edges of a specific type
+ */
+export declare function getEdgesByType(graph: DesignSystemGraph, type: EdgeType): string[];
+/**
+ * Get all outgoing edges of a specific type from a node
+ */
+export declare function getOutEdgesByType(graph: DesignSystemGraph, nid: string, type: EdgeType): string[];
+/**
+ * Get all incoming edges of a specific type to a node
+ */
+export declare function getInEdgesByType(graph: DesignSystemGraph, nid: string, type: EdgeType): string[];
+/**
+ * Get statistics about the graph
+ */
+export declare function getGraphStats(graph: DesignSystemGraph): GraphStats;
+/**
+ * Export graph to JSON format
+ */
+export declare function exportToJSON(graph: DesignSystemGraph): object;
+/**
+ * Import graph from JSON format
+ */
+export declare function importFromJSON(data: ReturnType<DesignSystemGraph['export']>): DesignSystemGraph;
+/**
+ * Export graph to DOT format for visualization
+ */
+export declare function exportToDOT(graph: DesignSystemGraph): string;
+/**
+ * Export graph to Cytoscape format for web visualization
+ */
+export declare function exportToCytoscape(graph: DesignSystemGraph): object;
+/**
+ * Builder class for constructing the graph incrementally
+ */
+export declare class GraphBuilder {
+    private graph;
+    readonly projectId: string;
+    constructor(options: GraphBuildOptions);
+    /**
+     * Add a token node
+     */
+    addToken(id: string, name: string, category: string, value: string, source: string, isW3C?: boolean): string;
+    /**
+     * Add a component node
+     */
+    addComponent(id: string, name: string, filePath: string, framework: string, props?: string[], variants?: string[]): string;
+    /**
+     * Add a file node
+     */
+    addFile(id: string, path: string, lineCount?: number): string;
+    /**
+     * Add a commit node
+     */
+    addCommit(sha: string, message: string, author: string, authorEmail: string | undefined, timestamp: Date): string;
+    /**
+     * Add a developer node
+     */
+    addDeveloper(id: string, name: string, email: string, githubLogin?: string, commitCount?: number): string;
+    /**
+     * Add a PR node
+     */
+    addPR(id: string, number: number, title: string, state: 'open' | 'closed' | 'merged', authorLogin?: string): string;
+    /**
+     * Add a drift signal node
+     */
+    addDriftSignal(id: string, driftType: string, severity: string, message: string, resolved?: boolean): string;
+    /**
+     * Add an edge between nodes
+     */
+    addEdge(type: EdgeType, sourceId: string, targetId: string, attributes?: Omit<EdgeAttributes, 'type'>): string | null;
+    /**
+     * Get the built graph
+     */
+    build(): DesignSystemGraph;
+    /**
+     * Get graph statistics
+     */
+    getStats(): GraphStats;
+}
+//# sourceMappingURL=builder.d.ts.map

package/dist/graph/builder.d.ts.map

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

package/dist/graph/builder.js

@@ -0,0 +1,328 @@
+/**
+ * Graph Builder
+ *
+ * Constructs the design system knowledge graph from SQLite data.
+ * Uses graphology for in-memory graph operations.
+ */
+import GraphConstructor from 'graphology';
+// Cast constructor for use
+const Graph = GraphConstructor;
+// ============================================================================
+// Graph Creation
+// ============================================================================
+/**
+ * Create an empty directed multigraph for the design system
+ */
+export function createGraph() {
+    return new Graph({
+        multi: true,
+        type: 'directed',
+        allowSelfLoops: false,
+    });
+}
+/**
+ * Generate a unique node ID
+ */
+export function nodeId(type, id) {
+    return `${type.toLowerCase()}:${id}`;
+}
+/**
+ * Generate a unique edge ID
+ */
+export function edgeId(type, sourceId, targetId) {
+    return `${type.toLowerCase()}:${sourceId}:${targetId}`;
+}
+// ============================================================================
+// Node Operations
+// ============================================================================
+/**
+ * Add a node to the graph if it doesn't exist
+ */
+export function addNode(graph, type, id, attributes) {
+    const nid = nodeId(type, id);
+    if (!graph.hasNode(nid)) {
+        graph.addNode(nid, {
+            ...attributes,
+            type,
+        });
+    }
+    return nid;
+}
+/**
+ * Update node attributes
+ */
+export function updateNode(graph, nid, attributes) {
+    if (graph.hasNode(nid)) {
+        graph.mergeNodeAttributes(nid, attributes);
+    }
+}
+/**
+ * Get all nodes of a specific type
+ */
+export function getNodesByType(graph, type) {
+    return graph.filterNodes((_node, attrs) => attrs.type === type);
+}
+// ============================================================================
+// Edge Operations
+// ============================================================================
+/**
+ * Add an edge to the graph
+ */
+export function addEdge(graph, type, sourceId, targetId, attributes) {
+    // Ensure both nodes exist
+    if (!graph.hasNode(sourceId) || !graph.hasNode(targetId)) {
+        return null;
+    }
+    const eid = edgeId(type, sourceId, targetId);
+    // Check if edge already exists
+    if (!graph.hasEdge(eid)) {
+        graph.addEdgeWithKey(eid, sourceId, targetId, {
+            ...attributes,
+            type,
+            createdAt: attributes?.createdAt ?? new Date(),
+        });
+    }
+    return eid;
+}
+/**
+ * Get all edges of a specific type
+ */
+export function getEdgesByType(graph, type) {
+    return graph.filterEdges((_edge, attrs) => attrs.type === type);
+}
+/**
+ * Get all outgoing edges of a specific type from a node
+ */
+export function getOutEdgesByType(graph, nid, type) {
+    if (!graph.hasNode(nid))
+        return [];
+    return graph.filterOutEdges(nid, (_edge, attrs) => attrs.type === type);
+}
+/**
+ * Get all incoming edges of a specific type to a node
+ */
+export function getInEdgesByType(graph, nid, type) {
+    if (!graph.hasNode(nid))
+        return [];
+    return graph.filterInEdges(nid, (_edge, attrs) => attrs.type === type);
+}
+// ============================================================================
+// Graph Stats
+// ============================================================================
+/**
+ * Get statistics about the graph
+ */
+export function getGraphStats(graph) {
+    const nodesByType = {};
+    const edgesByType = {};
+    graph.forEachNode((_node, attrs) => {
+        const nodeType = attrs.type;
+        nodesByType[nodeType] = (nodesByType[nodeType] ?? 0) + 1;
+    });
+    graph.forEachEdge((_edge, attrs) => {
+        const edgeType = attrs.type;
+        edgesByType[edgeType] = (edgesByType[edgeType] ?? 0) + 1;
+    });
+    return {
+        nodeCount: graph.order,
+        edgeCount: graph.size,
+        nodesByType: nodesByType,
+        edgesByType: edgesByType,
+    };
+}
+// ============================================================================
+// Serialization
+// ============================================================================
+/**
+ * Export graph to JSON format
+ */
+export function exportToJSON(graph) {
+    return graph.export();
+}
+/**
+ * Import graph from JSON format
+ */
+export function importFromJSON(data) {
+    const graph = createGraph();
+    graph.import(data);
+    return graph;
+}
+/**
+ * Export graph to DOT format for visualization
+ */
+export function exportToDOT(graph) {
+    const lines = ['digraph DesignSystem {'];
+    lines.push('  rankdir=LR;');
+    lines.push('  node [shape=box];');
+    lines.push('');
+    // Define node styles by type
+    const nodeStyles = {
+        Token: 'style=filled,fillcolor="#e3f2fd"',
+        Component: 'style=filled,fillcolor="#e8f5e9"',
+        File: 'style=filled,fillcolor="#fff3e0"',
+        Commit: 'style=filled,fillcolor="#fce4ec"',
+        Developer: 'style=filled,fillcolor="#f3e5f5"',
+        DriftSignal: 'style=filled,fillcolor="#ffebee"',
+    };
+    // Add nodes
+    graph.forEachNode((node, attrs) => {
+        const nodeAttrs = attrs;
+        const style = nodeStyles[nodeAttrs.type] ?? '';
+        const label = nodeAttrs.name.replace(/"/g, '\\"');
+        lines.push(`  "${node}" [label="${label}" ${style}];`);
+    });
+    lines.push('');
+    // Add edges
+    graph.forEachEdge((_edge, attrs, source, target) => {
+        const edgeAttrs = attrs;
+        const label = edgeAttrs.type;
+        lines.push(`  "${source}" -> "${target}" [label="${label}"];`);
+    });
+    lines.push('}');
+    return lines.join('\n');
+}
+/**
+ * Export graph to Cytoscape format for web visualization
+ */
+export function exportToCytoscape(graph) {
+    const elements = [];
+    graph.forEachNode((node, attrs) => {
+        elements.push({
+            group: 'nodes',
+            data: {
+                id: node,
+                ...attrs,
+            },
+        });
+    });
+    graph.forEachEdge((_edge, attrs, source, target) => {
+        elements.push({
+            group: 'edges',
+            data: {
+                id: _edge,
+                source,
+                target,
+                ...attrs,
+            },
+        });
+    });
+    return { elements };
+}
+// ============================================================================
+// Graph Builder Class
+// ============================================================================
+/**
+ * Builder class for constructing the graph incrementally
+ */
+export class GraphBuilder {
+    graph;
+    projectId;
+    constructor(options) {
+        this.graph = createGraph();
+        this.projectId = options.projectId;
+    }
+    /**
+     * Add a token node
+     */
+    addToken(id, name, category, value, source, isW3C = false) {
+        return addNode(this.graph, 'Token', id, {
+            name,
+            category,
+            value,
+            source,
+            isW3C,
+        });
+    }
+    /**
+     * Add a component node
+     */
+    addComponent(id, name, filePath, framework, props, variants) {
+        return addNode(this.graph, 'Component', id, {
+            name,
+            filePath,
+            framework,
+            props,
+            variants,
+        });
+    }
+    /**
+     * Add a file node
+     */
+    addFile(id, path, lineCount) {
+        const extension = path.split('.').pop() ?? '';
+        const name = path.split('/').pop() ?? path;
+        return addNode(this.graph, 'File', id, {
+            name,
+            path,
+            extension,
+            lineCount,
+        });
+    }
+    /**
+     * Add a commit node
+     */
+    addCommit(sha, message, author, authorEmail, timestamp) {
+        return addNode(this.graph, 'Commit', sha, {
+            name: (message.split('\n')[0] ?? '').slice(0, 50),
+            sha,
+            message,
+            author,
+            authorEmail,
+            timestamp,
+        });
+    }
+    /**
+     * Add a developer node
+     */
+    addDeveloper(id, name, email, githubLogin, commitCount = 0) {
+        return addNode(this.graph, 'Developer', id, {
+            name,
+            email,
+            githubLogin,
+            commitCount,
+        });
+    }
+    /**
+     * Add a PR node
+     */
+    addPR(id, number, title, state, authorLogin) {
+        return addNode(this.graph, 'PR', id, {
+            name: `#${number}: ${title.slice(0, 50)}`,
+            number,
+            title,
+            state,
+            authorLogin,
+        });
+    }
+    /**
+     * Add a drift signal node
+     */
+    addDriftSignal(id, driftType, severity, message, resolved = false) {
+        return addNode(this.graph, 'DriftSignal', id, {
+            name: message.slice(0, 50),
+            driftType,
+            severity,
+            message,
+            resolved,
+        });
+    }
+    /**
+     * Add an edge between nodes
+     */
+    addEdge(type, sourceId, targetId, attributes) {
+        return addEdge(this.graph, type, sourceId, targetId, attributes);
+    }
+    /**
+     * Get the built graph
+     */
+    build() {
+        return this.graph;
+    }
+    /**
+     * Get graph statistics
+     */
+    getStats() {
+        return getGraphStats(this.graph);
+    }
+}
+//# sourceMappingURL=builder.js.map

package/dist/graph/builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder.js","sourceRoot":"","sources":["../../src/graph/builder.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,gBAAgB,MAAM,YAAY,CAAC;AAc1C,2BAA2B;AAC3B,MAAM,KAAK,GAAG,gBAEU,CAAC;AAEzB,+EAA+E;AAC/E,iBAAiB;AACjB,+EAA+E;AAE/E;;GAEG;AACH,MAAM,UAAU,WAAW;IACzB,OAAO,IAAI,KAAK,CAAiC;QAC/C,KAAK,EAAE,IAAI;QACX,IAAI,EAAE,UAAU;QAChB,cAAc,EAAE,KAAK;KACtB,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,MAAM,CAAC,IAAc,EAAE,EAAU;IAC/C,OAAO,GAAG,IAAI,CAAC,WAAW,EAAE,IAAI,EAAE,EAAE,CAAC;AACvC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,MAAM,CAAC,IAAc,EAAE,QAAgB,EAAE,QAAgB;IACvE,OAAO,GAAG,IAAI,CAAC,WAAW,EAAE,IAAI,QAAQ,IAAI,QAAQ,EAAE,CAAC;AACzD,CAAC;AAED,+EAA+E;AAC/E,kBAAkB;AAClB,+EAA+E;AAE/E;;GAEG;AACH,MAAM,UAAU,OAAO,CACrB,KAAwB,EACxB,IAAc,EACd,EAAU,EACV,UAAwC;IAExC,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IAE7B,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACxB,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE;YACjB,GAAG,UAAU;YACb,IAAI;SACa,CAAC,CAAC;IACvB,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CACxB,KAAwB,EACxB,GAAW,EACX,UAAmC;IAEnC,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACvB,KAAK,CAAC,mBAAmB,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;IAC7C,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAC5B,KAAwB,EACxB,IAAc;IAEd,OAAO,KAAK,CAAC,WAAW,CACtB,CAAC,KAAa,EAAE,KAAiB,EAAE,EAAE,CAAE,KAAwB,CAAC,IAAI,KAAK,IAAI,CAC9E,CAAC;AACJ,CAAC;AAED,+EAA+E;AAC/E,kBAAkB;AAClB,+EAA+E;AAE/E;;GAEG;AACH,MAAM,UAAU,OAAO,CACrB,KAAwB,EACxB,IAAc,EACd,QAAgB,EAChB,QAAgB,EAChB,UAAyC;IAEzC,0BAA0B;IAC1B,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QACzD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAE7C,+BAA+B;IAC/B,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACxB,KAAK,CAAC,cAAc,CAAC,GAAG,EAAE,QAAQ,EAAE,QAAQ,EAAE;YAC5C,GAAG,UAAU;YACb,IAAI;YACJ,SAAS,EAAE,UAAU,EAAE,SAAS,IAAI,IAAI,IAAI,EAAE;SAC7B,CAAC,CAAC;IACvB,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAC5B,KAAwB,EACxB,IAAc;IAEd,OAAO,KAAK,CAAC,WAAW,CACtB,CAAC,KAAa,EAAE,KAAiB,EAAE,EAAE,CAAE,KAAwB,CAAC,IAAI,KAAK,IAAI,CAC9E,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAC/B,KAAwB,EACxB,GAAW,EACX,IAAc;IAEd,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC;QAAE,OAAO,EAAE,CAAC;IAEnC,OAAO,KAAK,CAAC,cAAc,CACzB,GAAG,EACH,CAAC,KAAa,EAAE,KAAiB,EAAE,EAAE,CAAE,KAAwB,CAAC,IAAI,KAAK,IAAI,CAC9E,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAC9B,KAAwB,EACxB,GAAW,EACX,IAAc;IAEd,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC;QAAE,OAAO,EAAE,CAAC;IAEnC,OAAO,KAAK,CAAC,aAAa,CACxB,GAAG,EACH,CAAC,KAAa,EAAE,KAAiB,EAAE,EAAE,CAAE,KAAwB,CAAC,IAAI,KAAK,IAAI,CAC9E,CAAC;AACJ,CAAC;AAED,+EAA+E;AAC/E,cAAc;AACd,+EAA+E;AAE/E;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,KAAwB;IACpD,MAAM,WAAW,GAAsC,EAAE,CAAC;IAC1D,MAAM,WAAW,GAAsC,EAAE,CAAC;IAE1D,KAAK,CAAC,WAAW,CAAC,CAAC,KAAa,EAAE,KAAiB,EAAE,EAAE;QACrD,MAAM,QAAQ,GAAI,KAAwB,CAAC,IAAI,CAAC;QAChD,WAAW,CAAC,QAAQ,CAAC,GAAG,CAAC,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;IAC3D,CAAC,CAAC,CAAC;IAEH,KAAK,CAAC,WAAW,CAAC,CAAC,KAAa,EAAE,KAAiB,EAAE,EAAE;QACrD,MAAM,QAAQ,GAAI,KAAwB,CAAC,IAAI,CAAC;QAChD,WAAW,CAAC,QAAQ,CAAC,GAAG,CAAC,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;IAC3D,CAAC,CAAC,CAAC;IAEH,OAAO;QACL,SAAS,EAAE,KAAK,CAAC,KAAK;QACtB,SAAS,EAAE,KAAK,CAAC,IAAI;QACrB,WAAW,EAAE,WAAuC;QACpD,WAAW,EAAE,WAAuC;KACrD,CAAC;AACJ,CAAC;AAED,+EAA+E;AAC/E,gBAAgB;AAChB,+EAA+E;AAE/E;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,KAAwB;IACnD,OAAO,KAAK,CAAC,MAAM,EAAE,CAAC;AACxB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAC5B,IAA6C;IAE7C,MAAM,KAAK,GAAG,WAAW,EAAE,CAAC;IAC5B,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACnB,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,KAAwB;IAClD,MAAM,KAAK,GAAa,CAAC,wBAAwB,CAAC,CAAC;IACnD,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IAC5B,KAAK,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;IAClC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,6BAA6B;IAC7B,MAAM,UAAU,GAAsC;QACpD,KAAK,EAAE,kCAAkC;QACzC,SAAS,EAAE,kCAAkC;QAC7C,IAAI,EAAE,kCAAkC;QACxC,MAAM,EAAE,kCAAkC;QAC1C,SAAS,EAAE,kCAAkC;QAC7C,WAAW,EAAE,kCAAkC;KAChD,CAAC;IAEF,YAAY;IACZ,KAAK,CAAC,WAAW,CAAC,CAAC,IAAY,EAAE,KAAiB,EAAE,EAAE;QACpD,MAAM,SAAS,GAAG,KAAuB,CAAC;QAC1C,MAAM,KAAK,GAAG,UAAU,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QAC/C,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAClD,KAAK,CAAC,IAAI,CAAC,MAAM,IAAI,aAAa,KAAK,KAAK,KAAK,IAAI,CAAC,CAAC;IACzD,CAAC,CAAC,CAAC;IAEH,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,YAAY;IACZ,KAAK,CAAC,WAAW,CACf,CAAC,KAAa,EAAE,KAAiB,EAAE,MAAc,EAAE,MAAc,EAAE,EAAE;QACnE,MAAM,SAAS,GAAG,KAAuB,CAAC;QAC1C,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,CAAC;QAC7B,KAAK,CAAC,IAAI,CAAC,MAAM,MAAM,SAAS,MAAM,aAAa,KAAK,KAAK,CAAC,CAAC;IACjE,CAAC,CACF,CAAC;IAEF,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAChB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAwB;IACxD,MAAM,QAAQ,GAAsD,EAAE,CAAC;IAEvE,KAAK,CAAC,WAAW,CAAC,CAAC,IAAY,EAAE,KAAiB,EAAE,EAAE;QACpD,QAAQ,CAAC,IAAI,CAAC;YACZ,KAAK,EAAE,OAAO;YACd,IAAI,EAAE;gBACJ,EAAE,EAAE,IAAI;gBACR,GAAG,KAAK;aACT;SACF,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,KAAK,CAAC,WAAW,CACf,CAAC,KAAa,EAAE,KAAiB,EAAE,MAAc,EAAE,MAAc,EAAE,EAAE;QACnE,QAAQ,CAAC,IAAI,CAAC;YACZ,KAAK,EAAE,OAAO;YACd,IAAI,EAAE;gBACJ,EAAE,EAAE,KAAK;gBACT,MAAM;gBACN,MAAM;gBACN,GAAG,KAAK;aACT;SACF,CAAC,CAAC;IACL,CAAC,CACF,CAAC;IAEF,OAAO,EAAE,QAAQ,EAAE,CAAC;AACtB,CAAC;AAED,+EAA+E;AAC/E,sBAAsB;AACtB,+EAA+E;AAE/E;;GAEG;AACH,MAAM,OAAO,YAAY;IACf,KAAK,CAAoB;IACjB,SAAS,CAAS;IAElC,YAAY,OAA0B;QACpC,IAAI,CAAC,KAAK,GAAG,WAAW,EAAE,CAAC;QAC3B,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;IACrC,CAAC;IAED;;OAEG;IACH,QAAQ,CACN,EAAU,EACV,IAAY,EACZ,QAAgB,EAChB,KAAa,EACb,MAAc,EACd,KAAK,GAAG,KAAK;QAEb,OAAO,OAAO,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE;YACtC,IAAI;YACJ,QAAQ;YACR,KAAK;YACL,MAAM;YACN,KAAK;SAC0B,CAAC,CAAC;IACrC,CAAC;IAED;;OAEG;IACH,YAAY,CACV,EAAU,EACV,IAAY,EACZ,QAAgB,EAChB,SAAiB,EACjB,KAAgB,EAChB,QAAmB;QAEnB,OAAO,OAAO,CAAC,IAAI,CAAC,KAAK,EAAE,WAAW,EAAE,EAAE,EAAE;YAC1C,IAAI;YACJ,QAAQ;YACR,SAAS;YACT,KAAK;YACL,QAAQ;SACuB,CAAC,CAAC;IACrC,CAAC;IAED;;OAEG;IACH,OAAO,CAAC,EAAU,EAAE,IAAY,EAAE,SAAkB;QAClD,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC;QAC9C,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC;QAE3C,OAAO,OAAO,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE;YACrC,IAAI;YACJ,IAAI;YACJ,SAAS;YACT,SAAS;SACsB,CAAC,CAAC;IACrC,CAAC;IAED;;OAEG;IACH,SAAS,CACP,GAAW,EACX,OAAe,EACf,MAAc,EACd,WAA+B,EAC/B,SAAe;QAEf,OAAO,OAAO,CAAC,IAAI,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,EAAE;YACxC,IAAI,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;YACjD,GAAG;YACH,OAAO;YACP,MAAM;YACN,WAAW;YACX,SAAS;SACsB,CAAC,CAAC;IACrC,CAAC;IAED;;OAEG;IACH,YAAY,CACV,EAAU,EACV,IAAY,EACZ,KAAa,EACb,WAAoB,EACpB,WAAW,GAAG,CAAC;QAEf,OAAO,OAAO,CAAC,IAAI,CAAC,KAAK,EAAE,WAAW,EAAE,EAAE,EAAE;YAC1C,IAAI;YACJ,KAAK;YACL,WAAW;YACX,WAAW;SACoB,CAAC,CAAC;IACrC,CAAC;IAED;;OAEG;IACH,KAAK,CACH,EAAU,EACV,MAAc,EACd,KAAa,EACb,KAAmC,EACnC,WAAoB;QAEpB,OAAO,OAAO,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,EAAE;YACnC,IAAI,EAAE,IAAI,MAAM,KAAK,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE;YACzC,MAAM;YACN,KAAK;YACL,KAAK;YACL,WAAW;SACoB,CAAC,CAAC;IACrC,CAAC;IAED;;OAEG;IACH,cAAc,CACZ,EAAU,EACV,SAAiB,EACjB,QAAgB,EAChB,OAAe,EACf,QAAQ,GAAG,KAAK;QAEhB,OAAO,OAAO,CAAC,IAAI,CAAC,KAAK,EAAE,aAAa,EAAE,EAAE,EAAE;YAC5C,IAAI,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;YAC1B,SAAS;YACT,QAAQ;YACR,OAAO;YACP,QAAQ;SACuB,CAAC,CAAC;IACrC,CAAC;IAED;;OAEG;IACH,OAAO,CACL,IAAc,EACd,QAAgB,EAChB,QAAgB,EAChB,UAAyC;QAEzC,OAAO,OAAO,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC;IACnE,CAAC;IAED;;OAEG;IACH,KAAK;QACH,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED;;OAEG;IACH,QAAQ;QACN,OAAO,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACnC,CAAC;CACF"}

package/dist/graph/collectors/git.d.ts

@@ -0,0 +1,90 @@
+/**
+ * Git History Collector
+ *
+ * Extracts commit history, authors, and file changes from git.
+ * Populates commits and developers tables.
+ */
+export interface CollectedCommit {
+    sha: string;
+    message: string;
+    author: string;
+    authorEmail: string;
+    timestamp: Date;
+    parentSha: string | null;
+    filesChanged: FileChange[];
+}
+export interface FileChange {
+    path: string;
+    status: 'added' | 'modified' | 'deleted' | 'renamed';
+    additions?: number;
+    deletions?: number;
+    oldPath?: string;
+}
+export interface CollectedDeveloper {
+    id: string;
+    name: string;
+    email: string;
+    commitCount: number;
+    firstSeenAt: Date;
+    lastSeenAt: Date;
+}
+export interface GitCollectorOptions {
+    /** Only collect commits after this date */
+    since?: Date;
+    /** Only collect commits before this date */
+    until?: Date;
+    /** Only collect commits touching these file patterns */
+    paths?: string[];
+    /** Maximum number of commits to collect */
+    maxCount?: number;
+    /** Include file change stats (slower but more data) */
+    includeStats?: boolean;
+}
+export interface GitCollectorResult {
+    commits: CollectedCommit[];
+    developers: CollectedDeveloper[];
+    stats: {
+        totalCommits: number;
+        totalDevelopers: number;
+        dateRange: {
+            start: Date;
+            end: Date;
+        } | null;
+    };
+}
+/**
+ * Collect git history from a repository
+ */
+export declare function collectGitHistory(projectRoot: string, options?: GitCollectorOptions): Promise<GitCollectorResult>;
+/**
+ * Collect commits that touched design-related files
+ */
+export declare function collectDesignSystemHistory(projectRoot: string, options?: Omit<GitCollectorOptions, 'paths'>): Promise<GitCollectorResult>;
+/**
+ * Get file history (who changed this file)
+ */
+export declare function getFileHistory(projectRoot: string, filePath: string, options?: {
+    maxCount?: number;
+}): Promise<CollectedCommit[]>;
+/**
+ * Get blame information for a file
+ */
+export declare function getFileBlame(projectRoot: string, filePath: string): Promise<Map<number, {
+    author: string;
+    email: string;
+    sha: string;
+    date: Date;
+}>>;
+/**
+ * Check if a path is inside a git repository
+ */
+export declare function isGitRepository(path: string): Promise<boolean>;
+/**
+ * Get the current branch name
+ */
+export declare function getCurrentBranch(projectRoot: string): Promise<string | null>;
+/**
+ * Get the remote URL
+ */
+export declare function getRemoteUrl(projectRoot: string): Promise<string | null>;
+//# sourceMappingURL=git.d.ts.map

package/dist/graph/collectors/git.d.ts.map

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