phpstan-mcp-mx 0.7.1 → 0.9.0

package/dist/tools/shared.js

@@ -0,0 +1,219 @@
+import { z } from 'zod';
+import { BaselineError, describeIncludedBaseline } from '../baseline.js';
+import { GitError } from '../changed.js';
+import { PhpstanError, analyse } from '../phpstan.js';
+import { DEFAULT_LIMIT, MAX_LIMIT, buildReport, renderReport } from '../report.js';
+import { ProjectError, resolveProject, resolveWithin } from '../project.js';
+import { TmpDirError } from '../tmpdir.js';
+/**
+ * Nullable veld als `anyOf` in plaats van `type: [..., "null"]`. Zod's `.nullable()`
+ * levert de array-vorm op; die is geldig JSON Schema, maar meerdere MCP-clients
+ * lezen `type` als één string en laten de constraint dan vallen of weigeren de tool.
+ *
+ * Let op de `z.literal(null)`: zod vouwt zowel `.nullable()` als een union met
+ * `z.null()` terug naar diezelfde array-vorm. Alleen de literal levert echt `anyOf`
+ * op (met een overbodige maar onschadelijke `const: null` erbij).
+ */
+export function nullable(schema) {
+    return z.union([schema, z.literal(null)]);
+}
+export const projectArgument = z
+    .string()
+    .describe('Absoluut pad naar de projectroot, zoals list_projects het teruggeeft');
+export const analysisShape = {
+    project: z.string(),
+    totals: z.object({ fileErrors: z.number(), generalErrors: z.number() }),
+    generalErrors: z
+        .array(z.string())
+        .describe('Fouten die niet aan een bestand hangen, zoals een crash of configuratiefout'),
+    warnings: z
+        .array(z.string())
+        .describe('Wat PHPStan naast het resultaat meldde. Staat hier "Result is incomplete", dan ' +
+        'dekt de analyse niet het hele project en is een schone uitslag geen bewijs'),
+    notices: z
+        .array(z.string())
+        .describe('Meldingen van deze server zelf, zoals een baseline die meedoet — dan rapporteert ' +
+        'PHPStan alleen wat er nieuw bij komt'),
+    omitted: z
+        .object({ warnings: z.number(), generalErrors: z.number() })
+        .describe('Hoeveel meldingen weggelaten zijn omdat het er te veel waren'),
+    summary: z
+        .object({
+        filesWithFindings: z.number(),
+        byFile: z.array(z.object({ file: z.string(), count: z.number() })),
+        byIdentifier: z.array(z.object({ identifier: z.string(), count: z.number() })),
+    })
+        .describe('Tellingen over álle bevindingen, ook die buiten deze pagina vallen'),
+    findings: z.array(z.object({
+        file: z.string().describe('Pad relatief aan de projectroot'),
+        line: nullable(z.number()),
+        message: z.string(),
+        identifier: nullable(z.string()),
+        tip: nullable(z.string()),
+    })),
+    page: z
+        .object({
+        offset: z.number(),
+        limit: z.number(),
+        returned: z.number(),
+        total: z.number(),
+        hasMore: z.boolean(),
+    })
+        .describe('Welk deel van de bevindingen dit antwoord bevat'),
+    filter: nullable(z.array(z.string())).describe('Op welke identifiers deze pagina beperkt is, of null als er niet gefilterd is'),
+};
+export const configArgument = z
+    .string()
+    .optional()
+    .describe('Ander configbestand dan PHPStan zelf zou pakken, bijv. "phpstan-strict.neon". ' +
+    'Moet binnen het project liggen');
+export const windowShape = {
+    identifiers: z
+        .array(z.string())
+        .optional()
+        .describe('Beperk de bevindingen tot deze identifiers, bijv. ["argument.type"]. ' +
+        '"missingType" matcht de hele groep. De samenvatting blijft over alles tellen'),
+    offset: z.number().int().min(0).optional().describe('Sla de eerste N bevindingen over'),
+    limit: z
+        .number()
+        .int()
+        .min(1)
+        .max(MAX_LIMIT)
+        .optional()
+        .describe(`Hoeveel bevindingen dit antwoord bevat (standaard ${String(DEFAULT_LIMIT)})`),
+};
+/**
+ * Zet de gedeelde argumenten om in AnalyseOptions. `config` gaat door resolveWithin:
+ * een neon mag `bootstrapFiles` en extensies bevatten, dus een vrij te kiezen
+ * configpad zou anders een route zijn om willekeurige PHP-code te laten uitvoeren —
+ * langs de whitelist heen die `project` juist wél afdwingt.
+ */
+export function common(resolved, args) {
+    return {
+        ...(args.level === undefined ? {} : { level: args.level }),
+        ...(args.config === undefined ? {} : { config: resolveWithin(resolved, args.config) }),
+        ...(args.memoryLimit === undefined ? {} : { memoryLimit: args.memoryLimit }),
+        ...(args.timeoutSeconds === undefined ? {} : { timeoutMs: args.timeoutSeconds * 1000 }),
+    };
+}
+/** Zet de venster-argumenten van een tool om in een Window voor het rapport. */
+export function window(args) {
+    return {
+        offset: args.offset,
+        limit: args.limit,
+        ...(args.identifiers === undefined ? {} : { identifiers: args.identifiers }),
+    };
+}
+/**
+ * Stuurt een logmelding naar de client. Faalt bewust stil: een client die
+ * halverwege wegvalt of geen logging wil, mag een lopende analyse niet omleggen.
+ * Dit staat naast de opstartregel op stderr — die is voor de mens die het
+ * clientlog opent, dit is voor de client zelf.
+ */
+function log(server, level, data) {
+    void server.server.sendLoggingMessage({ level, logger: 'phpstan-mcp', data }).catch(() => undefined);
+}
+/**
+ * Resolvet het project één keer en geeft het aan `plan`, zodat een tool die zelf nog
+ * paden binnen dat project moet valideren dat op hetzelfde geresolvede project doet.
+ * Eerder resolveerde analyse_file het project en deed runAnalysis dat daarna nog
+ * een keer.
+ */
+export async function runAnalysis(server, roots, project, plan, window, signal) {
+    const begin = Date.now();
+    try {
+        const resolved = resolveProject(project, roots);
+        const chosen = await plan(resolved);
+        if ('nothingToDo' in chosen) {
+            // Toch het volledige rapportschema teruggeven: een client die op
+            // structuredContent vertrouwt moet niet ineens een ander soort antwoord
+            // krijgen omdat er niets te doen was.
+            const empty = buildReport({
+                project: resolved.path,
+                findings: [],
+                generalErrors: [],
+                warnings: [],
+                totals: { fileErrors: 0, generalErrors: 0 },
+            }, {});
+            return {
+                content: [{ type: 'text', text: chosen.nothingToDo }],
+                structuredContent: { ...empty },
+            };
+        }
+        // Het signaal komt uit het MCP-verzoek zelf: annuleert de client, dan wordt de
+        // procesgroep opgeruimd in plaats van dat PHPStan doorrekent voor niemand.
+        log(server, 'debug', { gebeurtenis: 'analyse gestart', project: resolved.path });
+        const result = await analyse(resolved, {
+            ...chosen.options,
+            ...(signal === undefined ? {} : { signal }),
+        });
+        log(server, 'info', {
+            gebeurtenis: 'analyse klaar',
+            project: resolved.path,
+            bevindingen: result.totals.fileErrors,
+            waarschuwingen: result.warnings.length,
+            duurMs: Date.now() - begin,
+        });
+        const report = buildReport(result, window, collectNotices(resolved));
+        const heading = chosen.heading === undefined ? '' : `${chosen.heading}\n\n`;
+        return {
+            content: [{ type: 'text', text: heading + renderReport(report) }],
+            structuredContent: { ...report },
+        };
+    }
+    catch (error) {
+        return toFailure(error);
+    }
+}
+/**
+ * Wat deze server zelf bij een analyse te melden heeft. Nu alleen de baseline: doet
+ * die mee, dan rapporteert PHPStan alleen wat er nieuw bij komt, en dan is een
+ * schone uitslag geen schone code. Dat staat in de toolbeschrijving, maar niet in
+ * het antwoord waar het model naar kijkt.
+ */
+function collectNotices(project) {
+    const baseline = describeIncludedBaseline(project);
+    return baseline === null ? [] : [baseline];
+}
+/**
+ * Analyseren verandert de broncode niet. PHPStan schrijft wel zijn resultcache weg,
+ * maar dat is geen wijziging waar de gebruiker iets van merkt.
+ */
+export function readOnly() {
+    return { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false };
+}
+/**
+ * Verandert wel iets, maar niet aan de broncode. `idempotentHint` staat aan omdat
+ * twee keer legen hetzelfde oplevert; `destructiveHint` omdat er data weggaat die
+ * PHPStan daarna opnieuw moet opbouwen.
+ */
+export function clears() {
+    return { readOnlyHint: false, destructiveHint: true, idempotentHint: true, openWorldHint: false };
+}
+/**
+ * Schrijft een bestand in het project. Niet idempotent: draai je het opnieuw nadat
+ * er fouten bij zijn gekomen, dan staat er iets anders in.
+ */
+export function writes() {
+    return { readOnlyHint: false, destructiveHint: true, idempotentHint: false, openWorldHint: false };
+}
+/**
+ * Zet een fout die het model kan opvangen om in een tool-resultaat met `isError`.
+ * Alles wat hier niet in de lijst staat slaat door naar de SDK: dat is een bug in
+ * deze server en geen situatie waar het model iets mee kan.
+ */
+export function toFailure(error) {
+    if (error instanceof ProjectError ||
+        error instanceof PhpstanError ||
+        error instanceof BaselineError ||
+        error instanceof GitError ||
+        error instanceof TmpDirError) {
+        return failure(error.message);
+    }
+    throw error;
+}
+/** Een tool-antwoord dat als mislukt geldt, met alleen tekst erin. */
+export function failure(text) {
+    return { isError: true, content: [{ type: 'text', text }] };
+}
+//# sourceMappingURL=shared.js.map

package/dist/tools/shared.js.map

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

package/dist/tools/writes.d.ts

@@ -0,0 +1,17 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { Root } from '../roots.js';
+/** Env-variabele die schrijvende tools vrijgeeft. */
+export declare const WRITES_ENV_VAR = "PHPSTAN_MCP_ALLOW_WRITES";
+/**
+ * Of schrijvende tools geregistreerd mogen worden. Alleen "1" en "true" tellen; al
+ * het andere staat uit. Dat faalt de veilige kant op: een typfout laat schrijven
+ * uit, en de opstartregel zegt wat er geldt.
+ *
+ * Niet registreren en niet weigeren-bij-de-aanroep: een tool die bestaat maar altijd
+ * nee zegt, kost het model een ronde en context om dat te ontdekken.
+ */
+export declare function writesAllowed(env?: NodeJS.ProcessEnv): boolean;
+/** Hangt `clear_result_cache` aan de server. Verandert wel iets, maar niet aan de broncode. */
+export declare function registerClearResultCache(server: McpServer, roots: Root[]): void;
+/** Hangt `generate_baseline` aan de server. Alleen aanroepen als schrijven aanstaat. */
+export declare function registerGenerateBaseline(server: McpServer, roots: Root[]): void;

package/dist/tools/writes.js

@@ -0,0 +1,122 @@
+import { z } from 'zod';
+import { clearResultCache, generateBaseline } from '../phpstan.js';
+import { displayPath } from '../report.js';
+import { resolveNewWithin, resolveProject, resolveWithin } from '../project.js';
+import { clears, common, configArgument, projectArgument, toFailure, writes } from './shared.js';
+/** Env-variabele die schrijvende tools vrijgeeft. */
+export const WRITES_ENV_VAR = 'PHPSTAN_MCP_ALLOW_WRITES';
+/**
+ * Of schrijvende tools geregistreerd mogen worden. Alleen "1" en "true" tellen; al
+ * het andere staat uit. Dat faalt de veilige kant op: een typfout laat schrijven
+ * uit, en de opstartregel zegt wat er geldt.
+ *
+ * Niet registreren en niet weigeren-bij-de-aanroep: een tool die bestaat maar altijd
+ * nee zegt, kost het model een ronde en context om dat te ontdekken.
+ */
+export function writesAllowed(env = process.env) {
+    const configured = env[WRITES_ENV_VAR]?.trim().toLowerCase();
+    return configured === '1' || configured === 'true';
+}
+/** Hangt `clear_result_cache` aan de server. Verandert wel iets, maar niet aan de broncode. */
+export function registerClearResultCache(server, roots) {
+    server.registerTool('clear_result_cache', {
+        title: 'Resultcache legen',
+        description: 'Leegt PHPStans resultcache, zodat de volgende analyse alles opnieuw doorrekent. ' +
+            'Gebruik dit als een uitslag niet klopt met de code — bijvoorbeeld na een wijziging ' +
+            'aan een extensie of een geïncludeerde config. Let op: die cache ligt standaard niet ' +
+            'in het project maar in de tijdelijke map van het systeem, en wordt dan gedeeld met ' +
+            'elk ander project dat geen eigen tmpDir zet. Het antwoord noemt de map die geleegd is.',
+        inputSchema: {
+            project: projectArgument,
+            config: configArgument,
+            timeoutSeconds: z.number().int().positive().max(1800).optional(),
+        },
+        outputSchema: { project: z.string(), output: z.string() },
+        annotations: clears(),
+    }, async (args, extra) => {
+        try {
+            const resolved = resolveProject(args.project, roots);
+            const cleared = await clearResultCache(resolved, {
+                ...(args.config === undefined ? {} : { config: resolveWithin(resolved, args.config) }),
+                ...(args.timeoutSeconds === undefined ? {} : { timeoutMs: args.timeoutSeconds * 1000 }),
+                signal: extra.signal,
+            });
+            return {
+                content: [{ type: 'text', text: cleared.output }],
+                structuredContent: { ...cleared },
+            };
+        }
+        catch (error) {
+            return toFailure(error);
+        }
+    });
+}
+/** Standaardnaam, dezelfde die PHPStan zelf gebruikt. */
+const DEFAULT_BASELINE = 'phpstan-baseline.neon';
+/** Hangt `generate_baseline` aan de server. Alleen aanroepen als schrijven aanstaat. */
+export function registerGenerateBaseline(server, roots) {
+    server.registerTool('generate_baseline', {
+        title: 'Baseline genereren',
+        description: 'Zet alle huidige fouten in een baseline-bestand, 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: wat hierin komt, wordt daarna niet meer ' +
+            'gemeld. Overschrijft een bestaande baseline. Het bestand moet nog wel in de config ' +
+            'geïncludeerd worden voordat het effect heeft.',
+        inputSchema: {
+            project: projectArgument,
+            file: z
+                .string()
+                .optional()
+                .describe(`Doelbestand binnen het project (standaard ${DEFAULT_BASELINE})`),
+            paths: z.array(z.string()).optional().describe('Paden binnen het project'),
+            level: z.string().optional().describe('Level-override, 0 t/m 10 of "max"'),
+            config: configArgument,
+            allowEmpty: z
+                .boolean()
+                .optional()
+                .describe('Ook schrijven als er niets te negeren valt; anders weigert PHPStan'),
+            memoryLimit: z.string().optional(),
+            timeoutSeconds: z.number().int().positive().max(1800).optional(),
+        },
+        outputSchema: {
+            project: z.string(),
+            file: z.string(),
+            errors: z.number().describe('Hoeveel fouten er in de baseline gezet zijn'),
+            output: z.string(),
+        },
+        annotations: writes(),
+    }, async (args, extra) => {
+        try {
+            const resolved = resolveProject(args.project, roots);
+            const generated = await generateBaseline(resolved, {
+                file: resolveNewWithin(resolved, args.file ?? DEFAULT_BASELINE),
+                ...(args.paths === undefined
+                    ? {}
+                    : { paths: args.paths.map((path) => resolveWithin(resolved, path)) }),
+                ...(args.allowEmpty === undefined ? {} : { allowEmpty: args.allowEmpty }),
+                ...common(resolved, args),
+                signal: extra.signal,
+            });
+            return {
+                content: [{ type: 'text', text: renderGenerated(resolved, generated) }],
+                structuredContent: { ...generated },
+            };
+        }
+        catch (error) {
+            return toFailure(error);
+        }
+    });
+}
+/** De uitkomst plus wat er nog moet gebeuren voordat de baseline iets doet. */
+function renderGenerated(project, generated) {
+    const naam = displayPath(project.path, generated.file);
+    return [
+        `${String(generated.errors)} fout(en) in ${naam} gezet.`,
+        '',
+        `Deze fouten worden vanaf nu niet meer gemeld zodra ${naam} in de configuratie staat:`,
+        '',
+        'includes:',
+        `    - ${naam}`,
+    ].join('\n');
+}
+//# sourceMappingURL=writes.js.map

package/dist/tools/writes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"writes.js","sourceRoot":"","sources":["../../src/tools/writes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACnE,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAGhF,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAEjG,qDAAqD;AACrD,MAAM,CAAC,MAAM,cAAc,GAAG,0BAA0B,CAAC;AAEzD;;;;;;;GAOG;AACH,MAAM,UAAU,aAAa,CAAC,MAAyB,OAAO,CAAC,GAAG;IAChE,MAAM,UAAU,GAAG,GAAG,CAAC,cAAc,CAAC,EAAE,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC7D,OAAO,UAAU,KAAK,GAAG,IAAI,UAAU,KAAK,MAAM,CAAC;AACrD,CAAC;AAED,+FAA+F;AAC/F,MAAM,UAAU,wBAAwB,CAAC,MAAiB,EAAE,KAAa;IACvE,MAAM,CAAC,YAAY,CACjB,oBAAoB,EACpB;QACE,KAAK,EAAE,mBAAmB;QAC1B,WAAW,EACT,kFAAkF;YAClF,qFAAqF;YACrF,sFAAsF;YACtF,qFAAqF;YACrF,wFAAwF;QAC1F,WAAW,EAAE;YACX,OAAO,EAAE,eAAe;YACxB,MAAM,EAAE,cAAc;YACtB,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE;SACjE;QACD,YAAY,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE;QACzD,WAAW,EAAE,MAAM,EAAE;KACtB,EACD,KAAK,EAAE,IAAI,EAAE,KAAK,EAAuB,EAAE;QACzC,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,cAAc,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;YACrD,MAAM,OAAO,GAAG,MAAM,gBAAgB,CAAC,QAAQ,EAAE;gBAC/C,GAAG,CAAC,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;gBACtF,GAAG,CAAC,IAAI,CAAC,cAAc,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,cAAc,GAAG,IAAI,EAAE,CAAC;gBACvF,MAAM,EAAE,KAAK,CAAC,MAAM;aACrB,CAAC,CAAC;YAEH,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC;gBACjD,iBAAiB,EAAE,EAAE,GAAG,OAAO,EAAE;aAClC,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,SAAS,CAAC,KAAK,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC;AAED,yDAAyD;AACzD,MAAM,gBAAgB,GAAG,uBAAuB,CAAC;AAEjD,wFAAwF;AACxF,MAAM,UAAU,wBAAwB,CAAC,MAAiB,EAAE,KAAa;IACvE,MAAM,CAAC,YAAY,CACjB,mBAAmB,EACnB;QACE,KAAK,EAAE,oBAAoB;QAC3B,WAAW,EACT,qFAAqF;YACrF,gFAAgF;YAChF,iFAAiF;YACjF,qFAAqF;YACrF,+CAA+C;QACjD,WAAW,EAAE;YACX,OAAO,EAAE,eAAe;YACxB,IAAI,EAAE,CAAC;iBACJ,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,6CAA6C,gBAAgB,GAAG,CAAC;YAC7E,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,0BAA0B,CAAC;YAC1E,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mCAAmC,CAAC;YAC1E,MAAM,EAAE,cAAc;YACtB,UAAU,EAAE,CAAC;iBACV,OAAO,EAAE;iBACT,QAAQ,EAAE;iBACV,QAAQ,CAAC,oEAAoE,CAAC;YACjF,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YAClC,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE;SACjE;QACD,YAAY,EAAE;YACZ,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;YACnB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;YAChB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,6CAA6C,CAAC;YAC1E,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;SACnB;QACD,WAAW,EAAE,MAAM,EAAE;KACtB,EACD,KAAK,EAAE,IAAI,EAAE,KAAK,EAAuB,EAAE;QACzC,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,cAAc,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;YACrD,MAAM,SAAS,GAAG,MAAM,gBAAgB,CAAC,QAAQ,EAAE;gBACjD,IAAI,EAAE,gBAAgB,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,IAAI,gBAAgB,CAAC;gBAC/D,GAAG,CAAC,IAAI,CAAC,KAAK,KAAK,SAAS;oBAC1B,CAAC,CAAC,EAAE;oBACJ,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,EAAE,CAAC;gBACvE,GAAG,CAAC,IAAI,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC;gBACzE,GAAG,MAAM,CAAC,QAAQ,EAAE,IAAI,CAAC;gBACzB,MAAM,EAAE,KAAK,CAAC,MAAM;aACrB,CAAC,CAAC;YAEH,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,eAAe,CAAC,QAAQ,EAAE,SAAS,CAAC,EAAE,CAAC;gBACvE,iBAAiB,EAAE,EAAE,GAAG,SAAS,EAAE;aACpC,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,SAAS,CAAC,KAAK,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC;AAED,+EAA+E;AAC/E,SAAS,eAAe,CACtB,OAAwB,EACxB,SAA2C;IAE3C,MAAM,IAAI,GAAG,WAAW,CAAC,OAAO,CAAC,IAAI,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC;IACvD,OAAO;QACL,GAAG,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,gBAAgB,IAAI,SAAS;QACxD,EAAE;QACF,sDAAsD,IAAI,4BAA4B;QACtF,EAAE;QACF,WAAW;QACX,SAAS,IAAI,EAAE;KAChB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC"}

package/dist/tools.d.ts

@@ -1,15 +1,4 @@
 import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import type { Root } from './roots.js';
-/** Env-variabele die schrijvende tools vrijgeeft. */
-export declare const WRITES_ENV_VAR = "PHPSTAN_MCP_ALLOW_WRITES";
-/**
- * Of schrijvende tools geregistreerd mogen worden. Alleen "1" en "true" tellen; al
- * het andere staat uit. Dat faalt de veilige kant op: een typfout laat schrijven
- * uit, en de opstartregel zegt wat er geldt.
- *
- * Niet registreren en niet weigeren-bij-de-aanroep: een tool die bestaat maar altijd
- * nee zegt, kost het model een ronde en context om dat te ontdekken.
- */
-export declare function writesAllowed(env?: NodeJS.ProcessEnv): boolean;
 /** Hangt alle tools aan de server. */
 export declare function registerTools(server: McpServer, roots: Root[]): void;