# codemods/entrypoints/increment.entrypoint.ts

> 44 lines of code and 9 definitions.

Tree: Governance tree
Language: typescript
Layer: runtime
Canonical: https://banes-lab.com/anatomy/governance#file-governance-codemods-entrypoints-increment-entrypoint-ts
Source text: https://banes-lab.com/source/governance/codemods/entrypoints/increment.entrypoint.ts.txt

Listed in [codemods/entrypoints](https://banes-lab.com/api/source/governance/codemods/entrypoints.md), after [codemods/entrypoints/identifier.entrypoint.ts](https://banes-lab.com/source/governance/codemods/entrypoints/identifier.entrypoint.ts.md) and before [codemods/entrypoints/literal.entrypoint.ts](https://banes-lab.com/source/governance/codemods/entrypoints/literal.entrypoint.ts.md).

## Definitions

- `scanProgram` (lexical_declaration, line 10)
- `collect` (lexical_declaration, line 23)
- `RULE_ID` (lexical_declaration, line 8)
- `buildEdits` (lexical_declaration, line 14)
- `byFile` (lexical_declaration, line 15)
- `edit` (lexical_declaration, line 17)
- `seen` (lexical_declaration, line 24)
- `findings` (lexical_declaration, line 25)
- `key` (lexical_declaration, line 28)

## Uses

- [codemods/selectors/program.selector.ts](https://banes-lab.com/source/governance/codemods/selectors/program.selector.ts.md)

## Records this file checks

- [Standardization](https://banes-lab.com/records/architecture/standardization.md)

## Source

```typescript
import { CODEMOD_TSCONFIGS, programFor, repoSourceFiles } from "../selectors/program.selector.ts";
import { replacementText, scanSourceFile } from "../analyzers/increment.analyzer.ts";
import type { Edit } from "../../types/codemod.types.ts";
import type { IncrementFinding } from "../../types/analyzer.types.ts";
import { applyCodemod } from "../selectors/codemod.selector.ts";
import { defineCheck } from "@govlab/context/check";

const RULE_ID = "no-plusplus";

const scanProgram = function scanProgram(tsconfigPath: string): IncrementFinding[] {
    return repoSourceFiles(programFor(tsconfigPath)).flatMap((sourceFile) => scanSourceFile(sourceFile));
};

const buildEdits = function buildEdits(findings: readonly IncrementFinding[]): Map<string, Edit[]> {
    const byFile = new Map<string, Edit[]>();
    for (const finding of findings) {
        const edit: Edit = { end: finding.end, replacement: replacementText(finding), start: finding.start };
        byFile.set(finding.fileName, [...(byFile.get(finding.fileName) ?? []), edit]);
    }
    return byFile;
};

const collect = function collect(): IncrementFinding[] {
    const seen = new Set<string>();
    const findings: IncrementFinding[] = [];
    for (const tsconfig of CODEMOD_TSCONFIGS) {
        for (const finding of scanProgram(tsconfig)) {
            const key = `${finding.file}:${String(finding.start)}`;
            if (!seen.has(key)) {
                seen.add(key);
                findings.push(finding);
            }
        }
    }
    return findings;
};

applyCodemod({
    appliedNoun: "value-discarding increment(s) rewritten to compound assignment",
    blockedMessage: (finding) =>
        `'${finding.operand}++' is used where its value is read, so '${finding.operand} += 1' would change what the expression evaluates to — a postfix increment yields the value BEFORE the increment. Hoist the increment to its own statement and read the prior value explicitly.`,
    checks: defineCheck({ detects: [], enforces: ["architecture:standardization"] }),
    editsByFile: buildEdits,
    findings: collect(),
    gateOnBlocked: false,
    label: (finding) => finding.operand,
    programCount: CODEMOD_TSCONFIGS.length,
    ruleId: RULE_ID,
});
```
