@elaraai/eslint-plugin-east 1.0.4

package/LICENSE.md

@@ -0,0 +1,31 @@
+Copyright (c) 2025 Elara AI Pty Ltd
+
+# Dual License — AGPL-3.0 / Commercial
+
+This software is available under two licenses. You may choose which license applies to your use:
+
+## Option 1: AGPL-3.0 (Open Source)
+
+You may use, modify, and distribute this software under the terms of the GNU Affero General Public License v3.0.
+
+This requires that if you use this software in a network service, you must make your complete source code available under AGPL-3.0.
+
+Full text: https://www.gnu.org/licenses/agpl-3.0.html
+
+## Option 2: Commercial License
+
+If you wish to use this software without the source code disclosure requirements of AGPL-3.0, you must obtain a commercial license from Elara AI Pty Ltd.
+
+Contact: support@elara.ai
+
+## Contributions
+
+Contributions are welcome. By submitting a pull request, you agree to license your contribution under both AGPL-3.0 and our commercial license terms.
+
+## Governing Law
+
+This license is governed by the laws of New South Wales, Australia.
+
+---
+
+*Elara AI Pty Ltd*

package/README.md

@@ -0,0 +1,87 @@
+# ESLint Plugin East
+
+> East idiom diagnostics for ESLint — editor and CI
+
+[![License](https://img.shields.io/badge/license-AGPL--3.0-blue.svg)](LICENSE.md)
+[![Node Version](https://img.shields.io/badge/node-%3E%3D22.0.0-brightgreen.svg)](https://nodejs.org)
+
+**ESLint Plugin East** surfaces the [`@elaraai/east-diagnostics`](../east-diagnostics)
+rule set — the same East idiom checks the Claude plugin runs at write-time — in
+the editor (via the ESLint extension) and in CI (via `eslint` / `pnpm lint`).
+
+It is one type-aware rule, `east/east-rules`, that runs the whole set against the
+file's TypeScript program. Native TypeScript type errors are intentionally **not**
+reported here — those are `tsc`'s job; this plugin only surfaces the East-specific
+idioms `tsc` can't see.
+
+## Features
+
+- **One rule, every East check** - `east/east-rules` runs the full east-diagnostics set.
+- **Type-aware** - Bridges to the TS program via typescript-eslint `parserServices`.
+- **Editor + CI** - Shows as squiggles through the ESLint VS Code extension and fails CI through `pnpm lint`.
+- **Configurable** - Disable individual rules by name; tune rule options.
+
+## Installation
+
+```bash
+npm install -D @elaraai/eslint-plugin-east @typescript-eslint/parser eslint
+```
+
+## Quick Start
+
+Requires **type-aware** linting (`@typescript-eslint/parser` with a `project`).
+
+```js
+// eslint.config.js
+import east from "@elaraai/eslint-plugin-east";
+import tsParser from "@typescript-eslint/parser";
+
+export default [
+  {
+    files: ["**/*.ts"],
+    languageOptions: {
+      parser: tsParser,
+      parserOptions: { projectService: true },
+    },
+    plugins: { east },
+    rules: { "east/east-rules": "warn" },
+  },
+];
+```
+
+Or extend the bundled config: `export default [east.configs.recommended];`
+
+## Options
+
+```js
+"east/east-rules": ["warn", {
+  disabled: ["prefer-some-none"],            // turn off specific rules by name
+  preferExplicitEastType: { mode: "all-raw-values" },
+}]
+```
+
+## Claude Code plugin
+
+The East ecosystem also ships a [Claude Code](https://claude.com/claude-code) plugin — East language skills, example search, and preemptive diagnostics for East code — installed separately from the `elaraai` marketplace:
+
+```text
+# Inside Claude Code
+/plugin marketplace add elaraai/east-workspace
+/plugin install east@elaraai
+```
+
+```bash
+# From a terminal
+claude plugin marketplace add elaraai/east-workspace
+claude plugin install east@elaraai
+```
+
+## License
+
+Dual-licensed:
+- **Open Source**: [AGPL-3.0](LICENSE.md) - Free for open source use
+- **Commercial**: Available for proprietary use - contact support@elara.ai
+
+---
+
+*Developed by [Elara AI Pty Ltd](https://elaraai.com/)*

package/dist/src/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+import type { ESLint } from "eslint";
+declare const plugin: ESLint.Plugin;
+export default plugin;
+//# sourceMappingURL=index.d.ts.map

package/dist/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,MAAM,EAAgB,MAAM,QAAQ,CAAC;AASnD,QAAA,MAAM,MAAM,EAAE,MAAM,CAAC,MAGpB,CAAC;AASF,eAAe,MAAM,CAAC"}

package/dist/src/index.js

@@ -0,0 +1,18 @@
+import { eastRules } from "./rule.js";
+// typescript-eslint's RuleModule is structurally an ESLint rule; the cast bridges
+// the two slightly different RuleModule types.
+const rules = {
+    "east-rules": eastRules,
+};
+const plugin = {
+    meta: { name: "@elaraai/eslint-plugin-east", version: "1.0.4" },
+    rules,
+};
+plugin.configs = {
+    recommended: {
+        plugins: { east: plugin },
+        rules: { "east/east-rules": "warn" },
+    },
+};
+export default plugin;
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,kFAAkF;AAClF,+CAA+C;AAC/C,MAAM,KAAK,GAAoC;IAC7C,YAAY,EAAE,SAAuC;CACtD,CAAC;AAEF,MAAM,MAAM,GAAkB;IAC5B,IAAI,EAAE,EAAE,IAAI,EAAE,6BAA6B,EAAE,OAAO,EAAE,OAAO,EAAE;IAC/D,KAAK;CACN,CAAC;AAEF,MAAM,CAAC,OAAO,GAAG;IACf,WAAW,EAAE;QACX,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE;QACzB,KAAK,EAAE,EAAE,iBAAiB,EAAE,MAAM,EAAE;KACb;CAC1B,CAAC;AAEF,eAAe,MAAM,CAAC"}

package/dist/src/rule.d.ts

@@ -0,0 +1,8 @@
+import { ESLintUtils } from "@typescript-eslint/utils";
+import { type EastRulesOptions } from "@elaraai/east-diagnostics";
+export type Options = [EastRulesOptions];
+export type MessageIds = "east";
+export declare const eastRules: ESLintUtils.RuleModule<"east", Options, unknown, ESLintUtils.RuleListener> & {
+    name: string;
+};
+//# sourceMappingURL=rule.d.ts.map

package/dist/src/rule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rule.d.ts","sourceRoot":"","sources":["../../src/rule.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAgB,KAAK,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAEhF,MAAM,MAAM,OAAO,GAAG,CAAC,gBAAgB,CAAC,CAAC;AACzC,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC;AAShC,eAAO,MAAM,SAAS;;CAiDpB,CAAC"}

package/dist/src/rule.js

@@ -0,0 +1,61 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+import * as ts from "typescript";
+import { ESLintUtils } from "@typescript-eslint/utils";
+import { runEastRules } from "@elaraai/east-diagnostics";
+const createRule = ESLintUtils.RuleCreator((name) => `https://github.com/elaraai/east/tree/main/libs/eslint-plugin-east#${name}`);
+// One rule that runs the whole east-diagnostics set against the file's TS
+// program (obtained via typescript-eslint parser services) and reports each
+// diagnostic. Requires type-aware linting (parserOptions.project / projectService).
+export const eastRules = createRule({
+    name: "east-rules",
+    meta: {
+        type: "problem",
+        docs: {
+            description: "East-specific idiom diagnostics: prefer some()/none, no redundant casts, no unexecuted East expressions, etc.",
+        },
+        messages: { east: "{{message}}" },
+        schema: [
+            {
+                type: "object",
+                properties: {
+                    disabled: { type: "array", items: { type: "string" } },
+                    preferExplicitEastType: {
+                        type: "object",
+                        properties: { mode: { type: "string", enum: ["under-determined", "all-raw-values"] } },
+                        additionalProperties: false,
+                    },
+                },
+                additionalProperties: false,
+            },
+        ],
+    },
+    defaultOptions: [{}],
+    create(context, [options]) {
+        return {
+            "Program:exit"() {
+                const services = ESLintUtils.getParserServices(context);
+                const program = services.program;
+                const sourceFile = program.getSourceFile(context.filename);
+                if (sourceFile === undefined)
+                    return;
+                const diagnostics = runEastRules(ts, program, sourceFile, program.getTypeChecker(), options);
+                for (const d of diagnostics) {
+                    const start = sourceFile.getLineAndCharacterOfPosition(d.start);
+                    const end = sourceFile.getLineAndCharacterOfPosition(d.start + d.length);
+                    context.report({
+                        loc: {
+                            start: { line: start.line + 1, column: start.character },
+                            end: { line: end.line + 1, column: end.character },
+                        },
+                        messageId: "east",
+                        data: { message: `[${d.ruleName}] ${d.messageText}` },
+                    });
+                }
+            },
+        };
+    },
+});
+//# sourceMappingURL=rule.js.map

package/dist/src/rule.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rule.js","sourceRoot":"","sources":["../../src/rule.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,MAAM,YAAY,CAAC;AACjC,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,YAAY,EAAyB,MAAM,2BAA2B,CAAC;AAKhF,MAAM,UAAU,GAAG,WAAW,CAAC,WAAW,CACxC,CAAC,IAAI,EAAE,EAAE,CAAC,qEAAqE,IAAI,EAAE,CACtF,CAAC;AAEF,0EAA0E;AAC1E,4EAA4E;AAC5E,oFAAoF;AACpF,MAAM,CAAC,MAAM,SAAS,GAAG,UAAU,CAAsB;IACvD,IAAI,EAAE,YAAY;IAClB,IAAI,EAAE;QACJ,IAAI,EAAE,SAAS;QACf,IAAI,EAAE;YACJ,WAAW,EACT,+GAA+G;SAClH;QACD,QAAQ,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE;QACjC,MAAM,EAAE;YACN;gBACE,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,QAAQ,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;oBACtD,sBAAsB,EAAE;wBACtB,IAAI,EAAE,QAAQ;wBACd,UAAU,EAAE,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,kBAAkB,EAAE,gBAAgB,CAAC,EAAE,EAAE;wBACtF,oBAAoB,EAAE,KAAK;qBAC5B;iBACF;gBACD,oBAAoB,EAAE,KAAK;aAC5B;SACF;KACF;IACD,cAAc,EAAE,CAAC,EAAE,CAAC;IACpB,MAAM,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC;QACvB,OAAO;YACL,cAAc;gBACZ,MAAM,QAAQ,GAAG,WAAW,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC;gBACxD,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC;gBACjC,MAAM,UAAU,GAAG,OAAO,CAAC,aAAa,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;gBAC3D,IAAI,UAAU,KAAK,SAAS;oBAAE,OAAO;gBAErC,MAAM,WAAW,GAAG,YAAY,CAAC,EAAE,EAAE,OAAO,EAAE,UAAU,EAAE,OAAO,CAAC,cAAc,EAAE,EAAE,OAAO,CAAC,CAAC;gBAC7F,KAAK,MAAM,CAAC,IAAI,WAAW,EAAE,CAAC;oBAC5B,MAAM,KAAK,GAAG,UAAU,CAAC,6BAA6B,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;oBAChE,MAAM,GAAG,GAAG,UAAU,CAAC,6BAA6B,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC;oBACzE,OAAO,CAAC,MAAM,CAAC;wBACb,GAAG,EAAE;4BACH,KAAK,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,GAAG,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,SAAS,EAAE;4BACxD,GAAG,EAAE,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,GAAG,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,SAAS,EAAE;yBACnD;wBACD,SAAS,EAAE,MAAM;wBACjB,IAAI,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC,WAAW,EAAE,EAAE;qBACtD,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;SACF,CAAC;IACJ,CAAC;CACF,CAAC,CAAC"}

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@elaraai/eslint-plugin-east",
+  "version": "1.0.4",
+  "license": "AGPL-3.0-or-later",
+  "type": "module",
+  "description": "ESLint plugin surfacing East-specific idiom diagnostics (the east-diagnostics rule set) in the editor and CI.",
+  "main": "dist/src/index.js",
+  "types": "dist/src/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/src/index.d.ts",
+      "default": "./dist/src/index.js"
+    }
+  },
+  "files": [
+    "dist/src",
+    "!dist/src/**/*.spec.*",
+    "README.md",
+    "LICENSE.md"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/elaraai/east-workspace.git",
+    "directory": "libs/eslint-plugin-east"
+  },
+  "keywords": [
+    "east",
+    "elara",
+    "eslint",
+    "eslintplugin",
+    "lint"
+  ],
+  "author": "Elara AI Pty Ltd",
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "peerDependencies": {
+    "eslint": ">=9.0.0",
+    "typescript": ">=5.0.0"
+  },
+  "dependencies": {
+    "@typescript-eslint/utils": "^8.42.0",
+    "@elaraai/east-diagnostics": "1.0.4"
+  },
+  "devDependencies": {
+    "@types/node": "^22.18.1",
+    "@typescript-eslint/parser": "^8.42.0",
+    "eslint": "^9.34.0",
+    "typescript": "~5.9.2",
+    "@elaraai/east": "1.0.4"
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "npm run build && node --enable-source-maps --test-reporter=spec --test 'dist/test/**/*.spec.js'"
+  }
+}