feat: add no-processes-layer rule to enforce folder structure

- Implemented `no-processes-layer` rule to disallow a `processes` folder under the project's `src` directory.
- Added rule metadata and configuration options for ESLint.
- Added utilities to manage run-once rule state and to parse rule options for tests.
- Added unit tests for presence/absence of `processes`, error handling, and custom `src` configuration.
- Added test helpers used to run the rule in isolation.

Author: andrewmolyuk

Makefile

@@ -1,19 +1,32 @@
-@PHONY: lint install test update drawio
+.PHONY: install lint test update drawio
+
 
 install:
-	npm install --no-audit --no-fund --prefer-offline
+	npm install --no-audit --no-fund 
 
 lint:
 	npx eslint . --ext .ts,.js,.vue --fix
 	npx markdownlint --fix "**/*.md" -i node_modules
-	npx prettier --write "**/*.md" "**/*.json" "**/*.js" "**/*.ts"
+	npx prettier --write "**/*.md" "**/*.json" "**/*.js" "**/*.ts" --log-level warn
 
 test: lint
-	echo "CI=CI npx vitest"
+	CI=CI npx vitest
 
 update:
 	npx npm-check-updates -u
-	npm install --no-audit --no-fund --prefer-offline
+	npm install --no-audit --no-fund
 
 drawio:
-	/mnt/c/Program\ Files/draw.io/draw.io.exe -x -o docs/assets --transparent -f png docs/assets/drawio/*.drawio
+	@if [ -z "$(DRAWIO_CMD)" ]; then \
+		if [ -x "/mnt/c/Program Files/draw.io/draw.io.exe" ]; then DRAWIO_CMD="/mnt/c/Program Files/draw.io/draw.io.exe"; \
+		elif [ -x "/Applications/draw.io.app/Contents/MacOS/draw.io" ]; then DRAWIO_CMD="/Applications/draw.io.app/Contents/MacOS/draw.io"; \
+		elif [ -x "/Applications/diagrams.net.app/Contents/MacOS/diagrams.net" ]; then DRAWIO_CMD="/Applications/diagrams.net.app/Contents/MacOS/diagrams.net"; \
+		elif command -v draw.io >/dev/null 2>&1; then DRAWIO_CMD="$$(command -v draw.io)"; \
+		elif command -v diagrams.net >/dev/null 2>&1; then DRAWIO_CMD="$$(command -v diagrams.net)"; \
+		else DRAWIO_CMD=""; fi; \
+	fi; \
+	if [ -z "$$DRAWIO_CMD" ]; then \
+		echo "draw.io/diagrams.net not found. Install it or set DRAWIO_CMD environment variable."; \
+		exit 1; \
+	fi; \
+	"$$DRAWIO_CMD" -x -o docs/assets --transparent -f png docs/assets/drawio/*.drawio

README.md

@@ -9,3 +9,45 @@
 [![License](https://img.shields.io/npm/l/eslint-plugin-vue-fsd.svg)](LICENSE)
 
 A custom ESLint plugin for enforcing FSD patterns in Vue projects.
+
+> [!NOTE]
+> The project is in active development and may have breaking changes in minor versions, but we will strive to keep changes minimal and well-documented.
+
+![FSD Pattern](docs/assets/fsd.png)
+
+## Features
+
+- Enforces FSD (Feature-Sliced Design) architecture patterns in Vue.js projects.
+- Provides a set of rules and guidelines for structuring Vue components and their interactions.
+- Includes a set of predefined configurations for different project setups.
+
+## Installation
+
+```bash
+npm install eslint-plugin-vue-fsd --save-dev
+```
+
+## Usage
+
+```javascript
+import vueFsdPlugin from 'eslint-plugin-vue-fsd'
+
+// .eslintrc.js
+module.exports = {
+  ...vueFsdPlugin.configs.recommended,
+}
+```
+
+## Rules
+
+| Rule                                                       | Description                                    |
+| ---------------------------------------------------------- | ---------------------------------------------- |
+| `[no-processes-layer](./docs/rules/no-processes-layer.md)` | Ensure deprecated processes layer is not used. |
+
+## Contribution
+
+Pull requests and issues are welcome! Please follow the code style and add tests for new rules.
+
+## License
+
+MIT, see [LICENSE](./LICENSE) for details.

docs/assets/drawio/fsd.drawio

@@ -0,0 +1,67 @@
+# no-processes-layer
+
+Disallow a `processes` folder inside your `src` tree.
+
+## Why
+
+This repository enforces a layered architecture where certain folders are reserved or deprecated.
+The `processes` folder is considered a deprecated layer for the Feature-Sliced Design architecture. The rule prevents the presence of a `processes` directory inside your configured `src` path.
+
+The rule is intentionally conservative: it reports once per linting session to reduce noise from the same structural problem appearing in many files.
+
+## Rule details
+
+- Rule name: `vue-fsd/no-processes-layer`
+- Default messageId: `forbidden`
+- Type: `problem`
+
+This rule checks whether the configured `src` path contains a top-level `processes` directory.
+
+The rule reports at most once per linting session to avoid repeated identical messages across many files.
+
+## Options
+
+The rule accepts a single options object with the following property:
+
+- `src` (string) — the path/alias to your project's source root. Default: `"src"`.
+
+Example (ESLint config):
+
+```json
+{
+  "plugins": ["vue-fsd"],
+  "rules": {
+    "vue-fsd/no-processes-layer": ["error", { "src": "src" }]
+  }
+}
+```
+
+If your project uses a custom alias or a non-standard src path, pass that string via `src`.
+
+## Examples
+
+Bad:
+
+```text
+// filesystem: src/processes/
+src/processes/handler.js
+```
+
+Good:
+
+```text
+// keep code in another allowed layer (services, workers, etc.)
+src/services/processor.js
+```
+
+## When not to use
+
+Avoid using this rule in the following cases:
+
+- When migrating an existing codebase that heavily relies on the `processes` layer. In such cases, consider using the rule in a more lenient mode or with exceptions.
+- When working on experimental features or prototypes that may not adhere to the established folder structure.
+
+## References
+
+- [ESLint Documentation](https://eslint.org/docs/user-guide/configuring)
+- [Feature-Sliced Design](https://feature-sliced.design/)