@descent-vtt/spec-guard 0.1.0

package/dist/reporter.js

@@ -0,0 +1,198 @@
+/**
+ * Terminal and JSON reporting.
+ *
+ * The failure block is the whole product: a spec author who broke an invariant
+ * should be able to fix it without opening a single file, so every failure
+ * carries the spec location, the expectation, the observed count and real
+ * snippets from the offending code.
+ */
+// Raw SGR codes - a colour library is not worth a dependency here.
+const ESC = String.fromCharCode(27);
+const ANSI = {
+    reset: `${ESC}[0m`,
+    bold: `${ESC}[1m`,
+    dim: `${ESC}[2m`,
+    red: `${ESC}[31m`,
+    green: `${ESC}[32m`,
+    yellow: `${ESC}[33m`,
+    blue: `${ESC}[34m`,
+    magenta: `${ESC}[35m`,
+    cyan: `${ESC}[36m`,
+    gray: `${ESC}[90m`,
+};
+/** Creates a `paint(text, style)` helper honouring the color setting. */
+export function createPainter(color) {
+    if (!color)
+        return (text) => text;
+    return (text, ...styles) => styles.length === 0 ? text : `${styles.map((style) => ANSI[style]).join('')}${text}${ANSI.reset}`;
+}
+/**
+ * Colour is on only when the stream is a TTY and nobody asked otherwise.
+ * Honours the NO_COLOR and FORCE_COLOR conventions.
+ */
+export function shouldUseColor(stream, flag, env = process.env) {
+    if (flag !== undefined)
+        return flag;
+    if (env['NO_COLOR'])
+        return false;
+    if (env['FORCE_COLOR'] && env['FORCE_COLOR'] !== '0')
+        return true;
+    return Boolean(stream.isTTY);
+}
+/** Legacy Windows consoles render box-drawing glyphs poorly; degrade to ASCII. */
+export function shouldUseAscii(env = process.env, platform = process.platform) {
+    if (platform !== 'win32')
+        return false;
+    return !env['WT_SESSION'] && !env['TERM'] && !env['TERM_PROGRAM'];
+}
+function symbols(ascii) {
+    return ascii
+        ? { pass: '+', fail: 'x', warn: '!', more: '...' }
+        : { pass: '✔', fail: '✖', warn: '⚠', more: '…' };
+}
+function formatDuration(ms) {
+    return ms < 1000 ? `${Math.round(ms)}ms` : `${(ms / 1000).toFixed(2)}s`;
+}
+function countLabel(count, noun) {
+    if (count === 1)
+        return `${count} ${noun}`;
+    // "match" -> "matches", "spec" -> "specs".
+    return `${count} ${noun}${/(?:s|x|z|ch|sh)$/.test(noun) ? 'es' : 's'}`;
+}
+function formatLocation(result) {
+    return `${result.location.relativeFile}:${result.location.line}`;
+}
+function formatFailure(result, paint, glyphs, maxSnippets) {
+    const lines = [];
+    lines.push(`${paint(glyphs.fail, 'red', 'bold')} ${paint(formatLocation(result), 'bold')}  ${paint(`@${result.kind}`, 'magenta')}`);
+    lines.push(`    ${result.description}`);
+    lines.push(`    ${paint(result.message, 'red')}`);
+    if (result.reason)
+        lines.push(`    ${paint(`reason: ${result.reason}`, 'dim')}`);
+    for (const warning of result.warnings) {
+        lines.push(`    ${paint(`${glyphs.warn} ${warning}`, 'yellow')}`);
+    }
+    const shown = result.matches.slice(0, maxSnippets);
+    for (const match of shown) {
+        const where = paint(`${match.file}:${match.line}:${match.column}`, 'cyan');
+        lines.push(`      ${where}  ${paint(match.text.trim(), 'gray')}`);
+    }
+    const remaining = result.actual - shown.reduce((total, match) => total + match.count, 0);
+    if (remaining > 0) {
+        lines.push(`      ${paint(`${glyphs.more} ${countLabel(remaining, 'more match')} not shown`, 'dim')}`);
+    }
+    return lines;
+}
+function formatPass(result, paint, glyphs) {
+    const detail = result.kind === 'assert-present'
+        ? result.files.join(', ')
+        : `"${result.symbol}" ${paint(`(${countLabel(result.actual, 'match')})`, 'dim')} in ${result.targets.join(', ')}`;
+    return `${paint(glyphs.pass, 'green')} ${paint(formatLocation(result), 'dim')}  ${paint(`@${result.kind}`, 'dim')} ${detail}`;
+}
+function formatError(error, paint, glyphs) {
+    const lines = [
+        `${paint(glyphs.warn, 'yellow', 'bold')} ${paint(formatLocation(error), 'bold')}  ${paint('invalid directive', 'yellow')}`,
+        `    ${error.message}`,
+    ];
+    if (error.raw)
+        lines.push(`    ${paint(error.raw.split('\n')[0], 'dim')}`);
+    return lines;
+}
+/** Renders the full human-readable report. */
+export function formatReport(report, options, maxSnippets = 5) {
+    const paint = createPainter(options.color);
+    const glyphs = symbols(options.ascii ?? false);
+    const lines = [];
+    const failures = report.results.filter((result) => !result.ok);
+    const passes = report.results.filter((result) => result.ok);
+    // The engine label is only meaningful once something was actually searched.
+    const searched = report.results.some((result) => result.engine !== undefined);
+    const headline = [
+        countLabel(report.summary.specs, 'spec'),
+        countLabel(report.summary.total, 'assertion'),
+        ...(searched ? [report.engine] : []),
+    ].join(' · ');
+    lines.push(`${paint('spec-guard', 'bold', 'blue')} ${paint(headline, 'dim')}`);
+    lines.push('');
+    if (options.verbose) {
+        for (const result of passes)
+            lines.push(formatPass(result, paint, glyphs));
+        if (passes.length > 0)
+            lines.push('');
+    }
+    for (const warning of report.warnings) {
+        lines.push(`${paint(glyphs.warn, 'yellow')} ${paint(warning, 'yellow')}`);
+    }
+    if (report.warnings.length > 0)
+        lines.push('');
+    if (options.verbose) {
+        for (const result of passes) {
+            for (const warning of result.warnings) {
+                lines.push(`${paint(glyphs.warn, 'yellow')} ${paint(`${formatLocation(result)}  ${warning}`, 'yellow')}`);
+            }
+        }
+    }
+    for (const error of report.errors) {
+        lines.push(...formatError(error, paint, glyphs));
+        lines.push('');
+    }
+    for (const failure of failures) {
+        lines.push(...formatFailure(failure, paint, glyphs, maxSnippets));
+        lines.push('');
+    }
+    const parts = [
+        paint(`${report.summary.passed} passed`, 'green'),
+        failures.length > 0 ? paint(`${report.summary.failed} failed`, 'red', 'bold') : null,
+        report.errors.length > 0 ? paint(`${report.errors.length} invalid`, 'yellow') : null,
+        report.summary.skipped > 0 ? paint(`${report.summary.skipped} skipped`, 'dim') : null,
+        paint(formatDuration(report.durationMs), 'dim'),
+    ].filter((part) => part !== null);
+    lines.push(parts.join(paint(' · ', 'dim')));
+    if (report.ok) {
+        lines.push(paint(`${glyphs.pass} every spec assertion holds`, 'green'));
+    }
+    return lines.join('\n');
+}
+/** Machine-readable output for CI consumers. */
+export function formatJson(report) {
+    return JSON.stringify({
+        ok: report.ok,
+        root: report.root,
+        engine: report.engine,
+        durationMs: Math.round(report.durationMs * 1000) / 1000,
+        summary: report.summary,
+        specFiles: report.specFiles,
+        results: report.results.map((result) => ({
+            ok: result.ok,
+            kind: result.kind,
+            spec: {
+                file: result.location.relativeFile,
+                line: result.location.line,
+                column: result.location.column,
+            },
+            description: result.description,
+            message: result.message,
+            reason: result.reason,
+            symbol: result.symbol,
+            targets: result.targets,
+            files: result.files,
+            bounds: result.bounds,
+            actual: result.actual,
+            matches: result.matches,
+            warnings: result.warnings,
+            engine: result.engine,
+            durationMs: Math.round(result.durationMs * 1000) / 1000,
+        })),
+        errors: report.errors.map((error) => ({
+            spec: {
+                file: error.location.relativeFile,
+                line: error.location.line,
+                column: error.location.column,
+            },
+            message: error.message,
+            raw: error.raw,
+        })),
+        warnings: report.warnings,
+    }, null, 2);
+}
+//# sourceMappingURL=reporter.js.map

package/dist/reporter.js.map

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

package/dist/runner.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Directive -> Assertion -> Result.
+ *
+ * Resolution is strict and happens before any I/O: a directive with a bad
+ * number, an unknown boolean or a path escaping the root is an error, never a
+ * silently-passing assertion. A spec that lies is worse than no spec at all.
+ */
+import { type Engine, type EnginePreference } from './engine.js';
+import type { Assertion, AssertionResult, Directive, DirectiveError, RunReport } from './types.js';
+export declare const DEFAULT_MAX_SNIPPETS = 5;
+export declare const DEFAULT_CONCURRENCY = 8;
+export interface RunOptions {
+    /** Glob patterns / paths of the Markdown specs to execute. */
+    patterns: readonly string[];
+    /** Root of the codebase being asserted about. Defaults to cwd. */
+    root?: string;
+    /** Engine preference. `auto` uses ripgrep when available. */
+    engine?: EnginePreference;
+    /** Stop at the first failing assertion. */
+    failFast?: boolean;
+    /** Treat a target path that does not exist as a failure instead of a warning. */
+    strictTargets?: boolean;
+    /** Count matches inside the spec files themselves (off by default). */
+    includeSpecs?: boolean;
+    /** Max concurrent assertions. */
+    concurrency?: number;
+    /** Max snippets kept per failing assertion. */
+    maxSnippets?: number;
+}
+export interface RunResult extends RunReport {
+    /** Spec files that were executed, relative to root. */
+    specFiles: string[];
+}
+export interface ResolveContext {
+    root: string;
+    excludeFiles: ReadonlySet<string>;
+}
+/** Turns one directive into an executable assertion, or an error. */
+export declare function resolveDirective(directive: Directive, context: ResolveContext): {
+    assertion: Assertion;
+} | {
+    error: DirectiveError;
+};
+export interface ExecuteOptions {
+    root: string;
+    engine: Engine;
+    strictTargets: boolean;
+    maxSnippets: number;
+}
+/** Executes a single resolved assertion. */
+export declare function executeAssertion(assertion: Assertion, options: ExecuteOptions): Promise<AssertionResult>;
+/** Reads, parses and executes every directive found in the given spec files. */
+export declare function runSpecGuard(options: RunOptions): Promise<RunResult>;
+//# sourceMappingURL=runner.d.ts.map

package/dist/runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../src/runner.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,EAIL,KAAK,MAAM,EACX,KAAK,gBAAgB,EAEtB,MAAM,aAAa,CAAC;AAGrB,OAAO,KAAK,EACV,SAAS,EACT,eAAe,EAEf,SAAS,EACT,cAAc,EACd,SAAS,EAGV,MAAM,YAAY,CAAC;AAEpB,eAAO,MAAM,oBAAoB,IAAI,CAAC;AACtC,eAAO,MAAM,mBAAmB,IAAI,CAAC;AAErC,MAAM,WAAW,UAAU;IACzB,8DAA8D;IAC9D,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5B,kEAAkE;IAClE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,6DAA6D;IAC7D,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,2CAA2C;IAC3C,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,iFAAiF;IACjF,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,uEAAuE;IACvE,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,iCAAiC;IACjC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,+CAA+C;IAC/C,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,SAAU,SAAQ,SAAS;IAC1C,uDAAuD;IACvD,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AA4ED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CACnC;AAED,qEAAqE;AACrE,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,SAAS,EACpB,OAAO,EAAE,cAAc,GACtB;IAAE,SAAS,EAAE,SAAS,CAAA;CAAE,GAAG;IAAE,KAAK,EAAE,cAAc,CAAA;CAAE,CAoGtD;AAMD,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,OAAO,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;CACrB;AAiGD,4CAA4C;AAC5C,wBAAsB,gBAAgB,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC,CAI9G;AAYD,gFAAgF;AAChF,wBAAsB,YAAY,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC,CAqH1E"}

package/dist/runner.js

@@ -0,0 +1,387 @@
+/**
+ * Directive -> Assertion -> Result.
+ *
+ * Resolution is strict and happens before any I/O: a directive with a bad
+ * number, an unknown boolean or a path escaping the root is an error, never a
+ * silently-passing assertion. A spec that lies is worse than no spec at all.
+ */
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+import { createCachedEngine, resolveEngine, runSearches, } from './engine.js';
+import { expandSpecPatterns, toPosix } from './glob.js';
+import { parseDirectives } from './parser.js';
+export const DEFAULT_MAX_SNIPPETS = 5;
+export const DEFAULT_CONCURRENCY = 8;
+const TRUE_VALUES = new Set(['true', '1', 'yes', 'on']);
+const FALSE_VALUES = new Set(['false', '0', 'no', 'off']);
+function parseBoolean(value, attribute) {
+    if (value === undefined)
+        return false;
+    const normalized = value.trim().toLowerCase();
+    if (TRUE_VALUES.has(normalized))
+        return true;
+    if (FALSE_VALUES.has(normalized))
+        return false;
+    throw new Error(`Attribute "${attribute}" must be true or false, got "${value}".`);
+}
+function parseCount(value, attribute) {
+    const normalized = value.trim();
+    if (!/^\d+$/.test(normalized)) {
+        throw new Error(`Attribute "${attribute}" must be a non-negative integer, got "${value}".`);
+    }
+    return Number.parseInt(normalized, 10);
+}
+function splitList(value) {
+    if (value === undefined)
+        return [];
+    return value
+        .split(',')
+        .map((item) => item.trim())
+        .filter((item) => item.length > 0);
+}
+/** Rejects absolute paths and any `..` escape out of the root. */
+function normalizeTarget(target, root, attribute) {
+    if (path.isAbsolute(target) || /^[a-zA-Z]:[\\/]/.test(target)) {
+        throw new Error(`Attribute "${attribute}" must be relative to --root, got "${target}".`);
+    }
+    const absolute = path.resolve(root, target);
+    const relative = path.relative(root, absolute);
+    if (relative.startsWith('..')) {
+        throw new Error(`Attribute "${attribute}" escapes the root directory: "${target}".`);
+    }
+    return toPosix(relative) || '.';
+}
+function plural(count) {
+    return count === 1 ? '' : 'es';
+}
+function describeBounds(bounds) {
+    const { min, max } = bounds;
+    if (min !== undefined && max !== undefined) {
+        return min === max ? `exactly ${min} match${plural(min)}` : `between ${min} and ${max} matches`;
+    }
+    if (min !== undefined)
+        return `at least ${min} match${plural(min)}`;
+    if (max !== undefined)
+        return max === 0 ? 'no matches' : `at most ${max} match${plural(max)}`;
+    /* c8 ignore next */
+    return 'any number of matches';
+}
+/** Prose form used in the assertion description ("must appear at most 3 times"). */
+function describeExpectation(bounds) {
+    const { min, max } = bounds;
+    const times = (value) => `${value} time${value === 1 ? '' : 's'}`;
+    if (min !== undefined && max !== undefined) {
+        return min === max ? `must appear exactly ${times(min)}` : `must appear between ${min} and ${max} times`;
+    }
+    if (min !== undefined)
+        return `must appear at least ${times(min)}`;
+    if (max === 0)
+        return 'must not appear';
+    /* c8 ignore next */
+    return max === undefined ? 'may appear any number of times' : `must appear at most ${times(max)}`;
+}
+function satisfies(count, bounds) {
+    if (bounds.min !== undefined && count < bounds.min)
+        return false;
+    if (bounds.max !== undefined && count > bounds.max)
+        return false;
+    return true;
+}
+/** Turns one directive into an executable assertion, or an error. */
+export function resolveDirective(directive, context) {
+    const { attributes, kind, location } = directive;
+    const fail = (message) => ({
+        error: { location, raw: directive.raw, message },
+    });
+    try {
+        const reason = attributes['reason'];
+        if (kind === 'assert-present') {
+            const files = splitList(attributes['file']).map((file) => normalizeTarget(file, context.root, 'file'));
+            if (files.length === 0) {
+                return fail('@assert-present requires a file="..." attribute.');
+            }
+            return {
+                assertion: {
+                    kind,
+                    location,
+                    description: `${files.join(', ')} must exist`,
+                    reason,
+                    targets: [],
+                    files,
+                    bounds: { min: files.length, max: files.length },
+                    missingTargets: [],
+                },
+            };
+        }
+        const symbol = attributes['symbol'];
+        if (symbol === undefined || symbol.length === 0) {
+            return fail(`@${kind} requires a non-empty symbol="..." attribute.`);
+        }
+        const rawTargets = splitList(attributes['target']);
+        const targets = (rawTargets.length > 0 ? rawTargets : ['.']).map((target) => normalizeTarget(target, context.root, 'target'));
+        const bounds = {};
+        if (kind === 'assert-absence') {
+            if (attributes['expected'] !== undefined && attributes['max'] !== undefined) {
+                return fail('@assert-absence accepts either expected="..." or max="...", not both.');
+            }
+            const limit = attributes['expected'] ?? attributes['max'];
+            bounds.max = limit === undefined ? 0 : parseCount(limit, attributes['expected'] !== undefined ? 'expected' : 'max');
+        }
+        else {
+            const expected = attributes['expected'];
+            if (expected !== undefined) {
+                if (attributes['min'] !== undefined || attributes['max'] !== undefined) {
+                    return fail('@assert-count accepts either expected="..." or min/max, not both.');
+                }
+                const value = parseCount(expected, 'expected');
+                bounds.min = value;
+                bounds.max = value;
+            }
+            else {
+                if (attributes['min'] === undefined && attributes['max'] === undefined) {
+                    return fail('@assert-count requires expected="...", min="..." or max="...".');
+                }
+                if (attributes['min'] !== undefined)
+                    bounds.min = parseCount(attributes['min'], 'min');
+                if (attributes['max'] !== undefined)
+                    bounds.max = parseCount(attributes['max'], 'max');
+                if (bounds.min !== undefined && bounds.max !== undefined && bounds.min > bounds.max) {
+                    return fail(`min="${bounds.min}" is greater than max="${bounds.max}".`);
+                }
+            }
+        }
+        const search = {
+            regex: parseBoolean(attributes['regex'], 'regex'),
+            word: parseBoolean(attributes['word'], 'word'),
+            ignoreCase: parseBoolean(attributes['ignore-case'], 'ignore-case'),
+            globs: splitList(attributes['glob']),
+            excludeFiles: context.excludeFiles,
+        };
+        if (search.regex) {
+            try {
+                new RegExp(symbol);
+            }
+            catch (error) {
+                return fail(`Invalid regular expression: ${error instanceof Error ? error.message : String(error)}`);
+            }
+        }
+        const scope = targets.join(', ');
+        return {
+            assertion: {
+                kind,
+                location,
+                description: `"${symbol}" ${describeExpectation(bounds)} in ${scope}`,
+                reason,
+                symbol,
+                targets,
+                files: [],
+                bounds,
+                search,
+                missingTargets: [],
+            },
+        };
+    }
+    catch (error) {
+        return fail(error instanceof Error ? error.message : String(error));
+    }
+}
+async function pathExists(candidate) {
+    return (await fs.stat(candidate).catch(() => null)) !== null;
+}
+/**
+ * Resolves everything about an assertion that does not need a search, and
+ * returns either a finished result or the search still to run.
+ */
+async function prepareAssertion(assertion, options) {
+    const startedAt = performance.now();
+    const warnings = [];
+    const base = {
+        kind: assertion.kind,
+        location: assertion.location,
+        description: assertion.description,
+        reason: assertion.reason,
+        symbol: assertion.symbol,
+        targets: assertion.targets,
+        files: assertion.files,
+        bounds: assertion.bounds,
+        warnings,
+    };
+    if (assertion.kind === 'assert-present') {
+        const missing = [];
+        for (const file of assertion.files) {
+            if (!(await pathExists(path.resolve(options.root, file))))
+                missing.push(file);
+        }
+        const actual = assertion.files.length - missing.length;
+        return {
+            ...base,
+            ok: missing.length === 0,
+            actual,
+            message: missing.length === 0
+                ? `all ${assertion.files.length} referenced ${assertion.files.length === 1 ? 'path exists' : 'paths exist'}`
+                : `missing: ${missing.join(', ')}`,
+            matches: [],
+            durationMs: performance.now() - startedAt,
+        };
+    }
+    const existingTargets = [];
+    for (const target of assertion.targets) {
+        if (await pathExists(path.resolve(options.root, target)))
+            existingTargets.push(target);
+        else
+            assertion.missingTargets.push(target);
+    }
+    if (assertion.missingTargets.length > 0) {
+        warnings.push(`target path${assertion.missingTargets.length === 1 ? '' : 's'} not found: ${assertion.missingTargets.join(', ')}`);
+    }
+    if (options.strictTargets && assertion.missingTargets.length > 0) {
+        return {
+            ...base,
+            ok: false,
+            actual: 0,
+            message: `target path${assertion.missingTargets.length === 1 ? ' does' : 's do'} not exist: ${assertion.missingTargets.join(', ')}`,
+            matches: [],
+            durationMs: performance.now() - startedAt,
+        };
+    }
+    return {
+        request: {
+            root: options.root,
+            symbol: assertion.symbol,
+            targets: existingTargets,
+            options: assertion.search,
+        },
+        finish: (search) => ({
+            ...base,
+            ok: satisfies(search.count, assertion.bounds),
+            actual: search.count,
+            message: `expected ${describeBounds(assertion.bounds)}, found ${search.count}`,
+            matches: search.matches.slice(0, options.maxSnippets),
+            engine: search.engine,
+            durationMs: performance.now() - startedAt,
+        }),
+    };
+}
+/** Executes a single resolved assertion. */
+export async function executeAssertion(assertion, options) {
+    const prepared = await prepareAssertion(assertion, options);
+    if (!('request' in prepared))
+        return prepared;
+    return prepared.finish(await options.engine.search(prepared.request));
+}
+/**
+ * Groups searches that can share a single pass over the tree: same targets,
+ * same flags. This is where most of spec-guard's speed comes from - a spec with
+ * twenty assertions over `src/` costs one ripgrep pass, not twenty.
+ */
+function groupKey(request) {
+    const { options } = request;
+    return JSON.stringify([request.targets, options.regex, options.word, options.ignoreCase, options.globs]);
+}
+/** Reads, parses and executes every directive found in the given spec files. */
+export async function runSpecGuard(options) {
+    const startedAt = performance.now();
+    const root = path.resolve(options.root ?? process.cwd());
+    const maxSnippets = options.maxSnippets ?? DEFAULT_MAX_SNIPPETS;
+    const strictTargets = options.strictTargets ?? false;
+    const specFiles = await expandSpecPatterns(options.patterns, root);
+    const excludeFiles = new Set(options.includeSpecs ? [] : specFiles.map((file) => path.resolve(file)));
+    const directives = [];
+    const errors = [];
+    for (const file of specFiles) {
+        const relativeFile = toPosix(path.relative(root, file)) || toPosix(file);
+        const source = await fs.readFile(file, 'utf8').catch((error) => {
+            errors.push({
+                location: { file, relativeFile, line: 1, column: 1 },
+                raw: '',
+                message: `Unable to read spec file: ${error instanceof Error ? error.message : String(error)}`,
+            });
+            return null;
+        });
+        if (source === null)
+            continue;
+        const parsed = parseDirectives(source, { file, relativeFile });
+        directives.push(...parsed.directives);
+        errors.push(...parsed.errors);
+    }
+    const assertions = [];
+    for (const directive of directives) {
+        const resolved = resolveDirective(directive, { root, excludeFiles });
+        if ('error' in resolved)
+            errors.push(resolved.error);
+        else
+            assertions.push(resolved.assertion);
+    }
+    const engine = createCachedEngine(await resolveEngine(options.engine ?? 'auto'));
+    const executeOptions = { root, engine, strictTargets, maxSnippets };
+    const results = new Array(assertions.length);
+    if (options.failFast) {
+        // Fail-fast trades throughput for an early exit, so it runs unbatched.
+        for (let index = 0; index < assertions.length; index++) {
+            const result = await executeAssertion(assertions[index], executeOptions);
+            results[index] = result;
+            if (!result.ok) {
+                results.length = index + 1;
+                break;
+            }
+        }
+    }
+    else {
+        const prepared = await Promise.all(assertions.map((assertion) => prepareAssertion(assertion, executeOptions)));
+        const groups = new Map();
+        prepared.forEach((entry, index) => {
+            if (!('request' in entry)) {
+                results[index] = entry;
+                return;
+            }
+            const key = groupKey(entry.request);
+            const group = groups.get(key);
+            if (group)
+                group.push({ index, pending: entry });
+            else
+                groups.set(key, [{ index, pending: entry }]);
+        });
+        const batches = [...groups.values()];
+        const concurrency = Math.max(1, Math.min(options.concurrency ?? DEFAULT_CONCURRENCY, batches.length || 1));
+        let cursor = 0;
+        const worker = async () => {
+            while (cursor < batches.length) {
+                const batch = batches[cursor++];
+                /* c8 ignore next -- cursor is bounded by batches.length */
+                if (!batch)
+                    return;
+                const searches = await runSearches(engine, batch.map((entry) => entry.pending.request));
+                batch.forEach((entry, position) => {
+                    results[entry.index] = entry.pending.finish(searches[position]);
+                });
+            }
+        };
+        await Promise.all(Array.from({ length: concurrency }, worker));
+    }
+    const warnings = engine.fallbacks.map((message) => `ripgrep failed, fell back to the JavaScript engine (${message})`);
+    // Errors arrive in two waves (parse, then resolve); readers expect file order.
+    errors.sort((a, b) => a.location.relativeFile === b.location.relativeFile
+        ? a.location.line - b.location.line
+        : a.location.relativeFile < b.location.relativeFile
+            ? -1
+            : 1);
+    const failed = results.filter((result) => !result.ok).length;
+    return {
+        ok: failed === 0 && errors.length === 0,
+        root,
+        engine: warnings.length > 0 ? 'javascript' : engine.name,
+        durationMs: performance.now() - startedAt,
+        summary: {
+            specs: specFiles.length,
+            total: results.length,
+            passed: results.length - failed,
+            failed,
+            skipped: assertions.length - results.length,
+        },
+        results,
+        errors,
+        warnings,
+        specFiles: specFiles.map((file) => toPosix(path.relative(root, file)) || toPosix(file)),
+    };
+}
+//# sourceMappingURL=runner.js.map