@harness-engineering/eslint-plugin 0.1.0

package/dist/utils/path-utils.js

@@ -0,0 +1,62 @@
+// src/utils/path-utils.ts
+import * as path from 'path';
+import { minimatch } from 'minimatch';
+/**
+ * Resolve an import path relative to the importing file
+ * Returns path relative to project root (assumes /project/ prefix)
+ */
+export function resolveImportPath(importPath, importingFile) {
+    // External/absolute imports stay as-is
+    if (!importPath.startsWith('.')) {
+        return importPath;
+    }
+    // Resolve relative to importing file's directory
+    const importingDir = path.dirname(importingFile);
+    const resolved = path.resolve(importingDir, importPath);
+    // Extract path relative to project root
+    // Assumes paths like /project/src/... or /path/to/project/src/...
+    const srcIndex = resolved.indexOf('/src/');
+    if (srcIndex !== -1) {
+        return resolved.slice(srcIndex + 1); // Remove leading /
+    }
+    // Fallback: return as-is if no src/ found
+    return importPath;
+}
+/**
+ * Check if a file path matches a glob pattern
+ */
+export function matchesPattern(filePath, pattern) {
+    // Normalize path separators
+    const normalizedPath = filePath.replace(/\\/g, '/');
+    const normalizedPattern = pattern.replace(/\\/g, '/');
+    return minimatch(normalizedPath, normalizedPattern, { matchBase: false });
+}
+/**
+ * Find which layer a file belongs to
+ */
+export function getLayerForFile(filePath, layers) {
+    for (const layer of layers) {
+        if (matchesPattern(filePath, layer.pattern)) {
+            return layer.name;
+        }
+    }
+    return null;
+}
+/**
+ * Get layer definition by name
+ */
+export function getLayerByName(name, layers) {
+    return layers.find((l) => l.name === name);
+}
+/**
+ * Normalize a file path to project-relative format
+ * Extracts path from /any/path/src/... to src/...
+ */
+export function normalizePath(filePath) {
+    const srcIndex = filePath.indexOf('/src/');
+    if (srcIndex !== -1) {
+        return filePath.slice(srcIndex + 1);
+    }
+    return filePath;
+}
+//# sourceMappingURL=path-utils.js.map

package/dist/utils/path-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-utils.js","sourceRoot":"","sources":["../../src/utils/path-utils.ts"],"names":[],"mappings":"AAAA,0BAA0B;AAC1B,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAGtC;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,UAAkB,EAAE,aAAqB;IACzE,uCAAuC;IACvC,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAChC,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,iDAAiD;IACjD,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;IACjD,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC;IAExD,wCAAwC;IACxC,kEAAkE;IAClE,MAAM,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAC3C,IAAI,QAAQ,KAAK,CAAC,CAAC,EAAE,CAAC;QACpB,OAAO,QAAQ,CAAC,KAAK,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC,mBAAmB;IAC1D,CAAC;IAED,0CAA0C;IAC1C,OAAO,UAAU,CAAC;AACpB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,QAAgB,EAAE,OAAe;IAC9D,4BAA4B;IAC5B,MAAM,cAAc,GAAG,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACpD,MAAM,iBAAiB,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAEtD,OAAO,SAAS,CAAC,cAAc,EAAE,iBAAiB,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;AAC5E,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,QAAgB,EAAE,MAAe;IAC/D,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,cAAc,CAAC,QAAQ,EAAE,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;YAC5C,OAAO,KAAK,CAAC,IAAI,CAAC;QACpB,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY,EAAE,MAAe;IAC1D,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;AAC7C,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,QAAgB;IAC5C,MAAM,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAC3C,IAAI,QAAQ,KAAK,CAAC,CAAC,EAAE,CAAC;QACpB,OAAO,QAAQ,CAAC,KAAK,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC;IACtC,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/utils/schema.d.ts

@@ -0,0 +1,117 @@
+import { z } from 'zod';
+/**
+ * Layer definition for architectural boundaries
+ */
+export declare const LayerSchema: z.ZodObject<{
+    name: z.ZodString;
+    pattern: z.ZodString;
+    allowedDependencies: z.ZodArray<z.ZodString, "many">;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    pattern: string;
+    allowedDependencies: string[];
+}, {
+    name: string;
+    pattern: string;
+    allowedDependencies: string[];
+}>;
+/**
+ * Forbidden import rule
+ */
+export declare const ForbiddenImportSchema: z.ZodObject<{
+    from: z.ZodString;
+    disallow: z.ZodArray<z.ZodString, "many">;
+    message: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    from: string;
+    disallow: string[];
+    message?: string | undefined;
+}, {
+    from: string;
+    disallow: string[];
+    message?: string | undefined;
+}>;
+/**
+ * Boundary validation config
+ */
+export declare const BoundaryConfigSchema: z.ZodObject<{
+    requireSchema: z.ZodArray<z.ZodString, "many">;
+}, "strip", z.ZodTypeAny, {
+    requireSchema: string[];
+}, {
+    requireSchema: string[];
+}>;
+/**
+ * Complete harness.config.json schema
+ * Duplicated from @harness-engineering/cli to avoid circular dependency
+ */
+export declare const HarnessConfigSchema: z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    layers: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        pattern: z.ZodString;
+        allowedDependencies: z.ZodArray<z.ZodString, "many">;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        pattern: string;
+        allowedDependencies: string[];
+    }, {
+        name: string;
+        pattern: string;
+        allowedDependencies: string[];
+    }>, "many">>;
+    forbiddenImports: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        from: z.ZodString;
+        disallow: z.ZodArray<z.ZodString, "many">;
+        message: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        from: string;
+        disallow: string[];
+        message?: string | undefined;
+    }, {
+        from: string;
+        disallow: string[];
+        message?: string | undefined;
+    }>, "many">>;
+    boundaries: z.ZodOptional<z.ZodObject<{
+        requireSchema: z.ZodArray<z.ZodString, "many">;
+    }, "strip", z.ZodTypeAny, {
+        requireSchema: string[];
+    }, {
+        requireSchema: string[];
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    version: 1;
+    layers?: {
+        name: string;
+        pattern: string;
+        allowedDependencies: string[];
+    }[] | undefined;
+    forbiddenImports?: {
+        from: string;
+        disallow: string[];
+        message?: string | undefined;
+    }[] | undefined;
+    boundaries?: {
+        requireSchema: string[];
+    } | undefined;
+}, {
+    version: 1;
+    layers?: {
+        name: string;
+        pattern: string;
+        allowedDependencies: string[];
+    }[] | undefined;
+    forbiddenImports?: {
+        from: string;
+        disallow: string[];
+        message?: string | undefined;
+    }[] | undefined;
+    boundaries?: {
+        requireSchema: string[];
+    } | undefined;
+}>;
+export type HarnessConfig = z.infer<typeof HarnessConfigSchema>;
+export type Layer = z.infer<typeof LayerSchema>;
+export type ForbiddenImport = z.infer<typeof ForbiddenImportSchema>;
+//# sourceMappingURL=schema.d.ts.map

package/dist/utils/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/utils/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;;;EAItB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;EAIhC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,oBAAoB;;;;;;EAE/B,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAK9B,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAChE,MAAM,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAChD,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC"}

package/dist/utils/schema.js

@@ -0,0 +1,34 @@
+import { z } from 'zod';
+/**
+ * Layer definition for architectural boundaries
+ */
+export const LayerSchema = z.object({
+    name: z.string(),
+    pattern: z.string(),
+    allowedDependencies: z.array(z.string()),
+});
+/**
+ * Forbidden import rule
+ */
+export const ForbiddenImportSchema = z.object({
+    from: z.string(),
+    disallow: z.array(z.string()),
+    message: z.string().optional(),
+});
+/**
+ * Boundary validation config
+ */
+export const BoundaryConfigSchema = z.object({
+    requireSchema: z.array(z.string()),
+});
+/**
+ * Complete harness.config.json schema
+ * Duplicated from @harness-engineering/cli to avoid circular dependency
+ */
+export const HarnessConfigSchema = z.object({
+    version: z.literal(1),
+    layers: z.array(LayerSchema).optional(),
+    forbiddenImports: z.array(ForbiddenImportSchema).optional(),
+    boundaries: BoundaryConfigSchema.optional(),
+});
+//# sourceMappingURL=schema.js.map

package/dist/utils/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/utils/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC;IAClC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,mBAAmB,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;CACzC,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAC7B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC/B,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,aAAa,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;CACnC,CAAC,CAAC;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IACrB,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,QAAQ,EAAE;IACvC,gBAAgB,EAAE,CAAC,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC,QAAQ,EAAE;IAC3D,UAAU,EAAE,oBAAoB,CAAC,QAAQ,EAAE;CAC5C,CAAC,CAAC"}

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "@harness-engineering/eslint-plugin",
+  "version": "0.1.0",
+  "description": "ESLint plugin for harness engineering architectural constraints",
+  "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": {
+    "@typescript-eslint/utils": "^8.0.0",
+    "minimatch": "^9.0.0",
+    "zod": "^3.22.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "@typescript-eslint/parser": "^8.57.0",
+    "@typescript-eslint/rule-tester": "^8.0.0",
+    "eslint": "^10.0.0",
+    "typescript": "^5.0.0",
+    "vitest": "^2.0.0"
+  },
+  "peerDependencies": {
+    "eslint": "^8.0.0 || ^9.0.0 || ^10.0.0",
+    "typescript": "^5.0.0"
+  },
+  "keywords": [
+    "eslint",
+    "eslint-plugin",
+    "harness",
+    "architecture",
+    "layers"
+  ],
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Intense-Visions/harness-engineering.git",
+    "directory": "packages/eslint-plugin"
+  },
+  "bugs": {
+    "url": "https://github.com/Intense-Visions/harness-engineering/issues"
+  },
+  "homepage": "https://github.com/Intense-Visions/harness-engineering/tree/main/packages/eslint-plugin#readme",
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "eslint src",
+    "clean": "rm -rf dist"
+  }
+}