codesift-mcp 0.9.5 → 0.9.10

package/dist/tools/php-event-tools.js

@@ -0,0 +1,205 @@
+/**
+ * PHP/Yii2-specific code intelligence tools.
+ *
+ * Implementation module extracted from the legacy php-tools facade.
+ */
+import { readFile } from "node:fs/promises";
+import { join } from "node:path";
+import { getCodeIndex } from "./index-tools.js";
+import { extractPhpNamespace, extractPhpUseImports, resolvePhpClassReference } from "./php-import-utils.js";
+function buildConstantValueMap(index) {
+    const out = new Map();
+    const globalValues = new Map();
+    const ambiguousShortKeys = new Set();
+    // First, build classId → className map so we can resolve const owners.
+    const classIdToName = new Map();
+    const classIdToFqcn = new Map();
+    for (const s of index.symbols) {
+        if (s.kind === "class" || s.kind === "interface" || s.kind === "enum") {
+            // Use the symbol id as key — every constant carries `parent` referring
+            // to its enclosing class id, so we only need the id→name lookup.
+            const id = s.id;
+            if (id) {
+                classIdToName.set(id, s.name);
+                classIdToFqcn.set(id, phpClassFqcn(s));
+            }
+        }
+    }
+    for (const s of index.symbols) {
+        if (s.kind !== "constant")
+            continue;
+        if (!s.parent || !s.source)
+            continue;
+        const className = classIdToName.get(s.parent);
+        if (!className)
+            continue;
+        // Match the literal value: `const NAME = 'value';` or `const NAME = "v";`
+        // or `const NAME = 42;`. We accept the first occurrence in the constant's
+        // source slice — the extractor already narrows source to a single decl.
+        const m = /=\s*(?:['"]([^'"]+)['"]|(-?\d+(?:\.\d+)?))/.exec(s.source);
+        if (!m)
+            continue;
+        const value = m[1] ?? m[2];
+        if (value === undefined)
+            continue;
+        const shortKey = `${className}::${s.name}`;
+        if (out.has(shortKey)) {
+            ambiguousShortKeys.add(shortKey);
+        }
+        else {
+            out.set(shortKey, value);
+        }
+        const fqcn = classIdToFqcn.get(s.parent);
+        if (fqcn === className) {
+            globalValues.set(shortKey, value);
+        }
+        if (fqcn && fqcn !== className) {
+            out.set(`${fqcn}::${s.name}`, value);
+        }
+    }
+    return { values: out, globalValues, ambiguousShortKeys };
+}
+function phpClassFqcn(cls) {
+    const name = cls.name.replace(/^\\/, "");
+    if (name.includes("\\"))
+        return name;
+    const namespace = extractPhpNamespace(cls.source);
+    return namespace ? `${namespace}\\${name}` : name;
+}
+async function buildFilePhpContexts(index) {
+    const byFile = new Map();
+    const warnings = [];
+    const addSource = (file, source) => {
+        const context = byFile.get(file) ?? { imports: new Map(), namespace: null };
+        for (const [alias, fqcn] of extractPhpUseImports(source)) {
+            context.imports.set(alias, fqcn);
+        }
+        context.namespace ??= extractPhpNamespace(source);
+        byFile.set(file, context);
+    };
+    for (const sym of index.symbols) {
+        if (!sym.source)
+            continue;
+        addSource(sym.file, sym.source);
+    }
+    for (const file of index.files) {
+        if (!file.path.endsWith(".php"))
+            continue;
+        try {
+            addSource(file.path, await readFile(join(index.root, file.path), "utf-8"));
+        }
+        catch {
+            // File content is an enhancement for import/namespace context; indexed
+            // symbol source is still enough for literal and FQCN event tracing.
+            warnings.push(`Unable to read PHP file for import context: ${file.path}`);
+        }
+    }
+    return { contexts: byFile, warnings };
+}
+export async function tracePhpEvent(repo, options) {
+    const index = await getCodeIndex(repo);
+    if (!index)
+        throw new Error(`Repository "${repo}" not found.`);
+    const eventMap = new Map();
+    const constantValues = buildConstantValueMap(index);
+    const { contexts: fileContexts, warnings } = await buildFilePhpContexts(index);
+    const getOrCreate = (name) => {
+        let e = eventMap.get(name);
+        if (!e) {
+            e = { event_name: name, triggers: [], listeners: [] };
+            eventMap.set(name, e);
+        }
+        return e;
+    };
+    // Resolve `Class::CONST` references to their literal values via the pre-pass
+    // map. Returns the original key when the class+const pair isn't indexed
+    // (e.g. constants defined in vendor/) so the trace at least shows there's
+    // SOMETHING happening at this site.
+    const resolveEventName = (raw, file) => {
+        const [rawClassRef, constName] = raw.split("::");
+        if (!rawClassRef || !constName)
+            return raw.replace(/^\\/, "");
+        const classRef = rawClassRef.replace(/^\\/, "");
+        const normalized = `${classRef}::${constName}`;
+        if (!classRef || !constName)
+            return normalized;
+        const fileContext = fileContexts.get(file);
+        const resolvedClass = resolvePhpClassReference(rawClassRef, fileContext ? { namespace: fileContext.namespace, imports: fileContext.imports } : undefined);
+        const resolvedKey = `${resolvedClass}::${constName}`;
+        if (constantValues.values.has(resolvedKey)) {
+            return constantValues.values.get(resolvedKey);
+        }
+        if (!rawClassRef.includes("\\") && !fileContext?.namespace && !fileContext?.imports.get(classRef)) {
+            const globalValue = constantValues.globalValues.get(normalized);
+            if (globalValue)
+                return globalValue;
+        }
+        if (rawClassRef.startsWith("\\") && constantValues.values.has(normalized)) {
+            return constantValues.values.get(normalized);
+        }
+        const shortClass = normalized.replace(/^.*\\([^\\]+::)/, "$1");
+        if (!constantValues.ambiguousShortKeys.has(shortClass) && constantValues.values.has(shortClass)) {
+            return constantValues.values.get(shortClass);
+        }
+        return normalized;
+    };
+    const constRefPattern = String.raw `\\?[A-Za-z_][\w]*(?:\\[A-Za-z_][\w]*)*::[A-Za-z_][\w]*`;
+    const classRefPattern = String.raw `\\?[A-Za-z_][\w]*(?:\\[A-Za-z_][\w]*)*::class`;
+    // Scan PHP file symbols for event triggers and listeners
+    const phpSymbols = index.symbols.filter((s) => s.file.endsWith(".php") && s.source);
+    for (const sym of phpSymbols) {
+        const source = sym.source;
+        // Triggers: ->trigger('eventName') or ->trigger(Class::CONST)
+        // Now also accepts a bare identifier path (Foo::BAR) in addition to the
+        // string-literal form.
+        const triggerRe = new RegExp(String.raw `->trigger\s*\(\s*(?:['"]([^'"]+)['"]|(${constRefPattern}))`, "g");
+        let match;
+        while ((match = triggerRe.exec(source)) !== null) {
+            const literal = match[1];
+            const constRef = match[2];
+            const eventName = literal ?? (constRef ? resolveEventName(constRef, sym.file) : undefined);
+            if (!eventName)
+                continue;
+            if (options?.event_name && eventName !== options.event_name)
+                continue;
+            const line = sym.start_line + (source.slice(0, match.index).match(/\n/g)?.length ?? 0);
+            getOrCreate(eventName).triggers.push({
+                file: sym.file,
+                line,
+                context: extractLineContext(source, match.index),
+            });
+        }
+        // Listeners: ->on('eventName', ...) or ::on('eventName', ...) or
+        //            ::on(Foo::class, Foo::EVENT_BAR, ...)
+        // Yii2 prefers the class-const form for built-in events, so resolution is
+        // critical here.
+        const listenerRe = new RegExp(String.raw `(?:->|::)on\s*\(\s*(?:${classRefPattern}\s*,\s*)?(?:['"]([^'"]+)['"]|(${constRefPattern}))`, "g");
+        while ((match = listenerRe.exec(source)) !== null) {
+            const literal = match[1];
+            const constRef = match[2];
+            const eventName = literal ?? (constRef ? resolveEventName(constRef, sym.file) : undefined);
+            if (!eventName)
+                continue;
+            if (options?.event_name && eventName !== options.event_name)
+                continue;
+            const line = sym.start_line + (source.slice(0, match.index).match(/\n/g)?.length ?? 0);
+            getOrCreate(eventName).listeners.push({
+                file: sym.file,
+                line,
+                context: extractLineContext(source, match.index),
+            });
+        }
+    }
+    const events = [...eventMap.values()];
+    return warnings.length > 0
+        ? { events, total: events.length, warnings }
+        : { events, total: events.length };
+}
+// ---------------------------------------------------------------------------
+function extractLineContext(source, index) {
+    const lineStart = source.lastIndexOf("\n", index) + 1;
+    const lineEnd = source.indexOf("\n", index);
+    const end = lineEnd === -1 ? source.length : lineEnd;
+    return source.slice(lineStart, end).trim().slice(0, 200);
+}
+//# sourceMappingURL=php-event-tools.js.map

package/dist/tools/php-event-tools.js.map

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

package/dist/tools/php-god-model-tools.d.ts

@@ -0,0 +1,34 @@
+export interface GodModelFinding {
+    name: string;
+    file: string;
+    method_count: number;
+    relation_count: number;
+    line_count: number;
+    reasons: string[];
+}
+/**
+ * Flag oversized PHP classes. Two scopes:
+ *
+ * - `scope: "activerecord"` (default) — only models extending ActiveRecord.
+ *   Uses `analyzeActiveRecord` for model detection and counts relations as a
+ *   third threshold alongside methods and lines. Classic Yii2 god-model case:
+ *   Survey.php in Mobi2 with 175 methods, 30 relations, 2291 lines.
+ *
+ * - `scope: "all"` — every PHP class in the index, regardless of base class.
+ *   Captures service god-classes (UserService with 80 methods), component
+ *   aggregates, and any other PHP class that outgrew its responsibility.
+ *   `relation_count` is 0 for non-AR classes — the `min_relations` check is
+ *   skipped so a service with 60 methods isn't hidden by a relation threshold.
+ *
+ * Thresholds default to 50/15/500 but are configurable for both scopes.
+ */
+export declare function findPhpGodModel(repo: string, options?: {
+    min_methods?: number;
+    min_relations?: number;
+    min_lines?: number;
+    scope?: "activerecord" | "all";
+}): Promise<{
+    models: GodModelFinding[];
+    total: number;
+}>;
+//# sourceMappingURL=php-god-model-tools.d.ts.map

package/dist/tools/php-god-model-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"php-god-model-tools.d.ts","sourceRoot":"","sources":["../../src/tools/php-god-model-tools.ts"],"names":[],"mappings":"AAWA,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,eAAe,CACnC,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;IACR,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,cAAc,GAAG,KAAK,CAAC;CAChC,GACA,OAAO,CAAC;IAAE,MAAM,EAAE,eAAe,EAAE,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAsEvD"}

package/dist/tools/php-god-model-tools.js

@@ -0,0 +1,88 @@
+/**
+ * PHP/Yii2-specific code intelligence tools.
+ *
+ * Implementation module extracted from the legacy php-tools facade.
+ */
+import { getCodeIndex } from "./index-tools.js";
+import { analyzeActiveRecord } from "./php-active-record-tools.js";
+/**
+ * Flag oversized PHP classes. Two scopes:
+ *
+ * - `scope: "activerecord"` (default) — only models extending ActiveRecord.
+ *   Uses `analyzeActiveRecord` for model detection and counts relations as a
+ *   third threshold alongside methods and lines. Classic Yii2 god-model case:
+ *   Survey.php in Mobi2 with 175 methods, 30 relations, 2291 lines.
+ *
+ * - `scope: "all"` — every PHP class in the index, regardless of base class.
+ *   Captures service god-classes (UserService with 80 methods), component
+ *   aggregates, and any other PHP class that outgrew its responsibility.
+ *   `relation_count` is 0 for non-AR classes — the `min_relations` check is
+ *   skipped so a service with 60 methods isn't hidden by a relation threshold.
+ *
+ * Thresholds default to 50/15/500 but are configurable for both scopes.
+ */
+export async function findPhpGodModel(repo, options) {
+    const index = await getCodeIndex(repo);
+    if (!index)
+        throw new Error(`Repository "${repo}" not found.`);
+    const minM = options?.min_methods ?? 50;
+    const minR = options?.min_relations ?? 15;
+    const minL = options?.min_lines ?? 500;
+    const scope = options?.scope ?? "activerecord";
+    const models = [];
+    if (scope === "activerecord") {
+        const ar = await analyzeActiveRecord(repo);
+        for (const m of ar.models) {
+            // Look up the class symbol by (name, kind, file) — file match keeps
+            // duplicate class names in different paths reported independently.
+            const classSym = index.symbols.find((s) => s.name === m.name && s.kind === "class" && s.file === m.file);
+            const lineCount = classSym ? classSym.end_line - classSym.start_line : 0;
+            const reasons = [];
+            if (m.methods.length > minM)
+                reasons.push(`methods: ${m.methods.length} > ${minM}`);
+            if (m.relations.length > minR)
+                reasons.push(`relations: ${m.relations.length} > ${minR}`);
+            if (lineCount > minL)
+                reasons.push(`lines: ${lineCount} > ${minL}`);
+            if (reasons.length > 0) {
+                models.push({
+                    name: m.name,
+                    file: m.file,
+                    method_count: m.methods.length,
+                    relation_count: m.relations.length,
+                    line_count: lineCount,
+                    reasons,
+                });
+            }
+        }
+    }
+    else {
+        // scope === "all" — iterate every PHP class symbol directly.
+        const classSyms = index.symbols.filter((s) => s.kind === "class" && s.file.endsWith(".php"));
+        for (const cls of classSyms) {
+            const methodCount = index.symbols.filter((s) => s.parent === cls.id && s.kind === "method").length;
+            const lineCount = cls.end_line - cls.start_line;
+            const reasons = [];
+            if (methodCount > minM)
+                reasons.push(`methods: ${methodCount} > ${minM}`);
+            if (lineCount > minL)
+                reasons.push(`lines: ${lineCount} > ${minL}`);
+            // min_relations intentionally skipped in "all" scope — not AR, no relations
+            if (reasons.length > 0) {
+                models.push({
+                    name: cls.name,
+                    file: cls.file,
+                    method_count: methodCount,
+                    relation_count: 0,
+                    line_count: lineCount,
+                    reasons,
+                });
+            }
+        }
+    }
+    // Sort by severity (number of reasons desc, then methods desc)
+    models.sort((a, b) => b.reasons.length - a.reasons.length || b.method_count - a.method_count);
+    return { models, total: models.length };
+}
+// ---------------------------------------------------------------------------
+//# sourceMappingURL=php-god-model-tools.js.map

package/dist/tools/php-god-model-tools.js.map

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

package/dist/tools/php-import-utils.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Shared PHP namespace/import parsing helpers for lightweight tool analysis.
+ */
+export declare function extractPhpNamespace(source?: string): string | null;
+export declare function extractPhpUseImports(source?: string): Map<string, string>;
+export declare function resolvePhpClassReference(classRef: string, context?: {
+    namespace?: string | null;
+    imports?: Map<string, string>;
+}): string;
+//# sourceMappingURL=php-import-utils.d.ts.map

package/dist/tools/php-import-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"php-import-utils.d.ts","sourceRoot":"","sources":["../../src/tools/php-import-utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,wBAAgB,mBAAmB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAGlE;AAED,wBAAgB,oBAAoB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CA6BzE;AAED,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,OAAO,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,GACrE,MAAM,CAaR"}

package/dist/tools/php-import-utils.js

@@ -0,0 +1,71 @@
+/**
+ * Shared PHP namespace/import parsing helpers for lightweight tool analysis.
+ */
+export function extractPhpNamespace(source) {
+    const match = /\bnamespace\s+([^;{]+)\s*[;{]/m.exec(source ?? "");
+    return match?.[1]?.trim().replace(/^\\/, "") ?? null;
+}
+export function extractPhpUseImports(source) {
+    const imports = new Map();
+    for (const match of (source ?? "").matchAll(/^\s*use\s+(?!function\b|const\b)([^;]+);/gm)) {
+        for (const rawClause of splitTopLevelCommas(match[1])) {
+            const clause = rawClause.trim();
+            if (!clause)
+                continue;
+            const group = /^(.+?)\\?\{(.+)\}$/.exec(clause);
+            if (group) {
+                const prefix = group[1].trim().replace(/^\\/, "").replace(/\\+/g, "\\").replace(/\\$/, "");
+                for (const member of splitTopLevelCommas(group[2])) {
+                    const raw = member.trim();
+                    if (!raw)
+                        continue;
+                    const aliasMatch = /^(.+?)\s+as\s+([A-Za-z_]\w*)$/i.exec(raw);
+                    const imported = (aliasMatch?.[1] ?? raw).trim().replace(/^\\/, "").replace(/\\+/g, "\\");
+                    const fqcn = `${prefix}\\${imported}`;
+                    const alias = aliasMatch?.[2] ?? fqcn.split("\\").pop();
+                    if (alias)
+                        imports.set(alias, fqcn);
+                }
+                continue;
+            }
+            const aliasMatch = /^(.+?)\s+as\s+([A-Za-z_]\w*)$/i.exec(clause);
+            const fqcn = (aliasMatch?.[1] ?? clause).trim().replace(/^\\/, "").replace(/\\+/g, "\\");
+            const alias = aliasMatch?.[2] ?? fqcn.split("\\").pop();
+            if (alias)
+                imports.set(alias, fqcn);
+        }
+    }
+    return imports;
+}
+export function resolvePhpClassReference(classRef, context) {
+    if (classRef.startsWith("\\"))
+        return classRef.slice(1);
+    const segments = classRef.split("\\");
+    const first = segments[0];
+    const imported = context?.imports?.get(first);
+    if (imported) {
+        return segments.length === 1
+            ? imported
+            : `${imported}\\${segments.slice(1).join("\\")}`;
+    }
+    return context?.namespace ? `${context.namespace}\\${classRef}` : classRef;
+}
+function splitTopLevelCommas(input) {
+    const parts = [];
+    let start = 0;
+    let depth = 0;
+    for (let i = 0; i < input.length; i += 1) {
+        const ch = input[i];
+        if (ch === "{")
+            depth += 1;
+        if (ch === "}")
+            depth = Math.max(0, depth - 1);
+        if (ch === "," && depth === 0) {
+            parts.push(input.slice(start, i));
+            start = i + 1;
+        }
+    }
+    parts.push(input.slice(start));
+    return parts;
+}
+//# sourceMappingURL=php-import-utils.js.map

package/dist/tools/php-import-utils.js.map

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

package/dist/tools/php-namespace-tools.d.ts

@@ -0,0 +1,10 @@
+export interface PhpNamespaceResolution {
+    class_name: string;
+    namespace: string;
+    file_path: string | null;
+    exists: boolean;
+    psr4_root: string | null;
+    psr4_prefix: string | null;
+}
+export declare function resolvePhpNamespace(repo: string, className: string): Promise<PhpNamespaceResolution>;
+//# sourceMappingURL=php-namespace-tools.d.ts.map

package/dist/tools/php-namespace-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"php-namespace-tools.d.ts","sourceRoot":"","sources":["../../src/tools/php-namespace-tools.ts"],"names":[],"mappings":"AAaA,MAAM,WAAW,sBAAsB;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,sBAAsB,CAAC,CAuEjC"}

package/dist/tools/php-namespace-tools.js

@@ -0,0 +1,98 @@
+/**
+ * PHP/Yii2-specific code intelligence tools.
+ *
+ * Implementation module extracted from the legacy php-tools facade.
+ */
+import { readFile } from "node:fs/promises";
+import { join } from "node:path";
+import { getCodeIndex } from "./index-tools.js";
+export async function resolvePhpNamespace(repo, className) {
+    const index = await getCodeIndex(repo);
+    if (!index)
+        throw new Error(`Repository "${repo}" not found.`);
+    const composer = await readJsonSafe(join(index.root, "composer.json"));
+    const psr4 = mergePsr4Maps(composer?.autoload?.["psr-4"], composer?.["autoload-dev"]?.["psr-4"]);
+    // Strip leading backslash
+    const normalized = className.replace(/^\\/, "");
+    const parts = normalized.split("\\");
+    const namespaceOnly = parts.slice(0, -1).join("\\");
+    const shortName = parts[parts.length - 1];
+    // Find matching PSR-4 prefix (longest match wins). Composer also allows an
+    // empty fallback prefix and multiple roots per prefix.
+    let bestMatch = null;
+    for (const [prefix, roots] of Object.entries(psr4)) {
+        const normalizedPrefix = prefix.replace(/\\$/, "");
+        const matches = normalizedPrefix === "" ||
+            normalized.startsWith(normalizedPrefix + "\\") ||
+            normalized === normalizedPrefix;
+        if (matches) {
+            if (!bestMatch || normalizedPrefix.length > bestMatch.prefix.length) {
+                bestMatch = {
+                    prefix: normalizedPrefix,
+                    roots: (Array.isArray(roots) ? roots : [roots]).filter(Boolean),
+                };
+            }
+        }
+    }
+    if (!bestMatch || bestMatch.roots.length === 0) {
+        return {
+            class_name: shortName,
+            namespace: namespaceOnly,
+            file_path: null,
+            exists: false,
+            psr4_root: null,
+            psr4_prefix: null,
+        };
+    }
+    // Construct file path: strip prefix, replace \ with /, append .php
+    const remainder = bestMatch.prefix === ""
+        ? normalized
+        : normalized.slice(bestMatch.prefix.length).replace(/^\\/, "");
+    const relativePath = remainder.replace(/\\/g, "/") + ".php";
+    const candidates = bestMatch.roots.map((psr4Root) => {
+        const root = psr4Root.replace(/\/$/, "");
+        const filePath = root ? `${root}/${relativePath}` : relativePath;
+        return { psr4Root, filePath };
+    });
+    const existing = candidates.find(({ filePath }) => {
+        const normalizedFP = filePath.replace(/^\.\//, "");
+        return index.files.some((f) => f.path === normalizedFP || f.path === filePath);
+    });
+    const selected = existing ?? candidates[0];
+    return {
+        class_name: shortName,
+        namespace: namespaceOnly,
+        file_path: selected.filePath,
+        exists: Boolean(existing),
+        psr4_root: selected.psr4Root,
+        psr4_prefix: bestMatch.prefix,
+    };
+}
+// ---------------------------------------------------------------------------
+async function readJsonSafe(path) {
+    try {
+        const content = await readFile(path, "utf-8");
+        return JSON.parse(content);
+    }
+    catch {
+        return null;
+    }
+}
+function mergePsr4Maps(...maps) {
+    const merged = {};
+    for (const map of maps) {
+        if (!map)
+            continue;
+        for (const [prefix, roots] of Object.entries(map)) {
+            const existing = merged[prefix] ?? [];
+            for (const root of Array.isArray(roots) ? roots : [roots]) {
+                if (!root || existing.includes(root))
+                    continue;
+                existing.push(root);
+            }
+            merged[prefix] = existing;
+        }
+    }
+    return merged;
+}
+//# sourceMappingURL=php-namespace-tools.js.map

package/dist/tools/php-namespace-tools.js.map

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

package/dist/tools/php-nplus1-tools.d.ts

@@ -0,0 +1,27 @@
+export interface NPlusOneFinding {
+    file: string;
+    method: string;
+    line: number;
+    relation: string;
+    pattern: string;
+}
+/**
+ * Detect N+1 query patterns in Yii2/Eloquent controllers.
+ *
+ * Pattern: `foreach ($items as $item) { $item->relation->... }` without a
+ * prior `->with('relation')` call in the same method scope. This is the
+ * most common N+1 anti-pattern in Yii2 ActiveRecord code.
+ *
+ * Known limitations (acceptable for a "discovery" tool, not a gate):
+ * - Regex-based — can miss multi-line foreach bodies split across nested blocks
+ * - Doesn't cross function boundaries — eager loading in caller is invisible
+ * - False positives on nested loops if the outer collection is already eager-loaded
+ */
+export declare function findPhpNPlusOne(repo: string, options?: {
+    limit?: number;
+    file_pattern?: string;
+}): Promise<{
+    findings: NPlusOneFinding[];
+    total: number;
+}>;
+//# sourceMappingURL=php-nplus1-tools.d.ts.map

package/dist/tools/php-nplus1-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"php-nplus1-tools.d.ts","sourceRoot":"","sources":["../../src/tools/php-nplus1-tools.ts"],"names":[],"mappings":"AAsCA,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,eAAe,CACnC,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE,GAClD,OAAO,CAAC;IAAE,QAAQ,EAAE,eAAe,EAAE,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAuMzD"}