phpstan-mcp-mx 0.1.0

package/dist/phpstan.js.map

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

package/dist/project.d.ts

@@ -0,0 +1,46 @@
+import type { Root } from './roots.js';
+/** Een project dat door de whitelist is gekomen, met wat erin gevonden is. */
+export interface ResolvedProject {
+    /** Geresolvede absolute projectroot. */
+    readonly path: string;
+    /** Absoluut pad naar vendor/bin/phpstan, of null als het niet geïnstalleerd is. */
+    readonly binary: string | null;
+    /** Bestandsnaam van de gevonden config, of null als het project er geen heeft. */
+    readonly config: string | null;
+}
+/** Een project zoals `list_projects` het rapporteert. */
+export interface ProjectSummary {
+    readonly path: string;
+    /** De geconfigureerde root waaronder dit project gevonden is. */
+    readonly root: string;
+    readonly hasPhpstan: boolean;
+    readonly config: string | null;
+}
+/** Fout die als bruikbare melding naar het model teruggaat, niet als crash. */
+export declare class ProjectError extends Error {
+}
+/**
+ * Zet een `project`-argument om in een projectroot die binnen de whitelist valt.
+ * Gooit een ProjectError met een melding die zegt wat er wél mag.
+ */
+export declare function resolveProject(argument: string, roots: Root[]): ResolvedProject;
+/**
+ * Zoekt binnen één projectmap het PHPStan-binary en de configuratie op. Doet geen
+ * whitelist-check; die hoort in resolveProject thuis.
+ */
+export declare function describeProject(path: string): ResolvedProject;
+/**
+ * Zet een pad-argument om in een absoluut pad binnen het project. Accepteert zowel
+ * een pad relatief aan de projectroot als een absoluut pad, want een model dat net
+ * `list_projects` heeft gezien geeft het ene door en een model dat een foutmelding
+ * heeft gelezen het andere.
+ */
+export declare function resolveWithin(project: ResolvedProject, argument: string): string;
+/**
+ * Loopt de roots langs en levert de PHP-projecten die erin liggen.
+ *
+ * Wel recursief, maar streng begrensd: er wordt niet verder gezocht binnen een map
+ * die zélf een project is (anders vind je elk pakket in vendor/ opnieuw), niet in
+ * vendor/, node_modules/ en verborgen mappen, en niet dieper dan MAX_DEPTH.
+ */
+export declare function discoverProjects(roots: Root[]): ProjectSummary[];

package/dist/project.js

@@ -0,0 +1,156 @@
+import { readdirSync, realpathSync, statSync } from 'node:fs';
+import { isAbsolute, join, relative } from 'node:path';
+import { isUsable, ROOTS_ENV_VAR } from './roots.js';
+/** Volgorde waarin PHPStan zelf zijn configuratie zoekt. */
+const CONFIG_NAMES = ['phpstan.neon', 'phpstan.neon.dist'];
+/** Pad naar het PHPStan-binary binnen een project, relatief aan de projectroot. */
+const BINARY_PATH = join('vendor', 'bin', 'phpstan');
+/** Mappen die nooit een PHP-project zijn en die we bij het zoeken overslaan. */
+const SKIP_DIRS = new Set(['vendor', 'node_modules', 'storage', 'public']);
+/** Fout die als bruikbare melding naar het model teruggaat, niet als crash. */
+export class ProjectError extends Error {
+}
+/**
+ * Zet een `project`-argument om in een projectroot die binnen de whitelist valt.
+ * Gooit een ProjectError met een melding die zegt wat er wél mag.
+ */
+export function resolveProject(argument, roots) {
+    const usable = roots.filter(isUsable);
+    if (usable.length === 0) {
+        throw new ProjectError(`Deze server heeft geen bruikbare projectmappen. Zet ${ROOTS_ENV_VAR} in de ` +
+            'configuratie van de MCP-server op de absolute paden die geanalyseerd mogen worden.');
+    }
+    if (!isAbsolute(argument)) {
+        throw new ProjectError(`"${argument}" is geen absoluut pad. Geef het volledige pad naar de projectmap.`);
+    }
+    let path;
+    try {
+        path = realpathSync.native(argument);
+        if (!statSync(path).isDirectory()) {
+            throw new ProjectError(`"${argument}" is geen map.`);
+        }
+    }
+    catch (error) {
+        if (error instanceof ProjectError)
+            throw error;
+        throw new ProjectError(`"${argument}" bestaat niet.`);
+    }
+    // De containment-check draait op het geresolvede pad, ná realpath: anders komt
+    // een ".."-pad of een symlink naar buiten de whitelist er alsnog doorheen.
+    if (!usable.some((root) => contains(root.path, path))) {
+        const allowed = usable.map((root) => `  - ${root.path}`).join('\n');
+        throw new ProjectError(`"${path}" valt buiten de toegestane projectmappen. Toegestaan is alles onder:\n${allowed}`);
+    }
+    return describeProject(path);
+}
+/**
+ * Zoekt binnen één projectmap het PHPStan-binary en de configuratie op. Doet geen
+ * whitelist-check; die hoort in resolveProject thuis.
+ */
+export function describeProject(path) {
+    const binary = join(path, BINARY_PATH);
+    return {
+        path,
+        binary: isFile(binary) ? binary : null,
+        config: CONFIG_NAMES.find((name) => isFile(join(path, name))) ?? null,
+    };
+}
+/**
+ * Zet een pad-argument om in een absoluut pad binnen het project. Accepteert zowel
+ * een pad relatief aan de projectroot als een absoluut pad, want een model dat net
+ * `list_projects` heeft gezien geeft het ene door en een model dat een foutmelding
+ * heeft gelezen het andere.
+ */
+export function resolveWithin(project, argument) {
+    if (argument.trim() === '') {
+        throw new ProjectError('Geef een pad binnen het project op.');
+    }
+    const candidate = isAbsolute(argument) ? argument : join(project.path, argument);
+    let path;
+    try {
+        path = realpathSync.native(candidate);
+    }
+    catch {
+        throw new ProjectError(`"${argument}" bestaat niet in ${project.path}.`);
+    }
+    // Dezelfde volgorde als in resolveProject: pas ná realpath vergelijken, anders
+    // glipt een ".."-pad of een symlink er alsnog doorheen.
+    if (!contains(project.path, path)) {
+        throw new ProjectError(`"${argument}" ligt buiten het project ${project.path}.`);
+    }
+    return path;
+}
+/**
+ * Hoe diep er onder een root gezocht wordt. Twee is niet genoeg: een indeling als
+ * ~/projecten/<groep>/<project> zit al op niveau twee, en dan is er geen ruimte
+ * meer voor een tussenmap. Vier geeft die ruimte zonder dat het zoeken ontspoort.
+ */
+const MAX_DEPTH = 4;
+/**
+ * Loopt de roots langs en levert de PHP-projecten die erin liggen.
+ *
+ * Wel recursief, maar streng begrensd: er wordt niet verder gezocht binnen een map
+ * die zélf een project is (anders vind je elk pakket in vendor/ opnieuw), niet in
+ * vendor/, node_modules/ en verborgen mappen, en niet dieper dan MAX_DEPTH.
+ */
+export function discoverProjects(roots) {
+    const projects = [];
+    for (const root of roots) {
+        if (root.path === null)
+            continue;
+        collectProjects(root.path, root.path, 0, projects);
+    }
+    return projects;
+}
+function collectProjects(path, root, depth, found) {
+    if (isProjectDir(path)) {
+        found.push(summarise(path, root));
+        return;
+    }
+    if (depth >= MAX_DEPTH)
+        return;
+    for (const child of childDirectories(path)) {
+        collectProjects(child, root, depth + 1, found);
+    }
+}
+function summarise(path, root) {
+    const { binary, config } = describeProject(path);
+    return { path, root, hasPhpstan: binary !== null, config };
+}
+/** Een map telt als PHP-project zodra er een composer.json in staat. */
+function isProjectDir(path) {
+    return isFile(join(path, 'composer.json'));
+}
+function childDirectories(path) {
+    try {
+        // isDirectory() is false voor een symlink, dus symlinks worden niet gevolgd.
+        // Bewust: een root uitlezen mag nooit buiten die root uitkomen. Een project
+        // dat via een symlink in een root hangt is nog steeds analyseerbaar — het pad
+        // moet dan alleen expliciet aan resolveProject meegegeven worden.
+        return readdirSync(path, { withFileTypes: true })
+            .filter((entry) => entry.isDirectory() && !entry.name.startsWith('.') && !SKIP_DIRS.has(entry.name))
+            .map((entry) => join(path, entry.name));
+    }
+    catch {
+        return [];
+    }
+}
+function isFile(path) {
+    try {
+        return statSync(path).isFile();
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Of `child` binnen `parent` valt. Via path.relative en niet via startsWith,
+ * want "/a/foobar" begint óók met "/a/foo".
+ */
+function contains(parent, child) {
+    if (parent === child)
+        return true;
+    const rel = relative(parent, child);
+    return rel !== '' && !rel.startsWith('..') && !isAbsolute(rel);
+}
+//# sourceMappingURL=project.js.map

package/dist/project.js.map

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

package/dist/report.d.ts

@@ -0,0 +1,58 @@
+import type { AnalysisResult, Finding } from './phpstan.js';
+/** Standaard aantal bevindingen per tool-aanroep. */
+export declare const DEFAULT_LIMIT = 50;
+/** Bovengrens, zodat één aanroep de context niet alsnog kan vullen. */
+export declare const MAX_LIMIT = 500;
+/** Een bevinding zoals ze naar buiten gaat: pad relatief waar dat kan. */
+export interface DisplayFinding extends Omit<Finding, 'file'> {
+    readonly file: string;
+}
+/** Welk deel van de bevindingen dit antwoord bevat. */
+export interface Page {
+    readonly offset: number;
+    readonly limit: number;
+    readonly returned: number;
+    readonly total: number;
+    readonly hasMore: boolean;
+}
+/** Tellingen over álle bevindingen, ook die buiten deze pagina vallen. */
+export interface Summary {
+    readonly filesWithFindings: number;
+    readonly byFile: readonly {
+        file: string;
+        count: number;
+    }[];
+    readonly byIdentifier: readonly {
+        identifier: string;
+        count: number;
+    }[];
+}
+/** Het volledige antwoord van een analyse-tool. */
+export interface Report {
+    readonly project: string;
+    readonly totals: AnalysisResult['totals'];
+    readonly generalErrors: readonly string[];
+    readonly summary: Summary;
+    readonly findings: readonly DisplayFinding[];
+    readonly page: Page;
+}
+/** Waar in de bevindingenlijst dit antwoord begint en hoe lang het is. */
+export interface Window {
+    readonly offset?: number | undefined;
+    readonly limit?: number | undefined;
+}
+/**
+ * Zet een analyse om in het antwoord dat de tool teruggeeft: tellingen over alles,
+ * en maar één pagina bevindingen. De samenvatting rekent bewust over de volledige
+ * lijst — anders zou de tweede pagina andere totalen melden dan de eerste.
+ */
+export declare function buildReport(result: AnalysisResult, window?: Window): Report;
+/** Schrijft een rapport uit als tekst voor het model. */
+export declare function renderReport(report: Report): string;
+/**
+ * Pad zoals het aan het model getoond wordt: relatief aan de projectroot, tenzij
+ * het bestand daarbuiten ligt. PHPStan rapporteert ook fouten in vendor/ of in
+ * paden die van buiten de root geïncludeerd zijn, en een reeks ../../.. is daar
+ * onleesbaarder dan gewoon het absolute pad.
+ */
+export declare function displayPath(project: string, file: string): string;

package/dist/report.js

@@ -0,0 +1,111 @@
+import { isAbsolute, relative } from 'node:path';
+/** Standaard aantal bevindingen per tool-aanroep. */
+export const DEFAULT_LIMIT = 50;
+/** Bovengrens, zodat één aanroep de context niet alsnog kan vullen. */
+export const MAX_LIMIT = 500;
+/** Hoeveel regels de samenvattingslijsten hoogstens tonen. */
+const SUMMARY_ROWS = 15;
+/**
+ * Zet een analyse om in het antwoord dat de tool teruggeeft: tellingen over alles,
+ * en maar één pagina bevindingen. De samenvatting rekent bewust over de volledige
+ * lijst — anders zou de tweede pagina andere totalen melden dan de eerste.
+ */
+export function buildReport(result, window = {}) {
+    const all = result.findings.map((finding) => ({
+        ...finding,
+        file: displayPath(result.project, finding.file),
+    }));
+    const limit = clamp(window.limit ?? DEFAULT_LIMIT, 1, MAX_LIMIT);
+    const offset = clamp(window.offset ?? 0, 0, Math.max(all.length, 0));
+    const findings = all.slice(offset, offset + limit);
+    return {
+        project: result.project,
+        totals: result.totals,
+        generalErrors: result.generalErrors,
+        summary: summarise(all),
+        findings,
+        page: {
+            offset,
+            limit,
+            returned: findings.length,
+            total: all.length,
+            hasMore: offset + findings.length < all.length,
+        },
+    };
+}
+/** Schrijft een rapport uit als tekst voor het model. */
+export function renderReport(report) {
+    const lines = [];
+    if (report.generalErrors.length > 0) {
+        lines.push('Fouten buiten de bestanden om:');
+        for (const error of report.generalErrors)
+            lines.push(`- ${error}`);
+        lines.push('');
+    }
+    if (report.page.total === 0) {
+        lines.push(report.generalErrors.length === 0 ? 'Geen bevindingen.' : 'Verder geen bevindingen.');
+        return lines.join('\n');
+    }
+    lines.push(`${report.page.total} bevinding(en) in ${report.summary.filesWithFindings} bestand(en).`, '', 'Meest voorkomend:', ...report.summary.byIdentifier.map((row) => `  ${pad(row.count)}  ${row.identifier}`));
+    if (report.summary.byFile.length > 1) {
+        lines.push('', 'Zwaarst getroffen bestanden:', ...report.summary.byFile.map((row) => `  ${pad(row.count)}  ${row.file}`));
+    }
+    const from = report.page.offset + 1;
+    const to = report.page.offset + report.page.returned;
+    lines.push('', `Bevindingen ${from}-${to} van ${report.page.total}:`);
+    let current = null;
+    for (const finding of report.findings) {
+        if (finding.file !== current) {
+            current = finding.file;
+            lines.push('', current);
+        }
+        const where = finding.line === null ? '   ?' : String(finding.line).padStart(4);
+        lines.push(`${where}  ${finding.identifier ?? '-'}  ${finding.message}`);
+        if (finding.tip !== null)
+            lines.push(`      tip: ${finding.tip}`);
+    }
+    if (report.page.hasMore) {
+        lines.push('', `Nog ${report.page.total - to} bevinding(en). Roep dezelfde tool opnieuw aan met ` +
+            `offset=${to} voor de rest.`);
+    }
+    return lines.join('\n');
+}
+function summarise(findings) {
+    const perFile = new Map();
+    const perIdentifier = new Map();
+    for (const finding of findings) {
+        perFile.set(finding.file, (perFile.get(finding.file) ?? 0) + 1);
+        const identifier = finding.identifier ?? '(zonder identifier)';
+        perIdentifier.set(identifier, (perIdentifier.get(identifier) ?? 0) + 1);
+    }
+    return {
+        filesWithFindings: perFile.size,
+        byFile: topRows(perFile).map(([file, count]) => ({ file, count })),
+        byIdentifier: topRows(perIdentifier).map(([identifier, count]) => ({ identifier, count })),
+    };
+}
+/** De drukste regels eerst, bij gelijk aantal alfabetisch zodat de volgorde vastligt. */
+function topRows(counts) {
+    return [...counts.entries()]
+        .sort((a, b) => b[1] - a[1] || a[0].localeCompare(b[0]))
+        .slice(0, SUMMARY_ROWS);
+}
+/**
+ * Pad zoals het aan het model getoond wordt: relatief aan de projectroot, tenzij
+ * het bestand daarbuiten ligt. PHPStan rapporteert ook fouten in vendor/ of in
+ * paden die van buiten de root geïncludeerd zijn, en een reeks ../../.. is daar
+ * onleesbaarder dan gewoon het absolute pad.
+ */
+export function displayPath(project, file) {
+    const rel = relative(project, file);
+    if (rel === '' || rel.startsWith('..') || isAbsolute(rel))
+        return file;
+    return rel;
+}
+function clamp(value, low, high) {
+    return Math.min(Math.max(Math.trunc(value), low), high);
+}
+function pad(count) {
+    return String(count).padStart(4);
+}
+//# sourceMappingURL=report.js.map

package/dist/report.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"report.js","sourceRoot":"","sources":["../src/report.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAGjD,qDAAqD;AACrD,MAAM,CAAC,MAAM,aAAa,GAAG,EAAE,CAAC;AAEhC,uEAAuE;AACvE,MAAM,CAAC,MAAM,SAAS,GAAG,GAAG,CAAC;AAE7B,8DAA8D;AAC9D,MAAM,YAAY,GAAG,EAAE,CAAC;AAuCxB;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,MAAsB,EAAE,SAAiB,EAAE;IACrE,MAAM,GAAG,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QAC5C,GAAG,OAAO;QACV,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC;KAChD,CAAC,CAAC,CAAC;IAEJ,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,KAAK,IAAI,aAAa,EAAE,CAAC,EAAE,SAAS,CAAC,CAAC;IACjE,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC;IACrE,MAAM,QAAQ,GAAG,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,KAAK,CAAC,CAAC;IAEnD,OAAO;QACL,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,aAAa,EAAE,MAAM,CAAC,aAAa;QACnC,OAAO,EAAE,SAAS,CAAC,GAAG,CAAC;QACvB,QAAQ;QACR,IAAI,EAAE;YACJ,MAAM;YACN,KAAK;YACL,QAAQ,EAAE,QAAQ,CAAC,MAAM;YACzB,KAAK,EAAE,GAAG,CAAC,MAAM;YACjB,OAAO,EAAE,MAAM,GAAG,QAAQ,CAAC,MAAM,GAAG,GAAG,CAAC,MAAM;SAC/C;KACF,CAAC;AACJ,CAAC;AAED,yDAAyD;AACzD,MAAM,UAAU,YAAY,CAAC,MAAc;IACzC,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,IAAI,MAAM,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACpC,KAAK,CAAC,IAAI,CAAC,gCAAgC,CAAC,CAAC;QAC7C,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,aAAa;YAAE,KAAK,CAAC,IAAI,CAAC,KAAK,KAAK,EAAE,CAAC,CAAC;QACnE,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,KAAK,CAAC,EAAE,CAAC;QAC5B,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,0BAA0B,CAAC,CAAC;QACjG,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED,KAAK,CAAC,IAAI,CACR,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,qBAAqB,MAAM,CAAC,OAAO,CAAC,iBAAiB,eAAe,EACxF,EAAE,EACF,mBAAmB,EACnB,GAAG,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,KAAK,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,UAAU,EAAE,CAAC,CACtF,CAAC;IAEF,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrC,KAAK,CAAC,IAAI,CACR,EAAE,EACF,8BAA8B,EAC9B,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,KAAK,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,IAAI,EAAE,CAAC,CAC1E,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;IACpC,MAAM,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC;IACrD,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,eAAe,IAAI,IAAI,EAAE,QAAQ,MAAM,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC;IAEtE,IAAI,OAAO,GAAkB,IAAI,CAAC;IAClC,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QACtC,IAAI,OAAO,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;YAC7B,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;YACvB,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;QAC1B,CAAC;QACD,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;QAChF,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,KAAK,OAAO,CAAC,UAAU,IAAI,GAAG,KAAK,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;QACzE,IAAI,OAAO,CAAC,GAAG,KAAK,IAAI;YAAE,KAAK,CAAC,IAAI,CAAC,cAAc,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IACpE,CAAC;IAED,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;QACxB,KAAK,CAAC,IAAI,CACR,EAAE,EACF,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,GAAG,EAAE,qDAAqD;YAChF,UAAU,EAAE,gBAAgB,CAC/B,CAAC;IACJ,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,SAAS,SAAS,CAAC,QAAmC;IACpD,MAAM,OAAO,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC1C,MAAM,aAAa,GAAG,IAAI,GAAG,EAAkB,CAAC;IAEhD,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QAChE,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,qBAAqB,CAAC;QAC/D,aAAa,CAAC,GAAG,CAAC,UAAU,EAAE,CAAC,aAAa,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1E,CAAC;IAED,OAAO;QACL,iBAAiB,EAAE,OAAO,CAAC,IAAI;QAC/B,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QAClE,YAAY,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,UAAU,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAC;KAC3F,CAAC;AACJ,CAAC;AAED,yFAAyF;AACzF,SAAS,OAAO,CAAC,MAA2B;IAC1C,OAAO,CAAC,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC;SACzB,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;SACvD,KAAK,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC;AAC5B,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,OAAe,EAAE,IAAY;IACvD,MAAM,GAAG,GAAG,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IACpC,IAAI,GAAG,KAAK,EAAE,IAAI,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IACvE,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,KAAK,CAAC,KAAa,EAAE,GAAW,EAAE,IAAY;IACrD,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,EAAE,IAAI,CAAC,CAAC;AAC1D,CAAC;AAED,SAAS,GAAG,CAAC,KAAa;IACxB,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;AACnC,CAAC"}

package/dist/roots.d.ts

@@ -0,0 +1,23 @@
+/** Env-variabele met de projectmappen die deze server mag analyseren. */
+export declare const ROOTS_ENV_VAR = "PHPSTAN_MCP_ROOTS";
+/** Eén geconfigureerde root, na normalisatie. */
+export interface Root {
+    /** Zoals opgegeven in de env-variabele, ongewijzigd — voor foutmeldingen. */
+    readonly raw: string;
+    /** Het volledig geresolvede pad, of null als de root onbruikbaar is. */
+    readonly path: string | null;
+    /** Waarom de root onbruikbaar is, of null als er niets mis is. */
+    readonly problem: string | null;
+}
+/**
+ * Leest de toegestane roots uit de omgeving. Onbruikbare regels worden niet
+ * stilzwijgend genegeerd maar meegegeven met een reden, zodat `list_projects`
+ * kan uitleggen waarom een verwacht project ontbreekt.
+ */
+export declare function loadRoots(env?: NodeJS.ProcessEnv): Root[];
+/** Een root waarvan het pad geresolvet is en die dus daadwerkelijk bruikbaar is. */
+export type UsableRoot = Root & {
+    path: string;
+};
+/** Type-guard zodat `roots.filter(isUsable)` het null-pad wegneemt. */
+export declare function isUsable(root: Root): root is UsableRoot;

package/dist/roots.js

@@ -0,0 +1,55 @@
+import { realpathSync, statSync } from 'node:fs';
+import { delimiter, isAbsolute } from 'node:path';
+/** Env-variabele met de projectmappen die deze server mag analyseren. */
+export const ROOTS_ENV_VAR = 'PHPSTAN_MCP_ROOTS';
+/**
+ * Leest de toegestane roots uit de omgeving. Onbruikbare regels worden niet
+ * stilzwijgend genegeerd maar meegegeven met een reden, zodat `list_projects`
+ * kan uitleggen waarom een verwacht project ontbreekt.
+ */
+export function loadRoots(env = process.env) {
+    const configured = env[ROOTS_ENV_VAR];
+    if (configured === undefined || configured.trim() === '')
+        return [];
+    const roots = [];
+    const seen = new Set();
+    // path.delimiter in plaats van een harde ':' — op Windows is dat ';', en een
+    // Windows-pad bevat zelf een dubbele punt na de driveletter.
+    for (const entry of configured.split(delimiter)) {
+        const raw = entry.trim();
+        if (raw === '')
+            continue;
+        const root = inspectRoot(raw);
+        // Dedupliceren op het geresolvede pad: twee verschillende regels kunnen via
+        // een symlink dezelfde map zijn.
+        const key = root.path ?? `raw:${raw}`;
+        if (seen.has(key))
+            continue;
+        seen.add(key);
+        roots.push(root);
+    }
+    return roots;
+}
+function inspectRoot(raw) {
+    if (!isAbsolute(raw)) {
+        return { raw, path: null, problem: 'geen absoluut pad' };
+    }
+    try {
+        // realpathSync.native en niet de JS-variant: alleen de native versie
+        // corrigeert ook de hoofdlettervorm op een case-insensitive volume (macOS),
+        // en die vorm moet kloppen omdat de containment-check erop vergelijkt.
+        const path = realpathSync.native(raw);
+        if (!statSync(path).isDirectory()) {
+            return { raw, path: null, problem: 'is geen map' };
+        }
+        return { raw, path, problem: null };
+    }
+    catch {
+        return { raw, path: null, problem: 'bestaat niet' };
+    }
+}
+/** Type-guard zodat `roots.filter(isUsable)` het null-pad wegneemt. */
+export function isUsable(root) {
+    return root.path !== null;
+}
+//# sourceMappingURL=roots.js.map

package/dist/roots.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"roots.js","sourceRoot":"","sources":["../src/roots.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACjD,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAElD,yEAAyE;AACzE,MAAM,CAAC,MAAM,aAAa,GAAG,mBAAmB,CAAC;AAYjD;;;;GAIG;AACH,MAAM,UAAU,SAAS,CAAC,MAAyB,OAAO,CAAC,GAAG;IAC5D,MAAM,UAAU,GAAG,GAAG,CAAC,aAAa,CAAC,CAAC;IACtC,IAAI,UAAU,KAAK,SAAS,IAAI,UAAU,CAAC,IAAI,EAAE,KAAK,EAAE;QAAE,OAAO,EAAE,CAAC;IAEpE,MAAM,KAAK,GAAW,EAAE,CAAC;IACzB,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAE/B,6EAA6E;IAC7E,6DAA6D;IAC7D,KAAK,MAAM,KAAK,IAAI,UAAU,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC;QAChD,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;QACzB,IAAI,GAAG,KAAK,EAAE;YAAE,SAAS;QAEzB,MAAM,IAAI,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;QAC9B,4EAA4E;QAC5E,iCAAiC;QACjC,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,IAAI,OAAO,GAAG,EAAE,CAAC;QACtC,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,SAAS;QAC5B,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAEd,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACnB,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,WAAW,CAAC,GAAW;IAC9B,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACrB,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,mBAAmB,EAAE,CAAC;IAC3D,CAAC;IAED,IAAI,CAAC;QACH,qEAAqE;QACrE,4EAA4E;QAC5E,uEAAuE;QACvE,MAAM,IAAI,GAAG,YAAY,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACtC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC;YAClC,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,aAAa,EAAE,CAAC;QACrD,CAAC;QACD,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IACtC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,cAAc,EAAE,CAAC;IACtD,CAAC;AACH,CAAC;AAKD,uEAAuE;AACvE,MAAM,UAAU,QAAQ,CAAC,IAAU;IACjC,OAAO,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC;AAC5B,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,18 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { Root } from './roots.js';
+/**
+ * Versie van de server zoals gemeld in de MCP-handshake. Spiegelt `version` in
+ * package.json; die kan hier niet zomaar geïmporteerd worden, want een JSON-import
+ * verhuist bij het bouwen mee naar dist/ en wijst dan naar het verkeerde bestand.
+ */
+export declare const VERSION = "0.1.0";
+/**
+ * Bouwt de MCP-server met de tools die op deze set roots van toepassing zijn.
+ * De roots worden één keer bij het opstarten ingelezen: ze komen uit de
+ * serverconfiguratie, niet uit een tool-argument, en horen dus niet per aanroep
+ * te kunnen wijzigen.
+ *
+ * Staat bewust los van index.ts: dat bestand start bij import meteen de server,
+ * en een test die alleen de tools wil aanspreken moet dat niet in gang zetten.
+ */
+export declare function createServer(roots: Root[]): McpServer;

package/dist/server.js

@@ -0,0 +1,27 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { registerTools } from './tools.js';
+/**
+ * Versie van de server zoals gemeld in de MCP-handshake. Spiegelt `version` in
+ * package.json; die kan hier niet zomaar geïmporteerd worden, want een JSON-import
+ * verhuist bij het bouwen mee naar dist/ en wijst dan naar het verkeerde bestand.
+ */
+export const VERSION = '0.1.0';
+/**
+ * Bouwt de MCP-server met de tools die op deze set roots van toepassing zijn.
+ * De roots worden één keer bij het opstarten ingelezen: ze komen uit de
+ * serverconfiguratie, niet uit een tool-argument, en horen dus niet per aanroep
+ * te kunnen wijzigen.
+ *
+ * Staat bewust los van index.ts: dat bestand start bij import meteen de server,
+ * en een test die alleen de tools wil aanspreken moet dat niet in gang zetten.
+ */
+export function createServer(roots) {
+    const server = new McpServer({ name: 'phpstan-mcp', version: VERSION }, {
+        instructions: 'Statische analyse van PHP-projecten met PHPStan. Elke tool verwacht een ' +
+            'expliciet `project`-pad; de server heeft geen "huidig project". Roep ' +
+            'list_projects aan om te zien welke paden geldig zijn.',
+    });
+    registerTools(server, roots);
+    return server;
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3C;;;;GAIG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC;AAE/B;;;;;;;;GAQG;AACH,MAAM,UAAU,YAAY,CAAC,KAAa;IACxC,MAAM,MAAM,GAAG,IAAI,SAAS,CAC1B,EAAE,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE,OAAO,EAAE,EACzC;QACE,YAAY,EACV,0EAA0E;YAC1E,uEAAuE;YACvE,uDAAuD;KAC1D,CACF,CAAC;IAEF,aAAa,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAC7B,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/tools.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { Root } from './roots.js';
+/** Hangt alle tools aan de server. */
+export declare function registerTools(server: McpServer, roots: Root[]): void;