@nielspeter/eess-ts 0.1.0

package/dist/cli/commands/explain.js

@@ -0,0 +1,49 @@
+import { loadRuleFiles } from '../load-rules.js';
+function isDescribable(value) {
+    return (value !== null &&
+        value !== undefined &&
+        typeof value === 'object' &&
+        'describeRule' in value &&
+        typeof value['describeRule'] === 'function');
+}
+/**
+ * Dump all active rules as structured JSON or markdown.
+ */
+export async function runExplain(args) {
+    const builders = await loadRuleFiles(args.ruleFiles);
+    const descriptions = [];
+    for (const builder of builders) {
+        if (isDescribable(builder)) {
+            descriptions.push(builder.describeRule());
+        }
+    }
+    if (args.markdown) {
+        outputMarkdown(descriptions);
+    }
+    else {
+        outputJson(descriptions);
+    }
+}
+function outputJson(descriptions) {
+    const output = {
+        rules: descriptions,
+        generatedAt: new Date().toISOString(),
+    };
+    process.stdout.write(JSON.stringify(output, null, 2) + '\n');
+}
+function outputMarkdown(descriptions) {
+    if (descriptions.length === 0) {
+        process.stdout.write('No rules found.\n');
+        return;
+    }
+    process.stdout.write('| ID | Rule | Because | Suggestion |\n');
+    process.stdout.write('|----|------|---------|------------|\n');
+    for (const d of descriptions) {
+        const id = d.id ?? '-';
+        const rule = d.rule || '-';
+        const because = d.because ?? '-';
+        const suggestion = d.suggestion ?? '-';
+        process.stdout.write(`| ${id} | ${rule} | ${because} | ${suggestion} |\n`);
+    }
+}
+//# sourceMappingURL=explain.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"explain.js","sourceRoot":"","sources":["../../../src/cli/commands/explain.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAYhD,SAAS,aAAa,CAAC,KAAc;IACnC,OAAO,CACL,KAAK,KAAK,IAAI;QACd,KAAK,KAAK,SAAS;QACnB,OAAO,KAAK,KAAK,QAAQ;QACzB,cAAc,IAAI,KAAK;QACvB,OAAO,KAAK,CAAC,cAAc,CAAC,KAAK,UAAU,CAC5C,CAAA;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,IAAiB;IAChD,MAAM,QAAQ,GAAG,MAAM,aAAa,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;IAEpD,MAAM,YAAY,GAAsB,EAAE,CAAA;IAC1C,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,IAAI,aAAa,CAAC,OAAO,CAAC,EAAE,CAAC;YAC3B,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC,CAAA;QAC3C,CAAC;IACH,CAAC;IAED,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;QAClB,cAAc,CAAC,YAAY,CAAC,CAAA;IAC9B,CAAC;SAAM,CAAC;QACN,UAAU,CAAC,YAAY,CAAC,CAAA;IAC1B,CAAC;AACH,CAAC;AAED,SAAS,UAAU,CAAC,YAA+B;IACjD,MAAM,MAAM,GAAG;QACb,KAAK,EAAE,YAAY;QACnB,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACtC,CAAA;IACD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAA;AAC9D,CAAC;AAED,SAAS,cAAc,CAAC,YAA+B;IACrD,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAA;QACzC,OAAM;IACR,CAAC;IAED,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,wCAAwC,CAAC,CAAA;IAC9D,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,wCAAwC,CAAC,CAAA;IAC9D,KAAK,MAAM,CAAC,IAAI,YAAY,EAAE,CAAC;QAC7B,MAAM,EAAE,GAAG,CAAC,CAAC,EAAE,IAAI,GAAG,CAAA;QACtB,MAAM,IAAI,GAAG,CAAC,CAAC,IAAI,IAAI,GAAG,CAAA;QAC1B,MAAM,OAAO,GAAG,CAAC,CAAC,OAAO,IAAI,GAAG,CAAA;QAChC,MAAM,UAAU,GAAG,CAAC,CAAC,UAAU,IAAI,GAAG,CAAA;QACtC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,MAAM,IAAI,MAAM,OAAO,MAAM,UAAU,MAAM,CAAC,CAAA;IAC5E,CAAC;AACH,CAAC"}

package/dist/cli/config.d.ts

@@ -0,0 +1,31 @@
+import type { OutputFormat } from '@nielspeter/eess';
+export interface CliConfig {
+    /** Path to tsconfig.json. Default: 'tsconfig.json' */
+    project?: string;
+    /** Rule files to load. Default: discovered via glob */
+    rules?: string[];
+    /** Baseline file path */
+    baseline?: string;
+    /** Output format. 'auto' uses detectFormat() */
+    format?: OutputFormat | 'auto';
+    /** Directories to watch in --watch mode. Default: ['src'] */
+    watchDirs?: string[];
+}
+/**
+ * Define a CLI configuration with type safety.
+ *
+ * @example
+ * ```ts
+ * // eess-ts.config.ts
+ * import { defineConfig } from '@nielspeter/eess-ts'
+ *
+ * export default defineConfig({
+ *   project: 'tsconfig.json',
+ *   rules: ['arch.rules.ts'],
+ *   baseline: 'arch-baseline.json',
+ *   format: 'auto',
+ * })
+ * ```
+ */
+export declare function defineConfig(config: CliConfig): CliConfig;
+//# sourceMappingURL=config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/cli/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAEpD,MAAM,WAAW,SAAS;IACxB,sDAAsD;IACtD,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,uDAAuD;IACvD,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;IAChB,yBAAyB;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,gDAAgD;IAChD,MAAM,CAAC,EAAE,YAAY,GAAG,MAAM,CAAA;IAC9B,6DAA6D;IAC7D,SAAS,CAAC,EAAE,MAAM,EAAE,CAAA;CACrB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,SAAS,GAAG,SAAS,CAEzD"}

package/dist/cli/config.js

@@ -0,0 +1,20 @@
+/**
+ * Define a CLI configuration with type safety.
+ *
+ * @example
+ * ```ts
+ * // eess-ts.config.ts
+ * import { defineConfig } from '@nielspeter/eess-ts'
+ *
+ * export default defineConfig({
+ *   project: 'tsconfig.json',
+ *   rules: ['arch.rules.ts'],
+ *   baseline: 'arch-baseline.json',
+ *   format: 'auto',
+ * })
+ * ```
+ */
+export function defineConfig(config) {
+    return config;
+}
+//# sourceMappingURL=config.js.map

package/dist/cli/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/cli/config.ts"],"names":[],"mappings":"AAeA;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,YAAY,CAAC,MAAiB;IAC5C,OAAO,MAAM,CAAA;AACf,CAAC"}

package/dist/cli/index.d.ts

@@ -0,0 +1,21 @@
+interface ParsedArgs {
+    values: {
+        baseline?: string;
+        output?: string;
+        changed?: boolean;
+        base?: string;
+        format?: string;
+        config?: string;
+        help?: boolean;
+        version?: boolean;
+        watch?: boolean;
+        markdown?: boolean;
+        fix?: boolean;
+        apply?: boolean;
+    };
+    positionals: string[];
+}
+export declare function parseCliArgs(args: string[]): ParsedArgs;
+export declare function run(args: string[]): Promise<void>;
+export {};
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AA4CA,UAAU,UAAU;IAClB,MAAM,EAAE;QACN,QAAQ,CAAC,EAAE,MAAM,CAAA;QACjB,MAAM,CAAC,EAAE,MAAM,CAAA;QACf,OAAO,CAAC,EAAE,OAAO,CAAA;QACjB,IAAI,CAAC,EAAE,MAAM,CAAA;QACb,MAAM,CAAC,EAAE,MAAM,CAAA;QACf,MAAM,CAAC,EAAE,MAAM,CAAA;QACf,IAAI,CAAC,EAAE,OAAO,CAAA;QACd,OAAO,CAAC,EAAE,OAAO,CAAA;QACjB,KAAK,CAAC,EAAE,OAAO,CAAA;QACf,QAAQ,CAAC,EAAE,OAAO,CAAA;QAClB,GAAG,CAAC,EAAE,OAAO,CAAA;QACb,KAAK,CAAC,EAAE,OAAO,CAAA;KAChB,CAAA;IACD,WAAW,EAAE,MAAM,EAAE,CAAA;CACtB;AAGD,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,UAAU,CAoBvD;AAuED,wBAAsB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAoDvD"}

package/dist/cli/index.js

@@ -0,0 +1,168 @@
+import { parseArgs } from 'node:util';
+import { readFileSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+import path from 'node:path';
+import { resetProjectCache } from '../core/project.js';
+import { resolveConfig } from './resolve-config.js';
+import { runCheck } from './commands/check.js';
+import { runBaseline } from './commands/baseline.js';
+import { runExplain } from './commands/explain.js';
+import { watchAndRerun } from './watch.js';
+function getVersion() {
+    const pkgPath = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '../../package.json');
+    const pkg = JSON.parse(readFileSync(pkgPath, 'utf-8'));
+    if (pkg && typeof pkg === 'object' && 'version' in pkg && typeof pkg.version === 'string') {
+        return pkg.version;
+    }
+    return '0.0.0';
+}
+const HELP_TEXT = `
+eess-ts — Architecture testing for TypeScript
+
+Usage:
+  eess-ts check [files...]              Run architecture rules
+  eess-ts baseline [files...]           Generate baseline file
+  eess-ts explain [files...]            Dump all active rules as JSON
+
+Options:
+  --baseline <path>     Baseline file for filtering known violations
+  --output <path>       Output path for baseline file (default: arch-baseline.json)
+  --changed             Only report violations in changed files (git diff)
+  --base <branch>       Base branch for diff (default: main)
+  --format <format>     Output format: terminal, json, github, auto (default: auto)
+  --markdown            Output explain results as markdown table
+  --fix                 Apply deterministic fixes; dry-run (preview) unless --apply
+  --apply               With --fix, write the fixes to disk
+  -w, --watch           Watch for changes and re-run (check command only)
+  --config <path>       Path to config file
+  -v, --version         Show version number
+  -h, --help            Show this help message
+`;
+// eess-exclude eess/no-unused-exports: consumed by the test suite (tests are outside the build project)
+export function parseCliArgs(args) {
+    return parseArgs({
+        args,
+        options: {
+            baseline: { type: 'string' },
+            output: { type: 'string' },
+            changed: { type: 'boolean', default: false },
+            markdown: { type: 'boolean', default: false },
+            base: { type: 'string', default: 'main' },
+            format: { type: 'string' },
+            config: { type: 'string' },
+            help: { type: 'boolean', short: 'h', default: false },
+            version: { type: 'boolean', short: 'v', default: false },
+            watch: { type: 'boolean', short: 'w', default: false },
+            fix: { type: 'boolean', default: false },
+            apply: { type: 'boolean', default: false },
+        },
+        allowPositionals: true,
+        strict: true,
+    });
+}
+/** Require rule files to be specified, printing an error and setting exit code if missing. */
+function requireRuleFiles(ruleFiles) {
+    if (ruleFiles.length > 0)
+        return true;
+    console.error('Error: No rule files specified. Pass rule files as arguments or set them in config.');
+    process.exitCode = 1;
+    return false;
+}
+/** Handle the `check` subcommand. */
+async function handleCheck(ruleFiles, values, config, format, baseline, changed, base) {
+    if (!requireRuleFiles(ruleFiles))
+        return;
+    if (values.watch === true) {
+        const watchDirs = config.watchDirs ?? ['src'];
+        const checkArgs = { ruleFiles, baseline, changed, base, format, fresh: true };
+        process.stdout.write('eess-ts — watching for changes\n\n');
+        resetProjectCache();
+        await runCheck(checkArgs).catch(() => {
+            // Initial violations are printed by runCheck — don't exit
+        });
+        process.stdout.write('\nWatching for changes...\n');
+        watchAndRerun({
+            watchDirs,
+            watchFiles: ruleFiles,
+            onChangeDetected: async () => {
+                resetProjectCache();
+                await runCheck(checkArgs);
+            },
+        });
+    }
+    else {
+        const failures = await runCheck({
+            ruleFiles,
+            baseline,
+            changed,
+            base,
+            format,
+            fix: values.fix === true,
+            apply: values.apply === true,
+        });
+        if (failures > 0) {
+            process.exitCode = 1;
+        }
+    }
+}
+/** Handle the `baseline` subcommand. */
+async function handleBaseline(ruleFiles, output) {
+    if (!requireRuleFiles(ruleFiles))
+        return;
+    await runBaseline({ ruleFiles, output });
+}
+/** Handle the `explain` subcommand. */
+async function handleExplain(ruleFiles, markdown) {
+    if (!requireRuleFiles(ruleFiles))
+        return;
+    await runExplain({ ruleFiles, markdown });
+}
+export async function run(args) {
+    const parsed = parseCliArgs(args);
+    const { values, positionals } = parsed;
+    if (values.version === true) {
+        process.stdout.write(getVersion() + '\n');
+        return;
+    }
+    if (values.help === true) {
+        process.stdout.write(HELP_TEXT + '\n');
+        return;
+    }
+    const command = positionals[0];
+    if (command === undefined) {
+        console.error('Error: No command specified. Use --help for usage.');
+        process.exitCode = 1;
+        return;
+    }
+    if (values.watch === true && command !== 'check') {
+        console.error('Error: --watch is only supported with the check command.');
+        process.exitCode = 1;
+        return;
+    }
+    const config = await resolveConfig(values.config);
+    const ruleFiles = positionals.slice(1).length > 0 ? positionals.slice(1) : (config.rules ?? []);
+    const formatCandidate = values.format ?? config.format ?? 'auto';
+    const format = formatCandidate === 'json' ||
+        formatCandidate === 'github' ||
+        formatCandidate === 'terminal' ||
+        formatCandidate === 'auto'
+        ? formatCandidate
+        : 'auto';
+    const baseline = values.baseline ?? config.baseline;
+    const base = values.base ?? 'main';
+    const changed = values.changed ?? false;
+    if (command === 'check') {
+        await handleCheck(ruleFiles, values, config, format, baseline, changed, base);
+    }
+    else if (command === 'baseline') {
+        await handleBaseline(ruleFiles, values.output ?? 'arch-baseline.json');
+    }
+    else if (command === 'explain') {
+        await handleExplain(ruleFiles, values.markdown);
+    }
+    else {
+        console.error(`Error: Unknown command "${command}". Use --help for usage.`);
+        process.exitCode = 1;
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

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

package/dist/cli/load-rules.d.ts

@@ -0,0 +1,20 @@
+import type { CheckOptions, ArchViolation } from '@nielspeter/eess';
+/** Minimal interface for rule builders — needs .check(); .violations() enables --fix. */
+export interface RuleBuilderLike {
+    check: (opts?: CheckOptions) => void;
+    /** Collect violations without printing/throwing — used by --fix. */
+    violations?: () => ArchViolation[];
+}
+export interface LoadOptions {
+    /** Use cache-busting imports for watch mode. Default: false */
+    fresh?: boolean;
+}
+/**
+ * Load rule files via jiti (supports `.ts` and `.js`/`.mjs`).
+ *
+ * Rule files must export a default array of rule builders or a function
+ * returning one. When `fresh` is true, a cache-busting jiti instance is used so
+ * watch-mode re-runs pick up file changes.
+ */
+export declare function loadRuleFiles(files: string[], options?: LoadOptions): Promise<RuleBuilderLike[]>;
+//# sourceMappingURL=load-rules.d.ts.map

package/dist/cli/load-rules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-rules.d.ts","sourceRoot":"","sources":["../../src/cli/load-rules.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAEnE,yFAAyF;AAEzF,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,CAAC,IAAI,CAAC,EAAE,YAAY,KAAK,IAAI,CAAA;IACpC,oEAAoE;IACpE,UAAU,CAAC,EAAE,MAAM,aAAa,EAAE,CAAA;CACnC;AAGD,MAAM,WAAW,WAAW;IAC1B,+DAA+D;IAC/D,KAAK,CAAC,EAAE,OAAO,CAAA;CAChB;AAYD;;;;;;GAMG;AACH,wBAAsB,aAAa,CACjC,KAAK,EAAE,MAAM,EAAE,EACf,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,eAAe,EAAE,CAAC,CA8B5B"}

package/dist/cli/load-rules.js

@@ -0,0 +1,97 @@
+import path from 'node:path';
+import { createJiti } from 'jiti';
+// jiti so rule files can be authored in TypeScript (`arch.rules.ts`) — native
+// `import()` cannot load `.ts`. Cached, except in watch mode where a fresh
+// instance busts the module cache to pick up edits.
+let cachedJiti;
+function getJiti(fresh) {
+    if (fresh)
+        return createJiti(import.meta.url, { fsCache: false, moduleCache: false });
+    if (!cachedJiti)
+        cachedJiti = createJiti(import.meta.url);
+    return cachedJiti;
+}
+/**
+ * Load rule files via jiti (supports `.ts` and `.js`/`.mjs`).
+ *
+ * Rule files must export a default array of rule builders or a function
+ * returning one. When `fresh` is true, a cache-busting jiti instance is used so
+ * watch-mode re-runs pick up file changes.
+ */
+export async function loadRuleFiles(files, options) {
+    const builders = [];
+    const jiti = getJiti(options?.fresh === true);
+    for (const file of files) {
+        const resolved = path.resolve(file);
+        const mod = await jiti.import(resolved);
+        const exported = extractDefault(mod);
+        const items = resolveExported(exported, file);
+        // A non-builder value in the default-export array is a loud error, never a
+        // silent skip: a silently-dropped rule is a green-but-empty gate, which the
+        // whole point of this tool is to forbid (plan 0061, Phase 0). Every entry
+        // must be a `.check()`-able builder — a void preset call (`preset(...)`
+        // returning `undefined`) is the classic offender and must fail here, not
+        // vanish.
+        items.forEach((item, index) => {
+            if (!isRuleBuilderLike(item)) {
+                throw new Error(`Rule file "${file}": default export entry [${index}] is not a rule builder ` +
+                    `(got ${describeValue(item)}). Every entry must be a builder with a .check() ` +
+                    `method — e.g. \`modules(p).that()…\`. A preset that returns void cannot be placed ` +
+                    `directly in the array; call it in its own statement, or export a builder.`);
+            }
+            builders.push(item);
+        });
+    }
+    return builders;
+}
+/**
+ * Resolve the exported value to an array of unknowns.
+ * Supports: direct arrays, or factory functions returning arrays.
+ *
+ * A default export of the wrong shape (not an array, or a function that does
+ * not return an array) is a loud error — otherwise the rule file contributes
+ * zero gates silently.
+ */
+function resolveExported(exported, file) {
+    if (Array.isArray(exported)) {
+        return exported;
+    }
+    if (typeof exported === 'function') {
+        // Runtime validated: exported is a function, call it and check result
+        // eess-exclude eess/adr005-no-type-assertions: exported is runtime-verified as callable (typeof check); the static `Function` type is not callable with a typed signature
+        const result = exported();
+        if (Array.isArray(result)) {
+            return result;
+        }
+        throw new Error(`Rule file "${file}": default-exported function must return an array of rule builders ` +
+            `(got ${describeValue(result)}).`);
+    }
+    throw new Error(`Rule file "${file}": default export must be an array of rule builders, or a function ` +
+        `returning one (got ${describeValue(exported)}). Add \`export default [ …builders ]\`.`);
+}
+/** Short human-readable description of an unexpected value, for error messages. */
+function describeValue(value) {
+    if (value === null)
+        return 'null';
+    if (Array.isArray(value))
+        return 'an array';
+    return typeof value;
+}
+function extractDefault(mod) {
+    if (mod === null || mod === undefined || typeof mod !== 'object') {
+        return undefined;
+    }
+    // Dynamic import returns a module namespace object — 'in' narrows safely
+    if ('default' in mod) {
+        return mod['default'];
+    }
+    return undefined;
+}
+function isRuleBuilderLike(value) {
+    if (value === null || value === undefined || typeof value !== 'object') {
+        return false;
+    }
+    // Structural type check: must have a 'check' method ('in' narrows the read)
+    return 'check' in value && typeof value['check'] === 'function';
+}
+//# sourceMappingURL=load-rules.js.map

package/dist/cli/load-rules.js.map

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

package/dist/cli/resolve-config.d.ts

@@ -0,0 +1,11 @@
+import type { CliConfig } from './config.js';
+/**
+ * Resolve CLI configuration from an explicit path or by searching for a config file.
+ *
+ * Config resolution order:
+ * 1. CLI flags (highest priority) — handled by caller
+ * 2. eess-ts.config.ts in project root
+ * 3. Defaults (project: 'tsconfig.json', format: 'auto')
+ */
+export declare function resolveConfig(explicitPath?: string): Promise<CliConfig>;
+//# sourceMappingURL=resolve-config.d.ts.map

package/dist/cli/resolve-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-config.d.ts","sourceRoot":"","sources":["../../src/cli/resolve-config.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAK5C;;;;;;;GAOG;AACH,wBAAsB,aAAa,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAO7E"}

package/dist/cli/resolve-config.js

@@ -0,0 +1,61 @@
+import path from 'node:path';
+import fs from 'node:fs';
+// Config file names, in resolution order. First match wins.
+const CONFIG_FILENAMES = ['eess-ts.config.ts', 'eess-ts.config.js'];
+/**
+ * Resolve CLI configuration from an explicit path or by searching for a config file.
+ *
+ * Config resolution order:
+ * 1. CLI flags (highest priority) — handled by caller
+ * 2. eess-ts.config.ts in project root
+ * 3. Defaults (project: 'tsconfig.json', format: 'auto')
+ */
+export async function resolveConfig(explicitPath) {
+    const configPath = explicitPath ?? findConfigFile();
+    if (configPath === undefined)
+        return {};
+    const mod = await import(path.resolve(configPath));
+    return extractDefault(mod);
+}
+function findConfigFile() {
+    const cwd = process.cwd();
+    for (const name of CONFIG_FILENAMES) {
+        const candidate = path.join(cwd, name);
+        if (fs.existsSync(candidate))
+            return candidate;
+    }
+    return undefined;
+}
+/**
+ * Extract the default export from an ESM module.
+ * Supports both `export default config` and `module.exports = config`.
+ */
+function extractDefault(mod) {
+    if (mod === null || mod === undefined || typeof mod !== 'object') {
+        return {};
+    }
+    // Dynamic import returns a module namespace — 'in' narrows safely
+    if (!('default' in mod)) {
+        return {};
+    }
+    const defaultExport = mod['default'];
+    if (defaultExport === null || defaultExport === undefined || typeof defaultExport !== 'object') {
+        return {};
+    }
+    // Runtime validate: only pick known CliConfig fields ('in' narrows each read)
+    const config = {};
+    if ('project' in defaultExport && typeof defaultExport.project === 'string')
+        config.project = defaultExport.project;
+    if ('baseline' in defaultExport && typeof defaultExport.baseline === 'string')
+        config.baseline = defaultExport.baseline;
+    if ('format' in defaultExport) {
+        const format = defaultExport.format;
+        if (format === 'terminal' || format === 'json' || format === 'github' || format === 'auto') {
+            config.format = format;
+        }
+    }
+    if ('rules' in defaultExport && Array.isArray(defaultExport.rules))
+        config.rules = defaultExport.rules.filter((r) => typeof r === 'string');
+    return config;
+}
+//# sourceMappingURL=resolve-config.js.map

package/dist/cli/resolve-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-config.js","sourceRoot":"","sources":["../../src/cli/resolve-config.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAA;AAC5B,OAAO,EAAE,MAAM,SAAS,CAAA;AAGxB,4DAA4D;AAC5D,MAAM,gBAAgB,GAAG,CAAC,mBAAmB,EAAE,mBAAmB,CAAC,CAAA;AAEnE;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,YAAqB;IACvD,MAAM,UAAU,GAAG,YAAY,IAAI,cAAc,EAAE,CAAA;IAEnD,IAAI,UAAU,KAAK,SAAS;QAAE,OAAO,EAAE,CAAA;IAEvC,MAAM,GAAG,GAAY,MAAM,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAA;IAC3D,OAAO,cAAc,CAAC,GAAG,CAAC,CAAA;AAC5B,CAAC;AAED,SAAS,cAAc;IACrB,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,CAAA;IACzB,KAAK,MAAM,IAAI,IAAI,gBAAgB,EAAE,CAAC;QACpC,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAA;QACtC,IAAI,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC;YAAE,OAAO,SAAS,CAAA;IAChD,CAAC;IACD,OAAO,SAAS,CAAA;AAClB,CAAC;AAED;;;GAGG;AACH,SAAS,cAAc,CAAC,GAAY;IAClC,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,SAAS,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QACjE,OAAO,EAAE,CAAA;IACX,CAAC;IACD,kEAAkE;IAClE,IAAI,CAAC,CAAC,SAAS,IAAI,GAAG,CAAC,EAAE,CAAC;QACxB,OAAO,EAAE,CAAA;IACX,CAAC;IACD,MAAM,aAAa,GAAY,GAAG,CAAC,SAAS,CAAC,CAAA;IAC7C,IAAI,aAAa,KAAK,IAAI,IAAI,aAAa,KAAK,SAAS,IAAI,OAAO,aAAa,KAAK,QAAQ,EAAE,CAAC;QAC/F,OAAO,EAAE,CAAA;IACX,CAAC;IACD,8EAA8E;IAC9E,MAAM,MAAM,GAAc,EAAE,CAAA;IAC5B,IAAI,SAAS,IAAI,aAAa,IAAI,OAAO,aAAa,CAAC,OAAO,KAAK,QAAQ;QACzE,MAAM,CAAC,OAAO,GAAG,aAAa,CAAC,OAAO,CAAA;IACxC,IAAI,UAAU,IAAI,aAAa,IAAI,OAAO,aAAa,CAAC,QAAQ,KAAK,QAAQ;QAC3E,MAAM,CAAC,QAAQ,GAAG,aAAa,CAAC,QAAQ,CAAA;IAC1C,IAAI,QAAQ,IAAI,aAAa,EAAE,CAAC;QAC9B,MAAM,MAAM,GAAG,aAAa,CAAC,MAAM,CAAA;QACnC,IAAI,MAAM,KAAK,UAAU,IAAI,MAAM,KAAK,MAAM,IAAI,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;YAC3F,MAAM,CAAC,MAAM,GAAG,MAAM,CAAA;QACxB,CAAC;IACH,CAAC;IACD,IAAI,OAAO,IAAI,aAAa,IAAI,KAAK,CAAC,OAAO,CAAC,aAAa,CAAC,KAAK,CAAC;QAChE,MAAM,CAAC,KAAK,GAAG,aAAa,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAA;IACtF,OAAO,MAAM,CAAA;AACf,CAAC"}

package/dist/cli/watch.d.ts

@@ -0,0 +1,49 @@
+export interface WatchOptions {
+    /** Directories to watch for changes */
+    watchDirs: string[];
+    /** Additional files to watch (e.g., rule files) */
+    watchFiles: string[];
+    /** Callback to run on detected changes */
+    onChangeDetected: () => Promise<void>;
+    /** Debounce window in ms. Default: 250 */
+    debounceMs?: number;
+}
+export declare const TS_FILE_RE: RegExp;
+/**
+ * Scheduling logic for watch mode — extracted for testability.
+ *
+ * Debounces rapid triggers. If a trigger arrives while the callback
+ * is running, it queues a re-run after the current run completes.
+ */
+export declare class RunScheduler {
+    #private;
+    private debounceTimer;
+    private running;
+    private _pendingRerun;
+    private readonly debounceMs;
+    private readonly onRun;
+    constructor(onRun: (trigger: string) => Promise<void>, debounceMs?: number);
+    get runCount(): number;
+    get pendingRerun(): boolean;
+    get isRunning(): boolean;
+    /**
+     * Queue a run for the given trigger, resetting the debounce window.
+     * If a run is already in progress, marks a pending re-run instead.
+     */
+    schedule(trigger: string): void;
+    private executeRun;
+}
+/**
+ * Watch for file changes and re-run the callback.
+ *
+ * Uses Node.js `fs.watch` with `recursive: true` (Node 24+).
+ * Debounces rapid filesystem events. If a change arrives while
+ * a run is in progress, it is queued and executed after the
+ * current run completes.
+ *
+ * Known limitation: each re-run loads rule files with a fresh (cache-busting)
+ * jiti instance. Over long sessions, memory grows — restart the watcher
+ * periodically for long sessions.
+ */
+export declare function watchAndRerun(options: WatchOptions): void;
+//# sourceMappingURL=watch.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"watch.d.ts","sourceRoot":"","sources":["../../src/cli/watch.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,YAAY;IAC3B,uCAAuC;IACvC,SAAS,EAAE,MAAM,EAAE,CAAA;IACnB,mDAAmD;IACnD,UAAU,EAAE,MAAM,EAAE,CAAA;IACpB,0CAA0C;IAC1C,gBAAgB,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IACrC,0CAA0C;IAC1C,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAGD,eAAO,MAAM,UAAU,QAAiB,CAAA;AAExC;;;;;GAKG;AAEH,qBAAa,YAAY;;IACvB,OAAO,CAAC,aAAa,CAA2C;IAChE,OAAO,CAAC,OAAO,CAAQ;IACvB,OAAO,CAAC,aAAa,CAAQ;IAC7B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAQ;IACnC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAoC;gBAG9C,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,EAAE,UAAU,SAAM;IAKvE,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED,IAAI,YAAY,IAAI,OAAO,CAE1B;IAED,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED;;;OAGG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAW/B,OAAO,CAAC,UAAU;CAwBnB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI,CAqDzD"}