# core/adapters/tool.golangci-lint.adapter.ts

> 72 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-golangci-lint-adapter-ts
Source text: https://banes-lab.com/source/quality/core/adapters/tool.golangci-lint.adapter.ts.txt

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

## Definitions

- `golangciCall` (lexical_declaration, line 45)
- `golangciSpec` (lexical_declaration, line 28)
- `runGolangci` (lexical_declaration, line 58)
- `TOOL` (lexical_declaration, line 17)
- `LANGUAGE` (lexical_declaration, line 18)
- `CONFIG_FILE` (lexical_declaration, line 19)
- `REPORT_FILE` (lexical_declaration, line 20)
- `Invocation` (interface_declaration, line 22)
- `args` (lexical_declaration, line 46)
- `configFile` (lexical_declaration, line 59)
- `invocation` (lexical_declaration, line 64)
- `advisory` (lexical_declaration, line 69)
- `spec` (lexical_declaration, line 70)

## 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/classifiers/invocation.classifier.ts](https://banes-lab.com/source/quality/core/classifiers/invocation.classifier.ts.md)
- [core/factories/finding.factory.ts](https://banes-lab.com/source/quality/core/factories/finding.factory.ts.md)
- [core/parsers/tool.golangci-lint.parser.ts](https://banes-lab.com/source/quality/core/parsers/tool.golangci-lint.parser.ts.md)
- [core/persistence/tool.persistence.ts](https://banes-lab.com/source/quality/core/persistence/tool.persistence.ts.md)
- [core/selectors/failure.selector.ts](https://banes-lab.com/source/quality/core/selectors/failure.selector.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/classifiers](https://banes-lab.com/anatomy/quality/folder-quality-core-classifiers.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/persistence](https://banes-lab.com/anatomy/quality/folder-quality-core-persistence.md)
- [core/selectors](https://banes-lab.com/anatomy/quality/folder-quality-core-selectors.md)

## Source

```typescript
import type { AdvisoryContext, RunnerContext, ScanSpec, ToolCall } from "#types/tool.types";
import { FINDING_STATUSES, GO_MODULE } from "#configuration/constants/tool.constants";
import { NO_STDERR_DETAIL, installHint, toolErrorBecause } from "#configuration/strings/tool.strings";
import { fixCycle, passTool, residualOf } from "#core/adapters/tool.adapter";
import { readToolReport, writeToolFile } from "#core/persistence/tool.persistence";
import type { RunResult } from "#types/finding.types";
import { defineTool } from "#core/registries/tool.registry";
import { failedOnStatus } from "#core/classifiers/invocation.classifier";
import { gatingAdvisory } from "#core/factories/tool.factory";
import { nativeToolConfig } from "#core/resolvers/tool.resolver";
import { parseGolangciOutput } from "#core/parsers/tool.golangci-lint.parser";
import path from "node:path";
import { projectDirWithMarker } from "#core/resolvers/scope.resolver";
import { tailLines } from "#core/selectors/failure.selector";
import { toolFailure } from "#core/factories/finding.factory";

const TOOL = "golangci-lint";
const LANGUAGE = "go";
const CONFIG_FILE = ".golangci.yml";
const REPORT_FILE = "golangci-report.json";

interface Invocation {
    configFile: string;
    moduleDir: string;
    reportFile: string;
}

const golangciSpec = function golangciSpec(advisory: AdvisoryContext, reportFile: string): ScanSpec {
    return {
        failed: failedOnStatus(FINDING_STATUSES),
        failure: (exit) =>
            toolFailure(
                advisory,
                toolErrorBecause(
                    TOOL,
                    exit.status,
                    "a malformed config or module error",
                    tailLines(exit.stderr, NO_STDERR_DETAIL),
                ),
            ),
        parse: () => parseGolangciOutput(readToolReport(reportFile), advisory.ecosystem),
    };
};

const golangciCall = function golangciCall(invocation: Invocation, withFix: boolean): ToolCall {
    const args = [
        "run",
        "--config",
        invocation.configFile,
        "--output.json.path",
        invocation.reportFile,
        ...(withFix ? ["--fix"] : []),
        "./...",
    ];
    return { args, bin: TOOL, cwd: invocation.moduleDir };
};

const runGolangci = async function runGolangci(context: RunnerContext): Promise<RunResult> {
    const configFile = writeToolFile(
        context.root,
        CONFIG_FILE,
        await nativeToolConfig(context.root, LANGUAGE, CONFIG_FILE),
    );
    const invocation: Invocation = {
        configFile,
        moduleDir: projectDirWithMarker(context.root, context.paths, GO_MODULE),
        reportFile: path.join(path.dirname(configFile), REPORT_FILE),
    };
    const advisory = gatingAdvisory(context, TOOL, installHint(TOOL));
    const spec = golangciSpec(advisory, invocation.reportFile);
    return fixCycle(
        passTool(advisory, golangciCall(invocation, false), spec),
        (findings) => context.fix && findings.length > 0,
        (reported) => residualOf(reported, passTool(advisory, golangciCall(invocation, true), spec)),
    );
};

defineTool({ ecosystems: [LANGUAGE], run: runGolangci, tool: TOOL });
```