# core/parsers/tool.madge.parser.ts

> 25 lines of code and 4 definitions.

Tree: GovLab Quality
Language: typescript
Layer: processing
Canonical: https://banes-lab.com/anatomy/quality#file-quality-core-parsers-tool-madge-parser-ts
Source text: https://banes-lab.com/source/quality/core/parsers/tool.madge.parser.ts.txt

Listed in [core/parsers](https://banes-lab.com/api/source/quality/core/parsers.md), after [core/parsers/tool.luacheck.parser.ts](https://banes-lab.com/source/quality/core/parsers/tool.luacheck.parser.ts.md) and before [core/parsers/tool.oxlint.parser.ts](https://banes-lab.com/source/quality/core/parsers/tool.oxlint.parser.ts.md).

## Definitions

- `parseMadgeOutput` (lexical_declaration, line 14, exported)
- `TOOL` (lexical_declaration, line 7)
- `CHAIN_SEPARATOR` (lexical_declaration, line 8)
- `isCycle` (lexical_declaration, line 10)

## Contained in

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

## Uses

- [configuration/strings/tool.strings.ts](https://banes-lab.com/source/quality/configuration/strings/tool.strings.ts.md)
- [core/factories/finding.factory.ts](https://banes-lab.com/source/quality/core/factories/finding.factory.ts.md)
- [core/parsers/record.parser.ts](https://banes-lab.com/source/quality/core/parsers/record.parser.ts.md)

## Linked from

- [configuration/strings](https://banes-lab.com/anatomy/quality/folder-quality-configuration-strings.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 } from "#types/finding.types";
import { POSITION } from "#configuration/constants/tool.constants";
import { advisoryFinding } from "#core/factories/finding.factory";
import { circularDependency } from "#configuration/strings/tool.strings";
import { jsonArray } from "#core/parsers/record.parser";

const TOOL = "madge";
const CHAIN_SEPARATOR = " → ";

const isCycle = function isCycle(cycle: unknown): cycle is string[] {
    return Array.isArray(cycle) && cycle.length > 0 && typeof cycle[0] === "string";
};

export const parseMadgeOutput = function parseMadgeOutput(stdout: string, ecosystem: string): Finding[] {
    return jsonArray(stdout || "[]")
        .filter(isCycle)
        .map((cycle) =>
            advisoryFinding({
                column: POSITION,
                ecosystem,
                file: cycle[0] ?? "",
                line: POSITION,
                message: circularDependency([...cycle, cycle[0]].join(CHAIN_SEPARATOR)),
                ruleId: "circular-dependency",
                tool: TOOL,
            }),
        );
};
```