@nielspeter/eess-ts 0.1.0

package/dist/builders/slice-rule-builder.js

@@ -0,0 +1,134 @@
+import { TerminalBuilder } from '@nielspeter/eess';
+import { resolveByMatching, resolveByDefinition } from '../models/slice.js';
+import { beFreeOfCycles as beFreeOfCyclesCondition, respectLayerOrder as respectLayerOrderCondition, notDependOn as notDependOnCondition, } from '../conditions/slice.js';
+/**
+ * Rule builder for slice-level architecture rules.
+ *
+ * Unlike other builders that extend RuleBuilder<T>, SliceRuleBuilder
+ * has its own chain because the grouping step (matching/assignedFrom)
+ * replaces the predicate phase entirely.
+ *
+ * Usage:
+ *   slices(project).matching(glob).should().beFreeOfCycles().check()
+ *   slices(project).assignedFrom(def).should().respectLayerOrder(...).check()
+ */
+export class SliceRuleBuilder extends TerminalBuilder {
+    project;
+    _slices = [];
+    _conditions = [];
+    constructor(project) {
+        super();
+        this.project = project;
+    }
+    /**
+     * Define slices by glob matching. Each directory matching the glob
+     * becomes a slice named after that directory.
+     *
+     * @param glob - A glob pattern where the wildcard segment identifies slices
+     *
+     * @example
+     * slices(project).matching('src/features/*\/')
+     * // Slices: auth, billing, orders, etc.
+     */
+    matching(glob) {
+        this._slices = resolveByMatching(this.project, glob);
+        return this;
+    }
+    /**
+     * Define slices from an explicit name-to-glob mapping.
+     *
+     * @param definition - Map of slice names to glob patterns
+     *
+     * @example
+     * slices(project).assignedFrom({
+     *   presentation: 'src/controllers/**',
+     *   domain: 'src/domain/**',
+     * })
+     */
+    assignedFrom(definition) {
+        this._slices = resolveByDefinition(this.project, definition);
+        return this;
+    }
+    /**
+     * Begin the condition phase. Returns `this` for chaining.
+     */
+    should() {
+        return this;
+    }
+    /**
+     * Add another condition (AND).
+     */
+    andShould() {
+        return this;
+    }
+    /**
+     * Assert that no circular dependencies exist between slices.
+     */
+    beFreeOfCycles() {
+        this._conditions.push(beFreeOfCyclesCondition());
+        return this;
+    }
+    /**
+     * Assert that slices respect a layered dependency order.
+     * Layer N may depend on layers N+1, N+2, ... but NOT on layers with lower index.
+     *
+     * @param layers - Ordered layer names from highest to lowest
+     */
+    respectLayerOrder(...layers) {
+        this._conditions.push(respectLayerOrderCondition(...layers));
+        return this;
+    }
+    /**
+     * Assert that no slice depends on any of the listed slices.
+     *
+     * @param sliceNames - Names of forbidden dependency targets
+     */
+    notDependOn(...sliceNames) {
+        this._conditions.push(notDependOnCondition(...sliceNames));
+        return this;
+    }
+    collectViolations() {
+        if (this._slices.length === 0) {
+            return [];
+        }
+        if (this._conditions.length === 0) {
+            const ruleId = this._metadata?.id ?? 'unnamed';
+            console.warn(`[eess] Slice rule '${ruleId}' has no conditions. ` +
+                `Did you forget to add a condition like beFreeOfCycles()?`);
+            return [];
+        }
+        const context = {
+            rule: this.buildRuleDescription(),
+            because: this._reason,
+            ruleId: this._metadata?.id,
+            suggestion: this._metadata?.suggestion,
+            docs: this._metadata?.docs,
+        };
+        const violations = [];
+        for (const condition of this._conditions) {
+            violations.push(...condition.evaluate(this._slices, context));
+        }
+        return violations;
+    }
+    buildRuleDescription() {
+        const sliceDesc = this._slices.map((s) => s.name).join(', ');
+        const conditionDesc = this._conditions.map((c) => c.description).join(' and ');
+        return `slices [${sliceDesc}] should ${conditionDesc}`;
+    }
+}
+/**
+ * Entry point: create a slice-level rule builder.
+ *
+ * @param p - The loaded ArchProject
+ * @returns A SliceRuleBuilder — call `.matching()` or `.assignedFrom()` next
+ *
+ * @example
+ * slices(project)
+ *   .matching('src/features/*\/')
+ *   .should().beFreeOfCycles()
+ *   .check()
+ */
+export function slices(p) {
+    return new SliceRuleBuilder(p);
+}
+//# sourceMappingURL=slice-rule-builder.js.map

package/dist/builders/slice-rule-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slice-rule-builder.js","sourceRoot":"","sources":["../../src/builders/slice-rule-builder.ts"],"names":[],"mappings":"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"}

package/dist/builders/type-rule-builder.d.ts

@@ -0,0 +1,103 @@
+import type { ArchProject } from '../core/project.js';
+import { RuleBuilder } from '@nielspeter/eess';
+import type { TypeMatcher } from '../helpers/type-matchers.js';
+import { type TypeDeclaration } from '../predicates/type.js';
+/**
+ * Rule builder for interface and type alias declarations.
+ *
+ * Returned by the `types()` entry point. Provides type-specific
+ * predicates and conditions on top of the base RuleBuilder chain.
+ *
+ * @example
+ * types(project)
+ *   .that().haveProperty('sortBy')
+ *   .should().havePropertyType('sortBy', not(isString()))
+ *   .because('sortBy must be a union of literals, not bare string')
+ *   .check()
+ */
+export declare class TypeRuleBuilder extends RuleBuilder<TypeDeclaration, ArchProject> {
+    constructor(project: ArchProject);
+    /**
+     * Collect all InterfaceDeclarations and TypeAliasDeclarations
+     * from all source files in the project.
+     */
+    protected getElements(): TypeDeclaration[];
+    /** Filter to interface declarations only (excludes type aliases). */
+    areInterfaces(): this;
+    /** Filter to type alias declarations only (excludes interfaces). */
+    areTypeAliases(): this;
+    /**
+     * Filter to types that have a property with the given name. Resolves
+     * through the type system, so it works for both interfaces and aliases.
+     */
+    haveProperty(name: string): this;
+    /**
+     * Filter to types whose named property has a type satisfying the matcher.
+     * Resolves through aliases and mapped types (`Partial<>`, `Pick<>`, ...).
+     */
+    havePropertyOfType(name: string, matcher: TypeMatcher): this;
+    /**
+     * Filter to types that extend/reference the named type. Interfaces are
+     * matched by their `extends` clause; type aliases by a reference to the
+     * name in the resolved type text.
+     */
+    extendType(name: string): this;
+    /**
+     * Assert that the named property's type satisfies the matcher. Types
+     * lacking the property are skipped (no violation) — pair with
+     * `haveProperty()` to require it.
+     */
+    havePropertyType(name: string, matcher: TypeMatcher): this;
+    /** Assert that matched types are exported from their module. */
+    beExported(): this;
+    /** Assert that the filtered type set is empty (no matched type may exist). */
+    notExist(): this;
+    /** @deprecated Use `haveNameMatching()` after `.should()` instead. */
+    conditionHaveNameMatching(pattern: RegExp): this;
+    /** Assert that every matched type has all of the named properties (one violation per missing name). */
+    havePropertyNamed(...names: string[]): this;
+    /** Assert that no matched type has any of the named properties (one violation per forbidden name found). */
+    notHavePropertyNamed(...names: string[]): this;
+    /** Assert that every matched type has at least one property whose name matches the regex. */
+    havePropertyMatching(pattern: RegExp): this;
+    /** Assert that no matched type has a property whose name matches the regex (one violation per match). */
+    notHavePropertyMatching(pattern: RegExp): this;
+    /** Assert that every property of each matched type is `readonly` (resolves `Readonly<T>` too). */
+    haveOnlyReadonlyProperties(): this;
+    /** Assert that no matched type has more than `max` properties (guards against oversized DTOs). */
+    maxProperties(max: number): this;
+    /**
+     * After `.that()`: filter types whose name matches the pattern.
+     * After `.should()`: assert matched types have names matching the pattern.
+     */
+    haveNameMatching(pattern: RegExp | string): this;
+    /** Filter to types that are exported from their module. */
+    areExported(): this;
+    /** Filter to types that are NOT exported from their module. */
+    areNotExported(): this;
+    /**
+     * After `.that()`: filter types in a file matching the glob.
+     * After `.should()`: assert types reside in a file matching the glob.
+     */
+    resideInFile(glob: string): this;
+    /**
+     * After `.that()`: filter types in a folder matching the glob.
+     * After `.should()`: assert types reside in a folder matching the glob.
+     */
+    resideInFolder(glob: string): this;
+}
+/**
+ * Entry point for rules on interface and type alias declarations.
+ *
+ * Returns a TypeRuleBuilder that can filter and assert on all
+ * InterfaceDeclaration and TypeAliasDeclaration nodes in the project.
+ *
+ * @example
+ * // All types with a sortBy property must not use bare string
+ * types(project)
+ *   .that().haveProperty('sortBy')
+ *   .should().havePropertyType('sortBy', not(isString()))
+ *   .check()
+ */
+export declare function types(p: ArchProject): TypeRuleBuilder;
+//# sourceMappingURL=type-rule-builder.d.ts.map

package/dist/builders/type-rule-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-rule-builder.d.ts","sourceRoot":"","sources":["../../src/builders/type-rule-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAC9C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAA;AAC9D,OAAO,EAML,KAAK,eAAe,EACrB,MAAM,uBAAuB,CAAA;AAyB9B;;;;;;;;;;;;GAYG;AACH,qBAAa,eAAgB,SAAQ,WAAW,CAAC,eAAe,EAAE,WAAW,CAAC;gBAChE,OAAO,EAAE,WAAW;IAIhC;;;OAGG;IACH,SAAS,CAAC,WAAW,IAAI,eAAe,EAAE;IAW1C,qEAAqE;IACrE,aAAa,IAAI,IAAI;IAIrB,oEAAoE;IACpE,cAAc,IAAI,IAAI;IAItB;;;OAGG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAIhC;;;OAGG;IACH,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,IAAI;IAI5D;;;;OAIG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAM9B;;;;OAIG;IACH,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,IAAI;IAI1D,gEAAgE;IAChE,UAAU,IAAI,IAAI;IAIlB,8EAA8E;IAC9E,QAAQ,IAAI,IAAI;IAIhB,sEAAsE;IACtE,yBAAyB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAMhD,uGAAuG;IACvG,iBAAiB,CAAC,GAAG,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI;IAI3C,4GAA4G;IAC5G,oBAAoB,CAAC,GAAG,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI;IAI9C,6FAA6F;IAC7F,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI3C,yGAAyG;IACzG,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI9C,kGAAkG;IAClG,0BAA0B,IAAI,IAAI;IAIlC,kGAAkG;IAClG,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAMhC;;;OAGG;IACH,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAQhD,2DAA2D;IAC3D,WAAW,IAAI,IAAI;IAInB,+DAA+D;IAC/D,cAAc,IAAI,IAAI;IAItB;;;OAGG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAOhC;;;OAGG;IACH,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;CAMnC;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,KAAK,CAAC,CAAC,EAAE,WAAW,GAAG,eAAe,CAErD"}

package/dist/builders/type-rule-builder.js

@@ -0,0 +1,170 @@
+import { RuleBuilder } from '@nielspeter/eess';
+import { areInterfaces, areTypeAliases, haveProperty, havePropertyOfType, extendType, } from '../predicates/type.js';
+import { havePropertyType } from '../conditions/type-level.js';
+import { havePropertyNamed as memberHavePropertyNamed, notHavePropertyNamed as memberNotHavePropertyNamed, havePropertyMatching as memberHavePropertyMatching, notHavePropertyMatching as memberNotHavePropertyMatching, haveOnlyReadonlyProperties as memberHaveOnlyReadonlyProperties, maxProperties as memberMaxProperties, } from '../conditions/members.js';
+import { beExported as conditionBeExported, notExist as conditionNotExist, haveNameMatching as conditionHaveNameMatching, resideInFile as conditionResideInFile, resideInFolder as conditionResideInFolder, } from '../conditions/structural.js';
+import { haveNameMatching as identityHaveNameMatching, resideInFile as identityResideInFile, resideInFolder as identityResideInFolder, areExported as identityAreExported, areNotExported as identityAreNotExported, } from '../predicates/identity.js';
+/**
+ * Rule builder for interface and type alias declarations.
+ *
+ * Returned by the `types()` entry point. Provides type-specific
+ * predicates and conditions on top of the base RuleBuilder chain.
+ *
+ * @example
+ * types(project)
+ *   .that().haveProperty('sortBy')
+ *   .should().havePropertyType('sortBy', not(isString()))
+ *   .because('sortBy must be a union of literals, not bare string')
+ *   .check()
+ */
+export class TypeRuleBuilder extends RuleBuilder {
+    constructor(project) {
+        super(project);
+    }
+    /**
+     * Collect all InterfaceDeclarations and TypeAliasDeclarations
+     * from all source files in the project.
+     */
+    getElements() {
+        const elements = [];
+        for (const sf of this.project.getSourceFiles()) {
+            elements.push(...sf.getInterfaces());
+            elements.push(...sf.getTypeAliases());
+        }
+        return elements;
+    }
+    // --- Type-specific predicates ---
+    /** Filter to interface declarations only (excludes type aliases). */
+    areInterfaces() {
+        return this.addPredicate(areInterfaces());
+    }
+    /** Filter to type alias declarations only (excludes interfaces). */
+    areTypeAliases() {
+        return this.addPredicate(areTypeAliases());
+    }
+    /**
+     * Filter to types that have a property with the given name. Resolves
+     * through the type system, so it works for both interfaces and aliases.
+     */
+    haveProperty(name) {
+        return this.addPredicate(haveProperty(name));
+    }
+    /**
+     * Filter to types whose named property has a type satisfying the matcher.
+     * Resolves through aliases and mapped types (`Partial<>`, `Pick<>`, ...).
+     */
+    havePropertyOfType(name, matcher) {
+        return this.addPredicate(havePropertyOfType(name, matcher));
+    }
+    /**
+     * Filter to types that extend/reference the named type. Interfaces are
+     * matched by their `extends` clause; type aliases by a reference to the
+     * name in the resolved type text.
+     */
+    extendType(name) {
+        return this.addPredicate(extendType(name));
+    }
+    // --- Type-specific conditions ---
+    /**
+     * Assert that the named property's type satisfies the matcher. Types
+     * lacking the property are skipped (no violation) — pair with
+     * `haveProperty()` to require it.
+     */
+    havePropertyType(name, matcher) {
+        return this.addCondition(havePropertyType(name, matcher));
+    }
+    /** Assert that matched types are exported from their module. */
+    beExported() {
+        return this.addCondition(conditionBeExported());
+    }
+    /** Assert that the filtered type set is empty (no matched type may exist). */
+    notExist() {
+        return this.addCondition(conditionNotExist());
+    }
+    /** @deprecated Use `haveNameMatching()` after `.should()` instead. */
+    conditionHaveNameMatching(pattern) {
+        return this.addCondition(conditionHaveNameMatching(pattern));
+    }
+    // --- Member property conditions (plan 0030) ---
+    /** Assert that every matched type has all of the named properties (one violation per missing name). */
+    havePropertyNamed(...names) {
+        return this.addCondition(memberHavePropertyNamed(...names));
+    }
+    /** Assert that no matched type has any of the named properties (one violation per forbidden name found). */
+    notHavePropertyNamed(...names) {
+        return this.addCondition(memberNotHavePropertyNamed(...names));
+    }
+    /** Assert that every matched type has at least one property whose name matches the regex. */
+    havePropertyMatching(pattern) {
+        return this.addCondition(memberHavePropertyMatching(pattern));
+    }
+    /** Assert that no matched type has a property whose name matches the regex (one violation per match). */
+    notHavePropertyMatching(pattern) {
+        return this.addCondition(memberNotHavePropertyMatching(pattern));
+    }
+    /** Assert that every property of each matched type is `readonly` (resolves `Readonly<T>` too). */
+    haveOnlyReadonlyProperties() {
+        return this.addCondition(memberHaveOnlyReadonlyProperties());
+    }
+    /** Assert that no matched type has more than `max` properties (guards against oversized DTOs). */
+    maxProperties(max) {
+        return this.addCondition(memberMaxProperties(max));
+    }
+    // --- Identity predicates (convenience wrappers) ---
+    /**
+     * After `.that()`: filter types whose name matches the pattern.
+     * After `.should()`: assert matched types have names matching the pattern.
+     */
+    haveNameMatching(pattern) {
+        if (this._phase === 'condition') {
+            const regex = typeof pattern === 'string' ? new RegExp(pattern) : pattern;
+            return this.addCondition(conditionHaveNameMatching(regex));
+        }
+        return this.addPredicate(identityHaveNameMatching(pattern));
+    }
+    /** Filter to types that are exported from their module. */
+    areExported() {
+        return this.addPredicate(identityAreExported());
+    }
+    /** Filter to types that are NOT exported from their module. */
+    areNotExported() {
+        return this.addPredicate(identityAreNotExported());
+    }
+    /**
+     * After `.that()`: filter types in a file matching the glob.
+     * After `.should()`: assert types reside in a file matching the glob.
+     */
+    resideInFile(glob) {
+        if (this._phase === 'condition') {
+            return this.addCondition(conditionResideInFile(glob));
+        }
+        return this.addPredicate(identityResideInFile(glob));
+    }
+    /**
+     * After `.that()`: filter types in a folder matching the glob.
+     * After `.should()`: assert types reside in a folder matching the glob.
+     */
+    resideInFolder(glob) {
+        if (this._phase === 'condition') {
+            return this.addCondition(conditionResideInFolder(glob));
+        }
+        return this.addPredicate(identityResideInFolder(glob));
+    }
+}
+/**
+ * Entry point for rules on interface and type alias declarations.
+ *
+ * Returns a TypeRuleBuilder that can filter and assert on all
+ * InterfaceDeclaration and TypeAliasDeclaration nodes in the project.
+ *
+ * @example
+ * // All types with a sortBy property must not use bare string
+ * types(project)
+ *   .that().haveProperty('sortBy')
+ *   .should().havePropertyType('sortBy', not(isString()))
+ *   .check()
+ */
+export function types(p) {
+    return new TypeRuleBuilder(p);
+}
+//# sourceMappingURL=type-rule-builder.js.map

package/dist/builders/type-rule-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-rule-builder.js","sourceRoot":"","sources":["../../src/builders/type-rule-builder.ts"],"names":[],"mappings":"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"}

package/dist/cli/bin.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=bin.d.ts.map

package/dist/cli/bin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.d.ts","sourceRoot":"","sources":["../../src/cli/bin.ts"],"names":[],"mappings":""}

package/dist/cli/bin.js

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+import { run } from './index.js';
+void run(process.argv.slice(2));
+//# sourceMappingURL=bin.js.map

package/dist/cli/bin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.js","sourceRoot":"","sources":["../../src/cli/bin.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,GAAG,EAAE,MAAM,YAAY,CAAA;AAEhC,KAAK,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA"}

package/dist/cli/commands/baseline.d.ts

@@ -0,0 +1,11 @@
+export interface BaselineArgs {
+    ruleFiles: string[];
+    output: string;
+}
+/**
+ * Generate a baseline file from current rule violations.
+ *
+ * Wraps existing APIs: collectViolations + generateBaseline.
+ */
+export declare function runBaseline(args: BaselineArgs): Promise<void>;
+//# sourceMappingURL=baseline.d.ts.map

package/dist/cli/commands/baseline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"baseline.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/baseline.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,EAAE,CAAA;IACnB,MAAM,EAAE,MAAM,CAAA;CACf;AAED;;;;GAIG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAQnE"}

package/dist/cli/commands/baseline.js

@@ -0,0 +1,16 @@
+import { collectViolations } from '@nielspeter/eess';
+import { generateBaseline } from '@nielspeter/eess';
+import { loadRuleFiles } from '../load-rules.js';
+/**
+ * Generate a baseline file from current rule violations.
+ *
+ * Wraps existing APIs: collectViolations + generateBaseline.
+ */
+export async function runBaseline(args) {
+    const builders = await loadRuleFiles(args.ruleFiles);
+    const violations = collectViolations(...builders);
+    generateBaseline(violations, args.output);
+    process.stdout.write(`Baseline generated: ${String(violations.length)} violations recorded\n`);
+    process.stdout.write(`Written to: ${args.output}\n`);
+}
+//# sourceMappingURL=baseline.js.map

package/dist/cli/commands/baseline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"baseline.js","sourceRoot":"","sources":["../../../src/cli/commands/baseline.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAQhD;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,IAAkB;IAClD,MAAM,QAAQ,GAAG,MAAM,aAAa,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;IACpD,MAAM,UAAU,GAAG,iBAAiB,CAAC,GAAG,QAAQ,CAAC,CAAA;IAEjD,gBAAgB,CAAC,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,CAAA;IAEzC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,uBAAuB,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,wBAAwB,CAAC,CAAA;IAC9F,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,eAAe,IAAI,CAAC,MAAM,IAAI,CAAC,CAAA;AACtD,CAAC"}

package/dist/cli/commands/check.d.ts

@@ -0,0 +1,21 @@
+import type { OutputFormat } from '@nielspeter/eess';
+export interface CheckArgs {
+    ruleFiles: string[];
+    baseline?: string;
+    changed: boolean;
+    base: string;
+    format: OutputFormat | 'auto';
+    /** Use cache-busting imports for watch mode re-runs. */
+    fresh?: boolean;
+    /** Apply deterministic fixes instead of only reporting (plan 0066). */
+    fix?: boolean;
+    /** With `fix`, write to disk; otherwise dry-run (preview). */
+    apply?: boolean;
+}
+/**
+ * Run architecture rules from the specified rule files.
+ *
+ * Wraps existing programmatic APIs: withBaseline, diffAware, detectFormat.
+ */
+export declare function runCheck(args: CheckArgs): Promise<number>;
+//# sourceMappingURL=check.d.ts.map

package/dist/cli/commands/check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/check.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAgB,YAAY,EAAiB,MAAM,kBAAkB,CAAA;AAKjF,MAAM,WAAW,SAAS;IACxB,SAAS,EAAE,MAAM,EAAE,CAAA;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,OAAO,CAAA;IAChB,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,YAAY,GAAG,MAAM,CAAA;IAC7B,wDAAwD;IACxD,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,uEAAuE;IACvE,GAAG,CAAC,EAAE,OAAO,CAAA;IACb,8DAA8D;IAC9D,KAAK,CAAC,EAAE,OAAO,CAAA;CAChB;AAED;;;;GAIG;AACH,wBAAsB,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,CAgD/D"}

package/dist/cli/commands/check.js

@@ -0,0 +1,94 @@
+import { detectFormat, applyFixes } from '@nielspeter/eess';
+import { withBaseline } from '@nielspeter/eess';
+import { diffAware } from '@nielspeter/eess';
+import { ArchRuleError } from '@nielspeter/eess';
+import { loadRuleFiles } from '../load-rules.js';
+/**
+ * Run architecture rules from the specified rule files.
+ *
+ * Wraps existing programmatic APIs: withBaseline, diffAware, detectFormat.
+ */
+export async function runCheck(args) {
+    const started = Date.now();
+    const format = args.format === 'auto' ? detectFormat() : args.format;
+    const options = { format };
+    if (args.baseline !== undefined) {
+        options.baseline = withBaseline(args.baseline);
+    }
+    if (args.changed) {
+        options.diff = diffAware(args.base);
+    }
+    const builders = await loadRuleFiles(args.ruleFiles, { fresh: args.fresh });
+    if (args.fix === true) {
+        return runFix(builders, options, args.apply === true);
+    }
+    let failures = 0;
+    for (const builder of builders) {
+        try {
+            builder.check(options);
+        }
+        catch (error) {
+            if (error instanceof ArchRuleError) {
+                failures++;
+            }
+            else {
+                throw error;
+            }
+        }
+    }
+    // Report the denominator so a fast green is provably non-vacuous, not silence.
+    // Terminal only — JSON/GitHub-annotation output on stdout stays machine-clean.
+    if (format === 'terminal') {
+        const ms = Date.now() - started;
+        const time = ms < 1000 ? `${ms}ms` : `${(ms / 1000).toFixed(2)}s`;
+        const rules = builders.length;
+        const files = args.ruleFiles.length;
+        const scope = `${rules} rule${rules === 1 ? '' : 's'} across ${files} file${files === 1 ? '' : 's'}`;
+        process.stderr.write(failures === 0
+            ? `\n✓ eess-ts — ${scope} · 0 failing (${time})\n`
+            : `\n✗ eess-ts — ${failures} of ${scope} failing (${time})\n`);
+    }
+    return failures;
+}
+/** Collect a builder's violations without printing (prefers `.violations()`). */
+function collectViolations(builder, options) {
+    if (typeof builder.violations === 'function')
+        return builder.violations();
+    try {
+        builder.check(options);
+        return [];
+    }
+    catch (error) {
+        if (error instanceof ArchRuleError)
+            return error.violations;
+        throw error;
+    }
+}
+/**
+ * Apply deterministic fixes (plan 0066). Dry-run unless `write`. Returns the
+ * count of violations that have no automatic fix (the real remaining failures).
+ */
+function runFix(builders, options, write) {
+    const all = builders.flatMap((b) => collectViolations(b, options));
+    const fixable = all.filter((v) => v.fix !== undefined);
+    const result = applyFixes(fixable, { write });
+    const header = write
+        ? 'eess-ts --fix (applied)'
+        : 'eess-ts --fix (dry run — pass --apply to write)';
+    process.stdout.write(`${header}\n`);
+    for (const d of result.descriptions)
+        process.stdout.write(`  ${write ? 'fixed' : 'would fix'}: ${d}\n`);
+    if (result.skipped > 0) {
+        process.stdout.write(`  ${result.skipped} fix(es) skipped (overlapping — resolve manually)\n`);
+    }
+    const verb = write ? 'applied' : 'would apply';
+    process.stdout.write(`${result.applied} fix(es) ${verb} across ${result.files.length} file(s)\n`);
+    const remaining = all.filter((v) => v.fix === undefined);
+    if (remaining.length > 0) {
+        process.stdout.write(`${remaining.length} violation(s) with no automatic fix remain:\n`);
+        for (const v of remaining)
+            process.stdout.write(`  ${v.file}:${v.line}  ${v.message.split('\n')[0]}\n`);
+    }
+    return remaining.length;
+}
+//# sourceMappingURL=check.js.map

package/dist/cli/commands/check.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"check.js","sourceRoot":"","sources":["../../../src/cli/commands/check.ts"],"names":[],"mappings":"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"}

package/dist/cli/commands/explain.d.ts

@@ -0,0 +1,9 @@
+export interface ExplainArgs {
+    ruleFiles: string[];
+    markdown?: boolean;
+}
+/**
+ * Dump all active rules as structured JSON or markdown.
+ */
+export declare function runExplain(args: ExplainArgs): Promise<void>;
+//# sourceMappingURL=explain.d.ts.map

package/dist/cli/commands/explain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"explain.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/explain.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,EAAE,CAAA;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB;AAgBD;;GAEG;AACH,wBAAsB,UAAU,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAejE"}