@evolith/infra-providers 1.0.0 → 1.0.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 BeyondNet Code
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,75 @@
+# @evolith/infra-providers
+
+> Infrastructure adapters for the Evolith governance framework.
+
+[![npm version](https://img.shields.io/npm/v/@evolith/infra-providers)](https://www.npmjs.com/package/@evolith/infra-providers)
+[![license](https://img.shields.io/npm/l/@evolith/infra-providers)](./LICENSE)
+
+## Overview
+
+`@evolith/infra-providers` supplies the **concrete infrastructure adapters** that implement the ports defined in `@evolith/core-domain`. It handles filesystem I/O, logging, YAML/JSON config parsing, ruleset loading from disk, and webhook delivery.
+
+These adapters are injected into the domain at runtime — the domain itself has zero infrastructure dependencies.
+
+## Installation
+
+```bash
+npm install @evolith/infra-providers
+```
+
+## Providers
+
+| Export | Implements | Description |
+|--------|-----------|-------------|
+| `NodeFileSystemProvider` | `IFileSystemProvider` | Full filesystem adapter using Node.js `fs` + `fs-extra` |
+| `NestLoggerProvider` | `ILogger` | NestJS `LoggerService` wrapper |
+| `ConsoleLoggerProvider` | `ILogger` | Plain `console.*` logger (useful in scripts/tests) |
+| `NoOpLoggerProvider` | `ILogger` | Silent logger (testing) |
+| `YamlConfigParserProvider` | `IConfigParser` | Parses `.yaml` / `.yml` files |
+| `JsonConfigParserProvider` | `IConfigParser` | Parses `.json` files |
+| `DiskRulesetRepository` | `IRulesetRepository` | Loads governance rulesets from disk |
+| `WebhookAdapter` | — | HTTP webhook delivery with retry |
+| `MoscowPrioritizationService` | — | MoSCoW prioritization logic |
+
+## Usage
+
+```ts
+import { NodeFileSystemProvider } from '@evolith/infra-providers';
+import { YamlConfigParserProvider } from '@evolith/infra-providers';
+import { DiskRulesetRepository } from '@evolith/infra-providers';
+import { EvaluateGateUseCase } from '@evolith/core-domain/application/use-cases';
+
+const fs = new NodeFileSystemProvider().createFileSystem();
+const configParser = new YamlConfigParserProvider();
+const rulesetRepo = new DiskRulesetRepository(fs, configParser);
+
+const useCase = new EvaluateGateUseCase(rulesetRepo, fs, new ConsoleLoggerProvider());
+const result = await useCase.execute({ projectId, phase, artifacts });
+```
+
+### With NestJS
+
+```ts
+import { Module } from '@nestjs/common';
+import { NodeFileSystemProvider, DiskRulesetRepository } from '@evolith/infra-providers';
+
+@Module({
+  providers: [
+    { provide: 'IFileSystem', useClass: NodeFileSystemProvider },
+    { provide: 'IRulesetRepository', useClass: DiskRulesetRepository },
+  ],
+  exports: ['IFileSystem', 'IRulesetRepository'],
+})
+export class InfraModule {}
+```
+
+## Part of the Evolith suite
+
+| Package | Role |
+|---------|------|
+| [`@evolith/core-domain`](https://www.npmjs.com/package/@evolith/core-domain) | Domain logic and rule engine |
+| **`@evolith/infra-providers`** | Infrastructure adapters ← you are here |
+
+## License
+
+MIT — Copyright © 2026 BeyondNet Code. See [LICENSE](./LICENSE) for details.

package/package.json

@@ -1,12 +1,14 @@
 {
   "name": "@evolith/infra-providers",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "Shared infrastructure providers for Evolith Core",
+  "license": "MIT",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "files": [
     "dist",
-    "README.md"
+    "README.md",
+    "LICENSE"
   ],
   "publishConfig": {
     "access": "public",
@@ -16,7 +18,7 @@
     "build": "tsc"
   },
   "dependencies": {
-    "@evolith/core-domain": "1.0.0",
+    "@evolith/core-domain": "1.0.4",
     "@nestjs/common": "11.1.27",
     "ajv": "8.20.0",
     "ajv-formats": "3.0.1",