@principal-ai/subsystems-core 0.29.0

package/dist/rules/implementations/index.js

@@ -0,0 +1,73 @@
+"use strict";
+/**
+ * Built-in rule implementations
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.builtinRules = exports.validActionPatterns = exports.deadEndStates = exports.unreachableStates = exports.orphanedEdgeTypes = exports.orphanedNodeTypes = exports.minimumNodeSources = exports.stateTransitionReferences = exports.connectionTypeReferences = exports.noUnknownFields = exports.validColorFormat = exports.validEdgeTypes = exports.validNodeTypes = exports.requiredMetadata = void 0;
+// Schema rules
+var required_metadata_1 = require("./required-metadata");
+Object.defineProperty(exports, "requiredMetadata", { enumerable: true, get: function () { return required_metadata_1.requiredMetadata; } });
+var valid_node_types_1 = require("./valid-node-types");
+Object.defineProperty(exports, "validNodeTypes", { enumerable: true, get: function () { return valid_node_types_1.validNodeTypes; } });
+var valid_edge_types_1 = require("./valid-edge-types");
+Object.defineProperty(exports, "validEdgeTypes", { enumerable: true, get: function () { return valid_edge_types_1.validEdgeTypes; } });
+var valid_color_format_1 = require("./valid-color-format");
+Object.defineProperty(exports, "validColorFormat", { enumerable: true, get: function () { return valid_color_format_1.validColorFormat; } });
+var no_unknown_fields_1 = require("./no-unknown-fields");
+Object.defineProperty(exports, "noUnknownFields", { enumerable: true, get: function () { return no_unknown_fields_1.noUnknownFields; } });
+// Reference rules
+var connection_type_references_1 = require("./connection-type-references");
+Object.defineProperty(exports, "connectionTypeReferences", { enumerable: true, get: function () { return connection_type_references_1.connectionTypeReferences; } });
+var state_transition_references_1 = require("./state-transition-references");
+Object.defineProperty(exports, "stateTransitionReferences", { enumerable: true, get: function () { return state_transition_references_1.stateTransitionReferences; } });
+// Structure rules
+var minimum_node_sources_1 = require("./minimum-node-sources");
+Object.defineProperty(exports, "minimumNodeSources", { enumerable: true, get: function () { return minimum_node_sources_1.minimumNodeSources; } });
+var orphaned_node_types_1 = require("./orphaned-node-types");
+Object.defineProperty(exports, "orphanedNodeTypes", { enumerable: true, get: function () { return orphaned_node_types_1.orphanedNodeTypes; } });
+var orphaned_edge_types_1 = require("./orphaned-edge-types");
+Object.defineProperty(exports, "orphanedEdgeTypes", { enumerable: true, get: function () { return orphaned_edge_types_1.orphanedEdgeTypes; } });
+var unreachable_states_1 = require("./unreachable-states");
+Object.defineProperty(exports, "unreachableStates", { enumerable: true, get: function () { return unreachable_states_1.unreachableStates; } });
+var dead_end_states_1 = require("./dead-end-states");
+Object.defineProperty(exports, "deadEndStates", { enumerable: true, get: function () { return dead_end_states_1.deadEndStates; } });
+// Pattern rules
+var valid_action_patterns_1 = require("./valid-action-patterns");
+Object.defineProperty(exports, "validActionPatterns", { enumerable: true, get: function () { return valid_action_patterns_1.validActionPatterns; } });
+const required_metadata_2 = require("./required-metadata");
+const valid_node_types_2 = require("./valid-node-types");
+const valid_edge_types_2 = require("./valid-edge-types");
+const valid_color_format_2 = require("./valid-color-format");
+const no_unknown_fields_2 = require("./no-unknown-fields");
+const connection_type_references_2 = require("./connection-type-references");
+const state_transition_references_2 = require("./state-transition-references");
+const minimum_node_sources_2 = require("./minimum-node-sources");
+const orphaned_node_types_2 = require("./orphaned-node-types");
+const orphaned_edge_types_2 = require("./orphaned-edge-types");
+const unreachable_states_2 = require("./unreachable-states");
+const dead_end_states_2 = require("./dead-end-states");
+const valid_action_patterns_2 = require("./valid-action-patterns");
+/**
+ * All built-in rules
+ * Cast to GraphRule[] since rules with specific options extend the base interface
+ */
+exports.builtinRules = [
+    // Schema rules (5)
+    no_unknown_fields_2.noUnknownFields,
+    required_metadata_2.requiredMetadata,
+    valid_node_types_2.validNodeTypes,
+    valid_edge_types_2.validEdgeTypes,
+    valid_color_format_2.validColorFormat,
+    // Reference rules (2)
+    connection_type_references_2.connectionTypeReferences,
+    state_transition_references_2.stateTransitionReferences,
+    // Structure rules (5)
+    minimum_node_sources_2.minimumNodeSources,
+    orphaned_node_types_2.orphanedNodeTypes,
+    orphaned_edge_types_2.orphanedEdgeTypes,
+    unreachable_states_2.unreachableStates,
+    dead_end_states_2.deadEndStates,
+    // Pattern rules (1)
+    valid_action_patterns_2.validActionPatterns,
+];
+//# sourceMappingURL=index.js.map

package/dist/rules/implementations/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/rules/implementations/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,eAAe;AACf,yDAAuD;AAA9C,qHAAA,gBAAgB,OAAA;AACzB,uDAAoD;AAA3C,kHAAA,cAAc,OAAA;AACvB,uDAAoD;AAA3C,kHAAA,cAAc,OAAA;AACvB,2DAAwD;AAA/C,sHAAA,gBAAgB,OAAA;AACzB,yDAAsD;AAA7C,oHAAA,eAAe,OAAA;AAExB,kBAAkB;AAClB,2EAAwE;AAA/D,sIAAA,wBAAwB,OAAA;AACjC,6EAA0E;AAAjE,wIAAA,yBAAyB,OAAA;AAElC,kBAAkB;AAClB,+DAA4F;AAAnF,0HAAA,kBAAkB,OAAA;AAC3B,6DAA0D;AAAjD,wHAAA,iBAAiB,OAAA;AAC1B,6DAA0D;AAAjD,wHAAA,iBAAiB,OAAA;AAC1B,2DAAyD;AAAhD,uHAAA,iBAAiB,OAAA;AAC1B,qDAA6E;AAApE,gHAAA,aAAa,OAAA;AAEtB,gBAAgB;AAChB,iEAA+F;AAAtF,4HAAA,mBAAmB,OAAA;AAG5B,2DAAuD;AACvD,yDAAoD;AACpD,yDAAoD;AACpD,6DAAwD;AACxD,2DAAsD;AACtD,6EAAwE;AACxE,+EAA0E;AAC1E,iEAA4D;AAC5D,+DAA0D;AAC1D,+DAA0D;AAC1D,6DAAyD;AACzD,uDAAkD;AAClD,mEAA8D;AAE9D;;;GAGG;AACU,QAAA,YAAY,GAAgB;IACvC,mBAAmB;IACnB,mCAAe;IACf,oCAAgB;IAChB,iCAAc;IACd,iCAAc;IACd,qCAAgB;IAEhB,sBAAsB;IACtB,qDAAwB;IACxB,uDAAyB;IAEzB,sBAAsB;IACtB,yCAA0C;IAC1C,uCAAiB;IACjB,uCAAiB;IACjB,sCAAiB;IACjB,+BAAqC;IAErC,oBAAoB;IACpB,2CAA2C;CAC5C,CAAC"}

package/dist/rules/implementations/minimum-node-sources.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Rule: minimum-node-sources
+ * Ensures each nodeType has at least a minimum number of references (or sources) defined
+ *
+ * Note: This rule checks `references` field, with fallback to deprecated `sources` field.
+ */
+import type { GraphRule, RuleOptions } from '../types';
+/**
+ * Options for minimum-node-sources rule
+ */
+export interface MinimumNodeSourcesOptions extends RuleOptions {
+    /**
+     * Minimum number of references required per nodeType
+     * @default 1
+     */
+    minimum: number;
+    /**
+     * NodeType IDs to exclude from this check
+     * @default []
+     */
+    excludeNodeTypes: string[];
+}
+export declare const minimumNodeSources: GraphRule<MinimumNodeSourcesOptions>;
+//# sourceMappingURL=minimum-node-sources.d.ts.map

package/dist/rules/implementations/minimum-node-sources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"minimum-node-sources.d.ts","sourceRoot":"","sources":["../../../src/rules/implementations/minimum-node-sources.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAwC,WAAW,EAAE,MAAM,UAAU,CAAC;AAE7F;;GAEG;AACH,MAAM,WAAW,yBAA0B,SAAQ,WAAW;IAC5D;;;OAGG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,gBAAgB,EAAE,MAAM,EAAE,CAAC;CAC5B;AAOD,eAAO,MAAM,kBAAkB,EAAE,SAAS,CAAC,yBAAyB,CAoDnE,CAAC"}

package/dist/rules/implementations/minimum-node-sources.js

@@ -0,0 +1,59 @@
+"use strict";
+/**
+ * Rule: minimum-node-sources
+ * Ensures each nodeType has at least a minimum number of references (or sources) defined
+ *
+ * Note: This rule checks `references` field, with fallback to deprecated `sources` field.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.minimumNodeSources = void 0;
+const DEFAULT_OPTIONS = {
+    minimum: 1,
+    excludeNodeTypes: [],
+};
+exports.minimumNodeSources = {
+    id: 'minimum-node-sources',
+    name: 'Minimum Node References',
+    description: 'Each nodeType must have at least a minimum number of references defined',
+    impact: 'NodeTypes without references cannot be associated with log activity',
+    severity: 'error',
+    category: 'structure',
+    enabled: true,
+    fixable: false,
+    defaultOptions: DEFAULT_OPTIONS,
+    async check(context) {
+        const violations = [];
+        const { configuration, configPath, options } = context;
+        const minimum = options.minimum ?? DEFAULT_OPTIONS.minimum;
+        const excludeNodeTypes = options.excludeNodeTypes ?? DEFAULT_OPTIONS.excludeNodeTypes;
+        if (!configuration.nodeTypes) {
+            return violations;
+        }
+        for (const [typeId, nodeType] of Object.entries(configuration.nodeTypes)) {
+            // Skip excluded node types
+            if (excludeNodeTypes.includes(typeId)) {
+                continue;
+            }
+            // Get references from nodeType, with fallback to deprecated sources
+            const nodeTypeAny = nodeType;
+            const refs = nodeTypeAny.references ?? nodeTypeAny.sources;
+            const refCount = Array.isArray(refs) ? refs.length : 0;
+            if (refCount < minimum) {
+                violations.push({
+                    ruleId: 'minimum-node-sources',
+                    severity: 'error',
+                    file: configPath,
+                    path: `nodeTypes.${typeId}.references`,
+                    message: refCount === 0
+                        ? `Node type "${typeId}" has no references defined`
+                        : `Node type "${typeId}" has ${refCount} reference(s), minimum required is ${minimum}`,
+                    impact: 'This node type cannot be associated with log activity from source files',
+                    suggestion: `Add at least ${minimum} reference path(s) to nodeTypes.${typeId}.references`,
+                    fixable: false,
+                });
+            }
+        }
+        return violations;
+    },
+};
+//# sourceMappingURL=minimum-node-sources.js.map

package/dist/rules/implementations/minimum-node-sources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"minimum-node-sources.js","sourceRoot":"","sources":["../../../src/rules/implementations/minimum-node-sources.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAqBH,MAAM,eAAe,GAA8B;IACjD,OAAO,EAAE,CAAC;IACV,gBAAgB,EAAE,EAAE;CACrB,CAAC;AAEW,QAAA,kBAAkB,GAAyC;IACtE,EAAE,EAAE,sBAAsB;IAC1B,IAAI,EAAE,yBAAyB;IAC/B,WAAW,EAAE,yEAAyE;IACtF,MAAM,EAAE,qEAAqE;IAC7E,QAAQ,EAAE,OAAO;IACjB,QAAQ,EAAE,WAAW;IACrB,OAAO,EAAE,IAAI;IACb,OAAO,EAAE,KAAK;IACd,cAAc,EAAE,eAAe;IAE/B,KAAK,CAAC,KAAK,CAAC,OAAoD;QAC9D,MAAM,UAAU,GAAyB,EAAE,CAAC;QAC5C,MAAM,EAAE,aAAa,EAAE,UAAU,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;QAEvD,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,eAAe,CAAC,OAAO,CAAC;QAC3D,MAAM,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,IAAI,eAAe,CAAC,gBAAgB,CAAC;QAEtF,IAAI,CAAC,aAAa,CAAC,SAAS,EAAE;YAC5B,OAAO,UAAU,CAAC;SACnB;QAED,KAAK,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,SAAS,CAAC,EAAE;YACxE,2BAA2B;YAC3B,IAAI,gBAAgB,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE;gBACrC,SAAS;aACV;YAED,oEAAoE;YACpE,MAAM,WAAW,GAAG,QAA8C,CAAC;YACnE,MAAM,IAAI,GAAG,WAAW,CAAC,UAAU,IAAI,WAAW,CAAC,OAAO,CAAC;YAC3D,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;YAEvD,IAAI,QAAQ,GAAG,OAAO,EAAE;gBACtB,UAAU,CAAC,IAAI,CAAC;oBACd,MAAM,EAAE,sBAAsB;oBAC9B,QAAQ,EAAE,OAAO;oBACjB,IAAI,EAAE,UAAU;oBAChB,IAAI,EAAE,aAAa,MAAM,aAAa;oBACtC,OAAO,EACL,QAAQ,KAAK,CAAC;wBACZ,CAAC,CAAC,cAAc,MAAM,6BAA6B;wBACnD,CAAC,CAAC,cAAc,MAAM,SAAS,QAAQ,sCAAsC,OAAO,EAAE;oBAC1F,MAAM,EAAE,yEAAyE;oBACjF,UAAU,EAAE,gBAAgB,OAAO,mCAAmC,MAAM,aAAa;oBACzF,OAAO,EAAE,KAAK;iBACf,CAAC,CAAC;aACJ;SACF;QAED,OAAO,UAAU,CAAC;IACpB,CAAC;CACF,CAAC"}

package/dist/rules/implementations/no-unknown-fields.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Rule: no-unknown-fields
+ * Flags fields that are not defined in the configuration schema
+ */
+import type { GraphRule } from '../types';
+export declare const noUnknownFields: GraphRule;
+//# sourceMappingURL=no-unknown-fields.d.ts.map

package/dist/rules/implementations/no-unknown-fields.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"no-unknown-fields.d.ts","sourceRoot":"","sources":["../../../src/rules/implementations/no-unknown-fields.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAwC,MAAM,UAAU,CAAC;AAiDhF,eAAO,MAAM,eAAe,EAAE,SAkQ7B,CAAC"}

package/dist/rules/implementations/no-unknown-fields.js

@@ -0,0 +1,216 @@
+"use strict";
+/**
+ * Rule: no-unknown-fields
+ * Flags fields that are not defined in the configuration schema
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.noUnknownFields = void 0;
+/**
+ * Allowed fields for each configuration section
+ */
+const ALLOWED_FIELDS = {
+    root: ['metadata', 'nodeTypes', 'edgeTypes', 'allowedConnections', 'validation', 'display'],
+    metadata: ['name', 'version', 'description'],
+    nodeType: [
+        'description',
+        'shape',
+        'icon',
+        'color',
+        'stroke',
+        'size',
+        'dataSchema',
+        'states',
+        'layout',
+        'sources',
+        'actions',
+    ],
+    edgeType: [
+        'style',
+        'color',
+        'width',
+        'directed',
+        'animated',
+        'label',
+        'animation',
+        'dataSchema',
+        'activatedBy',
+    ],
+    connectionRule: ['from', 'to', 'via', 'constraints'],
+    connectionConstraints: ['maxInstances', 'bidirectional', 'exclusive'],
+    validation: ['stateTransitions', 'constraints', 'cardinality'],
+    display: ['layout', 'theme', 'animations'],
+    displayTheme: ['primary', 'success', 'warning', 'danger', 'info'],
+    displayAnimations: ['enabled', 'speed'],
+    dataSchemaField: ['type', 'required', 'displayInLabel', 'label', 'displayInInfo', 'description', 'placeholder'],
+    stateDefinition: ['color', 'icon', 'label'],
+    layoutHints: ['layer', 'cluster'],
+    edgeLabel: ['field', 'position'],
+    edgeAnimation: ['type', 'duration', 'color'],
+    nodeSize: ['width', 'height'],
+    stateTransition: ['from', 'to'],
+    constraint: ['id', 'description', 'check', 'severity'],
+    actionPattern: ['pattern', 'event', 'state', 'metadata'],
+};
+exports.noUnknownFields = {
+    id: 'no-unknown-fields',
+    name: 'No Unknown Fields',
+    description: 'Flag fields that are not defined in the configuration schema',
+    impact: 'Unknown fields are likely typos and will be ignored',
+    severity: 'error',
+    category: 'schema',
+    enabled: true,
+    fixable: true,
+    async check(context) {
+        const violations = [];
+        const { configuration, configPath } = context;
+        // Check root level fields
+        checkFields(configuration, ALLOWED_FIELDS.root, '', configPath, violations);
+        // Check metadata fields
+        if (configuration.metadata) {
+            checkFields(configuration.metadata, ALLOWED_FIELDS.metadata, 'metadata', configPath, violations);
+        }
+        // Check nodeTypes
+        if (configuration.nodeTypes) {
+            for (const [typeId, nodeType] of Object.entries(configuration.nodeTypes)) {
+                const basePath = `nodeTypes.${typeId}`;
+                checkFields(nodeType, ALLOWED_FIELDS.nodeType, basePath, configPath, violations);
+                // Check nested fields in nodeType
+                if (nodeType.dataSchema) {
+                    for (const [fieldName, fieldDef] of Object.entries(nodeType.dataSchema)) {
+                        checkFields(fieldDef, ALLOWED_FIELDS.dataSchemaField, `${basePath}.dataSchema.${fieldName}`, configPath, violations);
+                    }
+                }
+                if (nodeType.states) {
+                    for (const [stateName, stateDef] of Object.entries(nodeType.states)) {
+                        checkFields(stateDef, ALLOWED_FIELDS.stateDefinition, `${basePath}.states.${stateName}`, configPath, violations);
+                    }
+                }
+                if (nodeType.layout) {
+                    checkFields(nodeType.layout, ALLOWED_FIELDS.layoutHints, `${basePath}.layout`, configPath, violations);
+                }
+                if (nodeType.size) {
+                    checkFields(nodeType.size, ALLOWED_FIELDS.nodeSize, `${basePath}.size`, configPath, violations);
+                }
+                // Check actions
+                const nodeTypeAny = nodeType;
+                if (Array.isArray(nodeTypeAny.actions)) {
+                    nodeTypeAny.actions.forEach((action, index) => {
+                        if (typeof action === 'object' && action !== null) {
+                            checkFields(action, ALLOWED_FIELDS.actionPattern, `${basePath}.actions[${index}]`, configPath, violations);
+                        }
+                    });
+                }
+            }
+        }
+        // Check edgeTypes
+        if (configuration.edgeTypes) {
+            for (const [typeId, edgeType] of Object.entries(configuration.edgeTypes)) {
+                const basePath = `edgeTypes.${typeId}`;
+                checkFields(edgeType, ALLOWED_FIELDS.edgeType, basePath, configPath, violations);
+                if (edgeType.label && typeof edgeType.label === 'object') {
+                    checkFields(edgeType.label, ALLOWED_FIELDS.edgeLabel, `${basePath}.label`, configPath, violations);
+                }
+                if (edgeType.animation && typeof edgeType.animation === 'object') {
+                    checkFields(edgeType.animation, ALLOWED_FIELDS.edgeAnimation, `${basePath}.animation`, configPath, violations);
+                }
+                if (edgeType.dataSchema) {
+                    for (const [fieldName, fieldDef] of Object.entries(edgeType.dataSchema)) {
+                        checkFields(fieldDef, ALLOWED_FIELDS.dataSchemaField, `${basePath}.dataSchema.${fieldName}`, configPath, violations);
+                    }
+                }
+            }
+        }
+        // Check allowedConnections
+        if (configuration.allowedConnections) {
+            configuration.allowedConnections.forEach((rule, index) => {
+                const basePath = `allowedConnections[${index}]`;
+                checkFields(rule, ALLOWED_FIELDS.connectionRule, basePath, configPath, violations);
+                if (rule.constraints) {
+                    checkFields(rule.constraints, ALLOWED_FIELDS.connectionConstraints, `${basePath}.constraints`, configPath, violations);
+                }
+            });
+        }
+        // Check validation
+        if (configuration.validation) {
+            checkFields(configuration.validation, ALLOWED_FIELDS.validation, 'validation', configPath, violations);
+            // Check state transitions
+            if (configuration.validation.stateTransitions) {
+                for (const [nodeType, transitions] of Object.entries(configuration.validation.stateTransitions)) {
+                    if (Array.isArray(transitions)) {
+                        transitions.forEach((transition, index) => {
+                            checkFields(transition, ALLOWED_FIELDS.stateTransition, `validation.stateTransitions.${nodeType}[${index}]`, configPath, violations);
+                        });
+                    }
+                }
+            }
+            // Check constraints
+            if (configuration.validation.constraints &&
+                Array.isArray(configuration.validation.constraints)) {
+                configuration.validation.constraints.forEach((constraint, index) => {
+                    checkFields(constraint, ALLOWED_FIELDS.constraint, `validation.constraints[${index}]`, configPath, violations);
+                });
+            }
+        }
+        // Check display
+        if (configuration.display) {
+            checkFields(configuration.display, ALLOWED_FIELDS.display, 'display', configPath, violations);
+            if (configuration.display.theme) {
+                checkFields(configuration.display.theme, ALLOWED_FIELDS.displayTheme, 'display.theme', configPath, violations);
+            }
+            if (configuration.display.animations) {
+                checkFields(configuration.display.animations, ALLOWED_FIELDS.displayAnimations, 'display.animations', configPath, violations);
+            }
+        }
+        return violations;
+    },
+};
+/**
+ * Check an object's fields against allowed fields
+ */
+function checkFields(obj, allowedFields, path, configPath, violations) {
+    for (const field of Object.keys(obj)) {
+        if (!allowedFields.includes(field)) {
+            const suggestion = findSimilarField(field, allowedFields);
+            violations.push({
+                ruleId: 'no-unknown-fields',
+                severity: 'error',
+                file: configPath,
+                path: path ? `${path}.${field}` : field,
+                message: `Unknown field "${field}"${path ? ` in ${path}` : ' at root level'}`,
+                impact: 'This field will be ignored and may indicate a configuration error',
+                suggestion: suggestion
+                    ? `Did you mean "${suggestion}"? Allowed fields: ${allowedFields.join(', ')}`
+                    : `Allowed fields: ${allowedFields.join(', ')}`,
+                fixable: true,
+                fixData: { path, field, suggestion },
+            });
+        }
+    }
+}
+/**
+ * Find a similar field name for "did you mean" suggestions
+ */
+function findSimilarField(field, allowedFields) {
+    const fieldLower = field.toLowerCase();
+    for (const allowed of allowedFields) {
+        const allowedLower = allowed.toLowerCase();
+        // Check for substring match
+        if (fieldLower.includes(allowedLower) || allowedLower.includes(fieldLower)) {
+            return allowed;
+        }
+        // Check for small edit distance (typos)
+        if (Math.abs(field.length - allowed.length) <= 2) {
+            let differences = 0;
+            const minLen = Math.min(fieldLower.length, allowedLower.length);
+            for (let i = 0; i < minLen; i++) {
+                if (fieldLower[i] !== allowedLower[i])
+                    differences++;
+            }
+            differences += Math.abs(field.length - allowed.length);
+            if (differences <= 2)
+                return allowed;
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=no-unknown-fields.js.map

package/dist/rules/implementations/no-unknown-fields.js.map

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

package/dist/rules/implementations/orphaned-edge-types.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Rule: orphaned-edge-types
+ * Warns when edgeTypes are not used in any connection rule
+ */
+import type { GraphRule } from '../types';
+export declare const orphanedEdgeTypes: GraphRule;
+//# sourceMappingURL=orphaned-edge-types.d.ts.map

package/dist/rules/implementations/orphaned-edge-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orphaned-edge-types.d.ts","sourceRoot":"","sources":["../../../src/rules/implementations/orphaned-edge-types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAwC,MAAM,UAAU,CAAC;AAEhF,eAAO,MAAM,iBAAiB,EAAE,SA+C/B,CAAC"}

package/dist/rules/implementations/orphaned-edge-types.js

@@ -0,0 +1,50 @@
+"use strict";
+/**
+ * Rule: orphaned-edge-types
+ * Warns when edgeTypes are not used in any connection rule
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.orphanedEdgeTypes = void 0;
+exports.orphanedEdgeTypes = {
+    id: 'orphaned-edge-types',
+    name: 'Orphaned Edge Types',
+    description: 'EdgeTypes should be used in at least one connection rule',
+    impact: 'Orphaned edge types may indicate unused or misconfigured types',
+    severity: 'error',
+    category: 'structure',
+    enabled: true,
+    fixable: false,
+    async check(context) {
+        const violations = [];
+        const { configuration, configPath } = context;
+        if (!configuration.edgeTypes || Object.keys(configuration.edgeTypes).length === 0) {
+            return violations;
+        }
+        // Collect all edgeTypes referenced in allowedConnections
+        const referencedEdgeTypes = new Set();
+        if (configuration.allowedConnections) {
+            for (const connection of configuration.allowedConnections) {
+                if (connection.via) {
+                    referencedEdgeTypes.add(connection.via);
+                }
+            }
+        }
+        // Check each edgeType
+        for (const typeId of Object.keys(configuration.edgeTypes)) {
+            if (!referencedEdgeTypes.has(typeId)) {
+                violations.push({
+                    ruleId: 'orphaned-edge-types',
+                    severity: 'error',
+                    file: configPath,
+                    path: `edgeTypes.${typeId}`,
+                    message: `Edge type "${typeId}" is not used in any connection rule`,
+                    impact: 'This edge type may be unused or misconfigured',
+                    suggestion: `Add a connection rule using this edge type, or remove it if unused`,
+                    fixable: false,
+                });
+            }
+        }
+        return violations;
+    },
+};
+//# sourceMappingURL=orphaned-edge-types.js.map

package/dist/rules/implementations/orphaned-edge-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"orphaned-edge-types.js","sourceRoot":"","sources":["../../../src/rules/implementations/orphaned-edge-types.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAIU,QAAA,iBAAiB,GAAc;IAC1C,EAAE,EAAE,qBAAqB;IACzB,IAAI,EAAE,qBAAqB;IAC3B,WAAW,EAAE,0DAA0D;IACvE,MAAM,EAAE,gEAAgE;IACxE,QAAQ,EAAE,OAAO;IACjB,QAAQ,EAAE,WAAW;IACrB,OAAO,EAAE,IAAI;IACb,OAAO,EAAE,KAAK;IAEd,KAAK,CAAC,KAAK,CAAC,OAAyB;QACnC,MAAM,UAAU,GAAyB,EAAE,CAAC;QAC5C,MAAM,EAAE,aAAa,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC;QAE9C,IAAI,CAAC,aAAa,CAAC,SAAS,IAAI,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE;YACjF,OAAO,UAAU,CAAC;SACnB;QAED,yDAAyD;QACzD,MAAM,mBAAmB,GAAG,IAAI,GAAG,EAAU,CAAC;QAE9C,IAAI,aAAa,CAAC,kBAAkB,EAAE;YACpC,KAAK,MAAM,UAAU,IAAI,aAAa,CAAC,kBAAkB,EAAE;gBACzD,IAAI,UAAU,CAAC,GAAG,EAAE;oBAClB,mBAAmB,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;iBACzC;aACF;SACF;QAED,sBAAsB;QACtB,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,SAAS,CAAC,EAAE;YACzD,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE;gBACpC,UAAU,CAAC,IAAI,CAAC;oBACd,MAAM,EAAE,qBAAqB;oBAC7B,QAAQ,EAAE,OAAO;oBACjB,IAAI,EAAE,UAAU;oBAChB,IAAI,EAAE,aAAa,MAAM,EAAE;oBAC3B,OAAO,EAAE,cAAc,MAAM,sCAAsC;oBACnE,MAAM,EAAE,+CAA+C;oBACvD,UAAU,EAAE,oEAAoE;oBAChF,OAAO,EAAE,KAAK;iBACf,CAAC,CAAC;aACJ;SACF;QAED,OAAO,UAAU,CAAC;IACpB,CAAC;CACF,CAAC"}

package/dist/rules/implementations/orphaned-node-types.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Rule: orphaned-node-types
+ * Warns when nodeTypes are not used in any connection rule
+ */
+import type { GraphRule } from '../types';
+export declare const orphanedNodeTypes: GraphRule;
+//# sourceMappingURL=orphaned-node-types.d.ts.map

package/dist/rules/implementations/orphaned-node-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orphaned-node-types.d.ts","sourceRoot":"","sources":["../../../src/rules/implementations/orphaned-node-types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAwC,MAAM,UAAU,CAAC;AAEhF,eAAO,MAAM,iBAAiB,EAAE,SAkD/B,CAAC"}

package/dist/rules/implementations/orphaned-node-types.js

@@ -0,0 +1,53 @@
+"use strict";
+/**
+ * Rule: orphaned-node-types
+ * Warns when nodeTypes are not used in any connection rule
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.orphanedNodeTypes = void 0;
+exports.orphanedNodeTypes = {
+    id: 'orphaned-node-types',
+    name: 'Orphaned Node Types',
+    description: 'NodeTypes should be used in at least one connection rule',
+    impact: 'Orphaned node types may indicate unused or misconfigured types',
+    severity: 'error',
+    category: 'structure',
+    enabled: true,
+    fixable: false,
+    async check(context) {
+        const violations = [];
+        const { configuration, configPath } = context;
+        if (!configuration.nodeTypes || Object.keys(configuration.nodeTypes).length === 0) {
+            return violations;
+        }
+        // Collect all nodeTypes referenced in allowedConnections
+        const referencedNodeTypes = new Set();
+        if (configuration.allowedConnections) {
+            for (const connection of configuration.allowedConnections) {
+                if (connection.from) {
+                    referencedNodeTypes.add(connection.from);
+                }
+                if (connection.to) {
+                    referencedNodeTypes.add(connection.to);
+                }
+            }
+        }
+        // Check each nodeType
+        for (const typeId of Object.keys(configuration.nodeTypes)) {
+            if (!referencedNodeTypes.has(typeId)) {
+                violations.push({
+                    ruleId: 'orphaned-node-types',
+                    severity: 'error',
+                    file: configPath,
+                    path: `nodeTypes.${typeId}`,
+                    message: `Node type "${typeId}" is not used in any connection rule`,
+                    impact: 'This node type may be unused or misconfigured',
+                    suggestion: `Add a connection rule using this node type, or remove it if unused`,
+                    fixable: false,
+                });
+            }
+        }
+        return violations;
+    },
+};
+//# sourceMappingURL=orphaned-node-types.js.map

package/dist/rules/implementations/orphaned-node-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"orphaned-node-types.js","sourceRoot":"","sources":["../../../src/rules/implementations/orphaned-node-types.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAIU,QAAA,iBAAiB,GAAc;IAC1C,EAAE,EAAE,qBAAqB;IACzB,IAAI,EAAE,qBAAqB;IAC3B,WAAW,EAAE,0DAA0D;IACvE,MAAM,EAAE,gEAAgE;IACxE,QAAQ,EAAE,OAAO;IACjB,QAAQ,EAAE,WAAW;IACrB,OAAO,EAAE,IAAI;IACb,OAAO,EAAE,KAAK;IAEd,KAAK,CAAC,KAAK,CAAC,OAAyB;QACnC,MAAM,UAAU,GAAyB,EAAE,CAAC;QAC5C,MAAM,EAAE,aAAa,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC;QAE9C,IAAI,CAAC,aAAa,CAAC,SAAS,IAAI,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE;YACjF,OAAO,UAAU,CAAC;SACnB;QAED,yDAAyD;QACzD,MAAM,mBAAmB,GAAG,IAAI,GAAG,EAAU,CAAC;QAE9C,IAAI,aAAa,CAAC,kBAAkB,EAAE;YACpC,KAAK,MAAM,UAAU,IAAI,aAAa,CAAC,kBAAkB,EAAE;gBACzD,IAAI,UAAU,CAAC,IAAI,EAAE;oBACnB,mBAAmB,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;iBAC1C;gBACD,IAAI,UAAU,CAAC,EAAE,EAAE;oBACjB,mBAAmB,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;iBACxC;aACF;SACF;QAED,sBAAsB;QACtB,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,SAAS,CAAC,EAAE;YACzD,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE;gBACpC,UAAU,CAAC,IAAI,CAAC;oBACd,MAAM,EAAE,qBAAqB;oBAC7B,QAAQ,EAAE,OAAO;oBACjB,IAAI,EAAE,UAAU;oBAChB,IAAI,EAAE,aAAa,MAAM,EAAE;oBAC3B,OAAO,EAAE,cAAc,MAAM,sCAAsC;oBACnE,MAAM,EAAE,+CAA+C;oBACvD,UAAU,EAAE,oEAAoE;oBAChF,OAAO,EAAE,KAAK;iBACf,CAAC,CAAC;aACJ;SACF;QAED,OAAO,UAAU,CAAC;IACpB,CAAC;CACF,CAAC"}

package/dist/rules/implementations/required-metadata.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Rule: required-metadata
+ * Ensures configuration has required metadata fields (name, version)
+ */
+import type { GraphRule } from '../types';
+export declare const requiredMetadata: GraphRule;
+//# sourceMappingURL=required-metadata.d.ts.map

package/dist/rules/implementations/required-metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"required-metadata.d.ts","sourceRoot":"","sources":["../../../src/rules/implementations/required-metadata.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAwC,MAAM,UAAU,CAAC;AAEhF,eAAO,MAAM,gBAAgB,EAAE,SA4C9B,CAAC"}

package/dist/rules/implementations/required-metadata.js

@@ -0,0 +1,48 @@
+"use strict";
+/**
+ * Rule: required-metadata
+ * Ensures configuration has required metadata fields (name, version)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.requiredMetadata = void 0;
+exports.requiredMetadata = {
+    id: 'required-metadata',
+    name: 'Required Metadata',
+    description: 'Configuration must have name and version in metadata',
+    impact: 'Missing metadata makes configurations hard to identify and version',
+    severity: 'error',
+    category: 'schema',
+    enabled: true,
+    fixable: false,
+    async check(context) {
+        const violations = [];
+        const { configuration, configPath } = context;
+        if (!configuration.metadata) {
+            violations.push({
+                ruleId: 'required-metadata',
+                severity: 'error',
+                file: configPath,
+                path: 'metadata',
+                message: 'Configuration is missing metadata section',
+                impact: 'Cannot identify or version this configuration',
+                suggestion: 'Add a metadata section with name and version fields',
+                fixable: false,
+            });
+            return violations;
+        }
+        if (!configuration.metadata.name) {
+            violations.push({
+                ruleId: 'required-metadata',
+                severity: 'error',
+                file: configPath,
+                path: 'metadata.name',
+                message: 'Configuration metadata is missing required "name" field',
+                impact: 'Cannot identify this configuration',
+                suggestion: 'Add a name field to metadata',
+                fixable: false,
+            });
+        }
+        return violations;
+    },
+};
+//# sourceMappingURL=required-metadata.js.map

package/dist/rules/implementations/required-metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"required-metadata.js","sourceRoot":"","sources":["../../../src/rules/implementations/required-metadata.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAIU,QAAA,gBAAgB,GAAc;IACzC,EAAE,EAAE,mBAAmB;IACvB,IAAI,EAAE,mBAAmB;IACzB,WAAW,EAAE,sDAAsD;IACnE,MAAM,EAAE,oEAAoE;IAC5E,QAAQ,EAAE,OAAO;IACjB,QAAQ,EAAE,QAAQ;IAClB,OAAO,EAAE,IAAI;IACb,OAAO,EAAE,KAAK;IAEd,KAAK,CAAC,KAAK,CAAC,OAAyB;QACnC,MAAM,UAAU,GAAyB,EAAE,CAAC;QAC5C,MAAM,EAAE,aAAa,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC;QAE9C,IAAI,CAAC,aAAa,CAAC,QAAQ,EAAE;YAC3B,UAAU,CAAC,IAAI,CAAC;gBACd,MAAM,EAAE,mBAAmB;gBAC3B,QAAQ,EAAE,OAAO;gBACjB,IAAI,EAAE,UAAU;gBAChB,IAAI,EAAE,UAAU;gBAChB,OAAO,EAAE,2CAA2C;gBACpD,MAAM,EAAE,+CAA+C;gBACvD,UAAU,EAAE,qDAAqD;gBACjE,OAAO,EAAE,KAAK;aACf,CAAC,CAAC;YACH,OAAO,UAAU,CAAC;SACnB;QAED,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,IAAI,EAAE;YAChC,UAAU,CAAC,IAAI,CAAC;gBACd,MAAM,EAAE,mBAAmB;gBAC3B,QAAQ,EAAE,OAAO;gBACjB,IAAI,EAAE,UAAU;gBAChB,IAAI,EAAE,eAAe;gBACrB,OAAO,EAAE,yDAAyD;gBAClE,MAAM,EAAE,oCAAoC;gBAC5C,UAAU,EAAE,8BAA8B;gBAC1C,OAAO,EAAE,KAAK;aACf,CAAC,CAAC;SACJ;QAGD,OAAO,UAAU,CAAC;IACpB,CAAC;CACF,CAAC"}

package/dist/rules/implementations/state-transition-references.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Rule: state-transition-references
+ * Ensures state transitions only reference defined states
+ */
+import type { GraphRule } from '../types';
+export declare const stateTransitionReferences: GraphRule;
+//# sourceMappingURL=state-transition-references.d.ts.map

package/dist/rules/implementations/state-transition-references.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-transition-references.d.ts","sourceRoot":"","sources":["../../../src/rules/implementations/state-transition-references.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAwC,MAAM,UAAU,CAAC;AAEhF,eAAO,MAAM,yBAAyB,EAAE,SAsHvC,CAAC"}