@graph-ir/core 0.2.0

package/dist/schemas/graph-ir.schema.json

@@ -0,0 +1,360 @@
+{
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "https://graph-ir.dev/schemas/graph-ir.schema.json",
+    "title": "Graph-IR",
+    "description": "Graph Intermediate Representation schema",
+    "type": "object",
+    "required": ["version", "id", "nodes", "edges"],
+    "properties": {
+        "version": {
+            "type": "string",
+            "description": "Schema version for migration support",
+            "pattern": "^\\d+\\.\\d+\\.\\d+$"
+        },
+        "id": {
+            "type": "string",
+            "description": "Unique identifier for this graph",
+            "minLength": 1
+        },
+        "name": {
+            "type": "string",
+            "description": "Human-readable name"
+        },
+        "nodes": {
+            "type": "array",
+            "description": "Top-level nodes",
+            "items": { "$ref": "#/$defs/GraphNode" }
+        },
+        "edges": {
+            "type": "array",
+            "description": "Connections between nodes",
+            "items": { "$ref": "#/$defs/GraphEdge" }
+        },
+        "metadata": { "$ref": "#/$defs/GraphMetadata" },
+        "layoutOptions": { "$ref": "#/$defs/LayoutOptions" }
+    },
+    "$defs": {
+        "GraphNode": {
+            "type": "object",
+            "required": ["id", "type"],
+            "properties": {
+                "id": {
+                    "type": "string",
+                    "description": "Unique identifier within the graph",
+                    "minLength": 1
+                },
+                "type": {
+                    "type": "string",
+                    "description": "Node type (e.g., 'service', 'database')",
+                    "minLength": 1
+                },
+                "label": {
+                    "type": "string",
+                    "description": "Display label"
+                },
+                "description": {
+                    "type": "string",
+                    "description": "Optional description"
+                },
+                "symbol": {
+                    "type": "string",
+                    "description": "Symbol registry key used for visual representation"
+                },
+                "variant": {
+                    "type": "string",
+                    "description": "Optional variant of the selected symbol"
+                },
+                "properties": {
+                    "type": "object",
+                    "description": "Custom properties",
+                    "additionalProperties": true
+                },
+                "children": {
+                    "type": "array",
+                    "description": "Child nodes for compound graphs",
+                    "items": { "$ref": "#/$defs/GraphNode" }
+                },
+                "parent": {
+                    "type": "string",
+                    "description": "Parent node ID"
+                },
+                "ports": {
+                    "type": "array",
+                    "description": "Connection points",
+                    "items": { "$ref": "#/$defs/Port" }
+                },
+                "dimensions": { "$ref": "#/$defs/Dimensions" },
+                "position": { "$ref": "#/$defs/Position" },
+                "pinned": {
+                    "type": "boolean",
+                    "description": "Preserve position during layout"
+                },
+                "layoutOptions": { "$ref": "#/$defs/NodeLayoutOptions" },
+                "sourceInfo": { "$ref": "#/$defs/SourceInfo" }
+            }
+        },
+        "Port": {
+            "type": "object",
+            "required": ["id", "side"],
+            "properties": {
+                "id": {
+                    "type": "string",
+                    "description": "Unique identifier within parent node",
+                    "minLength": 1
+                },
+                "side": {
+                    "type": "string",
+                    "enum": ["NORTH", "SOUTH", "EAST", "WEST"],
+                    "description": "Which side of the node"
+                },
+                "label": {
+                    "type": "string",
+                    "description": "Optional label"
+                },
+                "position": {
+                    "type": "number",
+                    "minimum": 0,
+                    "maximum": 1,
+                    "description": "Position along the side (0.0 to 1.0)"
+                },
+                "properties": {
+                    "type": "object",
+                    "additionalProperties": true
+                }
+            }
+        },
+        "GraphEdge": {
+            "type": "object",
+            "required": ["id", "source", "target"],
+            "properties": {
+                "id": {
+                    "type": "string",
+                    "description": "Unique identifier within the graph",
+                    "minLength": 1
+                },
+                "source": {
+                    "type": "string",
+                    "description": "Source node ID",
+                    "minLength": 1
+                },
+                "target": {
+                    "type": "string",
+                    "description": "Target node ID",
+                    "minLength": 1
+                },
+                "sourcePort": {
+                    "type": "string",
+                    "description": "Source port ID"
+                },
+                "targetPort": {
+                    "type": "string",
+                    "description": "Target port ID"
+                },
+                "type": {
+                    "type": "string",
+                    "description": "Edge type"
+                },
+                "label": {
+                    "type": "string",
+                    "description": "Display label"
+                },
+                "properties": {
+                    "type": "object",
+                    "additionalProperties": true
+                },
+                "routingPoints": {
+                    "type": "array",
+                    "items": { "$ref": "#/$defs/Position" }
+                },
+                "style": { "$ref": "#/$defs/EdgeStyle" },
+                "sourceInfo": { "$ref": "#/$defs/SourceInfo" }
+            }
+        },
+        "EdgeStyle": {
+            "type": "object",
+            "properties": {
+                "lineStyle": {
+                    "type": "string",
+                    "enum": ["solid", "dashed", "dotted"]
+                },
+                "targetArrow": {
+                    "type": "string",
+                    "enum": ["arrow", "diamond", "circle", "none"]
+                },
+                "sourceArrow": {
+                    "type": "string",
+                    "enum": ["arrow", "diamond", "circle", "none"]
+                },
+                "routing": {
+                    "type": "string",
+                    "enum": ["orthogonal", "polyline", "spline"]
+                }
+            }
+        },
+        "Dimensions": {
+            "type": "object",
+            "required": ["width", "height"],
+            "properties": {
+                "width": { "type": "number", "minimum": 0 },
+                "height": { "type": "number", "minimum": 0 }
+            }
+        },
+        "Position": {
+            "type": "object",
+            "required": ["x", "y"],
+            "properties": {
+                "x": { "type": "number" },
+                "y": { "type": "number" }
+            }
+        },
+        "LayoutOptions": {
+            "type": "object",
+            "properties": {
+                "algorithm": {
+                    "type": "string",
+                    "enum": ["layered", "force", "radial", "tree", "fixed"]
+                },
+                "direction": {
+                    "type": "string",
+                    "enum": ["DOWN", "UP", "LEFT", "RIGHT"]
+                },
+                "spacing": { "$ref": "#/$defs/SpacingOptions" },
+                "edgeRouting": {
+                    "type": "string",
+                    "enum": ["orthogonal", "polyline", "spline"]
+                },
+                "hierarchyHandling": {
+                    "type": "string",
+                    "enum": ["INCLUDE_CHILDREN", "SEPARATE_CHILDREN"]
+                },
+                "algorithmOptions": {
+                    "type": "object",
+                    "additionalProperties": {
+                        "oneOf": [
+                            { "type": "string" },
+                            { "type": "number" },
+                            { "type": "boolean" }
+                        ]
+                    }
+                }
+            }
+        },
+        "SpacingOptions": {
+            "type": "object",
+            "properties": {
+                "nodeNode": { "type": "number", "minimum": 0 },
+                "nodeEdge": { "type": "number", "minimum": 0 },
+                "edgeEdge": { "type": "number", "minimum": 0 },
+                "layerSpacing": { "type": "number", "minimum": 0 }
+            }
+        },
+        "NodeLayoutOptions": {
+            "type": "object",
+            "properties": {
+                "portConstraints": {
+                    "type": "string",
+                    "enum": ["FREE", "FIXED_SIDE", "FIXED_ORDER", "FIXED_POS"]
+                },
+                "portAlignment": {
+                    "type": "string",
+                    "enum": ["BEGIN", "CENTER", "END", "JUSTIFIED"]
+                },
+                "sizeConstraints": {
+                    "type": "array",
+                    "items": {
+                        "type": "string",
+                        "enum": ["MINIMUM_SIZE", "NODE_LABELS", "PORTS"]
+                    }
+                },
+                "minimumSize": { "$ref": "#/$defs/Dimensions" },
+                "padding": {
+                    "type": "object",
+                    "properties": {
+                        "top": { "type": "number", "minimum": 0 },
+                        "right": { "type": "number", "minimum": 0 },
+                        "bottom": { "type": "number", "minimum": 0 },
+                        "left": { "type": "number", "minimum": 0 }
+                    }
+                }
+            }
+        },
+        "SourceInfo": {
+            "type": "object",
+            "required": ["range"],
+            "properties": {
+                "range": { "$ref": "#/$defs/SourceRange" },
+                "leadingComments": {
+                    "type": "array",
+                    "items": { "$ref": "#/$defs/Comment" }
+                },
+                "trailingComment": { "$ref": "#/$defs/Comment" },
+                "leadingWhitespace": { "type": "string" },
+                "modified": { "type": "boolean" },
+                "originalText": { "type": "string" }
+            }
+        },
+        "SourceRange": {
+            "type": "object",
+            "required": ["start", "end"],
+            "properties": {
+                "start": { "type": "integer", "minimum": 0 },
+                "end": { "type": "integer", "minimum": 0 },
+                "startPosition": {
+                    "type": "object",
+                    "required": ["line", "column"],
+                    "properties": {
+                        "line": { "type": "integer", "minimum": 0 },
+                        "column": { "type": "integer", "minimum": 0 }
+                    }
+                },
+                "endPosition": {
+                    "type": "object",
+                    "required": ["line", "column"],
+                    "properties": {
+                        "line": { "type": "integer", "minimum": 0 },
+                        "column": { "type": "integer", "minimum": 0 }
+                    }
+                }
+            }
+        },
+        "Comment": {
+            "type": "object",
+            "required": ["text", "style"],
+            "properties": {
+                "text": { "type": "string" },
+                "style": {
+                    "type": "string",
+                    "enum": ["line", "block"]
+                },
+                "range": { "$ref": "#/$defs/SourceRange" }
+            }
+        },
+        "GraphMetadata": {
+            "type": "object",
+            "properties": {
+                "author": { "type": "string" },
+                "created": {
+                    "type": "string",
+                    "format": "date-time"
+                },
+                "modified": {
+                    "type": "string",
+                    "format": "date-time"
+                },
+                "description": { "type": "string" },
+                "tags": {
+                    "type": "array",
+                    "items": { "type": "string" }
+                },
+                "notation": {
+                    "type": "string",
+                    "description": "Notation used by the graph, such as flowchart or ERD"
+                },
+                "custom": {
+                    "type": "object",
+                    "additionalProperties": true
+                }
+            }
+        }
+    }
+}

package/dist/skills/diff.d.ts

@@ -0,0 +1,73 @@
+/**
+ * IR Diff Skill
+ *
+ * Compare two Graph-IR files and display semantic differences.
+ */
+import type { GraphIR } from '@graph-ir/core';
+export interface DiffOptions {
+    /** Fields to ignore during comparison */
+    ignore?: string[];
+    /** Output format */
+    format?: 'pretty' | 'json' | 'markdown';
+    /** Only show summary statistics */
+    statsOnly?: boolean;
+}
+export interface DiffResult {
+    success: boolean;
+    changes: {
+        nodes: {
+            added: NodeChange[];
+            removed: NodeChange[];
+            modified: NodeModification[];
+        };
+        edges: {
+            added: EdgeChange[];
+            removed: EdgeChange[];
+            modified: EdgeModification[];
+        };
+    };
+    summary: {
+        nodes: {
+            added: number;
+            modified: number;
+            removed: number;
+        };
+        edges: {
+            added: number;
+            modified: number;
+            removed: number;
+        };
+    };
+    output: string;
+    errors: string[];
+}
+interface NodeChange {
+    id: string;
+    type: string;
+    label?: string;
+}
+interface EdgeChange {
+    id: string;
+    source: string;
+    target: string;
+    label?: string;
+}
+interface FieldChange {
+    path: string;
+    from: unknown;
+    to: unknown;
+}
+interface NodeModification {
+    id: string;
+    changes: FieldChange[];
+}
+interface EdgeModification {
+    id: string;
+    changes: FieldChange[];
+}
+/**
+ * Compare two Graph-IR objects
+ */
+export declare function diffIR(base: GraphIR, target: GraphIR, options?: DiffOptions): DiffResult;
+export {};
+//# sourceMappingURL=diff.d.ts.map

package/dist/skills/diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.d.ts","sourceRoot":"","sources":["../../src/skills/diff.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAwB,MAAM,gBAAgB,CAAC;AAEpE,MAAM,WAAW,WAAW;IAC1B,yCAAyC;IACzC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,oBAAoB;IACpB,MAAM,CAAC,EAAE,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAC;IACxC,mCAAmC;IACnC,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE;QACP,KAAK,EAAE;YACL,KAAK,EAAE,UAAU,EAAE,CAAC;YACpB,OAAO,EAAE,UAAU,EAAE,CAAC;YACtB,QAAQ,EAAE,gBAAgB,EAAE,CAAC;SAC9B,CAAC;QACF,KAAK,EAAE;YACL,KAAK,EAAE,UAAU,EAAE,CAAC;YACpB,OAAO,EAAE,UAAU,EAAE,CAAC;YACtB,QAAQ,EAAE,gBAAgB,EAAE,CAAC;SAC9B,CAAC;KACH,CAAC;IACF,OAAO,EAAE;QACP,KAAK,EAAE;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,QAAQ,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAA;SAAE,CAAC;QAC5D,KAAK,EAAE;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,QAAQ,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAA;SAAE,CAAC;KAC7D,CAAC;IACF,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,UAAU,UAAU;IAClB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,UAAU,UAAU;IAClB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,UAAU,WAAW;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,OAAO,CAAC;IACd,EAAE,EAAE,OAAO,CAAC;CACb;AAED,UAAU,gBAAgB;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,WAAW,EAAE,CAAC;CACxB;AAED,UAAU,gBAAgB;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,WAAW,EAAE,CAAC;CACxB;AAID;;GAEG;AACH,wBAAgB,MAAM,CACpB,IAAI,EAAE,OAAO,EACb,MAAM,EAAE,OAAO,EACf,OAAO,GAAE,WAAgB,GACxB,UAAU,CA8IZ"}