@harness-engineering/linter-gen 0.1.0

package/dist/templates/templates/dependency-graph.ts.hbs

@@ -0,0 +1,123 @@
+// Generated by @harness-engineering/linter-gen
+// Do not edit manually - regenerate from harness-linter.yml
+// Config: {{meta.configPath}}
+
+import { ESLintUtils, type TSESTree } from '@typescript-eslint/utils';
+import { minimatch } from 'minimatch';
+import * as path from 'path';
+
+const createRule = ESLintUtils.RuleCreator(
+  () => 'https://github.com/harness-engineering/linter-gen'
+);
+
+type MessageIds = 'circularDependency';
+
+const ENTRY_POINTS: string[] = {{{json config.entryPoints}}};
+const EXCLUDE_PATTERNS: string[] = {{{json config.exclude}}};
+const MAX_DEPTH = {{#if config.maxDepth}}{{config.maxDepth}}{{else}}20{{/if}};
+
+/**
+ * Normalize path separators to forward slashes
+ */
+function normalizePath(filePath: string): string {
+  return filePath.replace(/\\/g, '/');
+}
+
+/**
+ * Check if a path matches any of the exclude patterns
+ */
+function isExcluded(filePath: string): boolean {
+  const normalized = normalizePath(filePath);
+  return EXCLUDE_PATTERNS.some((pattern) =>
+    minimatch(normalized, pattern, { matchBase: true })
+  );
+}
+
+// Track imports per file for cycle detection
+const importGraph = new Map<string, Set<string>>();
+
+export default createRule<[], MessageIds>({
+  name: '{{name}}',
+  meta: {
+    type: 'problem',
+    docs: {
+      description: 'Detect circular import dependencies',
+    },
+    messages: {
+      circularDependency:
+        'Circular dependency detected: {{cycle}}',
+    },
+    schema: [],
+  },
+  defaultOptions: [],
+  create(context) {
+    const filePath = normalizePath(context.filename);
+
+    if (isExcluded(filePath)) {
+      return {};
+    }
+
+    const imports = new Set<string>();
+
+    return {
+      ImportDeclaration(node: TSESTree.ImportDeclaration) {
+        const importPath = String(node.source.value);
+
+        // Only track relative imports (internal dependencies)
+        if (!importPath.startsWith('.')) {
+          return;
+        }
+
+        // Resolve to absolute path
+        const resolvedPath = normalizePath(
+          path.resolve(path.dirname(context.filename), importPath)
+        );
+
+        imports.add(resolvedPath);
+      },
+
+      'Program:exit'() {
+        // Store this file's imports
+        importGraph.set(filePath, imports);
+
+        // Check for cycles starting from this file
+        const visited = new Set<string>();
+        const stack: string[] = [];
+
+        function detectCycle(current: string, depth: number): string[] | null {
+          if (depth > MAX_DEPTH) return null;
+          if (stack.includes(current)) {
+            const cycleStart = stack.indexOf(current);
+            return [...stack.slice(cycleStart), current];
+          }
+          if (visited.has(current)) return null;
+
+          visited.add(current);
+          stack.push(current);
+
+          const deps = importGraph.get(current);
+          if (deps) {
+            for (const dep of deps) {
+              const cycle = detectCycle(dep, depth + 1);
+              if (cycle) return cycle;
+            }
+          }
+
+          stack.pop();
+          return null;
+        }
+
+        const cycle = detectCycle(filePath, 0);
+        if (cycle) {
+          context.report({
+            loc: { line: 1, column: 0 },
+            messageId: 'circularDependency',
+            data: {
+              cycle: cycle.map((p) => path.basename(p)).join(' → '),
+            },
+          });
+        }
+      },
+    };
+  },
+});

package/dist/templates/templates/import-restriction.ts.hbs

@@ -0,0 +1,72 @@
+// Generated by @harness-engineering/linter-gen
+// Do not edit manually - regenerate from harness-linter.yml
+// Config: {{meta.configPath}}
+
+import { ESLintUtils, type TSESTree } from '@typescript-eslint/utils';
+import { minimatch } from 'minimatch';
+import * as path from 'path';
+
+const createRule = ESLintUtils.RuleCreator(
+  () => 'https://github.com/harness-engineering/linter-gen'
+);
+
+type MessageIds = 'forbidden';
+
+const SOURCE_PATTERN = '{{{json config.source}}}';
+const FORBIDDEN_IMPORTS: string[] = {{{json config.forbiddenImports}}};
+const MESSAGE = '{{{config.message}}}';
+
+/**
+ * Normalize path separators to forward slashes
+ */
+function normalizePath(filePath: string): string {
+  return filePath.replace(/\\/g, '/');
+}
+
+/**
+ * Check if a path matches a glob pattern
+ */
+function matchesPattern(filePath: string, pattern: string): boolean {
+  const normalized = normalizePath(filePath);
+  return minimatch(normalized, pattern, { matchBase: true });
+}
+
+export default createRule<[], MessageIds>({
+  name: '{{name}}',
+  meta: {
+    type: 'problem',
+    docs: {
+      description: MESSAGE,
+    },
+    messages: {
+      forbidden: MESSAGE,
+    },
+    schema: [],
+  },
+  defaultOptions: [],
+  create(context) {
+    const filePath = normalizePath(context.filename);
+
+    // Only apply to files matching source pattern
+    if (!matchesPattern(filePath, SOURCE_PATTERN)) {
+      return {};
+    }
+
+    return {
+      ImportDeclaration(node: TSESTree.ImportDeclaration) {
+        const importPath = String(node.source.value);
+
+        for (const forbidden of FORBIDDEN_IMPORTS) {
+          // Check exact match or pattern match
+          if (importPath === forbidden || matchesPattern(importPath, forbidden)) {
+            context.report({
+              node,
+              messageId: 'forbidden',
+            });
+            return;
+          }
+        }
+      },
+    };
+  },
+});

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@harness-engineering/linter-gen",
+  "version": "0.1.0",
+  "description": "Generate ESLint rules from YAML configuration",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "dependencies": {
+    "yaml": "^2.3.0",
+    "handlebars": "^4.7.0",
+    "zod": "^3.22.0",
+    "minimatch": "^9.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.0.0",
+    "vitest": "^2.0.0"
+  },
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Intense-Visions/harness-engineering.git",
+    "directory": "packages/linter-gen"
+  },
+  "bugs": {
+    "url": "https://github.com/Intense-Visions/harness-engineering/issues"
+  },
+  "homepage": "https://github.com/Intense-Visions/harness-engineering/tree/main/packages/linter-gen#readme",
+  "scripts": {
+    "build": "tsc && cp -r src/templates dist/templates",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "eslint src",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  }
+}