phpstan-mcp-mx 0.8.0 → 0.10.0

package/CHANGELOG.md

@@ -0,0 +1,87 @@
+# Wijzigingen
+
+Alle noemenswaardige wijzigingen per versie. Vanaf 0.10.0 gegenereerd door
+semantic-release uit de commit-historie; de versies daarvoor zijn met de hand
+geschreven.
+
+# [0.10.0](https://codeberg.org/MartijnSchimmel/phpstan-mcp-mx/compare/v0.9.0...v0.10.0) (2026-09-10)
+
+
+### Features
+
+* log ook de diagnose en de tools die iets veranderen ([cf76a9e](https://codeberg.org/MartijnSchimmel/phpstan-mcp-mx/commit/cf76a9e136259059ae7db87112a3d869fe43619b))
+
+## 0.9.0
+
+- Logmeldingen naar de client bij het starten en afronden van een analyse, met duur,
+  bevindingen en waarschuwingen. De server declareert daarvoor de `logging`-capability.
+- `tools.ts` en `phpstan.ts` opgesplitst per verantwoordelijkheid. Geen gedragswijziging: de
+  dekking is voor en na identiek.
+- Testdekking wordt gemeten (`npm run coverage`) met drempels die een terugval opvangen.
+- zod bijgewerkt naar 4.6.1.
+
+## 0.8.0
+
+- Nieuwe tool `server_config`: met welke instellingen deze server draait — roots, standaard
+  geheugenlimiet, hoeveel analyses tegelijk, waar de tijdelijke bestanden heen gaan en of
+  schrijvende tools aanstaan. Een geweigerde instelling wordt gemeld in plaats van
+  verzwegen.
+
+## 0.7.1
+
+- README noemt de CI-opstelling. Eerste release die vanuit CI gepubliceerd is.
+
+## 0.7.0
+
+- Elk project krijgt zijn eigen tijdelijke map, zodat PHPStans resultcache per project blijft
+  werken. Zonder dit deelden alle projecten één cache en maakten ze die van elkaar ongeldig.
+  Terug te zetten met `PHPSTAN_MCP_TMPDIR=shared`.
+
+## 0.6.0
+
+- Nieuwe tool `clear_result_cache`.
+- Nieuwe tool `generate_baseline`, alleen beschikbaar als de server met
+  `PHPSTAN_MCP_ALLOW_WRITES=1` gestart is. Zonder die vlag wordt hij niet geregistreerd.
+
+## 0.5.0
+
+- Nieuwe tool `diagnose_project`: PHPStans eigen opstelling in een project.
+- `list_projects` meldt per project of het onder git staat.
+- Een analyse waarschuwt als er een baseline meedoet; een schone uitslag is dan geen schone
+  code.
+- Nieuwe prompt met het werkpatroon om je eigen wijziging na te kijken.
+- `analyse_changed` kent `staged`, voor een controle vlak vóór een commit.
+- PHPStan wordt gestart met `PAO_DISABLE=1`, zodat `laravel/pao` de uitvoer niet vervangt.
+
+## 0.4.0
+
+- `PHPSTAN_MCP_MAX_PARALLEL` begrenst hoeveel analyses er over projecten heen tegelijk
+  draaien (standaard 2).
+- Een geannuleerd verzoek breekt de analyse af in plaats van door te rekenen.
+
+## 0.3.1
+
+- Bij een timeout wordt de procesgroep nu ook op Windows opgeruimd.
+
+## 0.3.0
+
+- Een analyse meldt het als PHPStan zegt dat het resultaat onvolledig is. Die waarschuwing
+  ging eerder verloren.
+- Waarschuwingen en algemene fouten worden begrensd op tien meldingen van elk hoogstens 1000
+  tekens.
+
+## 0.2.0
+
+- Nieuwe tool `analyse_changed`: alleen de PHP-bestanden die volgens git gewijzigd zijn.
+- De analysetools kennen `config`, voor een ander configbestand binnen het project.
+- De analysetools kennen `identifiers`, om de bevindingen tot één soort te beperken.
+- `PHPSTAN_MCP_MEMORY_LIMIT` zet de standaard geheugenlimiet.
+
+## 0.1.1
+
+- README beschrijft de PATH-valkuil bij het registreren van de server.
+
+## 0.1.0
+
+- Eerste publicatie: `list_projects`, `analyse_project`, `analyse_file` en
+  `baseline_summary`.

package/README.md

@@ -521,9 +521,9 @@ npm test
 npm run inspect      # MCP Inspector tegen de gebouwde server
 ```
 
-Dezelfde vier stappen draaien in CI op Node 20, 22 en 24 — de versies die `engines` belooft —
-en nog een keer bij `npm publish` via `prepublishOnly`. Draai je ze lokaal op één Node, dan
-zegt dat dus nog niets over de oudste versie die dit pakket ondersteunt.
+Dezelfde vier stappen draaien in CI op Node 24, en nog een keer bij een release. `engines`
+belooft `>=20`; die ondergrens is bij het opzetten van CI eenmalig in Docker nagelopen en
+draait niet mee bij elke build.
 
 ## Licentie
 

package/dist/index.js

@@ -2,7 +2,7 @@
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
 import { loadDefaultMemoryLimit, loadMaxParallel } from './phpstan.js';
 import { loadTmpDirMode } from './tmpdir.js';
-import { WRITES_ENV_VAR, writesAllowed } from './tools.js';
+import { WRITES_ENV_VAR, writesAllowed } from './tools/writes.js';
 import { loadRoots } from './roots.js';
 import { createServer } from './server.js';
 import { VERSION } from './version.js';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,sBAAsB,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACvE,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3D,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,KAAK,UAAU,IAAI;IACjB,MAAM,KAAK,GAAG,SAAS,EAAE,CAAC;IAC1B,MAAM,MAAM,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;IAEnC,8EAA8E;IAC9E,kEAAkE;IAClE,MAAM,MAAM,CAAC,OAAO,CAAC,IAAI,oBAAoB,EAAE,CAAC,CAAC;IAEjD,OAAO,CAAC,KAAK,CACX,eAAe,OAAO,uBAAuB,KAAK,CAAC,MAAM,yBAAyB;QAChF,qBAAqB,EAAE;QACvB,mBAAmB,EAAE;QACrB,cAAc,EAAE;QAChB,cAAc,EAAE,CACnB,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH;;;GAGG;AACH,SAAS,cAAc;IACrB,IAAI,CAAC;QACH,OAAO,cAAc,EAAE,KAAK,QAAQ,CAAC,CAAC,CAAC,2BAA2B,CAAC,CAAC,CAAC,EAAE,CAAC;IAC1E,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,aAAa,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;IAC/E,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,SAAS,cAAc;IACrB,IAAI,aAAa,EAAE;QAAE,OAAO,yBAAyB,CAAC;IAEtD,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,EAAE,IAAI,EAAE,CAAC;IACvD,OAAO,UAAU,KAAK,SAAS,IAAI,UAAU,KAAK,EAAE;QAClD,CAAC,CAAC,EAAE;QACJ,CAAC,CAAC,aAAa,cAAc,cAAc,UAAU,8CAA8C,CAAC;AACxG,CAAC;AAED,sEAAsE;AACtE,SAAS,mBAAmB;IAC1B,IAAI,CAAC;QACH,OAAO,eAAe,MAAM,CAAC,eAAe,EAAE,CAAC,WAAW,CAAC;IAC7D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,aAAa,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;IAC/E,CAAC;AACH,CAAC;AAED,SAAS,qBAAqB;IAC5B,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,sBAAsB,EAAE,CAAC;QACvC,OAAO,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,oBAAoB,KAAK,EAAE,CAAC;IAChE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,aAAa,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;IAC/E,CAAC;AACH,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;IAC9B,OAAO,CAAC,KAAK,CAAC,+BAA+B,EAAE,KAAK,CAAC,CAAC;IACtD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,sBAAsB,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACvE,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClE,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,KAAK,UAAU,IAAI;IACjB,MAAM,KAAK,GAAG,SAAS,EAAE,CAAC;IAC1B,MAAM,MAAM,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;IAEnC,8EAA8E;IAC9E,kEAAkE;IAClE,MAAM,MAAM,CAAC,OAAO,CAAC,IAAI,oBAAoB,EAAE,CAAC,CAAC;IAEjD,OAAO,CAAC,KAAK,CACX,eAAe,OAAO,uBAAuB,KAAK,CAAC,MAAM,yBAAyB;QAChF,qBAAqB,EAAE;QACvB,mBAAmB,EAAE;QACrB,cAAc,EAAE;QAChB,cAAc,EAAE,CACnB,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH;;;GAGG;AACH,SAAS,cAAc;IACrB,IAAI,CAAC;QACH,OAAO,cAAc,EAAE,KAAK,QAAQ,CAAC,CAAC,CAAC,2BAA2B,CAAC,CAAC,CAAC,EAAE,CAAC;IAC1E,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,aAAa,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;IAC/E,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,SAAS,cAAc;IACrB,IAAI,aAAa,EAAE;QAAE,OAAO,yBAAyB,CAAC;IAEtD,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,EAAE,IAAI,EAAE,CAAC;IACvD,OAAO,UAAU,KAAK,SAAS,IAAI,UAAU,KAAK,EAAE;QAClD,CAAC,CAAC,EAAE;QACJ,CAAC,CAAC,aAAa,cAAc,cAAc,UAAU,8CAA8C,CAAC;AACxG,CAAC;AAED,sEAAsE;AACtE,SAAS,mBAAmB;IAC1B,IAAI,CAAC;QACH,OAAO,eAAe,MAAM,CAAC,eAAe,EAAE,CAAC,WAAW,CAAC;IAC7D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,aAAa,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;IAC/E,CAAC;AACH,CAAC;AAED,SAAS,qBAAqB;IAC5B,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,sBAAsB,EAAE,CAAC;QACvC,OAAO,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,oBAAoB,KAAK,EAAE,CAAC;IAChE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,aAAa,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;IAC/E,CAAC;AACH,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;IAC9B,OAAO,CAAC,KAAK,CAAC,+BAA+B,EAAE,KAAK,CAAC,CAAC;IACtD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/phpstan/error.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Fout die als bruikbare melding naar het model teruggaat, niet als crash.
+ *
+ * Staat in een eigen module omdat zowel phpstan.ts als de queue hem gooit, en
+ * queue.ts importeren vanuit phpstan.ts zou een cyclus zijn.
+ */
+export declare class PhpstanError extends Error {
+}

package/dist/phpstan/error.js

@@ -0,0 +1,9 @@
+/**
+ * Fout die als bruikbare melding naar het model teruggaat, niet als crash.
+ *
+ * Staat in een eigen module omdat zowel phpstan.ts als de queue hem gooit, en
+ * queue.ts importeren vanuit phpstan.ts zou een cyclus zijn.
+ */
+export class PhpstanError extends Error {
+}
+//# sourceMappingURL=error.js.map

package/dist/phpstan/error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.js","sourceRoot":"","sources":["../../src/phpstan/error.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,OAAO,YAAa,SAAQ,KAAK;CAAG"}

package/dist/phpstan/output.d.ts

@@ -0,0 +1,57 @@
+import { z } from 'zod';
+declare const outputSchema: z.ZodObject<{
+    totals: z.ZodObject<{
+        errors: z.ZodNumber;
+        file_errors: z.ZodNumber;
+    }, z.core.$strip>;
+    files: z.ZodRecord<z.ZodString, z.ZodObject<{
+        messages: z.ZodArray<z.ZodObject<{
+            message: z.ZodString;
+            line: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+            identifier: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            tip: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    errors: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+type PhpstanOutput = z.infer<typeof outputSchema>;
+/**
+ * Leest PHPStans JSON, of null als het geen bruikbare JSON is. Normaliseert
+ * `files: []` naar `{}` zodat het schema streng kan blijven; PHP codeert een lege
+ * associatieve array nu eenmaal als JSON-array.
+ */
+export declare function tryParse(stdout: string): PhpstanOutput | null;
+/**
+ * Haalt uit stderr wat het model moet weten bij een gelúkte analyse. Dit werd eerder
+ * helemaal weggegooid zodra de JSON parseerde — en juist daar staat PHPStans
+ * "Result is incomplete because of severe errors.": geldige JSON die het project niet
+ * volledig dekt. Zonder deze regels leest een model een schone uitslag die dat niet is.
+ */
+export declare function collectWarnings(stderr: string): string[];
+/** Zet PHPStans uitvoer om in het interne resultaat, met de waarschuwingen erbij. */
+export declare function toResult(project: string, output: PhpstanOutput, warnings: readonly string[]): AnalysisResult;
+/** Eén bevinding van PHPStan, gekoppeld aan een bestand. */
+export interface Finding {
+    /** Absoluut pad zoals PHPStan het rapporteert. */
+    readonly file: string;
+    readonly line: number | null;
+    readonly message: string;
+    /** Bijv. "argument.type"; ontbreekt bij oudere PHPStan-versies. */
+    readonly identifier: string | null;
+    /** PHPStans eigen hint bij deze fout, als die er is. */
+    readonly tip: string | null;
+}
+/** Uitkomst van een geslaagde analyse — ook als er fouten gevonden zijn. */
+export interface AnalysisResult {
+    readonly project: string;
+    readonly findings: readonly Finding[];
+    /** Fouten die niet aan een bestand hangen, zoals configuratieproblemen. */
+    readonly generalErrors: readonly string[];
+    /** Wat PHPStan naast de JSON op stderr zei; leeg als er niets bijzonders was. */
+    readonly warnings: readonly string[];
+    readonly totals: {
+        readonly fileErrors: number;
+        readonly generalErrors: number;
+    };
+}
+export {};

package/dist/phpstan/output.js

@@ -0,0 +1,76 @@
+import { z } from 'zod';
+const findingSchema = z.object({
+    message: z.string(),
+    line: z.number().nullable().optional(),
+    identifier: z.string().nullable().optional(),
+    tip: z.string().nullable().optional(),
+});
+const outputSchema = z.object({
+    totals: z.object({ errors: z.number(), file_errors: z.number() }),
+    files: z.record(z.string(), z.object({ messages: z.array(findingSchema) })),
+    errors: z.array(z.string()),
+});
+/**
+ * Leest PHPStans JSON, of null als het geen bruikbare JSON is. Normaliseert
+ * `files: []` naar `{}` zodat het schema streng kan blijven; PHP codeert een lege
+ * associatieve array nu eenmaal als JSON-array.
+ */
+export function tryParse(stdout) {
+    if (stdout.trim() === '')
+        return null;
+    let raw;
+    try {
+        raw = JSON.parse(stdout);
+    }
+    catch {
+        return null;
+    }
+    // PHP codeert een lege associatieve array als [], niet als {}. Een project
+    // zonder bevindingen levert dus "files": [] op, wat het schema anders afkeurt.
+    if (typeof raw === 'object' && raw !== null && Array.isArray(raw.files)) {
+        raw.files = {};
+    }
+    const parsed = outputSchema.safeParse(raw);
+    return parsed.success ? parsed.data : null;
+}
+/**
+ * Regels op stderr die geen waarschuwing zijn. Bewust een lijst van wat ongevaarlijk
+ * is en niet van wat alarmerend is: PHPStan kan meldingen introduceren die we hier
+ * niet kennen, en die stil laten vallen is precies de fout die dit moet voorkomen.
+ */
+const HARMLESS_STDERR = [/^Note: /];
+/**
+ * Haalt uit stderr wat het model moet weten bij een gelúkte analyse. Dit werd eerder
+ * helemaal weggegooid zodra de JSON parseerde — en juist daar staat PHPStans
+ * "Result is incomplete because of severe errors.": geldige JSON die het project niet
+ * volledig dekt. Zonder deze regels leest een model een schone uitslag die dat niet is.
+ */
+export function collectWarnings(stderr) {
+    return stderr
+        .split('\n')
+        .map((line) => line.trim())
+        .filter((line) => line !== '' && !HARMLESS_STDERR.some((pattern) => pattern.test(line)));
+}
+/** Zet PHPStans uitvoer om in het interne resultaat, met de waarschuwingen erbij. */
+export function toResult(project, output, warnings) {
+    const findings = [];
+    for (const [file, entry] of Object.entries(output.files)) {
+        for (const message of entry.messages) {
+            findings.push({
+                file,
+                line: message.line ?? null,
+                message: message.message,
+                identifier: message.identifier ?? null,
+                tip: message.tip ?? null,
+            });
+        }
+    }
+    return {
+        project,
+        findings,
+        generalErrors: output.errors,
+        warnings,
+        totals: { fileErrors: output.totals.file_errors, generalErrors: output.totals.errors },
+    };
+}
+//# sourceMappingURL=output.js.map

package/dist/phpstan/output.js.map

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

package/dist/phpstan/process.d.ts

@@ -0,0 +1,45 @@
+/** Waarom een run gestopt is, als hij niet zelf klaar was. */
+type StopReason = 'timeout' | 'geannuleerd';
+export interface Execution {
+    readonly code: number | null;
+    readonly signal: NodeJS.Signals | null;
+    /** Null als het proces gewoon zelf klaar was. */
+    readonly reason: StopReason | null;
+    readonly stdout: string;
+    readonly stderr: string;
+    readonly spawnError: NodeJS.ErrnoException | null;
+}
+/**
+ * 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
+ * ruim overheen.
+ *
+ * `detached: true` maakt het proces leider van een eigen procesgroep, zodat een
+ * timeout de héle groep kan doden. Zonder dat blijven PHPStans parallelle workers
+ * na een timeout gewoon doorrekenen.
+ */
+export declare function execute(binary: string, args: readonly string[], cwd: string, timeoutMs: number, signal: AbortSignal | undefined): Promise<Execution>;
+/** Hoe een procesgroep op dit platform opgeruimd wordt. */
+export type KillPlan = {
+    readonly kind: 'signaal';
+    readonly target: number;
+    readonly signal: NodeJS.Signals;
+} | {
+    readonly kind: 'commando';
+    readonly command: string;
+    readonly args: readonly string[];
+};
+/**
+ * Bepaalt hoe de procesgroep van `pid` gedood wordt. Als plan teruggegeven en niet
+ * meteen uitgevoerd, want anders is de Windows-tak niet te testen op een machine
+ * waar je hem niet kunt uitvoeren — en juist die tak was stuk.
+ */
+export declare function planKill(pid: number, signal: NodeJS.Signals, platform?: NodeJS.Platform): KillPlan;
+/**
+ * Of een mislukte kill het melden waard is. `ESRCH` betekent dat de groep al weg
+ * is — de race tussen de timer en deze aanroep, en precies de gewenste uitkomst.
+ * Alles anders wél melden: de vorige versie slikte élke fout en verborg daarmee dat
+ * een negatieve pid op Windows niet eens bestaat.
+ */
+export declare function isReportableKillError(error: unknown): boolean;
+export {};

package/dist/phpstan/process.js

@@ -0,0 +1,148 @@
+import { spawn } from 'node:child_process';
+import { tmpDirEnv } from '../tmpdir.js';
+/** Hoe lang een gedode procesgroep de tijd krijgt voordat SIGKILL volgt. */
+const KILL_GRACE_MS = 5_000;
+/**
+ * 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
+ * ruim overheen.
+ *
+ * `detached: true` maakt het proces leider van een eigen procesgroep, zodat een
+ * timeout de héle groep kan doden. Zonder dat blijven PHPStans parallelle workers
+ * na een timeout gewoon doorrekenen.
+ */
+export function execute(binary, args, cwd, timeoutMs, signal) {
+    return new Promise((resolve) => {
+        // Geen `timeout`-optie van spawn: die doodt alleen het proces zelf.
+        const child = spawn(binary, args, {
+            cwd,
+            shell: false,
+            detached: true,
+            // PAO_DISABLE hoort bij --no-progress en --no-ansi: allemaal om PHPStans
+            // eigen, machineleesbare uitvoer te krijgen. laravel/pao hangt zich via
+            // autoload.files in de autoloader van het project, ziet aan variabelen als
+            // CLAUDECODE dat er een agent draait, en vervangt de uitvoer dan door zijn
+            // eigen formaat ({"tool":"phpstan","result":"passed"}). Dat parseert hier
+            // niet, dus zonder deze regel is zo'n project onanalyseerbaar — en de server
+            // erft die agent-variabelen juist altijd, want de client start hem.
+            //
+            // De tmpdir-variabelen komen uit de projectroot (die is hier de cwd), zodat
+            // elk project zijn eigen resultcache houdt.
+            env: { ...process.env, PAO_DISABLE: '1', ...tmpDirEnv(cwd) },
+        });
+        const stdout = [];
+        const stderr = [];
+        let spawnError = null;
+        child.stdout.on('data', (chunk) => stdout.push(chunk));
+        child.stderr.on('data', (chunk) => stderr.push(chunk));
+        child.on('error', (error) => {
+            spawnError = error;
+        });
+        const timers = [];
+        const stopTimers = () => timers.forEach((timer) => { clearTimeout(timer); });
+        let reason = null;
+        // Timeout en annulering ruimen op dezelfde manier op; alleen de reden verschilt,
+        // en die bepaalt straks welke uitleg het model krijgt.
+        const stop = (why) => {
+            reason ??= why;
+            killGroup(child.pid, 'SIGTERM');
+            // Wie op SIGTERM niet reageert, krijgt alsnog SIGKILL.
+            timers.push(setTimeout(() => { killGroup(child.pid, 'SIGKILL'); }, KILL_GRACE_MS));
+        };
+        timers.push(setTimeout(() => { stop('timeout'); }, timeoutMs));
+        const onAbort = () => { stop('geannuleerd'); };
+        signal?.addEventListener('abort', onAbort, { once: true });
+        let settled = false;
+        const finish = (code, stopSignal) => {
+            if (settled)
+                return;
+            settled = true;
+            stopTimers();
+            // Listener opruimen: het signaal van een verzoek kan langer leven dan deze
+            // run, en een achterblijvende listener houdt het proces vast.
+            signal?.removeEventListener('abort', onAbort);
+            resolve({
+                code,
+                signal: stopSignal,
+                reason,
+                stdout: Buffer.concat(stdout).toString('utf8'),
+                stderr: Buffer.concat(stderr).toString('utf8'),
+                spawnError,
+            });
+        };
+        // Normaal wachten we op 'close': dan is alle output binnen.
+        child.on('close', finish);
+        // Maar bij een timeout wordt alleen het proces zelf gedood, terwijl zijn
+        // kleinkinderen — PHPStan draait parallelle workers — de pipes openhouden.
+        // 'close' komt dan pas als die klaar zijn, en dan is de timeout geen timeout
+        // meer. Zodra het proces zelf door een signaal is gestopt, heeft wachten op
+        // meer output geen zin.
+        child.on('exit', (code, exitSignal) => {
+            if (exitSignal !== null)
+                finish(code, exitSignal);
+        });
+    });
+}
+/**
+ * Bepaalt hoe de procesgroep van `pid` gedood wordt. Als plan teruggegeven en niet
+ * meteen uitgevoerd, want anders is de Windows-tak niet te testen op een machine
+ * waar je hem niet kunt uitvoeren — en juist die tak was stuk.
+ */
+export function planKill(pid, signal, platform = process.platform) {
+    // Een negatieve pid als groeps-id is POSIX; op Windows bestaat dat niet en
+    // gooit process.kill. `taskkill /T` neemt de kinderen mee, `/F` forceert.
+    // Windows heeft geen SIGTERM-equivalent, dus de vriendelijke eerste stap valt
+    // daar weg; de tweede aanroep treft dan een al verdwenen boom, en dat is
+    // onschadelijk (exit 128, net als ESRCH hieronder).
+    if (platform === 'win32') {
+        return { kind: 'commando', command: 'taskkill', args: ['/T', '/F', '/PID', String(pid)] };
+    }
+    // Het minteken maakt van het pid een groeps-id; dat werkt alleen omdat het
+    // proces met `detached` is gestart.
+    return { kind: 'signaal', target: -pid, signal };
+}
+/** Exit code van taskkill als het proces er al niet meer is. */
+const TASKKILL_NOT_FOUND = 128;
+/** Doodt de hele procesgroep van `pid`, op de manier die dit platform kent. */
+function killGroup(pid, signal) {
+    if (pid === undefined)
+        return;
+    const plan = planKill(pid, signal);
+    if (plan.kind === 'commando') {
+        // Fire-and-forget: dit loopt in een timer en mag de event loop niet blokkeren.
+        const killer = spawn(plan.command, [...plan.args], { shell: false, stdio: 'ignore' });
+        killer.on('error', (error) => { reportKillFailure(pid, error); });
+        killer.on('exit', (code) => {
+            if (code !== 0 && code !== TASKKILL_NOT_FOUND) {
+                reportKillFailure(pid, new Error(`${plan.command} gaf exit code ${String(code)}`));
+            }
+        });
+        return;
+    }
+    try {
+        process.kill(plan.target, plan.signal);
+    }
+    catch (error) {
+        if (isReportableKillError(error))
+            reportKillFailure(pid, error);
+    }
+}
+/**
+ * Of een mislukte kill het melden waard is. `ESRCH` betekent dat de groep al weg
+ * is — de race tussen de timer en deze aanroep, en precies de gewenste uitkomst.
+ * Alles anders wél melden: de vorige versie slikte élke fout en verborg daarmee dat
+ * een negatieve pid op Windows niet eens bestaat.
+ */
+export function isReportableKillError(error) {
+    return error?.code !== 'ESRCH';
+}
+/**
+ * Meldt dat het opruimen niet gelukt is. Naar stderr, want bij stdio-transport is
+ * stdout het protocol — en niet gooien: dit loopt in een timer, waar een exception
+ * de hele server omhaalt.
+ */
+function reportKillFailure(pid, error) {
+    const reason = error instanceof Error ? error.message : String(error);
+    console.error(`phpstan-mcp kon procesgroep ${String(pid)} niet opruimen: ${reason}`);
+}
+//# sourceMappingURL=process.js.map

package/dist/phpstan/process.js.map

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

package/dist/phpstan/queue.d.ts

@@ -0,0 +1,21 @@
+/** Env-variabele met het aantal analyses dat tegelijk mag draaien. */
+export declare const MAX_PARALLEL_ENV_VAR = "PHPSTAN_MCP_MAX_PARALLEL";
+/**
+ * Leest hoeveel analyses tegelijk mogen draaien. Een onbruikbare waarde wordt
+ * geweigerd en niet stil vervangen door de standaard — net als bij de
+ * geheugenlimiet: wie dit zet, heeft er iets mee bedoeld.
+ */
+export declare function loadMaxParallel(env?: NodeJS.ProcessEnv): number;
+/**
+ * Laat `task` pas draaien als er een slot vrij is. Dit zit *binnen* de queue per
+ * project en niet ervoor: de queue gaat over PHPStans resultcache in dat ene
+ * project, dit over de machine als geheel.
+ */
+export declare function withSlot<T>(task: () => Promise<T>): Promise<T>;
+/** Stopt vóór er iets gestart wordt als de aanroeper het verzoek al heeft afgebroken. */
+export declare function throwIfAborted(project: string, signal: AbortSignal | undefined): void;
+/**
+ * Zet een taak achter in de rij voor deze sleutel, zodat runs binnen hetzelfde
+ * project elkaar niet overlappen.
+ */
+export declare function enqueue<T>(key: string, task: () => Promise<T>): Promise<T>;

package/dist/phpstan/queue.js

@@ -0,0 +1,76 @@
+import { PhpstanError } from './error.js';
+/** Env-variabele met het aantal analyses dat tegelijk mag draaien. */
+export const MAX_PARALLEL_ENV_VAR = 'PHPSTAN_MCP_MAX_PARALLEL';
+/**
+ * Twee tegelijk. De queue per project bestond al voor de resultcache, maar over
+ * projecten heen begrensde niets: een model dat na list_projects tien projecten
+ * aanroept, start tien PHPStan-processen die elk hun eigen parallelle workers
+ * opzetten — en met een geheugenlimiet van 2G is dat tien keer dat plafond.
+ */
+const DEFAULT_MAX_PARALLEL = 2;
+/**
+ * Leest hoeveel analyses tegelijk mogen draaien. Een onbruikbare waarde wordt
+ * geweigerd en niet stil vervangen door de standaard — net als bij de
+ * geheugenlimiet: wie dit zet, heeft er iets mee bedoeld.
+ */
+export function loadMaxParallel(env = process.env) {
+    const configured = env[MAX_PARALLEL_ENV_VAR]?.trim();
+    if (configured === undefined || configured === '')
+        return DEFAULT_MAX_PARALLEL;
+    const parsed = Number(configured);
+    if (!Number.isInteger(parsed) || parsed < 1) {
+        throw new PhpstanError(`${MAX_PARALLEL_ENV_VAR} staat op "${configured}", en dat is geen geheel getal van 1 of hoger. ` +
+            `Laat hem weg voor de standaard (${String(DEFAULT_MAX_PARALLEL)}).`);
+    }
+    return parsed;
+}
+/** Hoeveel analyses er nu draaien, en wie op een vrij slot wacht. */
+let running = 0;
+const waiting = [];
+/**
+ * Laat `task` pas draaien als er een slot vrij is. Dit zit *binnen* de queue per
+ * project en niet ervoor: de queue gaat over PHPStans resultcache in dat ene
+ * project, dit over de machine als geheel.
+ */
+export async function withSlot(task) {
+    // Per poging opnieuw uitlezen, zodat een gewijzigde omgeving meteen geldt en de
+    // grens niet vastligt op wat er bij het opstarten stond.
+    while (running >= loadMaxParallel()) {
+        await new Promise((resolve) => waiting.push(resolve));
+    }
+    running += 1;
+    try {
+        return await task();
+    }
+    finally {
+        running -= 1;
+        // Precies één wachtende wekken; die controleert de grens zelf opnieuw.
+        waiting.shift()?.();
+    }
+}
+/** Stopt vóór er iets gestart wordt als de aanroeper het verzoek al heeft afgebroken. */
+export function throwIfAborted(project, signal) {
+    if (signal?.aborted === true) {
+        throw new PhpstanError(`De analyse van ${project} is niet gestart: het verzoek was al geannuleerd.`);
+    }
+}
+/** Lopende analyses per projectpad, zodat aanroepen per project op volgorde gaan. */
+const queues = new Map();
+/**
+ * Zet een taak achter in de rij voor deze sleutel, zodat runs binnen hetzelfde
+ * project elkaar niet overlappen.
+ */
+export function enqueue(key, task) {
+    const previous = queues.get(key) ?? Promise.resolve();
+    // .catch vóór .then: een mislukte vorige analyse mag de volgende niet blokkeren.
+    const result = previous.then(task, task);
+    const tail = result.catch(() => undefined);
+    queues.set(key, tail);
+    void tail.then(() => {
+        // Alleen opruimen als er ondertussen niets nieuws achteraan is gezet.
+        if (queues.get(key) === tail)
+            queues.delete(key);
+    });
+    return result;
+}
+//# sourceMappingURL=queue.js.map

package/dist/phpstan/queue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue.js","sourceRoot":"","sources":["../../src/phpstan/queue.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE1C,sEAAsE;AACtE,MAAM,CAAC,MAAM,oBAAoB,GAAG,0BAA0B,CAAC;AAE/D;;;;;GAKG;AACH,MAAM,oBAAoB,GAAG,CAAC,CAAC;AAE/B;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,MAAyB,OAAO,CAAC,GAAG;IAClE,MAAM,UAAU,GAAG,GAAG,CAAC,oBAAoB,CAAC,EAAE,IAAI,EAAE,CAAC;IACrD,IAAI,UAAU,KAAK,SAAS,IAAI,UAAU,KAAK,EAAE;QAAE,OAAO,oBAAoB,CAAC;IAE/E,MAAM,MAAM,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC;IAClC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5C,MAAM,IAAI,YAAY,CACpB,GAAG,oBAAoB,cAAc,UAAU,iDAAiD;YAC9F,mCAAmC,MAAM,CAAC,oBAAoB,CAAC,IAAI,CACtE,CAAC;IACJ,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,qEAAqE;AACrE,IAAI,OAAO,GAAG,CAAC,CAAC;AAEhB,MAAM,OAAO,GAAmB,EAAE,CAAC;AAEnC;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAI,IAAsB;IACtD,gFAAgF;IAChF,yDAAyD;IACzD,OAAO,OAAO,IAAI,eAAe,EAAE,EAAE,CAAC;QACpC,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IAC9D,CAAC;IAED,OAAO,IAAI,CAAC,CAAC;IACb,IAAI,CAAC;QACH,OAAO,MAAM,IAAI,EAAE,CAAC;IACtB,CAAC;YAAS,CAAC;QACT,OAAO,IAAI,CAAC,CAAC;QACb,uEAAuE;QACvE,OAAO,CAAC,KAAK,EAAE,EAAE,EAAE,CAAC;IACtB,CAAC;AACH,CAAC;AAED,yFAAyF;AACzF,MAAM,UAAU,cAAc,CAAC,OAAe,EAAE,MAA+B;IAC7E,IAAI,MAAM,EAAE,OAAO,KAAK,IAAI,EAAE,CAAC;QAC7B,MAAM,IAAI,YAAY,CAAC,kBAAkB,OAAO,mDAAmD,CAAC,CAAC;IACvG,CAAC;AACH,CAAC;AAED,qFAAqF;AACrF,MAAM,MAAM,GAAG,IAAI,GAAG,EAA4B,CAAC;AAEnD;;;GAGG;AACH,MAAM,UAAU,OAAO,CAAI,GAAW,EAAE,IAAsB;IAC5D,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;IACtD,iFAAiF;IACjF,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACzC,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;IAE3C,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IACtB,KAAK,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE;QAClB,sEAAsE;QACtE,IAAI,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,IAAI;YAAE,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACnD,CAAC,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC"}