@diskcare/rules-engine

English

Rule engine for DiskCare. It decides risk and eligibility based on rule config.

$3

- RulesEngine to evaluate rules by target id
- RulesConfigLoader to load and validate rule files
- Types for rule configs and decisions

$3

``ts
import { RulesEngine } from "@diskcare/rules-engine";
const engine = new RulesEngine({
rules: [
{ id: "npm-cache", risk: "safe", safeAfterDays: 14, description: "npm cache is reproducible" },
],
defaults: { risk: "caution", safeAfterDays: 30 },
});
const decision = engine.decide("npm-cache");
`

$3

- Validation errors throw RulesConfigError with filePath and cause.
- When no rule matches, defaults are used.
- Rules may include optional paths for custom target discovery (handled by the CLI).

$3

You can embed the rules engine in another tool by providing a RuleConfig object and calling decide(targetId) for each target you discover.

---

Türkçe

DiskCare için kural motoru. Risk ve uygunluk kararlarını kural yapılandırmasına göre verir.

$3

- Hedef id'ye göre kuralları değerlendiren RulesEngine
- Kural dosyalarını yükleyen ve doğrulayan RulesConfigLoader
- Kural yapılandırmaları ve kararlar için tipler

$3

`ts
import { RulesEngine } from "@diskcare/rules-engine";
const engine = new RulesEngine({
rules: [
{ id: "npm-cache", risk: "safe", safeAfterDays: 14, description: "npm cache is reproducible" },
],
defaults: { risk: "caution", safeAfterDays: 30 },
});
const decision = engine.decide("npm-cache");
`

$3

- Doğrulama hataları, filePath ve sebep ile RulesConfigError fırlatır.
- Hiçbir kural eşleşmezse, varsayılanlar kullanılır.
- Kurallar, özel hedef keşfi için isteğe bağlı paths içerebilir (CLI tarafından işlenir).

$3

Kurallar motorunu başka bir araca gömerek bir RuleConfig nesnesi sağlayabilir ve keşfettiğiniz her hedef için decide(targetId)` çağırabilirsiniz.