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

> 60 lines of code and 13 definitions.

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

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

## Definitions

- `recoverableFinding` (lexical_declaration, line 23)
- `runPmd` (lexical_declaration, line 36)
- `reported` (lexical_declaration, line 40)
- `TOOL` (lexical_declaration, line 15)
- `DEFAULTS` (lexical_declaration, line 16)
- `VIOLATIONS_EXIT` (lexical_declaration, line 20)
- `OK_STATUSES` (lexical_declaration, line 21)
- `{ command, ruleset }` (lexical_declaration, line 37)
- `{ bin, prefix }` (lexical_declaration, line 38)
- `advisory` (lexical_declaration, line 39)
- `spec` (lexical_declaration, line 41)
- `status` (lexical_declaration, line 45)
- `args` (lexical_declaration, line 52)

## Contained in

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

## Uses

- [configuration/strings/tool.strings.ts](https://banes-lab.com/source/quality/configuration/strings/tool.strings.ts.md)
- [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/report.parser.ts](https://banes-lab.com/source/quality/core/parsers/report.parser.ts.md)

## Linked from

- [configuration/strings](https://banes-lab.com/anatomy/quality/folder-quality-configuration-strings.md)
- [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)

## Source

```typescript
import type { Finding, RunResult } from "#types/finding.types";
import type { RunnerContext, ScanSpec, ToolSpawn } from "#types/tool.types";
import { commandHint, pmdRecoverable, toolErrorMessage } from "#configuration/strings/tool.strings";
import { toolFailure, toolFinding } from "#core/factories/finding.factory";
import { POSITION } from "#configuration/constants/tool.constants";
import { commandOf } from "#core/lexers/invocation.lexer";
import { defineTool } from "#core/registries/tool.registry";
import { exitDetail } from "#core/selectors/failure.selector";
import { parseSarifReport } from "#core/parsers/report.parser";
import { quietGatingAdvisory } from "#core/factories/tool.factory";
import { scanTool } from "#core/adapters/tool.adapter";
import { statusIn } from "#core/predicates/failure.predicate";
import { toolSetting } from "#core/resolvers/tool.resolver";

const TOOL = "pmd";
const DEFAULTS = {
    command: "java -cp pmd/lib/* net.sourceforge.pmd.cli.PmdCli",
    ruleset: "rulesets/java/quickstart.xml",
};
const VIOLATIONS_EXIT = 4;
const OK_STATUSES: ReadonlySet<number> = new Set([0, VIOLATIONS_EXIT]);

const recoverableFinding = function recoverableFinding(context: RunnerContext, status: number): Finding {
    return toolFinding({
        advisory: true,
        column: POSITION,
        ecosystem: context.ecosystem,
        file: context.root,
        line: POSITION,
        message: pmdRecoverable(status),
        ruleId: `${TOOL}/recoverable-error`,
        tool: TOOL,
    });
};

const runPmd = async function runPmd(context: RunnerContext): Promise<RunResult> {
    const { command, ruleset } = await toolSetting(context.root, TOOL, DEFAULTS);
    const { bin, prefix } = commandOf(command, TOOL);
    const advisory = quietGatingAdvisory(context, TOOL, commandHint(TOOL, bin));
    const reported = (result: ToolSpawn): Finding[] => parseSarifReport(result.stdout, context.ecosystem, TOOL);
    const spec: ScanSpec = {
        failed: (result) => !statusIn(OK_STATUSES, result.status) && reported(result).length === 0,
        failure: (exit) => toolFailure(advisory, toolErrorMessage(TOOL, exit.status, exitDetail(exit))),
        parse: (result) => {
            const status = result.status ?? 0;
            return [
                ...reported(result),
                ...(statusIn(OK_STATUSES, status) ? [] : [recoverableFinding(context, status)]),
            ];
        },
    };
    const args = [
        ...prefix,
        "check",
        "-f",
        "sarif",
        "-R",
        ruleset,
        ...context.paths.flatMap((target) => ["-d", target]),
    ];
    return scanTool(advisory, { args, bin, cwd: context.root }, spec);
};

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