phpstan-mcp-mx 0.23.0 → 0.25.0

package/dist/failure.js.map

@@ -1 +1 @@
-{"version":3,"file":"failure.js","sourceRoot":"","sources":["../src/failure.ts"],"names":[],"mappings":"AA2DA;;;;;GAKG;AACH,MAAM,OAAO,WAAY,SAAQ,KAAK;IACE;IAAgC;IAAtE,YAAY,OAAe,EAAW,MAAqB,EAAW,UAA0B,EAAE;QAEhG,KAAK,CAAC,OAAO,CAAC,CAAC;QAFqB,WAAM,GAAN,MAAM,CAAe;QAAW,YAAO,GAAP,OAAO,CAAqB;IAGlG,CAAC;CACF"}
+{"version":3,"file":"failure.js","sourceRoot":"","sources":["../src/failure.ts"],"names":[],"mappings":"AA+DA;;;;;GAKG;AACH,MAAM,OAAO,WAAY,SAAQ,KAAK;IACE;IAAgC;IAAtE,YAAY,OAAe,EAAW,MAAqB,EAAW,UAA0B,EAAE;QAEhG,KAAK,CAAC,OAAO,CAAC,CAAC;QAFqB,WAAM,GAAN,MAAM,CAAe;QAAW,YAAO,GAAP,OAAO,CAAqB;IAGlG,CAAC;CACF"}

package/dist/finding.d.ts

@@ -0,0 +1,65 @@
+import type { ParseProblem, ProbedType } from './dumptype.js';
+import type { AnalyseOptions } from './phpstan.js';
+import type { ResolvedProject } from './project.js';
+/** Hoeveel regels er standaard voor en na de regel getoond worden. */
+export declare const DEFAULT_CONTEXT = 5;
+/** Meer is geen context meer maar het bestand; dat hoort bij een tool die het bestand leest. */
+export declare const MAX_CONTEXT = 30;
+/** Wat een aanroep vraagt. */
+export interface FindingRequest {
+    readonly path: string;
+    readonly line: number;
+    readonly context?: number | undefined;
+    /** Zonder: de variabelen en property-ketens op de regel zelf. */
+    readonly expressions?: readonly string[] | undefined;
+}
+/** Een bevinding van PHPStan op de gevraagde regel, uit dezelfde run als de types. */
+export interface LineFinding {
+    readonly message: string;
+    readonly identifier: string | null;
+    readonly tip: string | null;
+}
+/** Het antwoord van `show_finding`. */
+export interface FindingView {
+    readonly project: string;
+    /** Pad relatief aan de projectroot. */
+    readonly file: string;
+    readonly line: number;
+    /** De code rond de regel, met de regelnummers van het bestand. */
+    readonly code: readonly {
+        number: number;
+        text: string;
+    }[];
+    /** Wat PHPStan op deze regel meldt; null als PHPStan niet gestart is of het bestand niet kon lezen. */
+    readonly findings: readonly LineFinding[] | null;
+    readonly types: readonly ProbedType[];
+    /** Waarom er geen types zijn, of null als ze er zijn. */
+    readonly typesProblem: string | null;
+    readonly parseErrors: readonly ParseProblem[];
+    readonly generalErrors: readonly string[];
+    readonly warnings: readonly string[];
+}
+/**
+ * Een bevinding met de code eromheen en de types die PHPStan vlak vóór die regel afleidt.
+ *
+ * Voor een client die zelf geen bestanden kan lezen (Claude Desktop): daar ziet het model
+ * van een bevinding alleen de melding. In Claude Code kan het model het bestand zelf openen,
+ * maar de types niet zien; die komen uit hetzelfde mechanisme als `inspect_type`, een kopie
+ * in editor mode, en dezelfde run levert de bevindingen op die regel.
+ *
+ * Staat er op de regel geen variabele, dan start PHPStan niet: er valt niets te dumpen, en de
+ * melding had het model al. Is de regel geen begin van een statement, dan geeft PHPStan een
+ * parse-fout; die wordt benoemd, en er wordt niet naar een andere regel gegokt.
+ */
+export declare function showFinding(project: ResolvedProject, request: FindingRequest, options?: Pick<AnalyseOptions, 'config' | 'memoryLimit' | 'timeoutMs' | 'signal'>): Promise<FindingView>;
+/**
+ * De variabelen en property-ketens op een regel, zoals ze vóór die regel al bestaan: `$user`,
+ * `$this->repo`, `$order->customer->email`. Geen methode-aanroepen (daar horen argumenten bij),
+ * geen kale `$this` (dat is de klasse), en niets wat pas op deze regel ontstaat: het doel van
+ * een toewijzing, de variabelen van een `foreach … as` en de parameters van een closure. Die
+ * geven vóór de regel alleen `*ERROR*`. Een tekst tussen enkele quotes en commentaar tellen niet
+ * mee; tussen dubbele quotes wel, want daar wordt een variabele ingevuld.
+ */
+export declare function variablesOn(line: string): string[];
+/** Schrijft de bevinding uit als tekst voor het model. */
+export declare function renderFinding(view: FindingView): string;

package/dist/finding.js

@@ -0,0 +1,177 @@
+import { readFileSync, statSync } from 'node:fs';
+import { MAX_EXPRESSIONS, insertProbes, readProbes } from './dumptype.js';
+import { PhpstanError, analyseEdited, tmpCopyName } from './phpstan.js';
+import { resolveWithin } from './project.js';
+import { displayPath } from './report.js';
+/** Hoeveel regels er standaard voor en na de regel getoond worden. */
+export const DEFAULT_CONTEXT = 5;
+/** Meer is geen context meer maar het bestand; dat hoort bij een tool die het bestand leest. */
+export const MAX_CONTEXT = 30;
+/** Een regel code wordt ingekort; een geminificeerd bestand heeft er één van een megabyte. */
+const MAX_LINE_CHARS = 300;
+/**
+ * Een bevinding met de code eromheen en de types die PHPStan vlak vóór die regel afleidt.
+ *
+ * Voor een client die zelf geen bestanden kan lezen (Claude Desktop): daar ziet het model
+ * van een bevinding alleen de melding. In Claude Code kan het model het bestand zelf openen,
+ * maar de types niet zien; die komen uit hetzelfde mechanisme als `inspect_type`, een kopie
+ * in editor mode, en dezelfde run levert de bevindingen op die regel.
+ *
+ * Staat er op de regel geen variabele, dan start PHPStan niet: er valt niets te dumpen, en de
+ * melding had het model al. Is de regel geen begin van een statement, dan geeft PHPStan een
+ * parse-fout; die wordt benoemd, en er wordt niet naar een andere regel gegokt.
+ */
+export async function showFinding(project, request, options = {}) {
+    const file = resolveWithin(project, request.path);
+    if (!statSync(file).isFile()) {
+        throw new PhpstanError(`"${request.path}" is a directory; show_finding needs one PHP file.`, 'invalid_argument', {
+            hint: 'Pass the path of the file the finding is in.',
+        });
+    }
+    const source = readFileSync(file, 'utf8');
+    const lines = source.split('\n').map((line) => line.replace(/\r$/, ''));
+    // Een afsluitend regeleinde levert een lege laatste "regel" op die in geen editor bestaat.
+    const count = source.endsWith('\n') ? lines.length - 1 : lines.length;
+    if (!Number.isInteger(request.line) || request.line < 1 || request.line > count) {
+        throw new PhpstanError(`Line ${String(request.line)} is outside the file, which has ${String(count)} line(s).`, 'invalid_argument', {
+            hint: 'Pass the line from the finding.',
+        });
+    }
+    const context = Math.min(Math.max(Math.trunc(request.context ?? DEFAULT_CONTEXT), 0), MAX_CONTEXT);
+    const from = Math.max(request.line - context, 1);
+    const to = Math.min(request.line + context, count);
+    const code = lines.slice(from - 1, to).map((text, index) => ({ number: from + index, text: shorten(text) }));
+    const base = { project: project.path, file: displayPath(project.path, file), line: request.line, code };
+    const expressions = request.expressions ?? variablesOn(lines[request.line - 1] ?? '');
+    if (expressions.length === 0) {
+        return {
+            ...base,
+            findings: null,
+            types: [],
+            typesProblem: 'There is no variable on this line, so PHPStan was not started. Pass expressions to see their types.',
+            parseErrors: [],
+            generalErrors: [],
+            warnings: [],
+        };
+    }
+    const probe = insertProbes(source, request.line, expressions);
+    const result = await analyseEdited(project, { insteadOf: file, content: probe.content, name: tmpCopyName(project.path, 'finding') }, options);
+    const report = readProbes(project.path, file, probe, result);
+    // Na het invoegen staat de gevraagde regel zoveel regels lager als er dumps zijn.
+    const verschoven = request.line + probe.expressions.length;
+    const findings = result.findings
+        .filter((finding) => finding.file === file && finding.line === verschoven && finding.identifier !== 'phpstan.parse')
+        .map((finding) => ({ message: finding.message, identifier: finding.identifier, tip: finding.tip }));
+    if (report.parseErrors.length > 0) {
+        return {
+            ...base,
+            findings: null,
+            types: [],
+            typesProblem: `Line ${String(request.line)} does not start a statement (it is, for example, inside an array or a method ` +
+                'chain that spans several lines), so nothing can be inserted before it. Call inspect_type with the line ' +
+                'where the statement starts.',
+            parseErrors: report.parseErrors,
+            generalErrors: report.generalErrors,
+            warnings: report.warnings,
+        };
+    }
+    return {
+        ...base,
+        findings,
+        types: report.types,
+        typesProblem: null,
+        parseErrors: [],
+        generalErrors: report.generalErrors,
+        warnings: report.warnings,
+    };
+}
+/**
+ * De variabelen en property-ketens op een regel, zoals ze vóór die regel al bestaan: `$user`,
+ * `$this->repo`, `$order->customer->email`. Geen methode-aanroepen (daar horen argumenten bij),
+ * geen kale `$this` (dat is de klasse), en niets wat pas op deze regel ontstaat: het doel van
+ * een toewijzing, de variabelen van een `foreach … as` en de parameters van een closure. Die
+ * geven vóór de regel alleen `*ERROR*`. Een tekst tussen enkele quotes en commentaar tellen niet
+ * mee; tussen dubbele quotes wel, want daar wordt een variabele ingevuld.
+ */
+export function variablesOn(line) {
+    const code = line
+        .replace(/'(?:[^'\\]|\\.)*'/g, "''")
+        .replace(/\/\*.*?\*\//g, '')
+        .replace(/(?:\/\/|#(?!\[)).*$/, '');
+    const nieuw = new Set();
+    for (const match of code.matchAll(/(\$\w+)\s*(?:=(?![=>])|\?\?=)/g)) {
+        // `??=` laat een bestaande waarde staan, maar de variabele hoeft nog niet te bestaan.
+        nieuw.add(match[1] ?? '');
+    }
+    for (const match of code.matchAll(/\bas\s+(?:&?\s*(\$\w+)\s*=>\s*)?&?\s*(\$\w+)/g)) {
+        nieuw.add(match[1] ?? '');
+        nieuw.add(match[2] ?? '');
+    }
+    for (const match of code.matchAll(/\b(?:fn|function)\s*&?\s*\(([^)]*)\)/g)) {
+        for (const parameter of (match[1] ?? '').matchAll(/\$\w+/g)) {
+            nieuw.add(parameter[0]);
+        }
+    }
+    const gevonden = [];
+    // `(?!\w)` vóór de lookahead op `(`: anders maakt backtracking van `$a->foo()` een `$a->fo`.
+    // Niet na `::`: `self::$x` is een statische property, geen lokale variabele.
+    for (const match of code.matchAll(/(?<!::)\$\w+(?:\s*\??->\s*\w+(?!\w)(?!\s*\())*/g)) {
+        const expressie = match[0].replace(/\s+/g, '');
+        const variabele = /^\$\w+/.exec(expressie)?.[0] ?? '';
+        if (expressie === '$this' || nieuw.has(variabele) || gevonden.includes(expressie)) {
+            continue;
+        }
+        gevonden.push(expressie);
+    }
+    return gevonden.slice(0, MAX_EXPRESSIONS);
+}
+/** Schrijft de bevinding uit als tekst voor het model. */
+export function renderFinding(view) {
+    const lines = [`${view.file}, line ${String(view.line)}:`, ''];
+    const breedte = String(view.code.at(-1)?.number ?? view.line).length;
+    for (const regel of view.code) {
+        const teken = regel.number === view.line ? '>' : ' ';
+        lines.push(`${teken} ${String(regel.number).padStart(breedte)} | ${regel.text}`.trimEnd());
+    }
+    if (view.warnings.length > 0) {
+        lines.push('', 'WARNING PHPStan reported this alongside the result:', ...view.warnings.map((warning) => `- ${warning}`));
+    }
+    if (view.generalErrors.length > 0) {
+        lines.push('', 'Errors not tied to a file:', ...view.generalErrors.map((error) => `- ${error}`));
+    }
+    if (view.findings !== null) {
+        lines.push('');
+        if (view.findings.length === 0) {
+            lines.push('PHPStan reports nothing on this line.');
+        }
+        else {
+            lines.push('PHPStan reports on this line:');
+            for (const finding of view.findings) {
+                lines.push(`- ${finding.identifier === null ? '' : `${finding.identifier}: `}${finding.message}`);
+                if (finding.tip !== null) {
+                    lines.push(`  tip: ${finding.tip}`);
+                }
+            }
+        }
+    }
+    lines.push('');
+    if (view.typesProblem !== null) {
+        lines.push(`No types: ${view.typesProblem}`);
+        for (const error of view.parseErrors) {
+            lines.push(`- ${error.inserted ? 'inserted line' : error.line === null ? 'no line' : `line ${String(error.line)}`}: ${error.message}`);
+        }
+        return lines.join('\n');
+    }
+    lines.push(`Types right before line ${String(view.line)}:`);
+    for (const probed of view.types) {
+        lines.push(`- ${probed.expression}: ${probed.type ?? 'no type reported'}`);
+        for (const problem of probed.problems) {
+            lines.push(`    ${problem.identifier === null ? '' : `${problem.identifier}: `}${problem.message}`);
+        }
+    }
+    return lines.join('\n');
+}
+function shorten(text) {
+    return text.length <= MAX_LINE_CHARS ? text : `${text.slice(0, MAX_LINE_CHARS)}… (line cut off)`;
+}
+//# sourceMappingURL=finding.js.map

package/dist/finding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"finding.js","sourceRoot":"","sources":["../src/finding.ts"],"names":[],"mappings":"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"}

package/dist/history.d.ts

@@ -0,0 +1,61 @@
+import type { ResolvedProject } from './project.js';
+/** Hoeveel wijzigingen per baseline-bestand standaard. */
+export declare const DEFAULT_HISTORY_LIMIT = 20;
+/** Meer dan dit is niet meer te lezen, en elke wijziging kost een `git show`. */
+export declare const MAX_HISTORY_LIMIT = 100;
+/** Hoeveel entries en genegeerde fouten een baseline telt. */
+export interface BaselineCount {
+    readonly entries: number;
+    readonly errors: number;
+}
+/** Eén wijziging van een baseline-bestand, of de werkkopie als die afwijkt van de laatste commit. */
+export interface HistoryRow {
+    /** Null: de werkkopie, nog niet gecommit. */
+    readonly commit: string | null;
+    /** Commitdatum, ISO 8601; null bij de werkkopie. */
+    readonly date: string | null;
+    readonly subject: string | null;
+    /** De naam van het bestand in die commit; anders dan nu als het later hernoemd is. */
+    readonly file: string;
+    /** Null als het bestand in die commit niet te lezen was. */
+    readonly count: BaselineCount | null;
+    /** Ten opzichte van de rij eronder; null als een van beide niet te lezen was. */
+    readonly delta: BaselineCount | null;
+    /** De soorten die het meest veranderden, in genegeerde fouten; positief is erbij. */
+    readonly changes: readonly {
+        identifier: string;
+        change: number;
+    }[];
+}
+/** Het verloop van één baseline-bestand, nieuwste wijziging eerst. */
+export interface FileHistory {
+    readonly file: string;
+    readonly rows: readonly HistoryRow[];
+    /** De stand vóór de oudste rij: nul als het bestand daar ontstond. */
+    readonly start: BaselineCount | null;
+    /** Of er nog oudere commits zijn die het bestand raakten; dan helpt een hogere `limit`. */
+    readonly olderCommits: boolean;
+}
+/** Het antwoord van `baseline_history`. */
+export interface HistoryReport {
+    readonly project: string;
+    readonly files: readonly FileHistory[];
+    readonly notices: readonly string[];
+}
+/**
+ * Het verloop van de geïncludeerde baselines door de git-geschiedenis: per commit die het
+ * bestand raakte hoeveel entries en genegeerde fouten, het verschil met de vorige, en welke
+ * soorten het meest veranderden. Zonder PHPStan: alleen git en de baseline-parser.
+ *
+ * Langs de first-parent-lijn van HEAD, want alleen dan is "het verschil met de rij eronder"
+ * zinvol: zonder die vlag komen commits uit verschillende branches op datum door elkaar, en
+ * vergelijk je een commit met een die er nooit zijn ouder was. Een gemergede branch telt zo als
+ * één wijziging, en dat is ook de vraag: welke merge zette er een stapel bij. `--follow`, zodat
+ * een hernoemd bestand niet begint met "alles nieuw"; dat kan alleen per bestand.
+ *
+ * Bewust zonder auteur: commit en onderwerp zijn genoeg om hem terug te vinden, en een lijst
+ * met namen bij "wie zette er fouten bij" is niet waar deze tool voor is.
+ */
+export declare function baselineHistory(project: ResolvedProject, limit?: number): Promise<HistoryReport>;
+/** Schrijft het verloop uit als tekst voor het model. */
+export declare function renderHistory(report: HistoryReport): string;

package/dist/history.js

@@ -0,0 +1,275 @@
+import { readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { findBaselineFiles, includedBaselineFiles, isUnreadableBaseline, parseBaseline } from './baseline.js';
+import { GitError, execute, gitShow, throwIfFailed } from './changed.js';
+/** Hoeveel wijzigingen per baseline-bestand standaard. */
+export const DEFAULT_HISTORY_LIMIT = 20;
+/** Meer dan dit is niet meer te lezen, en elke wijziging kost een `git show`. */
+export const MAX_HISTORY_LIMIT = 100;
+/** Hoeveel soorten een rij hoogstens noemt bij "wat veranderde er". */
+const CHANGE_ROWS = 4;
+/** Scheiding tussen commits en tussen velden in de uitvoer van `git log`; komen niet voor in een onderwerp. */
+const RECORD = '\x1e';
+const FIELD = '\x1f';
+const EMPTY = { count: { entries: 0, errors: 0 }, entries: [] };
+/**
+ * Het verloop van de geïncludeerde baselines door de git-geschiedenis: per commit die het
+ * bestand raakte hoeveel entries en genegeerde fouten, het verschil met de vorige, en welke
+ * soorten het meest veranderden. Zonder PHPStan: alleen git en de baseline-parser.
+ *
+ * Langs de first-parent-lijn van HEAD, want alleen dan is "het verschil met de rij eronder"
+ * zinvol: zonder die vlag komen commits uit verschillende branches op datum door elkaar, en
+ * vergelijk je een commit met een die er nooit zijn ouder was. Een gemergede branch telt zo als
+ * één wijziging, en dat is ook de vraag: welke merge zette er een stapel bij. `--follow`, zodat
+ * een hernoemd bestand niet begint met "alles nieuw"; dat kan alleen per bestand.
+ *
+ * Bewust zonder auteur: commit en onderwerp zijn genoeg om hem terug te vinden, en een lijst
+ * met namen bij "wie zette er fouten bij" is niet waar deze tool voor is.
+ */
+export async function baselineHistory(project, limit = DEFAULT_HISTORY_LIMIT) {
+    const files = includedBaselineFiles(project);
+    if (files.length === 0) {
+        return { project: project.path, files: [], notices: [noBaselineNotice(project)] };
+    }
+    const { prefix, shallow } = await repository(project);
+    const max = Math.min(Math.max(Math.trunc(limit), 1), MAX_HISTORY_LIMIT);
+    const histories = [];
+    for (const file of files) {
+        histories.push(await historyOf(project, prefix, file, max));
+    }
+    const notices = [];
+    if (shallow) {
+        notices.push('This is a shallow clone: git has only part of the history, so the oldest change shown may be counted as ' +
+            'the creation of the baseline while it is not.');
+    }
+    const onleesbaar = histories.flatMap((history) => history.rows.filter((row) => row.count === null).map((row) => `${history.file} at ${row.commit ?? 'the working copy'}`));
+    if (onleesbaar.length > 0) {
+        notices.push(`Could not read the baseline in: ${onleesbaar.join(', ')}. Its counts and the change next to it are unknown, not zero.`);
+    }
+    return { project: project.path, files: histories, notices };
+}
+/**
+ * Het pad van het project binnen de repository, en of het een ondiepe kloon is. In één
+ * aanroep, die tegelijk zegt of er überhaupt een repository is.
+ */
+async function repository(project) {
+    const args = ['rev-parse', '--show-prefix', '--is-shallow-repository'];
+    const result = await execute(project.path, args);
+    try {
+        throwIfFailed(project.path, args, result);
+    }
+    catch (error) {
+        throw explain(project, error);
+    }
+    const [prefix = '', shallow = ''] = result.stdout.split('\n').map((line) => line.trim());
+    return { prefix, shallow: shallow === 'true' };
+}
+/**
+ * Een eigen melding bij een ontbrekende git of repository: die van `throwIfFailed` is
+ * geschreven voor `analyse_changed` en raadt `analyse_project` met paden aan, en dat helpt hier
+ * niet. Een fout en geen lege uitkomst: de geschiedenis is hier het hele antwoord, en "niets"
+ * zou lezen als een baseline die nooit veranderd is.
+ */
+function explain(project, error) {
+    if (!(error instanceof GitError)) {
+        return error;
+    }
+    if (error.reason === 'not_a_git_repository') {
+        return new GitError(`${project.path} is not under git, so its baseline has no history to read. baseline_summary shows what is in it now.`, error.reason, error.details);
+    }
+    if (error.reason === 'git_missing' && /not found/i.test(error.message)) {
+        return new GitError('git was not found, and the history of the baseline is read with git. baseline_summary works without it.', error.reason, error.details);
+    }
+    return error;
+}
+async function historyOf(project, prefix, file, limit) {
+    // Eén commit meer dan getoond: dat is de stand vóór de oudste rij. Is die er niet, dan
+    // ontstond het bestand in de oudste rij.
+    const logged = await logOf(project, file, `${prefix}${file}`, limit + 1);
+    const shown = logged.slice(0, limit);
+    const older = logged[limit];
+    const snapshots = [];
+    for (const commit of shown) {
+        snapshots.push(snapshot(await gitShow(project.path, `${commit.commit}:${commit.path}`)));
+    }
+    const start = older === undefined ? EMPTY : snapshot(await gitShow(project.path, `${older.commit}:${older.path}`));
+    const rows = shown.map((commit, index) => {
+        const before = snapshots[index + 1] ?? start;
+        return row(commit.commit, commit.date, commit.subject, display(commit.path, prefix), snapshots[index] ?? EMPTY, before);
+    });
+    // De werkkopie, als die afwijkt van de laatste commit. Vergeleken op de entries en niet op
+    // de tekst: met core.autocrlf verschillen de regeleinden, en dat is geen wijziging.
+    const working = snapshot(readOrEmpty(join(project.path, file)));
+    const latest = snapshots[0] ?? start;
+    if (shown.length === 0 || !sameEntries(working, latest)) {
+        rows.unshift(row(null, null, null, file, working, latest));
+    }
+    return { file, rows, start: start.count, olderCommits: older !== undefined };
+}
+/**
+ * De commits die dit bestand raakten, nieuwste eerst. Een lege repository is geen fout: dan is
+ * er nog geen geschiedenis, en is de werkkopie het hele verhaal.
+ *
+ * `--no-color`, `--no-ext-diff` en `--no-show-signature` zetten vast wat de gebruikersconfig
+ * anders verandert aan uitvoer die geparsed wordt, net als bij `diff -U0` en `git grep`: met
+ * `log.showSignature=true` staat de GPG-uitvoer tussen de regels. Het pad staat na `--` en
+ * komt uit de map van het project (een naam die met `phpstan-baseline` begint), niet uit een
+ * aanroep.
+ *
+ * Twee paden, want git is hier niet consequent: de pathspec geldt vanaf de werkmap (het
+ * project), de namen die `--name-only` teruggeeft gelden vanaf de repositoryroot. Met één pad
+ * vond de test voor een project in een submap niets.
+ */
+async function logOf(project, pathspec, fromRoot, max) {
+    const args = [
+        'log', '--first-parent', '--follow', '--no-color', '--no-ext-diff', '--no-show-signature', '--name-only',
+        `--format=${RECORD}%H${FIELD}%cI${FIELD}%s`, `--max-count=${String(max)}`, '--', pathspec,
+    ];
+    const result = await execute(project.path, args);
+    if (result.spawnError === null && result.code !== 0 && /does not have any commits yet|bad default revision/i.test(result.stderr)) {
+        return [];
+    }
+    try {
+        throwIfFailed(project.path, args, result);
+    }
+    catch (error) {
+        throw explain(project, error);
+    }
+    const commits = [];
+    // Van nieuw naar oud: het pad van een commit waar git geen naam bij geeft (een merge op een
+    // oude git, die de first-parent-diff nog niet toont), is dat van de rij erboven.
+    let current = fromRoot;
+    for (const record of result.stdout.split(RECORD)) {
+        const [header = '', ...names] = record.split('\n');
+        const [commit, date, subject] = header.split(FIELD);
+        if (commit === undefined || date === undefined || subject === undefined || commit.trim() === '') {
+            continue;
+        }
+        current = names.map((name) => name.trim()).find((name) => name !== '') ?? current;
+        commits.push({ commit: commit.trim(), date, subject, path: current });
+    }
+    return commits;
+}
+function snapshot(content) {
+    const entries = parseBaseline(content);
+    if (isUnreadableBaseline(content, entries)) {
+        return { count: null, entries: [] };
+    }
+    return { count: { entries: entries.length, errors: entries.reduce((sum, entry) => sum + entry.count, 0) }, entries };
+}
+function row(commit, date, subject, file, now, before) {
+    const leesbaar = now.count !== null && before.count !== null;
+    return {
+        commit,
+        date,
+        subject,
+        file,
+        count: now.count,
+        delta: now.count === null || before.count === null ? null : { entries: now.count.entries - before.count.entries, errors: now.count.errors - before.count.errors },
+        changes: leesbaar ? changesBetween(before.entries, now.entries) : [],
+    };
+}
+/** Per identifier het verschil in genegeerde fouten; de grootste eerst, bij gelijk verschil alfabetisch. */
+function changesBetween(before, now) {
+    const change = new Map();
+    for (const entry of before) {
+        change.set(entry.identifier, (change.get(entry.identifier) ?? 0) - entry.count);
+    }
+    for (const entry of now) {
+        change.set(entry.identifier, (change.get(entry.identifier) ?? 0) + entry.count);
+    }
+    return [...change]
+        .filter(([, verschil]) => verschil !== 0)
+        .sort((a, b) => Math.abs(b[1]) - Math.abs(a[1]) || a[0].localeCompare(b[0]))
+        .slice(0, CHANGE_ROWS)
+        .map(([identifier, verschil]) => ({ identifier, change: verschil }));
+}
+function sameEntries(a, b) {
+    return a.count !== null && b.count !== null && JSON.stringify(a.entries) === JSON.stringify(b.entries);
+}
+/** Het pad in een commit, relatief aan het project als het daarbinnen lag. */
+function display(path, prefix) {
+    return prefix !== '' && path.startsWith(prefix) ? path.slice(prefix.length) : path;
+}
+function readOrEmpty(file) {
+    try {
+        return readFileSync(file, 'utf8');
+    }
+    catch {
+        return '';
+    }
+}
+function noBaselineNotice(project) {
+    if (project.config === null) {
+        return `${project.path} has no phpstan.neon(.dist), so no baseline is included.`;
+    }
+    const los = findBaselineFiles(project);
+    return los.length > 0
+        ? `${los.join(', ')} ${los.length === 1 ? 'is' : 'are'} not included by the config, so ${los.length === 1 ? 'it hides' : 'they hide'} nothing; no history is shown.`
+        : 'The config includes no phpstan-baseline*.neon from the project root, so there is no baseline history.';
+}
+/** Schrijft het verloop uit als tekst voor het model. */
+export function renderHistory(report) {
+    const lines = [];
+    if (report.notices.length > 0) {
+        lines.push(...report.notices.map((notice) => `Note: ${notice}`), '');
+    }
+    if (report.files.length === 0) {
+        lines.push('No baseline history.');
+        return lines.join('\n');
+    }
+    for (const history of report.files) {
+        lines.push(...renderFile(history), '');
+    }
+    lines.push('Each change is compared with the one below it, along the first-parent line of HEAD: a merged branch counts as ' +
+        'one change. Counts are ignored errors; a baseline entry can cover several.');
+    return lines.join('\n');
+}
+function renderFile(history) {
+    const committed = history.rows.filter((row) => row.commit !== null);
+    const newest = history.rows[0];
+    const lines = [headline(history, committed.length, newest?.count ?? null), ''];
+    for (const row of history.rows) {
+        const date = row.date === null ? 'working copy' : row.date.slice(0, 10);
+        const commit = row.commit === null ? '(not committed)' : row.commit.slice(0, 10);
+        const count = row.count === null ? '?' : String(row.count.errors);
+        const delta = row.delta === null ? '?' : signed(row.delta.errors);
+        const kolommen = `  ${date.padEnd(12)}  ${commit.padEnd(15)}  ${count.padStart(6)}  ${delta.padStart(6)}  `;
+        // De regels eronder beginnen onder het onderwerp.
+        const inspring = ' '.repeat(kolommen.length);
+        lines.push(`${kolommen}${row.subject ?? ''}`.trimEnd());
+        if (row.changes.length > 0) {
+            lines.push(`${inspring}${row.changes.map((change) => `${signed(change.change)} ${change.identifier}`).join(', ')}`);
+        }
+        if (row.file !== history.file) {
+            lines.push(`${inspring}(then named ${row.file})`);
+        }
+    }
+    if (history.olderCommits) {
+        lines.push('', `Older commits changed ${history.file} too; pass a higher limit (up to ${String(MAX_HISTORY_LIMIT)}) to see them.`);
+    }
+    return lines;
+}
+function headline(history, committed, now) {
+    const nu = now === null ? 'cannot be read now' : `ignores ${String(now.errors)} error(s) in ${String(now.entries)} ${now.entries === 1 ? 'entry' : 'entries'} now`;
+    if (committed === 0) {
+        return `${history.file} ${nu}. It has never been committed, so there is no history yet.`;
+    }
+    if (committed === 1 && !history.olderCommits && history.rows.length === 1) {
+        return `${history.file} ${nu}. Only one commit touched it, the one that created it; there is nothing to compare yet.`;
+    }
+    const start = history.start;
+    const end = now;
+    const verloop = start === null || end === null
+        ? 'the net change is unknown because a version cannot be read'
+        : `${String(start.errors)} → ${String(end.errors)} ignored error(s) (net ${signed(end.errors - start.errors)})`;
+    const deltas = history.rows.flatMap((row) => (row.delta === null ? [] : [row.delta.errors]));
+    const erbij = deltas.filter((delta) => delta > 0).length;
+    const eraf = deltas.filter((delta) => delta < 0).length;
+    return (`${history.file} ${nu}. Over the last ${String(history.rows.length)} change(s): ${verloop}; ` +
+        `${String(erbij)} of them added errors, ${String(eraf)} removed some.`);
+}
+function signed(value) {
+    return value > 0 ? `+${String(value)}` : String(value);
+}
+//# sourceMappingURL=history.js.map

package/dist/history.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"history.js","sourceRoot":"","sources":["../src/history.ts"],"names":[],"mappings":"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"}

package/dist/phpstan/process.d.ts

@@ -9,6 +9,16 @@ export interface Execution {
     readonly stderr: string;
     readonly spawnError: NodeJS.ErrnoException | null;
 }
+/**
+ * Of deze server de run gestopt heeft, door een timeout of een annulering.
+ *
+ * Op POSIX blijkt dat uit het signaal. Op Windows niet: `taskkill /F` laat het proces eindigen
+ * met exit code 1 en zonder signaal, en tot hier las elke timeout en elke annulering daar als
+ * "PHPStan returned no usable JSON", met het advies de cache te legen. Nagemeten toen de
+ * testsuite op Windows ging draaien. Daarom telt ook de reden, maar alleen als het proces niet
+ * toch nog zelf klaar was (`completed`): een run die net op tijd eindigde, is geen timeout.
+ */
+export declare function wasStopped(execution: Pick<Execution, 'signal' | 'reason'>, completed: boolean): boolean;
 /**
  * Start PHPStan zonder shell. Bewust spawn en niet execFile: die laatste kapt de
  * output af op maxBuffer (1 MB), en de JSON van een groot project gaat daar