# core/adapters/tool.phpcs.adapter.ts

> 46 lines of code and 12 definitions.

Tree: GovLab Quality
Language: typescript
Layer: infrastructure
Canonical: https://banes-lab.com/anatomy/quality#file-quality-core-adapters-tool-phpcs-adapter-ts
Source text: https://banes-lab.com/source/quality/core/adapters/tool.phpcs.adapter.ts.txt

Listed in [core/adapters](https://banes-lab.com/api/source/quality/core/adapters.md), after [core/adapters/tool.perlcritic.adapter.ts](https://banes-lab.com/source/quality/core/adapters/tool.perlcritic.adapter.ts.md) and before [core/adapters/tool.phpmd.adapter.ts](https://banes-lab.com/source/quality/core/adapters/tool.phpmd.adapter.ts.md).

## Definitions

- `runPhpcs` (lexical_declaration, line 21)
- `parse` (lexical_declaration, line 24)
- `TOOL` (lexical_declaration, line 15)
- `FIXER` (lexical_declaration, line 16)
- `DEFAULT_STANDARD` (lexical_declaration, line 17)
- `ERRORS_FOUND_EXIT` (lexical_declaration, line 18)
- `OK_STATUSES` (lexical_declaration, line 19)
- `flags` (lexical_declaration, line 22)
- `advisory` (lexical_declaration, line 23)
- `report` (lexical_declaration, line 25)
- `call` (lexical_declaration, line 28)
- `fixed` (lexical_declaration, line 33)

## Contained in

- [core/adapters](https://banes-lab.com/anatomy/quality/folder-quality-core-adapters.md)

## Uses

- [core/adapters/tool.adapter.ts](https://banes-lab.com/source/quality/core/adapters/tool.adapter.ts.md)
- [core/factories/finding.factory.ts](https://banes-lab.com/source/quality/core/factories/finding.factory.ts.md)
- [core/parsers/tool.phpcs.parser.ts](https://banes-lab.com/source/quality/core/parsers/tool.phpcs.parser.ts.md)
- [core/predicates/failure.predicate.ts](https://banes-lab.com/source/quality/core/predicates/failure.predicate.ts.md)

## Linked from

- [core/adapters](https://banes-lab.com/anatomy/quality/folder-quality-core-adapters.md)
- [core/factories](https://banes-lab.com/anatomy/quality/folder-quality-core-factories.md)
- [core/parsers](https://banes-lab.com/anatomy/quality/folder-quality-core-parsers.md)
- [core/predicates](https://banes-lab.com/anatomy/quality/folder-quality-core-predicates.md)

## Source

```typescript
import { NO_STDERR_DETAIL, installHint, toolErrorBecause } from "#configuration/strings/tool.strings";
import type { RunnerContext, ScanSpec, ToolCall } from "#types/tool.types";
import { findingsResult, signalDeathResult } from "#core/factories/finding.factory";
import { fixCycle, messageScan, passTool, residualOf } from "#core/adapters/tool.adapter";
import type { RunResult } from "#types/finding.types";
import { defineTool } from "#core/registries/tool.registry";
import { gatingAdvisory } from "#core/factories/tool.factory";
import { parsePhpcsOutput } from "#core/parsers/tool.phpcs.parser";
import { signalKilled } from "#core/predicates/failure.predicate";
import { spawnTool } from "#core/adapters/invocation.adapter";
import { stringField } from "#core/selectors/record.selector";
import { tailLines } from "#core/selectors/failure.selector";
import { toolSection } from "#core/resolvers/tool.resolver";

const TOOL = "phpcs";
const FIXER = "phpcbf";
const DEFAULT_STANDARD = "PSR12";
const ERRORS_FOUND_EXIT = 2;
const OK_STATUSES: ReadonlySet<number> = new Set([0, 1, ERRORS_FOUND_EXIT]);

const runPhpcs = async function runPhpcs(context: RunnerContext): Promise<RunResult> {
    const flags = [`--standard=${stringField(await toolSection(context.root, TOOL), "standard", DEFAULT_STANDARD)}`];
    const advisory = gatingAdvisory(context, TOOL, installHint(TOOL));
    const parse: ScanSpec["parse"] = (result) => parsePhpcsOutput(result.stdout, context.ecosystem);
    const report = messageScan(advisory, OK_STATUSES, parse, (exit) =>
        toolErrorBecause(TOOL, exit.status, "a bad standard", tailLines(exit.stderr, NO_STDERR_DETAIL)),
    );
    const call: ToolCall = { args: ["--report=json", ...flags, ...context.paths], bin: TOOL, cwd: context.root };
    return fixCycle(
        passTool(advisory, call, report),
        (findings) => context.fix && findings.some((finding) => finding.fixable),
        (reported) => {
            const fixed = spawnTool(FIXER, [...flags, ...context.paths], {
                cwd: context.root,
                encoding: "utf8",
                shell: false,
            });
            if (fixed.error) {
                return findingsResult(reported);
            }
            if (signalKilled(fixed.status)) {
                return signalDeathResult(advisory, fixed.signal);
            }
            return residualOf(reported, passTool(advisory, call, { ...report, failed: () => false }));
        },
    );
};

defineTool({ ecosystems: ["php"], run: runPhpcs, tool: TOOL });
```