@nielspeter/eess 0.1.0

package/dist/combinators.js

@@ -0,0 +1,43 @@
+export function not(input) {
+    if (typeof input === 'function') {
+        return (value) => !input(value);
+    }
+    return {
+        description: `not (${input.description})`,
+        test: (element) => !input.test(element),
+    };
+}
+function assertHomogeneous(inputs) {
+    if (inputs.length === 0)
+        return;
+    const firstIsFunction = typeof inputs[0] === 'function';
+    if (inputs.some((i) => (typeof i === 'function') !== firstIsFunction)) {
+        throw new TypeError('Cannot mix Predicate objects and Matcher functions in and()/or()');
+    }
+}
+export function and(...inputs) {
+    assertHomogeneous(inputs);
+    if (typeof inputs[0] === 'function') {
+        const matchers = inputs.filter((input) => typeof input === 'function');
+        const fn = (value) => matchers.every((m) => m(value));
+        return fn;
+    }
+    const predicates = inputs.filter((input) => typeof input !== 'function');
+    return {
+        description: predicates.map((p) => p.description).join(' and '),
+        test: (element) => predicates.every((p) => p.test(element)),
+    };
+}
+export function or(...inputs) {
+    assertHomogeneous(inputs);
+    if (typeof inputs[0] === 'function') {
+        const matchers = inputs.filter((input) => typeof input === 'function');
+        return (value) => matchers.some((m) => m(value));
+    }
+    const predicates = inputs.filter((input) => typeof input !== 'function');
+    return {
+        description: predicates.map((p) => p.description).join(' or '),
+        test: (element) => predicates.some((p) => p.test(element)),
+    };
+}
+//# sourceMappingURL=combinators.js.map

package/dist/combinators.js.map

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

package/dist/condition.d.ts

@@ -0,0 +1,56 @@
+import type { ArchViolation } from './violation.js';
+/**
+ * Context passed to conditions during evaluation.
+ *
+ * Provides the rule description and optional rationale so that
+ * violations can include meaningful error messages.
+ */
+export interface ConditionContext {
+    /** Human-readable rule description assembled from the fluent chain */
+    rule: string;
+    /** Optional rationale provided via .because() */
+    because?: string;
+    /** Unique rule identifier from .rule({ id }) */
+    ruleId?: string;
+    /** Actionable fix suggestion from .rule({ suggestion }) */
+    suggestion?: string;
+    /** Link to documentation from .rule({ docs }) */
+    docs?: string;
+    /**
+     * Index of the call argument to fold into the violation element/message.
+     *
+     * Read by `calls()` conditions in `src/conditions/call.ts` when building
+     * violations — threaded into `archCall.getName({ withArgument: ... })`
+     * so identity-keyed registrations (HTTP routes, event handlers,
+     * registry entries, etc.) can be excluded individually rather than
+     * only by file. See proposal 011 / plan 0057.
+     *
+     * Conditions for other builder types (class, function, module, JSX,
+     * etc.) simply ignore this field — it's a `calls()`-specific concern
+     * placed on the shared context because abstraction cost would exceed
+     * the leak for one optional primitive.
+     */
+    identifyByArgument?: number;
+}
+/**
+ * A condition that evaluates filtered elements and returns violations.
+ *
+ * Conditions receive the elements that passed predicate filtering.
+ * They return violations for elements that DON'T satisfy the condition.
+ *
+ * Most conditions check each element individually. Some (like notExist)
+ * check the entire set.
+ */
+export interface Condition<T> {
+    /** Human-readable description of what this condition checks */
+    readonly description: string;
+    /**
+     * Evaluate elements against this condition.
+     *
+     * @param elements - The filtered elements (after predicates)
+     * @param context - Rule description and rationale
+     * @returns Violations for elements that don't satisfy the condition
+     */
+    evaluate(elements: T[], context: ConditionContext): ArchViolation[];
+}
+//# sourceMappingURL=condition.d.ts.map

package/dist/condition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"condition.d.ts","sourceRoot":"","sources":["../src/condition.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AAEnD;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B,sEAAsE;IACtE,IAAI,EAAE,MAAM,CAAA;IACZ,iDAAiD;IACjD,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,gDAAgD;IAChD,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,2DAA2D;IAC3D,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,iDAAiD;IACjD,IAAI,CAAC,EAAE,MAAM,CAAA;IACb;;;;;;;;;;;;;OAaG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAA;CAC5B;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,SAAS,CAAC,CAAC;IAC1B,+DAA+D;IAC/D,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAE5B;;;;;;OAMG;IACH,QAAQ,CAAC,QAAQ,EAAE,CAAC,EAAE,EAAE,OAAO,EAAE,gBAAgB,GAAG,aAAa,EAAE,CAAA;CACpE"}

package/dist/condition.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=condition.js.map

package/dist/condition.js.map

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

package/dist/correspondence.d.ts

@@ -0,0 +1,78 @@
+import type { ArchViolation } from './violation.js';
+import { TerminalBuilder } from './terminal-builder.js';
+/** How to identify an element for a two-sided violation message. */
+export interface ElementInfo {
+    readonly name: string;
+    readonly file?: string;
+    readonly line?: number;
+}
+/**
+ * A labelled set of elements produced by a dialect's `.select()` terminal.
+ * Engine-neutral: `T` is opaque; `identify` yields message metadata.
+ */
+export interface Selection<T> {
+    readonly elements: readonly T[];
+    readonly label: string;
+    readonly identify: (element: T) => ElementInfo;
+}
+export type Direction = 'left-to-right' | 'right-to-left' | 'both';
+/** Extract related endpoints from an element (for `preserveRelations`). */
+export interface RelationSpec<L, R> {
+    readonly left: (element: L) => readonly string[];
+    readonly right: (element: R) => readonly string[];
+    readonly direction?: Direction;
+}
+/**
+ * Join-key extraction for a correspondence (O(n+m) indexed matching).
+ *
+ * - A single function keys both sides — each element is `L | R`. Convenient
+ *   when both sides share a key shape.
+ * - A `{ left, right }` pair keys each side with its own type — no
+ *   union-narrowing at the call site, and the join key may differ from the
+ *   display name (show "ADR 001", join on "001").
+ *
+ * Omit `keyBy` entirely to key by each side's `identify().name`.
+ */
+export type KeyBy<L, R> = ((element: L | R) => string) | {
+    readonly left: (l: L) => string;
+    readonly right: (r: R) => string;
+};
+export interface CorrespondenceOptions<L, R> {
+    readonly left: Selection<L>;
+    readonly right: Selection<R>;
+    /** Fast path: extract a join key per element (O(n+m)). Defaults to `identify().name`. */
+    readonly keyBy?: KeyBy<L, R>;
+    /** General fallback: arbitrary predicate (O(n×m)). Use only when no key exists. */
+    readonly matchBy?: (left: L, right: R) => boolean;
+    /** Optional per-side fix suggestions for the two-sided message. */
+    readonly suggest?: {
+        readonly left?: (info: ElementInfo, right: Selection<R>) => string;
+        readonly right?: (info: ElementInfo, left: Selection<L>) => string;
+    };
+}
+/**
+ * Builder binding two element selections and asserting they correspond. A
+ * `TerminalBuilder` (it operates over two selections, like the pair builders),
+ * so `because`/`rule`/`warn`/`excluding`/baseline come for free. It does NOT
+ * compose with the `not`/`and`/`or` combinators (those act on
+ * `Predicate`/`Condition`). Chain checks with `.andShould()`.
+ */
+export declare class CorrespondenceBuilder<L, R> extends TerminalBuilder {
+    private readonly opts;
+    private readonly _checks;
+    constructor(opts: CorrespondenceOptions<L, R>);
+    /** Readability marker; the condition phase is implicit. */
+    should(): this;
+    /** Chain another correspondence check (AND). */
+    andShould(): this;
+    /** Every element on the named side(s) has a counterpart on the other. */
+    beComplete(opts?: {
+        direction?: Direction;
+    }): this;
+    /** Related endpoints on one side have matching relations on the other. */
+    preserveRelations(spec: RelationSpec<L, R>): this;
+    protected collectViolations(): ArchViolation[];
+}
+/** Bind two selections into a correspondence. */
+export declare function correspondence<L, R>(opts: CorrespondenceOptions<L, R>): CorrespondenceBuilder<L, R>;
+//# sourceMappingURL=correspondence.d.ts.map

package/dist/correspondence.d.ts.map

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

package/dist/correspondence.js

@@ -0,0 +1,127 @@
+import { TerminalBuilder } from './terminal-builder.js';
+import { matchSelections } from './matching.js';
+function violationFor(info, message, ruleId) {
+    return {
+        rule: 'correspondence',
+        ruleId,
+        element: info.name,
+        file: info.file ?? '<selection>',
+        line: info.line ?? 0,
+        message,
+        codeFrame: undefined,
+    };
+}
+/**
+ * Builder binding two element selections and asserting they correspond. A
+ * `TerminalBuilder` (it operates over two selections, like the pair builders),
+ * so `because`/`rule`/`warn`/`excluding`/baseline come for free. It does NOT
+ * compose with the `not`/`and`/`or` combinators (those act on
+ * `Predicate`/`Condition`). Chain checks with `.andShould()`.
+ */
+export class CorrespondenceBuilder extends TerminalBuilder {
+    opts;
+    _checks = [];
+    constructor(opts) {
+        super();
+        this.opts = opts;
+    }
+    /** Readability marker; the condition phase is implicit. */
+    should() {
+        return this;
+    }
+    /** Chain another correspondence check (AND). */
+    andShould() {
+        return this;
+    }
+    /** Every element on the named side(s) has a counterpart on the other. */
+    beComplete(opts = {}) {
+        this._checks.push((o, ruleId) => completeness(o, opts.direction ?? 'both', ruleId));
+        return this;
+    }
+    /** Related endpoints on one side have matching relations on the other. */
+    preserveRelations(spec) {
+        this._checks.push((o, ruleId) => relations(o, spec, ruleId));
+        return this;
+    }
+    collectViolations() {
+        const ruleId = this._metadata?.id;
+        return this._checks.flatMap((check) => check(this.opts, ruleId));
+    }
+}
+/** Bind two selections into a correspondence. */
+export function correspondence(opts) {
+    return new CorrespondenceBuilder(opts);
+}
+// --- matching internals (delegate to the shared matchSelections engine) ---
+function matchOptsFor(o) {
+    if (o.matchBy)
+        return { matchBy: o.matchBy };
+    const { keyBy, left, right } = o;
+    // Omitted → key by each side's identify().name. A function → same key both
+    // sides. A { left, right } pair → each side keyed by its own extractor.
+    if (keyBy === undefined) {
+        return {
+            leftKey: (el) => left.identify(el).name,
+            rightKey: (el) => right.identify(el).name,
+        };
+    }
+    if (typeof keyBy === 'function') {
+        return { leftKey: keyBy, rightKey: keyBy };
+    }
+    return { leftKey: keyBy.left, rightKey: keyBy.right };
+}
+function completeness(o, direction, ruleId) {
+    const out = [];
+    const suggestLeft = o.suggest?.left;
+    const suggestRight = o.suggest?.right;
+    const result = matchSelections(o.left.elements, o.right.elements, matchOptsFor(o));
+    if (direction !== 'right-to-left') {
+        for (const l of result.leftUnmatched) {
+            const info = o.left.identify(l);
+            const extra = suggestLeft ? `\n  ${suggestLeft(info, o.right)}` : '';
+            out.push(violationFor(info, `${o.left.label} "${info.name}" has no matching ${o.right.label}${extra}`, ruleId));
+        }
+        for (const l of result.leftAmbiguous) {
+            const info = o.left.identify(l);
+            out.push(violationFor(info, `${o.left.label} "${info.name}" matches multiple ${o.right.label}s — the correspondence is ambiguous`, ruleId));
+        }
+    }
+    if (direction !== 'left-to-right') {
+        for (const r of result.rightUnmatched) {
+            const info = o.right.identify(r);
+            const extra = suggestRight ? `\n  ${suggestRight(info, o.left)}` : '';
+            out.push(violationFor(info, `${o.right.label} "${info.name}" has no matching ${o.left.label}${extra}`, ruleId));
+        }
+    }
+    return out;
+}
+function relations(o, spec, ruleId) {
+    const out = [];
+    const direction = spec.direction ?? 'both';
+    const result = matchSelections(o.left.elements, o.right.elements, matchOptsFor(o));
+    // group right counterparts by their left element (object identity)
+    const byLeft = new Map();
+    for (const p of result.pairs) {
+        const list = byLeft.get(p.left);
+        if (list)
+            list.push(p.right);
+        else
+            byLeft.set(p.left, [p.right]);
+    }
+    if (direction !== 'right-to-left') {
+        for (const l of o.left.elements) {
+            const counterparts = byLeft.get(l) ?? [];
+            if (counterparts.length === 0)
+                continue;
+            const rightRelations = new Set(counterparts.flatMap((r) => spec.right(r)));
+            const info = o.left.identify(l);
+            for (const rel of spec.left(l)) {
+                if (!rightRelations.has(rel)) {
+                    out.push(violationFor(info, `${o.left.label} "${info.name}" relates to "${rel}" but its ${o.right.label} counterpart does not`, ruleId));
+                }
+            }
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=correspondence.js.map

package/dist/correspondence.js.map

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

package/dist/define.d.ts

@@ -0,0 +1,41 @@
+import type { Predicate } from './predicate.js';
+import type { Condition, ConditionContext } from './condition.js';
+import type { ArchViolation } from './violation.js';
+/**
+ * Create a custom predicate for use in `.that().satisfy()` chains.
+ *
+ * The predicate filters elements — return `true` to keep, `false` to exclude.
+ *
+ * @example
+ * ```ts
+ * const isAbstract = definePredicate<ClassDeclaration>(
+ *   'is abstract',
+ *   (cls) => cls.isAbstract()
+ * )
+ *
+ * classes(p).that().satisfy(isAbstract).should().beExported().check()
+ * ```
+ */
+export declare function definePredicate<T>(description: string, test: (element: T) => boolean): Predicate<T>;
+/**
+ * Create a custom condition for use in `.should().satisfy()` chains.
+ *
+ * The callback receives the filtered element array and rule context.
+ * Return an `ArchViolation[]` for elements that fail the condition.
+ *
+ * @example
+ * ```ts
+ * const useSharedHelper = defineCondition<ClassDeclaration>(
+ *   'use shared count helper',
+ *   (classes, context) => {
+ *     return classes
+ *       .filter(cls => !usesHelper(cls))
+ *       .map(cls => createViolation(cls, 'should use shared count helper', context))
+ *   }
+ * )
+ *
+ * classes(p).that().extend('Base').should().satisfy(useSharedHelper).check()
+ * ```
+ */
+export declare function defineCondition<T>(description: string, evaluate: (elements: T[], context: ConditionContext) => ArchViolation[]): Condition<T>;
+//# sourceMappingURL=define.d.ts.map

package/dist/define.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define.d.ts","sourceRoot":"","sources":["../src/define.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC/C,OAAO,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AACjE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AAEnD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAC/B,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,OAAO,GAC5B,SAAS,CAAC,CAAC,CAAC,CAEd;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAC/B,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,CAAC,QAAQ,EAAE,CAAC,EAAE,EAAE,OAAO,EAAE,gBAAgB,KAAK,aAAa,EAAE,GACtE,SAAS,CAAC,CAAC,CAAC,CAEd"}

package/dist/define.js

@@ -0,0 +1,42 @@
+/**
+ * Create a custom predicate for use in `.that().satisfy()` chains.
+ *
+ * The predicate filters elements — return `true` to keep, `false` to exclude.
+ *
+ * @example
+ * ```ts
+ * const isAbstract = definePredicate<ClassDeclaration>(
+ *   'is abstract',
+ *   (cls) => cls.isAbstract()
+ * )
+ *
+ * classes(p).that().satisfy(isAbstract).should().beExported().check()
+ * ```
+ */
+export function definePredicate(description, test) {
+    return { description, test };
+}
+/**
+ * Create a custom condition for use in `.should().satisfy()` chains.
+ *
+ * The callback receives the filtered element array and rule context.
+ * Return an `ArchViolation[]` for elements that fail the condition.
+ *
+ * @example
+ * ```ts
+ * const useSharedHelper = defineCondition<ClassDeclaration>(
+ *   'use shared count helper',
+ *   (classes, context) => {
+ *     return classes
+ *       .filter(cls => !usesHelper(cls))
+ *       .map(cls => createViolation(cls, 'should use shared count helper', context))
+ *   }
+ * )
+ *
+ * classes(p).that().extend('Base').should().satisfy(useSharedHelper).check()
+ * ```
+ */
+export function defineCondition(description, evaluate) {
+    return { description, evaluate };
+}
+//# sourceMappingURL=define.js.map

package/dist/define.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"define.js","sourceRoot":"","sources":["../src/define.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,eAAe,CAC7B,WAAmB,EACnB,IAA6B;IAE7B,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,CAAA;AAC9B,CAAC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,eAAe,CAC7B,WAAmB,EACnB,QAAuE;IAEvE,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,CAAA;AAClC,CAAC"}

package/dist/diff-aware.d.ts

@@ -0,0 +1,37 @@
+import type { ArchViolation } from './violation.js';
+/**
+ * A diff filter that restricts violation reporting to files
+ * changed since a base branch.
+ *
+ * IMPORTANT: Rules evaluate the FULL project (needed for cross-file
+ * rules like cycles and layer ordering). Only the REPORTING is filtered
+ * to changed files. This ensures correctness — a new file that creates
+ * a cycle is detected even though the cycle involves unchanged files.
+ */
+export declare class DiffFilter {
+    private readonly changedFiles;
+    constructor(changedFiles: Set<string> | null);
+    /**
+     * Filter violations to only those in changed files.
+     * If changedFiles is null (git error), returns all violations unfiltered.
+     */
+    filterToChanged(violations: ArchViolation[]): ArchViolation[];
+    /** Number of changed files detected, or -1 if diff unavailable */
+    get size(): number;
+}
+/**
+ * Create a diff filter from git, comparing HEAD against a base branch.
+ *
+ * Uses `git diff --name-only <base>...HEAD` to find changed files.
+ * Resolves relative paths to absolute paths for matching against
+ * violation file paths (which are always absolute).
+ *
+ * @param baseBranch - The base branch to diff against (default: 'main')
+ * @returns A DiffFilter for use with check(\{ diff \})
+ *
+ * @example
+ * // Only report violations in files changed since main
+ * classes(p).should().notContain(call('eval')).check(\{ diff: diffAware('main') \})
+ */
+export declare function diffAware(baseBranch?: string): DiffFilter;
+//# sourceMappingURL=diff-aware.d.ts.map

package/dist/diff-aware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff-aware.d.ts","sourceRoot":"","sources":["../src/diff-aware.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AAEnD;;;;;;;;GAQG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAoB;gBAErC,YAAY,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,IAAI;IAI5C;;;OAGG;IACH,eAAe,CAAC,UAAU,EAAE,aAAa,EAAE,GAAG,aAAa,EAAE;IAM7D,kEAAkE;IAClE,IAAI,IAAI,IAAI,MAAM,CAEjB;CACF;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,SAAS,CAAC,UAAU,GAAE,MAAe,GAAG,UAAU,CA6BjE"}

package/dist/diff-aware.js

@@ -0,0 +1,69 @@
+import { execFileSync } from 'node:child_process';
+import path from 'node:path';
+/**
+ * A diff filter that restricts violation reporting to files
+ * changed since a base branch.
+ *
+ * IMPORTANT: Rules evaluate the FULL project (needed for cross-file
+ * rules like cycles and layer ordering). Only the REPORTING is filtered
+ * to changed files. This ensures correctness — a new file that creates
+ * a cycle is detected even though the cycle involves unchanged files.
+ */
+export class DiffFilter {
+    changedFiles;
+    constructor(changedFiles) {
+        this.changedFiles = changedFiles;
+    }
+    /**
+     * Filter violations to only those in changed files.
+     * If changedFiles is null (git error), returns all violations unfiltered.
+     */
+    filterToChanged(violations) {
+        const files = this.changedFiles;
+        if (files === null)
+            return violations;
+        return violations.filter((v) => files.has(v.file));
+    }
+    /** Number of changed files detected, or -1 if diff unavailable */
+    get size() {
+        return this.changedFiles === null ? -1 : this.changedFiles.size;
+    }
+}
+/**
+ * Create a diff filter from git, comparing HEAD against a base branch.
+ *
+ * Uses `git diff --name-only <base>...HEAD` to find changed files.
+ * Resolves relative paths to absolute paths for matching against
+ * violation file paths (which are always absolute).
+ *
+ * @param baseBranch - The base branch to diff against (default: 'main')
+ * @returns A DiffFilter for use with check(\{ diff \})
+ *
+ * @example
+ * // Only report violations in files changed since main
+ * classes(p).should().notContain(call('eval')).check(\{ diff: diffAware('main') \})
+ */
+export function diffAware(baseBranch = 'main') {
+    const cwd = process.cwd();
+    let output;
+    try {
+        output = execFileSync('git', ['diff', '--name-only', `${baseBranch}...HEAD`], {
+            encoding: 'utf-8',
+            cwd,
+            stdio: ['pipe', 'pipe', 'pipe'],
+        }).trim();
+    }
+    catch (err) {
+        // Not a git repo, or base branch doesn't exist — skip filtering (report all violations)
+        const detail = err instanceof Error ? ` (${err.message.split('\n')[0] ?? ''})` : '';
+        console.warn(`[eess] Could not run git diff against '${baseBranch}'${detail}. All violations will be reported.`);
+        return new DiffFilter(null);
+    }
+    if (output === '') {
+        // No changes — empty set means nothing is "changed", so all violations are filtered out
+        return new DiffFilter(new Set());
+    }
+    const changedFiles = new Set(output.split('\n').map((relativePath) => path.resolve(cwd, relativePath)));
+    return new DiffFilter(changedFiles);
+}
+//# sourceMappingURL=diff-aware.js.map

package/dist/diff-aware.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff-aware.js","sourceRoot":"","sources":["../src/diff-aware.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACjD,OAAO,IAAI,MAAM,WAAW,CAAA;AAG5B;;;;;;;;GAQG;AACH,MAAM,OAAO,UAAU;IACJ,YAAY,CAAoB;IAEjD,YAAY,YAAgC;QAC1C,IAAI,CAAC,YAAY,GAAG,YAAY,CAAA;IAClC,CAAC;IAED;;;OAGG;IACH,eAAe,CAAC,UAA2B;QACzC,MAAM,KAAK,GAAG,IAAI,CAAC,YAAY,CAAA;QAC/B,IAAI,KAAK,KAAK,IAAI;YAAE,OAAO,UAAU,CAAA;QACrC,OAAO,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAA;IACpD,CAAC;IAED,kEAAkE;IAClE,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,YAAY,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAA;IACjE,CAAC;CACF;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,SAAS,CAAC,aAAqB,MAAM;IACnD,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,CAAA;IAEzB,IAAI,MAAc,CAAA;IAClB,IAAI,CAAC;QACH,MAAM,GAAG,YAAY,CAAC,KAAK,EAAE,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,UAAU,SAAS,CAAC,EAAE;YAC5E,QAAQ,EAAE,OAAO;YACjB,GAAG;YACH,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;SAChC,CAAC,CAAC,IAAI,EAAE,CAAA;IACX,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,wFAAwF;QACxF,MAAM,MAAM,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,CAAA;QACnF,OAAO,CAAC,IAAI,CACV,0CAA0C,UAAU,IAAI,MAAM,oCAAoC,CACnG,CAAA;QACD,OAAO,IAAI,UAAU,CAAC,IAAI,CAAC,CAAA;IAC7B,CAAC;IAED,IAAI,MAAM,KAAK,EAAE,EAAE,CAAC;QAClB,wFAAwF;QACxF,OAAO,IAAI,UAAU,CAAC,IAAI,GAAG,EAAE,CAAC,CAAA;IAClC,CAAC;IAED,MAAM,YAAY,GAAG,IAAI,GAAG,CAC1B,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,YAAY,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC,CAC1E,CAAA;IAED,OAAO,IAAI,UAAU,CAAC,YAAY,CAAC,CAAA;AACrC,CAAC"}

package/dist/environment.d.ts

@@ -0,0 +1,14 @@
+import type { OutputFormat } from './check-options.js';
+/**
+ * Detect the current CI environment and return the appropriate output format.
+ *
+ * - GitHub Actions: detected via GITHUB_ACTIONS env var
+ * - Other CI: detected via CI env var (falls back to terminal)
+ * - Local: terminal
+ */
+export declare function detectFormat(): OutputFormat;
+/**
+ * Check if running in any CI environment.
+ */
+export declare function isCI(): boolean;
+//# sourceMappingURL=environment.d.ts.map

package/dist/environment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment.d.ts","sourceRoot":"","sources":["../src/environment.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAEtD;;;;;;GAMG;AACH,wBAAgB,YAAY,IAAI,YAAY,CAK3C;AAED;;GAEG;AACH,wBAAgB,IAAI,IAAI,OAAO,CAE9B"}

package/dist/environment.js

@@ -0,0 +1,20 @@
+/**
+ * Detect the current CI environment and return the appropriate output format.
+ *
+ * - GitHub Actions: detected via GITHUB_ACTIONS env var
+ * - Other CI: detected via CI env var (falls back to terminal)
+ * - Local: terminal
+ */
+export function detectFormat() {
+    if (process.env['GITHUB_ACTIONS'] === 'true') {
+        return 'github';
+    }
+    return 'terminal';
+}
+/**
+ * Check if running in any CI environment.
+ */
+export function isCI() {
+    return process.env['CI'] === 'true' || process.env['GITHUB_ACTIONS'] === 'true';
+}
+//# sourceMappingURL=environment.js.map

package/dist/environment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment.js","sourceRoot":"","sources":["../src/environment.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,MAAM,UAAU,YAAY;IAC1B,IAAI,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,KAAK,MAAM,EAAE,CAAC;QAC7C,OAAO,QAAQ,CAAA;IACjB,CAAC;IACD,OAAO,UAAU,CAAA;AACnB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,IAAI;IAClB,OAAO,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,KAAK,MAAM,CAAA;AACjF,CAAC"}

package/dist/errors.d.ts

@@ -0,0 +1,14 @@
+import type { ArchViolation } from './violation.js';
+/**
+ * Thrown by `.check()` when architecture violations are found.
+ *
+ * Integrates naturally with vitest/jest — the test fails with a readable
+ * error message listing all violations and their locations.
+ */
+export declare class ArchRuleError extends Error {
+    #private;
+    constructor(violations: ArchViolation[], reason?: string);
+    /** The violations that failed the rule, in report order. */
+    get violations(): ArchViolation[];
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AAEnD;;;;;GAKG;AACH,qBAAa,aAAc,SAAQ,KAAK;;gBAG1B,UAAU,EAAE,aAAa,EAAE,EAAE,MAAM,CAAC,EAAE,MAAM;IAQxD,4DAA4D;IAC5D,IAAI,UAAU,IAAI,aAAa,EAAE,CAEhC;CACF"}

package/dist/errors.js

@@ -0,0 +1,21 @@
+/**
+ * Thrown by `.check()` when architecture violations are found.
+ *
+ * Integrates naturally with vitest/jest — the test fails with a readable
+ * error message listing all violations and their locations.
+ */
+export class ArchRuleError extends Error {
+    #violations;
+    constructor(violations, reason) {
+        const summary = `Architecture violation${violations.length === 1 ? '' : 's'} (${String(violations.length)} found)`;
+        const reasonLine = reason ? ` — ${reason}` : '';
+        super(`${summary}${reasonLine}`);
+        this.name = 'ArchRuleError';
+        this.#violations = violations;
+    }
+    /** The violations that failed the rule, in report order. */
+    get violations() {
+        return this.#violations;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,OAAO,aAAc,SAAQ,KAAK;IAC7B,WAAW,CAAiB;IAErC,YAAY,UAA2B,EAAE,MAAe;QACtD,MAAM,OAAO,GAAG,yBAAyB,UAAU,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,SAAS,CAAA;QAClH,MAAM,UAAU,GAAG,MAAM,CAAC,CAAC,CAAC,MAAM,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAA;QAC/C,KAAK,CAAC,GAAG,OAAO,GAAG,UAAU,EAAE,CAAC,CAAA;QAChC,IAAI,CAAC,IAAI,GAAG,eAAe,CAAA;QAC3B,IAAI,CAAC,WAAW,GAAG,UAAU,CAAA;IAC/B,CAAC;IAED,4DAA4D;IAC5D,IAAI,UAAU;QACZ,OAAO,IAAI,CAAC,WAAW,CAAA;IACzB,CAAC;CACF"}