@svp-labs/talos 0.0.0 → 0.1.0

package/dist/langs/php/deptrac-config.js

@@ -0,0 +1,118 @@
+import { stringify } from 'yaml';
+import { namespacesOf } from './composer.js';
+import { generatedHeader } from '../../configs/header.js';
+export const DEPTRAC_BASE = 'deptrac.yaml';
+export const DEPTRAC_PROJECT = 'deptrac.project.yaml';
+/** PCRE-escaped, for a pattern between `#` delimiters. */
+export function escapePcre(text) {
+    return text.replaceAll(/[.*+?^${}()|[\]\\#/-]/g, String.raw `\$&`);
+}
+/**
+ * Test code by path, as Talos classifies it: a `tests` or `test` directory, or a `*Test.php` file.
+ * deptrac matches it case-insensitively against absolute paths; `(?-i)` makes it exact.
+ */
+export function testPattern(dir) {
+    const start = dir === undefined ? '(^|/)' : `^${escapePcre(dir)}/(.*/)?`;
+    return String.raw `(?-i)${start}tests?/|Test\.php$`;
+}
+/**
+ * The universal rules, which deptrac runs apart from the project's own layers: a class that
+ * belongs to two layers is checked against both rulesets, so the two can't share one config.
+ * Shipped code is in no ruleset, so it may depend on no other layer.
+ */
+export function deptracConfig(options) {
+    const prefixes = options.devPrefixes ?? [];
+    const dev = prefixes.length === 0
+        ? []
+        : [
+            {
+                name: 'DevDependencies',
+                collectors: [
+                    {
+                        type: 'classNameRegex',
+                        value: `#^(?:${prefixes.map((p) => escapePcre(p)).join('|')})#`,
+                    },
+                ],
+            },
+        ];
+    return {
+        deptrac: {
+            paths: [...options.paths],
+            exclude_files: [...options.excludeFiles],
+            layers: [
+                { name: 'Tests', collectors: [{ type: 'directory', value: options.tests }] },
+                {
+                    name: 'Shipped',
+                    collectors: [
+                        {
+                            type: 'bool',
+                            must: [{ type: 'directory', value: '.*' }],
+                            must_not: [{ type: 'layer', value: 'Tests' }],
+                        },
+                    ],
+                },
+                ...dev,
+            ],
+            ruleset: { Tests: ['Shipped', ...dev.map((layer) => layer.name)] },
+        },
+    };
+}
+/** The committed base, which editors and `vendor/bin/deptrac` read; the gate adds dev packages. */
+export function renderDeptracBase(version) {
+    const config = deptracConfig({
+        paths: ['.'],
+        excludeFiles: ['#(^|/)(vendor|node_modules)/#', String.raw `#\.blade\.php$#`],
+        tests: testPattern(),
+    });
+    const note = `# The project's own layers go in ${DEPTRAC_PROJECT}, which Talos runs on its own;\n` +
+        '# the gate also forbids shipped code any package only require-dev brings.\n';
+    return generatedHeader('#', version) + note + stringify(config);
+}
+const CLASSMAP_ENTRY = /^\s*'((?:[^'\\]|\\.)+)' => \$vendorDir \. '\/([^/']+\/[^/']+)\//;
+/** The classes each package's classmap holds, from Composer's `autoload_classmap.php`. */
+export function classmapClasses(text) {
+    const classes = new Map();
+    for (const line of text.split('\n')) {
+        const match = CLASSMAP_ENTRY.exec(line);
+        if (match?.[1] === undefined || match[2] === undefined)
+            continue;
+        const name = match[1].replaceAll('\\\\', '\\');
+        classes.set(match[2], [...(classes.get(match[2]) ?? []), name]);
+    }
+    return classes;
+}
+/** The namespace every class shares, with its trailing separator; undefined when none. */
+export function commonNamespace(names) {
+    const spaces = names.map((name) => name.split('\\').slice(0, -1));
+    const [first, ...rest] = spaces;
+    if (first === undefined)
+        return undefined;
+    let length = first.length;
+    for (const space of rest) {
+        let shared = 0;
+        while (shared < Math.min(length, space.length) && space[shared] === first[shared])
+            shared += 1;
+        length = shared;
+    }
+    return length === 0 ? undefined : `${first.slice(0, length).join('\\')}\\`;
+}
+function overlaps(a, b) {
+    return a.startsWith(b) || b.startsWith(a);
+}
+/**
+ * The namespace prefixes of packages only `require-dev` brings (Composer's `packages-dev`): their
+ * PSR-4 and PSR-0 prefixes, and for a classmap package the namespace all its classes share. A
+ * prefix that overlaps one of `own` (the project's and its other packages') is left out: a tool
+ * shipped as a phar can still declare an application's namespaces, as pint does `App\`.
+ */
+export function devPrefixes(lock, classmap, own) {
+    const shipped = [...own, ...lock.packages.flatMap((pkg) => namespacesOf(pkg.autoload))];
+    const prefixes = lock['packages-dev'].flatMap((pkg) => {
+        const fromMap = commonNamespace(classmap.get(pkg.name) ?? []);
+        return [...namespacesOf(pkg.autoload), ...(fromMap === undefined ? [] : [fromMap])];
+    });
+    return [...new Set(prefixes)]
+        .filter((prefix) => !shipped.some((name) => overlaps(prefix, name)))
+        .sort((a, b) => a.localeCompare(b));
+}
+//# sourceMappingURL=deptrac-config.js.map

package/dist/langs/php/deptrac-config.js.map

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

package/dist/langs/php/deptrac.js

@@ -0,0 +1,117 @@
+import { readFile, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { stringify } from 'yaml';
+import { z } from 'zod';
+import { namespacesOf, readLock, readManifest } from './composer.js';
+import { classmapClasses, DEPTRAC_PROJECT, deptracConfig, devPrefixes, escapePcre, testPattern, } from './deptrac-config.js';
+import { absolute, componentDir, fileExists, fromTool, inRepo, phpFiles, tracks } from './paths.js';
+import { failed, jsonFrom, runVendorTool, sentence } from './run.js';
+import { scopeFor } from './scope.js';
+import { EngineError } from '../../core/check.js';
+const report = z.object({
+    Report: z.object({ Errors: z.number().int().default(0) }),
+    files: z
+        .union([
+        z.record(z.string(), z.object({
+            messages: z.array(z.object({ message: z.string(), line: z.number().int(), type: z.string() })),
+        })),
+        z.tuple([]),
+    ])
+        .default([]),
+});
+/**
+ * deptrac's JSON report. Every message is a violation: a skipped one too, since the gate is run
+ * with `--report-skipped` (a list of skipped violations is a stored baseline), and uncovered
+ * dependencies are never asked for.
+ */
+export function parseDeptracJson(json) {
+    const parsed = report.safeParse(json);
+    if (!parsed.success)
+        throw new EngineError('deptrac wrote JSON Talos cannot read');
+    const files = Array.isArray(parsed.data.files) ? {} : parsed.data.files;
+    const violations = Object.entries(files).flatMap(([file, entry]) => entry.messages.map((m) => ({ file, line: m.line, message: m.message })));
+    return { violations, errors: parsed.data.Report.Errors };
+}
+const UNIVERSAL = /^(.+) must not depend on (.+) \(Shipped on (Tests|DevDependencies)\)$/;
+/** A universal rule's violation in words; a project's own keeps deptrac's message. */
+export function universalFinding(v, toRepo) {
+    const match = UNIVERSAL.exec(v.message);
+    const location = { file: toRepo(v.file), line: v.line };
+    if (match === null) {
+        return { rule: 'deptrac/layers', message: sentence(v.message), location };
+    }
+    const [, from = '', to = '', layer] = match;
+    const test = layer === 'Tests';
+    return {
+        rule: test ? 'deptrac/test-code' : 'deptrac/dev-dependency',
+        message: test
+            ? `Shipped code must not use test code: ${from} uses ${to}.`
+            : `Shipped code must not use a package only require-dev installs: ${from} uses ${to}.`,
+        location,
+    };
+}
+async function analyse(ctx, config, name) {
+    const output = join(ctx.scratch, `${name}.json`);
+    const args = ['analyse', `--config-file=${config}`, '--formatter=json', `--output=${output}`];
+    const flags = ['--report-skipped', '--no-progress', '--no-cache'];
+    const result = await runVendorTool(ctx, 'deptrac', [...args, ...flags]);
+    if (!(await fileExists(output)))
+        throw failed('deptrac analyse', result);
+    return parseDeptracJson(jsonFrom(await readFile(output, 'utf8'), 'deptrac'));
+}
+/** The namespaces the project's own autoload declares, its tests' included. */
+async function ownNamespaces(ctx) {
+    const manifest = await readManifest(ctx);
+    return [...namespacesOf(manifest.autoload), ...namespacesOf(manifest['autoload-dev'])];
+}
+/** The universal rules over every checked file, with the dev-only packages composer.lock names. */
+async function universal(ctx) {
+    const scope = await scopeFor(ctx, phpFiles(ctx));
+    const classmap = await readFile(absolute(ctx, 'vendor/composer/autoload_classmap.php'), 'utf8')
+        .then(classmapClasses)
+        .catch(() => new Map());
+    const exclude = [...scope.excluded, ...scope.excludedDirs].map((path) => `#^${escapePcre(absolute(ctx, path).replaceAll('\\', '/'))}(/|$)#`);
+    const config = deptracConfig({
+        paths: scope.paths.map((path) => absolute(ctx, path)),
+        excludeFiles: exclude,
+        tests: testPattern(componentDir(ctx).replaceAll('\\', '/')),
+        devPrefixes: devPrefixes(await readLock(ctx), classmap, await ownNamespaces(ctx)),
+    });
+    const file = join(ctx.scratch, 'deptrac.universal.yaml');
+    await writeFile(file, stringify(config));
+    const found = await analyse(ctx, file, 'universal');
+    if (found.errors > 0) {
+        throw new EngineError(`deptrac found ${found.errors} error(s) in Talos's config`);
+    }
+    return found.violations;
+}
+/** The project's own layers, run as written; errors in its config are the project's to fix. */
+async function project(ctx, toRepo) {
+    const found = await analyse(ctx, absolute(ctx, DEPTRAC_PROJECT), 'project');
+    const where = inRepo(ctx.component.root, DEPTRAC_PROJECT);
+    const errors = found.errors === 0
+        ? []
+        : [
+            {
+                rule: 'deptrac/config',
+                message: `deptrac found ${found.errors} error(s) in ${where}, such as a skipped violation that no longer occurs; run deptrac on it to see them.`,
+                key: `${where} errors`,
+            },
+        ];
+    const violations = found.violations.map((v) => ({
+        rule: 'deptrac/layers',
+        message: sentence(v.message),
+        location: { file: toRepo(v.file), line: v.line },
+    }));
+    return [...violations, ...errors];
+}
+/**
+ * php/arch: the universal rules always, and the project's own layers from deptrac.project.yaml
+ * when it has one, run as written, since deptrac's rules are the project's to state.
+ */
+export async function arch(ctx) {
+    const toRepo = (file) => fromTool(ctx, file);
+    const found = (await universal(ctx)).map((v) => universalFinding(v, toRepo));
+    return tracks(ctx, DEPTRAC_PROJECT) ? [...found, ...(await project(ctx, toRepo))] : found;
+}
+//# sourceMappingURL=deptrac.js.map

package/dist/langs/php/deptrac.js.map

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

package/dist/langs/php/format.js

@@ -0,0 +1,94 @@
+import { copyFile, mkdir, readFile, writeFile } from 'node:fs/promises';
+import { dirname, join } from 'node:path';
+import { z } from 'zod';
+import { absolute, fromTool, phpFiles } from './paths.js';
+import { renderPint } from './pint-config.js';
+import { failed, jsonFrom, runVendorTool } from './run.js';
+import { EngineError } from '../../core/check.js';
+/** pint fixing files with `-v --format=json` prints PHP CS Fixer's report. */
+const report = z.object({
+    files: z
+        .array(z.object({ name: z.string(), appliedFixers: z.array(z.string()).default([]) }))
+        .default([]),
+});
+export function parsePintJson(json) {
+    const parsed = report.safeParse(json);
+    if (!parsed.success)
+        throw new EngineError('pint printed JSON Talos cannot read');
+    return parsed.data.files.map((file) => ({ path: file.name, fixers: file.appliedFixers }));
+}
+/** The first to the last line pint changed, from the file before and after; 1-based. */
+export function changedSpan(before, after) {
+    const old = before.split('\n');
+    const now = after.split('\n');
+    let head = 0;
+    while (head < old.length && head < now.length && old[head] === now[head])
+        head += 1;
+    if (head === old.length && head === now.length)
+        return undefined;
+    let tail = 0;
+    while (tail < old.length - head &&
+        tail < now.length - head &&
+        old[old.length - 1 - tail] === now[now.length - 1 - tail]) {
+        tail += 1;
+    }
+    return { line: head + 1, endLine: Math.max(head + 1, old.length - tail) };
+}
+function lines(span) {
+    return span.line === span.endLine
+        ? `Line ${span.line} is`
+        : `Lines ${span.line} to ${span.endLine} are`;
+}
+export function formatFinding(file, span, fixers) {
+    const more = fixers.length > 5 ? ', …' : '';
+    const which = fixers.length === 0 ? '' : ` (${fixers.slice(0, 5).join(', ')}${more})`;
+    return {
+        rule: 'pint/format',
+        message: `${lines(span)} not formatted the way pint writes them${which}.`,
+        location: { file, ...span },
+    };
+}
+const CHUNK = 200;
+/**
+ * pint fixes copies of the component's PHP files in the scratch directory with the base config
+ * as Talos renders it; each file it changed is one finding, from its first to its last changed
+ * line. A file pint can't parse is left to php/types, which reports the syntax error.
+ */
+export async function format(ctx) {
+    const files = phpFiles(ctx);
+    const copy = join(ctx.scratch, 'copy');
+    for (const file of files) {
+        const target = join(copy, ...file.split('/'));
+        await mkdir(dirname(target), { recursive: true });
+        await copyFile(absolute(ctx, file), target);
+    }
+    const config = join(ctx.scratch, 'pint.json');
+    await writeFile(config, renderPint(''));
+    const fixed = [];
+    for (let start = 0; start < files.length; start += CHUNK) {
+        const chunk = files.slice(start, start + CHUNK);
+        const args = [
+            '-v',
+            '--format=json',
+            `--config=${config}`,
+            `--cache-file=${join(ctx.scratch, 'pint.cache')}`,
+        ];
+        const result = await runVendorTool(ctx, 'pint', [...args, ...chunk], { cwd: copy });
+        if (!result.stdout.includes('{"'))
+            throw failed('pint', result);
+        fixed.push(...parsePintJson(jsonFrom(result.stdout, 'pint')));
+    }
+    const findings = [];
+    for (const { path, fixers } of fixed) {
+        const file = path.replaceAll('\\', '/');
+        const [before, after] = await Promise.all([
+            readFile(absolute(ctx, file), 'utf8'),
+            readFile(join(copy, ...file.split('/')), 'utf8'),
+        ]);
+        const span = changedSpan(before, after);
+        if (span !== undefined)
+            findings.push(formatFinding(fromTool(ctx, file), span, fixers));
+    }
+    return findings;
+}
+//# sourceMappingURL=format.js.map

package/dist/langs/php/format.js.map

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

package/dist/langs/php/index.js

@@ -0,0 +1,81 @@
+import { deadCode, lint, types } from './analysis.js';
+import { PHP_GENERATED } from './configs.js';
+import { arch } from './deptrac.js';
+import { format } from './format.js';
+import { infectionRunner } from './infection.js';
+import { install } from './install.js';
+import { phpFiles, shippedFiles, tracks } from './paths.js';
+import { pestRunner } from './pest.js';
+import { bind } from './run.js';
+import { strength } from './strength.js';
+import { PHP_DEV_TOOLS, toolchain } from './toolchain.js';
+import { typecov } from './typecov.js';
+import { APPLIES, skip, } from '../../core/check.js';
+import { mutationChecks, testChecks } from '../../quality/index.js';
+function hasPhp(ctx) {
+    return phpFiles(ctx).length > 0 ? APPLIES : skip('the component has no PHP files');
+}
+function hasShipped(ctx) {
+    return shippedFiles(ctx).length > 0 ? APPLIES : skip('the component ships no PHP, only tests');
+}
+function hasComposer(ctx) {
+    return tracks(ctx, 'composer.json') ? APPLIES : skip('the component has no composer.json');
+}
+function check({ name, tier, title, run, applies = hasPhp }) {
+    return {
+        scope: 'component',
+        langs: ['php'],
+        id: `php/${name}`,
+        tier,
+        title,
+        applies,
+        run: async (ctx) => run(bind(ctx)),
+    };
+}
+const own = [
+    check({ name: 'format', tier: 'commit', title: 'pint, Laravel preset', run: format }),
+    check({
+        name: 'lint',
+        tier: 'commit',
+        title: 'PHPMD, cognitive complexity, nesting and file size',
+        run: lint,
+    }),
+    check({ name: 'types', tier: 'commit', title: 'PHPStan max with strict-rules', run: types }),
+    check({ name: 'deadcode', tier: 'commit', title: 'PHPStan dead-code rules', run: deadCode }),
+    check({
+        name: 'typecov',
+        tier: 'head',
+        title: 'Type coverage of shipped code',
+        applies: hasShipped,
+        run: typecov,
+    }),
+    check({
+        name: 'arch',
+        tier: 'head',
+        title: 'deptrac: the universal rules and the project’s',
+        applies: hasShipped,
+        run: arch,
+    }),
+    check({
+        name: 'config-strength',
+        tier: 'head',
+        title: 'PHPStan, PHPMD and PHPUnit settings no weaker than the base',
+        run: strength,
+    }),
+    check({
+        name: 'toolchain',
+        tier: 'head',
+        title: 'The dev tools at the versions Talos pins',
+        applies: hasComposer,
+        run: toolchain,
+    }),
+];
+export const phpPack = {
+    name: 'php',
+    lang: 'php',
+    checks: [...own, ...testChecks('php', pestRunner), ...mutationChecks('php', infectionRunner)],
+    generated: PHP_GENERATED,
+    install,
+    devTools: PHP_DEV_TOOLS,
+};
+//# sourceMappingURL=index.js.map

package/dist/langs/php/index.js.map

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

package/dist/langs/php/infection.js

@@ -0,0 +1,151 @@
+import { writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { absolute, componentDir, fileExists, inComponent } from './paths.js';
+import { bind, runVendorTool, tail, vendorBin } from './run.js';
+import { topLevel } from './scope.js';
+import { EngineError } from '../../core/check.js';
+/**
+ * Infection has no Pest adapter, so it runs Pest through its PHPUnit one, by way of this
+ * script, which runs Pest and makes what it says read the way PHPUnit's would:
+ * - asked its version, it answers with the installed PHPUnit's, not Pest's;
+ * - Pest prints its own summary, and Infection takes a run without PHPUnit's `OK (` for a
+ *   failure, so a passing run gets that line;
+ * - Infection finds each covering test's file in the JUnit report by the test's class, with
+ *   PHPUnit's absolute path; Pest writes the path relative to the project and names the class
+ *   it makes of a test file `P\Tests\X` in coverage but `Tests\X` in the report, so each path is
+ *   made absolute and an entry is added under the `P\` name, the original kept for test classes.
+ */
+const BRIDGE = String.raw `<?php
+
+declare(strict_types=1);
+
+$root = __ROOT__;
+$args = array_slice($argv, 1);
+if (in_array('--version', $args, true)) {
+    require $root . '/vendor/autoload.php';
+    echo 'PHPUnit ' . \PHPUnit\Runner\Version::id() . PHP_EOL;
+    exit(0);
+}
+
+function talos_junit(array $args): ?string
+{
+    foreach ($args as $index => $arg) {
+        if (str_starts_with($arg, '--log-junit=')) {
+            return substr($arg, strlen('--log-junit='));
+        }
+        if ($arg === '--log-junit') {
+            return $args[$index + 1] ?? null;
+        }
+    }
+    return null;
+}
+
+function talos_fix_junit(string $junit, string $root): void
+{
+    $extra = '';
+    $xml = preg_replace_callback(
+        '/<testsuite name="([^"]+)" file="([^"]+)"/',
+        static function (array $match) use ($root, &$extra): string {
+            $file = $match[2];
+            if (!str_starts_with($file, '/') && preg_match('/^[A-Za-z]:/', $file) !== 1) {
+                $file = $root . '/' . $file;
+            }
+            if (!str_starts_with($match[1], 'P\\')) {
+                $extra .= '<testsuite name="P\\' . $match[1] . '" file="' . $file . '" tests="0" time="0"/>';
+            }
+            return '<testsuite name="' . $match[1] . '" file="' . $file . '"';
+        },
+        (string) file_get_contents($junit),
+    );
+    file_put_contents($junit, str_replace('</testsuites>', $extra . '</testsuites>', (string) $xml));
+}
+
+$ini = [];
+foreach (['memory_limit', 'pcov.enabled', 'pcov.directory', 'pcov.exclude'] as $name) {
+    $value = ini_get($name);
+    if ($value !== false) {
+        $ini[] = '-d';
+        $ini[] = $name . '=' . $value;
+    }
+}
+$process = proc_open(
+    array_merge([PHP_BINARY], $ini, [$root . '/vendor/bin/pest'], $args),
+    [0 => STDIN, 1 => ['pipe', 'w'], 2 => STDERR],
+    $pipes,
+);
+if ($process === false) {
+    exit(255);
+}
+$output = (string) stream_get_contents($pipes[1]);
+fclose($pipes[1]);
+$code = proc_close($process);
+echo $output;
+$junit = talos_junit($args);
+if ($junit !== null && is_file($junit)) {
+    talos_fix_junit($junit, $root);
+}
+if ($code === 0) {
+    echo PHP_EOL . 'OK (the Pest run passed)' . PHP_EOL;
+}
+exit($code);
+`;
+/** A PHP single-quoted string literal. */
+export function phpString(text) {
+    const escaped = text.replaceAll('\\', '\\\\').replaceAll("'", "\\'");
+    return `'${escaped}'`;
+}
+export function pestBridge(root) {
+    return BRIDGE.replace('__ROOT__', () => phpString(root));
+}
+/** Infection's config, as JSON (which JSON5 is a superset of), every path absolute. */
+export function infectionConfig(config) {
+    const json = {
+        source: { directories: [...config.sources] },
+        tmpDir: join(config.scratch, 'infection-tmp'),
+        logs: { json: config.log },
+        phpUnit: { configDir: config.componentDir, customPath: config.bridge },
+        mutators: { '@default': true },
+    };
+    return `${JSON.stringify(json, null, 2)}\n`;
+}
+/** The source directories that hold the files: their top-level directories, `.` for root files. */
+export function sourceDirs(files) {
+    const { dirs, rootFiles } = topLevel(files);
+    return rootFiles.length > 0 ? ['.'] : dirs;
+}
+async function mutate(ctx, files) {
+    const local = files
+        .map((file) => inComponent(ctx.component.root, file))
+        .filter((file) => file !== undefined);
+    const dir = componentDir(ctx);
+    const bridge = join(ctx.scratch, 'pest-for-infection.php');
+    await vendorBin(ctx, 'pest');
+    await writeFile(bridge, pestBridge(dir));
+    const log = join(ctx.scratch, 'infection.json');
+    const config = join(ctx.scratch, 'infection.json5');
+    const sources = sourceDirs(local).map((source) => absolute(ctx, source));
+    await writeFile(config, infectionConfig({ sources, scratch: ctx.scratch, log, componentDir: dir, bridge }));
+    const result = await runVendorTool(ctx, 'infection', [
+        `--configuration=${config}`,
+        `--filter=${local.join(',')}`,
+        '--threads=max',
+        '--no-progress',
+        '--min-msi=0',
+        '--with-uncovered',
+        `--initial-tests-php-options=-d pcov.enabled=1 -d pcov.directory=${dir}`,
+    ], { env: { XDEBUG_MODE: 'coverage' }, timeoutMs: 2 * 60 * 60 * 1000 });
+    if (!(await fileExists(log))) {
+        throw new EngineError(`infection wrote no report (exit ${result.code}):\n${tail(result)}`);
+    }
+    return log;
+}
+const FORMAT = 'infection';
+/** Infection over the requested files, its JSON log as the report. */
+export const infectionRunner = {
+    async run(ctx, files) {
+        const bound = bind(ctx);
+        const path = await mutate(bound, files);
+        return { path, base: componentDir(bound), format: FORMAT };
+    },
+};
+//# sourceMappingURL=infection.js.map

package/dist/langs/php/infection.js.map

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