phpstan-mcp-mx 0.4.0 → 0.6.0

package/README.md

@@ -286,6 +286,7 @@ antwoord volloopt met wat er al jaren stond.
 | --- | --- | --- |
 | `project` | ja | absoluut pad naar de projectroot |
 | `base` | nee | commit, branch of tag om tegen te vergelijken (standaard `HEAD`) |
+| `staged` | nee | alleen wat gestaged is (`git diff --cached`), voor een check vóór een commit |
 
 Verder dezelfde argumenten als `analyse_project`, op `paths` na. Met `base=main` krijg je de
 hele branch in plaats van alleen je onopgeslagen werk.
@@ -302,6 +303,34 @@ als "overgeslagen" bij het antwoord te staan in plaats van er stil uit te vallen
 Staat het project niet onder git, dan zegt de tool dat en verwijst hij naar `analyse_project`
 met expliciete `paths`.
 
+### `diagnose_project`
+
+Vraagt PHPStan zelf om zijn opstelling: PHP- en PHPStan-versie, de configs die
+Composer-pakketten meebrengen (zoals Larastan) en of de turbo-extensie aanstaat. Draait geen
+analyse.
+
+Gebruik dit als een project zich anders gedraagt dan een ander project, vóórdat je aan de
+code gaat twijfelen. Dat is niet theoretisch: hiermee bleek dat één project een dependency
+had (`laravel/pao`) die de uitvoer van PHPStan onderschepte.
+
+### `clear_result_cache`
+
+Leegt PHPStans resultcache, zodat de volgende analyse alles opnieuw doorrekent. Nuttig als
+een uitslag niet klopt met de code — bijvoorbeeld na een wijziging aan een extensie of een
+geïncludeerde config.
+
+Die cache ligt standaard **niet** in het project maar in de tijdelijke map van het systeem
+(`sys_get_temp_dir()/phpstan`), en wordt dan gedeeld met elk ander project dat geen eigen
+`tmpDir` zet. Bovendien volgt die map `TMPDIR`, dus wat de server leegt hoeft niet dezelfde
+map te zijn als wat je terminal gebruikt. Het antwoord noemt daarom de map die geleegd is:
+
+```
+Result cache cleared from directory:
+/var/tmp/phpstan
+```
+
+Wil je per project een eigen cache, zet dan `tmpDir` in je `phpstan.neon`.
+
 ### `baseline_summary`
 
 Leest de `phpstan-baseline*.neon` van een project en telt wat er genegeerd wordt, per
@@ -311,6 +340,45 @@ Let op het onderscheid: wat hier in staat is precies wat `analyse_project` *niet
 project dat zijn baseline includet, rapporteert alleen de fouten die er nieuw bij komen —
 die vergelijking maakt PHPStan zelf al.
 
+### `generate_baseline` (alleen met schrijfrechten)
+
+Zet alle huidige fouten in een baseline, zodat een volgende analyse alleen meldt wat er nieuw
+bij komt. Bedoeld om een bestaand project onder PHPStan te krijgen — niet om fouten weg te
+werken.
+
+Deze tool bestaat alleen als de server met `PHPSTAN_MCP_ALLOW_WRITES=1` gestart is:
+
+```bash
+claude mcp add phpstan --scope user \
+  --env PHPSTAN_MCP_ROOTS=/pad/naar/projecten \
+  --env PHPSTAN_MCP_ALLOW_WRITES=1 \
+  -- phpstan-mcp-mx
+```
+
+Zonder die variabele wordt hij niet geregistreerd — hij staat dan dus ook niet in de
+toollijst, in plaats van dat hij bestaat en bij elke aanroep weigert. Alle andere tools
+blijven read-only.
+
+| Argument | Verplicht | Betekenis |
+| --- | --- | --- |
+| `project` | ja | absoluut pad naar de projectroot |
+| `file` | nee | doelbestand binnen het project (standaard `phpstan-baseline.neon`) |
+| `allowEmpty` | nee | ook schrijven als er niets te negeren valt |
+
+Verder dezelfde `paths`, `level`, `config` en `memoryLimit` als een analyse. Het antwoord
+zegt erbij wat er nog moet gebeuren, want een baseline die nergens ingesloten wordt doet
+niets:
+
+```
+5 fout(en) in phpstan-baseline.neon gezet.
+
+Deze fouten worden vanaf nu niet meer gemeld zodra phpstan-baseline.neon in de
+configuratie staat:
+
+includes:
+    - phpstan-baseline.neon
+```
+
 ## Wat je terugkrijgt
 
 Een analyse levert eerst tellingen over álle bevindingen en daarna één pagina met de
@@ -354,6 +422,18 @@ Dat onderscheid is wezenlijk: zonder die regel is een lege uitslag niet te onder
 een schone. Staat er een waarschuwing, dan leest het antwoord ook niet meer "Geen
 bevindingen" maar "Verder geen bevindingen".
 
+Doet er een baseline mee, dan staat dat er ook bij:
+
+```
+Ter info:
+- phpstan-baseline.neon wordt geïncludeerd: 1037 genegeerde fout(en) staan niet in dit
+  rapport. Gebruik baseline_summary om te zien wat er in staat.
+```
+
+Dat is het verschil tussen "geen bevindingen" en "geen bevindingen, plus duizend die niet
+gemeld worden". De check kijkt of je config het bestand echt includeert — een baseline die
+naast `phpstan.neon` ligt zonder erin te staan, doet niets.
+
 Het `warnings`-veld staat los van `generalErrors`: dat tweede is PHPStans eigen
 `errors`-array uit de JSON. Beide lijsten zijn begrensd op tien meldingen van elk hoogstens
 1000 tekens — een mislukte Laravel-bootstrap levert anders een lap tekst op die het hele

package/dist/baseline.d.ts

@@ -37,6 +37,19 @@ export declare class BaselineError extends Error {
  * van pakketten in vendor/ oppikken.
  */
 export declare function findBaselineFiles(project: ResolvedProject): string[];
+/**
+ * Meldt of de configuratie van dit project een baseline includeert, en hoeveel
+ * fouten die dan verbergt. Null als er geen baseline meedoet.
+ *
+ * Dit is nodig omdat een schone uitslag dan geen schone code betekent: PHPStan past
+ * de baseline zelf toe en rapporteert alleen wat er nieuw bij komt. Dat staat in de
+ * toolbeschrijving, maar niet in het antwoord waar het model naar kijkt.
+ *
+ * De include-check is regelgericht, net als de parser zelf: een lijst-entry die naar
+ * een baseline-bestand verwijst. Op de hele bestandsinhoud matchen zou ook aanslaan
+ * op een naam in een comment of onder een andere sleutel.
+ */
+export declare function describeIncludedBaseline(project: ResolvedProject): string | null;
 /**
  * Leest een baseline-bestand uit.
  *

package/dist/baseline.js

@@ -21,6 +21,53 @@ export function findBaselineFiles(project) {
         return [];
     }
 }
+/**
+ * Meldt of de configuratie van dit project een baseline includeert, en hoeveel
+ * fouten die dan verbergt. Null als er geen baseline meedoet.
+ *
+ * Dit is nodig omdat een schone uitslag dan geen schone code betekent: PHPStan past
+ * de baseline zelf toe en rapporteert alleen wat er nieuw bij komt. Dat staat in de
+ * toolbeschrijving, maar niet in het antwoord waar het model naar kijkt.
+ *
+ * De include-check is regelgericht, net als de parser zelf: een lijst-entry die naar
+ * een baseline-bestand verwijst. Op de hele bestandsinhoud matchen zou ook aanslaan
+ * op een naam in een comment of onder een andere sleutel.
+ */
+export function describeIncludedBaseline(project) {
+    if (project.config === null)
+        return null;
+    let config;
+    try {
+        config = readFileSync(join(project.path, project.config), 'utf8');
+    }
+    catch {
+        return null;
+    }
+    const included = findBaselineFiles(project).filter((file) => isIncludedIn(config, file));
+    if (included.length === 0)
+        return null;
+    const namen = included.join(', ');
+    let errors;
+    try {
+        const summary = summariseBaseline(project);
+        errors = summary.files
+            .filter((entry) => included.includes(entry.file))
+            .reduce((total, entry) => total + entry.errors, 0);
+    }
+    catch {
+        // Een onleesbare baseline mag geen analyse omleggen. Dat hij meedoet is ook
+        // zonder aantal het vermelden waard — juist dan, want dan is niet te zeggen
+        // hoeveel er verborgen wordt.
+        return `${namen} wordt geïncludeerd en is niet te lezen; wat daarin staat, meldt deze analyse niet.`;
+    }
+    return (`${namen} wordt geïncludeerd: ${String(errors)} genegeerde fout(en) staan niet in dit ` +
+        'rapport. Gebruik baseline_summary om te zien wat er in staat.');
+}
+/** Of `file` in deze config als lijst-entry voorkomt, met of zonder ./ ervoor. */
+function isIncludedIn(config, file) {
+    const escaped = file.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+    return new RegExp(`^\\s*-\\s*['"]?(?:\\./)?${escaped}['"]?\\s*$`, 'm').test(config);
+}
 /**
  * Leest een baseline-bestand uit.
  *

package/dist/baseline.js.map

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

package/dist/changed.d.ts

@@ -7,6 +7,8 @@ export declare const DEFAULT_BASE = "HEAD";
 /** De gewijzigde PHP-bestanden van een project, met wat er niet bruikbaar was. */
 export interface ChangedFiles {
     readonly base: string;
+    /** Of er naar de index gekeken is in plaats van naar de werkboom. */
+    readonly staged: boolean;
     /** Absolute paden binnen het project, alfabetisch zodat de volgorde vastligt. */
     readonly files: readonly string[];
     /** Paden die git noemde maar die niet te gebruiken zijn, met de reden. */
@@ -22,4 +24,4 @@ export interface ChangedFiles {
  * veranderd is, en `ls-files --others` de nieuwe bestanden die nog nergens in staan.
  * Zonder die tweede mist juist het bestand dat net is aangemaakt.
  */
-export declare function changedPhpFiles(project: ResolvedProject, base?: string): Promise<ChangedFiles>;
+export declare function changedPhpFiles(project: ResolvedProject, base?: string, staged?: boolean): Promise<ChangedFiles>;

package/dist/changed.js

@@ -17,7 +17,7 @@ const GIT_TIMEOUT_MS = 15_000;
  * veranderd is, en `ls-files --others` de nieuwe bestanden die nog nergens in staan.
  * Zonder die tweede mist juist het bestand dat net is aangemaakt.
  */
-export async function changedPhpFiles(project, base = DEFAULT_BASE) {
+export async function changedPhpFiles(project, base = DEFAULT_BASE, staged = false) {
     // --relative: zonder dat rapporteert git paden vanaf de repositoryroot, en die
     // hoeft niet de projectroot te zijn — een project kan in een monorepo liggen.
     //
@@ -32,10 +32,17 @@ export async function changedPhpFiles(project, base = DEFAULT_BASE) {
         '--name-only',
         '--relative',
         '--diff-filter=ACMR',
+        // --cached vergelijkt de index met `base` in plaats van de werkboom: dat is de
+        // vraag "wat sta ik op het punt te committen".
+        ...(staged ? ['--cached'] : []),
         '--end-of-options',
         checkBase(base),
     ]);
-    const untracked = await git(project.path, ['ls-files', '--others', '--exclude-standard']);
+    // Niet-toegevoegde bestanden horen er alleen bij als je naar de werkboom kijkt.
+    // Bij --cached zijn ze per definitie niet gestaged, dus dan blijft die uitvraag weg.
+    const untracked = staged
+        ? ''
+        : await git(project.path, ['ls-files', '--others', '--exclude-standard']);
     const candidates = [...new Set([...lines(changed), ...lines(untracked)])]
         .filter(isAnalysablePhp)
         .sort();
@@ -58,7 +65,7 @@ export async function changedPhpFiles(project, base = DEFAULT_BASE) {
             });
         }
     }
-    return { base, files, skipped };
+    return { base, staged, files, skipped };
 }
 /**
  * Blade-templates eindigen óók op `.php`, en juist die moeten er niet in: een

package/dist/changed.js.map

@@ -1 +1 @@
-{"version":3,"file":"changed.js","sourceRoot":"","sources":["../src/changed.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAE3C,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE3D,+EAA+E;AAC/E,MAAM,OAAO,QAAS,SAAQ,KAAK;CAAG;AAEtC,iFAAiF;AACjF,MAAM,CAAC,MAAM,YAAY,GAAG,MAAM,CAAC;AAEnC;;;GAGG;AACH,MAAM,cAAc,GAAG,MAAM,CAAC;AAW9B;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,OAAwB,EACxB,OAAe,YAAY;IAE3B,+EAA+E;IAC/E,8EAA8E;IAC9E,EAAE;IACF,gFAAgF;IAChF,iFAAiF;IACjF,iFAAiF;IACjF,kFAAkF;IAClF,gFAAgF;IAChF,+BAA+B;IAC/B,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE;QACtC,MAAM;QACN,aAAa;QACb,YAAY;QACZ,oBAAoB;QACpB,kBAAkB;QAClB,SAAS,CAAC,IAAI,CAAC;KAChB,CAAC,CAAC;IACH,MAAM,SAAS,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,UAAU,EAAE,UAAU,EAAE,oBAAoB,CAAC,CAAC,CAAC;IAE1F,MAAM,UAAU,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,EAAE,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;SACtE,MAAM,CAAC,eAAe,CAAC;SACvB,IAAI,EAAE,CAAC;IAEV,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,OAAO,GAAuC,EAAE,CAAC;IAEvD,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,IAAI,CAAC;YACH,wEAAwE;YACxE,8EAA8E;YAC9E,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC;QAChD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,2EAA2E;YAC3E,0EAA0E;YAC1E,2EAA2E;YAC3E,YAAY;YACZ,OAAO,CAAC,IAAI,CAAC;gBACX,IAAI,EAAE,SAAS;gBACf,MAAM,EAAE,KAAK,YAAY,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;aACtE,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;AAClC,CAAC;AAED;;;;;;;GAOG;AACH,SAAS,eAAe,CAAC,IAAY;IACnC,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IACjC,OAAO,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;AACjE,CAAC;AAED;;;;;GAKG;AACH,SAAS,SAAS,CAAC,IAAY;IAC7B,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,QAAQ,CAChB,IAAI,IAAI,uEAAuE;YAC7E,yFAAyF,CAC5F,CAAC;IACJ,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,KAAK,CAAC,MAAc;IAC3B,OAAO,MAAM;SACV,KAAK,CAAC,IAAI,CAAC;SACX,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;SAC1B,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,EAAE,CAAC,CAAC;AACnC,CAAC;AAED,KAAK,UAAU,GAAG,CAAC,GAAW,EAAE,IAAc;IAC5C,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IAEtE,IAAI,UAAU,KAAK,IAAI,EAAE,CAAC;QACxB,MAAM,IAAI,QAAQ,CAChB,UAAU,CAAC,IAAI,KAAK,QAAQ;YAC1B,CAAC,CAAC,mFAAmF;YACrF,CAAC,CAAC,kCAAkC,GAAG,KAAK,UAAU,CAAC,OAAO,EAAE,CACnE,CAAC;IACJ,CAAC;IAED,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;QACf,MAAM,IAAI,QAAQ,CAAC,kBAAkB,CAAC,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC;IAClE,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,kBAAkB,CACzB,GAAW,EACX,IAAuB,EACvB,MAAc,EACd,IAAmB;IAEnB,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;IAE7C,IAAI,uBAAuB,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QAC1C,OAAO,CACL,GAAG,GAAG,kEAAkE;YACxE,+CAA+C,CAChD,CAAC;IACJ,CAAC;IAED,gFAAgF;IAChF,mEAAmE;IACnE,IAAI,mDAAmD,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QACtE,OAAO,CACL,aAAa,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,EAAE,aAAa,GAAG,IAAI;YAC5D,yEAAyE,CAC1E,CAAC;IACJ,CAAC;IAED,OAAO,iBAAiB,GAAG,eAAe,IAAI,IAAI,GAAG,SAAS,OAAO,KAAK,EAAE,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;AAC7G,CAAC;AASD,SAAS,OAAO,CAAC,GAAW,EAAE,IAAuB;IACnD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,+EAA+E;QAC/E,gFAAgF;QAChF,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,cAAc,EAAE,CAAC,CAAC;QAExE,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,IAAI,UAAU,GAAiC,IAAI,CAAC;QAEpD,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE,CAAC,CAAC,MAAM,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;QACzE,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE,CAAC,CAAC,MAAM,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;QACzE,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAA4B,EAAE,EAAE,CAAC,CAAC,UAAU,GAAG,KAAK,CAAC,CAAC,CAAC;QAC1E,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC;IAC7E,CAAC,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"changed.js","sourceRoot":"","sources":["../src/changed.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -1,6 +1,7 @@
 #!/usr/bin/env node
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
 import { loadDefaultMemoryLimit, loadMaxParallel } from './phpstan.js';
+import { WRITES_ENV_VAR, writesAllowed } from './tools.js';
 import { loadRoots } from './roots.js';
 import { VERSION, createServer } from './server.js';
 async function main() {
@@ -11,7 +12,8 @@ async function main() {
     await server.connect(new StdioServerTransport());
     console.error(`phpstan-mcp ${VERSION} luistert op stdio, ${roots.length} root(s) geconfigureerd` +
         describeMemoryDefault() +
-        describeMaxParallel());
+        describeMaxParallel() +
+        describeWrites());
 }
 /**
  * Zet de standaard geheugenlimiet in de opstartregel, zodat je in het clientlog ziet
@@ -19,6 +21,19 @@ async function main() {
  * kan er verder prima mee door, en analyse() legt het probleem alsnog uit aan wie
  * een analyse aanvraagt.
  */
+/**
+ * Zegt of schrijvende tools meedoen. Ook bij "uit" iets melden zou ruis zijn, maar
+ * een waarde die níet herkend wordt moet je wel zien: die staat er met een bedoeling
+ * en doet niets.
+ */
+function describeWrites() {
+    if (writesAllowed())
+        return ', schrijvende tools aan';
+    const configured = process.env[WRITES_ENV_VAR]?.trim();
+    return configured === undefined || configured === ''
+        ? ''
+        : `, LET OP: ${WRITES_ENV_VAR} staat op "${configured}"; alleen "1" en "true" zetten schrijven aan`;
+}
 /** Zelfde afweging als bij de geheugenlimiet: melden, niet fataal. */
 function describeMaxParallel() {
     try {

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,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEpD,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,CACxB,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,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,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3D,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEpD,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,CACnB,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH;;;;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.d.ts

@@ -45,6 +45,61 @@ export interface AnalyseOptions {
 /** Fout die als bruikbare melding naar het model teruggaat, niet als crash. */
 export declare class PhpstanError extends Error {
 }
+/** Uitkomst van `phpstan diagnose`: PHPStans eigen tekst, ongewijzigd. */
+export interface Diagnosis {
+    readonly project: string;
+    /** De regels zoals PHPStan ze op stdout zet. */
+    readonly output: string;
+}
+/** Uitkomst van het legen van de resultcache. */
+export interface CacheCleared {
+    readonly project: string;
+    /** PHPStans eigen tekst; die noemt de map die geleegd is. */
+    readonly output: string;
+}
+/**
+ * Leegt PHPStans resultcache voor dit project.
+ *
+ * Wél door de queue van dit project: een analyse die tegelijk draait gebruikt
+ * diezelfde cache. Let op dat de cache standaard *niet* in het project ligt maar in
+ * `sys_get_temp_dir()/phpstan`, en dus gedeeld wordt met elk ander project dat geen
+ * eigen `tmpDir` in zijn config zet. PHPStans uitvoer noemt de map, zodat aan het
+ * antwoord te zien is wat er precies geleegd is.
+ */
+export declare function clearResultCache(project: ResolvedProject, options?: Pick<AnalyseOptions, 'config' | 'timeoutMs' | 'signal'>): Promise<CacheCleared>;
+/** Opties voor het genereren van een baseline. */
+export interface GenerateBaselineOptions extends AnalyseOptions {
+    /** Absoluut pad waar de baseline geschreven wordt. */
+    readonly file: string;
+    /** Ook schrijven als er niets te negeren valt. */
+    readonly allowEmpty?: boolean;
+}
+/** Uitkomst van het genereren van een baseline. */
+export interface BaselineGenerated {
+    readonly project: string;
+    readonly file: string;
+    /** Hoeveel fouten er in de baseline gezet zijn. */
+    readonly errors: number;
+    readonly output: string;
+}
+/**
+ * Laat PHPStan een baseline schrijven: alle huidige fouten worden erin gezet, zodat
+ * een volgende analyse alleen meldt wat er nieuw bij komt.
+ *
+ * Dit schrijft een bestand in het project — de enige tool die dat doet, en daarom
+ * alleen bereikbaar als de server met schrijfrechten gestart is.
+ */
+export declare function generateBaseline(project: ResolvedProject, options: GenerateBaselineOptions): Promise<BaselineGenerated>;
+/**
+ * Draait `phpstan diagnose` in één project: PHP- en PHPStan-versie, de configs die
+ * Composer-pakketten meebrengen, en of de turbo-extensie aanstaat. Geen analyse, dus
+ * geen bevindingen — dit is wat je wil weten als een project zich vreemd gedraagt.
+ *
+ * Wel door de semafoor en niet door de queue per project: dit is een PHPStan-proces
+ * dat de machine belast, maar het schrijft geen resultcache waar een analyse
+ * overheen zou kunnen lopen.
+ */
+export declare function diagnose(project: ResolvedProject, options?: Pick<AnalyseOptions, 'timeoutMs' | 'signal'>): Promise<Diagnosis>;
 /**
  * Draait PHPStan in één project en levert de bevindingen.
  *

package/dist/phpstan.js

@@ -20,6 +20,100 @@ const MEMORY_LIMIT_PATTERN = /^(-1|\d+[KMG]?)$/i;
 /** Fout die als bruikbare melding naar het model teruggaat, niet als crash. */
 export class PhpstanError extends Error {
 }
+/**
+ * Leegt PHPStans resultcache voor dit project.
+ *
+ * Wél door de queue van dit project: een analyse die tegelijk draait gebruikt
+ * diezelfde cache. Let op dat de cache standaard *niet* in het project ligt maar in
+ * `sys_get_temp_dir()/phpstan`, en dus gedeeld wordt met elk ander project dat geen
+ * eigen `tmpDir` in zijn config zet. PHPStans uitvoer noemt de map, zodat aan het
+ * antwoord te zien is wat er precies geleegd is.
+ */
+export async function clearResultCache(project, options = {}) {
+    const binary = requireBinary(project);
+    throwIfAborted(project.path, options.signal);
+    return enqueue(project.path, () => withSlot(async () => {
+        throwIfAborted(project.path, options.signal);
+        const args = ['clear-result-cache', '--no-ansi'];
+        if (options.config !== undefined)
+            args.push(`--configuration=${options.config}`);
+        const execution = await execute(binary, args, project.path, options.timeoutMs ?? DEFAULT_TIMEOUT_MS, options.signal);
+        const output = execution.stdout.trim();
+        if (execution.code !== 0 || output === '') {
+            throw new PhpstanError(`PHPStan kon de resultcache van ${project.path} niet legen (exit code ${execution.code ?? '?'}).\n\n` +
+                (execution.stderr.trim() || output || 'Geen output op stdout of stderr.'));
+        }
+        return { project: project.path, output };
+    }));
+}
+/**
+ * Laat PHPStan een baseline schrijven: alle huidige fouten worden erin gezet, zodat
+ * een volgende analyse alleen meldt wat er nieuw bij komt.
+ *
+ * Dit schrijft een bestand in het project — de enige tool die dat doet, en daarom
+ * alleen bereikbaar als de server met schrijfrechten gestart is.
+ */
+export async function generateBaseline(project, options) {
+    const binary = requireBinary(project);
+    throwIfAborted(project.path, options.signal);
+    const installed = { ...project, binary };
+    return enqueue(project.path, () => withSlot(async () => {
+        throwIfAborted(project.path, options.signal);
+        const execution = await execute(binary, buildBaselineArgs(installed, options), project.path, options.timeoutMs ?? DEFAULT_TIMEOUT_MS, options.signal);
+        // Op de tekst afgaan en niet op de exit code, om dezelfde reden als bij een
+        // analyse: PHPStan meldt "niets te schrijven" met exit 1 én met een bruikbare
+        // uitleg erbij, en die uitleg is meer waard dan een eigen foutmelding.
+        const output = (execution.stdout.trim() || execution.stderr.trim()).slice(0, 2000);
+        const match = /Baseline generated with (\d+) error/i.exec(output);
+        if (match === null) {
+            throw new PhpstanError(`PHPStan heeft geen baseline geschreven in ${project.path}.\n\n` +
+                (output === '' ? 'Geen output op stdout of stderr.' : output));
+        }
+        return { project: project.path, file: options.file, errors: Number(match[1]), output };
+    }));
+}
+/** Weigert een project zonder PHPStan met de melding die zegt wat er wél kan. */
+function requireBinary(project) {
+    if (project.binary === null) {
+        throw new PhpstanError(`PHPStan is niet geïnstalleerd in ${project.path} (vendor/bin/phpstan ontbreekt). ` +
+            'Draai daar eerst `composer install`.');
+    }
+    return project.binary;
+}
+/**
+ * Draait `phpstan diagnose` in één project: PHP- en PHPStan-versie, de configs die
+ * Composer-pakketten meebrengen, en of de turbo-extensie aanstaat. Geen analyse, dus
+ * geen bevindingen — dit is wat je wil weten als een project zich vreemd gedraagt.
+ *
+ * Wel door de semafoor en niet door de queue per project: dit is een PHPStan-proces
+ * dat de machine belast, maar het schrijft geen resultcache waar een analyse
+ * overheen zou kunnen lopen.
+ */
+export async function diagnose(project, options = {}) {
+    const binary = requireBinary(project);
+    throwIfAborted(project.path, options.signal);
+    return withSlot(async () => {
+        throwIfAborted(project.path, options.signal);
+        const execution = await execute(binary, ['diagnose', '--no-ansi'], project.path, options.timeoutMs ?? DEFAULT_TIMEOUT_MS, options.signal);
+        if (execution.spawnError !== null) {
+            throw new PhpstanError(`PHPStan kon niet gestart worden in ${project.path}: ${execution.spawnError.message}`);
+        }
+        if (execution.signal !== null) {
+            throw new PhpstanError(execution.reason === 'geannuleerd'
+                ? `De diagnose van ${project.path} is afgebroken omdat het verzoek geannuleerd is.`
+                : `De diagnose van ${project.path} is afgebroken (signaal ${execution.signal}).`);
+        }
+        // diagnose zet zijn rapport op stdout en alleen de configuratieregel op stderr.
+        // Een lege stdout betekent dus dat er iets anders mis is; dan is PHPStans eigen
+        // uitleg bruikbaarder dan een zelfbedachte melding.
+        const output = execution.stdout.trim();
+        if (output === '') {
+            throw new PhpstanError(`PHPStan gaf geen diagnose terug in ${project.path} (exit code ${execution.code ?? '?'}).\n\n` +
+                (execution.stderr.trim() || 'Geen output op stdout of stderr.'));
+        }
+        return { project: project.path, output };
+    });
+}
 /**
  * Draait PHPStan in één project en levert de bevindingen.
  *
@@ -28,13 +122,8 @@ export class PhpstanError extends Error {
  * overheen. Verschillende projecten draaien wél parallel.
  */
 export async function analyse(project, options = {}) {
-    if (project.binary === null) {
-        throw new PhpstanError(`PHPStan is niet geïnstalleerd in ${project.path} (vendor/bin/phpstan ontbreekt). ` +
-            'Draai daar eerst `composer install`.');
-    }
-    // Na de null-check is binary een string; dit maakt dat expliciet zodat run()
-    // er geen cast voor nodig heeft.
-    const installed = { ...project, binary: project.binary };
+    // requireBinary levert de string op, zodat run() er geen cast voor nodig heeft.
+    const installed = { ...project, binary: requireBinary(project) };
     // Vóór de queue: een verzoek dat al afgebroken is hoeft niet eens in de rij.
     throwIfAborted(installed.path, options.signal);
     return enqueue(installed.path, () => withSlot(() => run(installed, options)));
@@ -81,7 +170,33 @@ export function loadDefaultMemoryLimit(env = process.env) {
     return configured;
 }
 function buildArgs(project, options) {
-    const args = ['analyse', '--error-format=json', '--no-progress', '--no-interaction', '--no-ansi'];
+    return [
+        'analyse',
+        '--error-format=json',
+        ...QUIET_FLAGS,
+        ...flags(options),
+        ...targets(project, options),
+    ];
+}
+/**
+ * Dezelfde aanroep, maar met `--generate-baseline` in plaats van een errorformat:
+ * PHPStan schrijft dan een bestand en rapporteert in tekst hoeveel het er waren.
+ */
+function buildBaselineArgs(project, options) {
+    return [
+        'analyse',
+        ...QUIET_FLAGS,
+        `--generate-baseline=${options.file}`,
+        ...(options.allowEmpty === true ? ['--allow-empty-baseline'] : []),
+        ...flags(options),
+        ...targets(project, options),
+    ];
+}
+/** Vlaggen die er altijd bij horen, zodat de uitvoer machineleesbaar blijft. */
+const QUIET_FLAGS = ['--no-progress', '--no-interaction', '--no-ansi'];
+/** De vlaggen die uit de opties komen, in de volgorde die PHPStan zelf aanhoudt. */
+function flags(options) {
+    const args = [];
     // Vóór de rest, zoals PHPStan het zelf ook documenteert: de config bepaalt wat de
     // overige vlaggen overrulen.
     if (options.config !== undefined)
@@ -92,14 +207,17 @@ function buildArgs(project, options) {
     const memoryLimit = options.memoryLimit ?? loadDefaultMemoryLimit();
     if (memoryLimit !== undefined)
         args.push(`--memory-limit=${memoryLimit}`);
+    return args;
+}
+/** De paden die geanalyseerd worden, met de controle die PHPStan zelf niet uitlegt. */
+function targets(project, options) {
     // Zonder config én zonder paden weet PHPStan niet wat het moet doen; dan is een
     // duidelijke melding beter dan PHPStans eigen usage-tekst.
     const paths = options.paths ?? [];
     if (paths.length === 0 && project.config === null) {
         throw new PhpstanError(`${project.path} heeft geen phpstan.neon(.dist). Geef expliciet paths mee, of maak een config aan.`);
     }
-    args.push(...paths);
-    return args;
+    return paths;
 }
 /** Hoe lang een gedode procesgroep de tijd krijgt voordat SIGKILL volgt. */
 const KILL_GRACE_MS = 5_000;
@@ -115,7 +233,19 @@ const KILL_GRACE_MS = 5_000;
 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 });
+        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.
+            env: { ...process.env, PAO_DISABLE: '1' },
+        });
         const stdout = [];
         const stderr = [];
         let spawnError = null;