projscan 1.1.0 → 1.2.0

package/dist/core/languages/phpExports.js

@@ -0,0 +1,58 @@
+/**
+ * Top-level PHP declarations are always public to anything that imports the
+ * file's namespace via `use` — there's no `private` modifier at the file /
+ * namespace scope (only inside classes). So all top-level
+ * function_definition / class_declaration / interface_declaration /
+ * trait_declaration / enum_declaration nodes count as exports.
+ *
+ * Method-level visibility is enforced inside `phpFunctions.ts` (where
+ * we surface per-method CC); it doesn't matter at the file-export level.
+ */
+const TOP_LEVEL_EXPORTS = {
+    function_definition: 'function',
+    class_declaration: 'class',
+    interface_declaration: 'interface',
+    trait_declaration: 'class',
+    enum_declaration: 'enum',
+};
+export function extractPhpExports(root) {
+    const exports = [];
+    // Only walk top-level (program -> direct children). Nested classes are
+    // method-level and addressed by phpFunctions, not file exports.
+    for (const child of root.namedChildren) {
+        visit(child, exports, /* depth */ 0);
+    }
+    return exports;
+}
+function visit(node, out, depth) {
+    const kind = TOP_LEVEL_EXPORTS[node.type];
+    if (kind && depth === 0) {
+        const name = nameOf(node);
+        if (name) {
+            out.push({ name, kind, typeOnly: false, line: node.startPosition.row + 1 });
+        }
+        return;
+    }
+    // namespace_definition wraps further declarations; descend with the same
+    // depth so we still classify its top-level children as exports.
+    if (node.type === 'namespace_definition') {
+        const body = node.namedChildren.find((c) => c.type === 'declaration_list' || c.type === 'compound_statement');
+        if (body) {
+            for (const c of body.namedChildren)
+                visit(c, out, depth);
+        }
+    }
+}
+function nameOf(node) {
+    if (node.childForFieldName) {
+        const id = node.childForFieldName('name');
+        if (id)
+            return id.text;
+    }
+    for (const c of node.namedChildren) {
+        if (c.type === 'name')
+            return c.text;
+    }
+    return null;
+}
+//# sourceMappingURL=phpExports.js.map

package/dist/core/languages/phpExports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"phpExports.js","sourceRoot":"","sources":["../../../src/core/languages/phpExports.ts"],"names":[],"mappings":"AAUA;;;;;;;;;GASG;AACH,MAAM,iBAAiB,GAA+B;IACpD,mBAAmB,EAAE,UAAU;IAC/B,iBAAiB,EAAE,OAAO;IAC1B,qBAAqB,EAAE,WAAW;IAClC,iBAAiB,EAAE,OAAO;IAC1B,gBAAgB,EAAE,MAAM;CACzB,CAAC;AAEF,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC5C,MAAM,OAAO,GAAgB,EAAE,CAAC;IAChC,uEAAuE;IACvE,gEAAgE;IAChE,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;QACvC,KAAK,CAAC,KAAK,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC;IACvC,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,KAAK,CAAC,IAAY,EAAE,GAAgB,EAAE,KAAa;IAC1D,MAAM,IAAI,GAAG,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1C,IAAI,IAAI,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;QAC1B,IAAI,IAAI,EAAE,CAAC;YACT,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,CAAC,aAAa,CAAC,GAAG,GAAG,CAAC,EAAE,CAAC,CAAC;QAC9E,CAAC;QACD,OAAO;IACT,CAAC;IACD,yEAAyE;IACzE,gEAAgE;IAChE,IAAI,IAAI,CAAC,IAAI,KAAK,sBAAsB,EAAE,CAAC;QACzC,MAAM,IAAI,GAAG,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,kBAAkB,IAAI,CAAC,CAAC,IAAI,KAAK,oBAAoB,CAAC,CAAC;QAC9G,IAAI,IAAI,EAAE,CAAC;YACT,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,aAAa;gBAAE,KAAK,CAAC,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;QAC3D,CAAC;IACH,CAAC;AACH,CAAC;AAED,SAAS,MAAM,CAAC,IAAY;IAC1B,IAAI,IAAI,CAAC,iBAAiB,EAAE,CAAC;QAC3B,MAAM,EAAE,GAAG,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC;QAC1C,IAAI,EAAE;YAAE,OAAO,EAAE,CAAC,IAAI,CAAC;IACzB,CAAC;IACD,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;QACnC,IAAI,CAAC,CAAC,IAAI,KAAK,MAAM;YAAE,OAAO,CAAC,CAAC,IAAI,CAAC;IACvC,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/core/languages/phpFunctions.d.ts

@@ -0,0 +1,25 @@
+import type { FunctionInfo } from '../ast.js';
+interface TsNode {
+    type: string;
+    text: string;
+    startPosition: {
+        row: number;
+        column: number;
+    };
+    endPosition: {
+        row: number;
+        column: number;
+    };
+    namedChildren: TsNode[];
+    childForFieldName?: (name: string) => TsNode | null;
+}
+/**
+ * Per-function McCabe CC for PHP. Walks `function_definition` (free
+ * functions) and `method_declaration` nodes. Methods inside `class Foo`
+ * are named `Foo.method`; methods in interfaces/traits/enums use the
+ * declaring type's name. Anonymous functions and closures are not
+ * extracted as separate functions; their CC folds into the enclosing
+ * function.
+ */
+export declare function extractPhpFunctions(root: TsNode): FunctionInfo[];
+export {};

package/dist/core/languages/phpFunctions.js

@@ -0,0 +1,144 @@
+const PHP_DECISION_NODES = new Set([
+    'if_statement',
+    'else_if_clause',
+    'elseif_clause',
+    'for_statement',
+    'foreach_statement',
+    'while_statement',
+    'do_statement',
+    'catch_clause',
+    'conditional_expression',
+]);
+/**
+ * Per-function McCabe CC for PHP. Walks `function_definition` (free
+ * functions) and `method_declaration` nodes. Methods inside `class Foo`
+ * are named `Foo.method`; methods in interfaces/traits/enums use the
+ * declaring type's name. Anonymous functions and closures are not
+ * extracted as separate functions; their CC folds into the enclosing
+ * function.
+ */
+export function extractPhpFunctions(root) {
+    const out = [];
+    walk(root, null, out);
+    return out;
+}
+function walk(node, ownerName, out) {
+    // Containers that scope methods by their type name.
+    if (node.type === 'class_declaration' ||
+        node.type === 'interface_declaration' ||
+        node.type === 'trait_declaration' ||
+        node.type === 'enum_declaration') {
+        const nameNode = node.childForFieldName ? node.childForFieldName('name') : findChild(node, 'name');
+        const cls = nameNode?.text ?? ownerName;
+        const body = node.childForFieldName ? node.childForFieldName('body') : findChild(node, 'declaration_list');
+        if (body) {
+            for (const child of body.namedChildren)
+                walk(child, cls, out);
+        }
+        return;
+    }
+    // namespace_definition wraps everything in a namespace { ... } block; descend.
+    if (node.type === 'namespace_definition') {
+        for (const child of node.namedChildren)
+            walk(child, ownerName, out);
+        return;
+    }
+    if (node.type === 'declaration_list' || node.type === 'compound_statement') {
+        for (const child of node.namedChildren)
+            walk(child, ownerName, out);
+        return;
+    }
+    if (node.type === 'function_definition' || node.type === 'method_declaration') {
+        const nameNode = node.childForFieldName ? node.childForFieldName('name') : findChild(node, 'name');
+        const baseName = nameNode?.text ?? '<anonymous>';
+        const fnName = ownerName && node.type === 'method_declaration' ? `${ownerName}.${baseName}` : baseName;
+        const line = node.startPosition.row + 1;
+        const endLine = node.endPosition.row + 1;
+        const { cc, callSites } = analyzeBody(node);
+        out.push({ name: fnName, line, endLine, cyclomaticComplexity: cc, callSites });
+        return;
+    }
+    for (const child of node.namedChildren)
+        walk(child, ownerName, out);
+}
+function analyzeBody(fnNode) {
+    let count = 0;
+    const calls = new Set();
+    const body = fnNode.childForFieldName ? fnNode.childForFieldName('body') : findChild(fnNode, 'compound_statement');
+    if (!body)
+        return { cc: 1, callSites: [] };
+    walkSkipNested(body, (n) => {
+        if (PHP_DECISION_NODES.has(n.type)) {
+            count++;
+            return;
+        }
+        if (n.type === 'case_statement') {
+            if (!/^\s*default\b/.test(n.text))
+                count++;
+            return;
+        }
+        if (n.type === 'match_condition_list') {
+            if (!/^\s*default\b/.test(n.text))
+                count++;
+            return;
+        }
+        if (n.type === 'binary_expression') {
+            const t = n.text;
+            if (/(\s|^)(\|\||&&|\?\?)(\s|$)/.test(t))
+                count++;
+            else if (/\b(and|or)\b/.test(t))
+                count++;
+            return;
+        }
+        if (n.type === 'function_call_expression' ||
+            n.type === 'member_call_expression' ||
+            n.type === 'nullsafe_member_call_expression' ||
+            n.type === 'scoped_call_expression') {
+            const name = phpCalleeName(n);
+            if (name)
+                calls.add(name);
+        }
+    });
+    return { cc: count + 1, callSites: [...calls] };
+}
+function phpCalleeName(callNode) {
+    const target = callNode.type === 'function_call_expression'
+        ? (callNode.childForFieldName ? callNode.childForFieldName('function') : null)
+        : (callNode.childForFieldName ? callNode.childForFieldName('name') : null);
+    if (!target)
+        return null;
+    switch (target.type) {
+        case 'name':
+        case 'variable_name':
+            return target.text.replace(/^\$/, '');
+        case 'qualified_name': {
+            let last = null;
+            for (const c of target.namedChildren)
+                if (c.type === 'name')
+                    last = c;
+            return last ? last.text : null;
+        }
+        default:
+            return null;
+    }
+}
+function walkSkipNested(node, visit) {
+    visit(node);
+    for (const child of node.namedChildren) {
+        if (child.type === 'function_definition' ||
+            child.type === 'method_declaration' ||
+            child.type === 'anonymous_function_creation_expression' ||
+            child.type === 'arrow_function') {
+            // Nested fn: skip so its decisions don't double-count into the parent.
+            continue;
+        }
+        walkSkipNested(child, visit);
+    }
+}
+function findChild(node, type) {
+    for (const c of node.namedChildren)
+        if (c.type === type)
+            return c;
+    return null;
+}
+//# sourceMappingURL=phpFunctions.js.map

package/dist/core/languages/phpFunctions.js.map

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

package/dist/core/languages/phpImports.d.ts

@@ -0,0 +1,31 @@
+import type { AstImport } from '../ast.js';
+interface TsNode {
+    type: string;
+    text: string;
+    startPosition: {
+        row: number;
+        column: number;
+    };
+    namedChildren: TsNode[];
+    childForFieldName?: (name: string) => TsNode | null;
+}
+/**
+ * Extract PHP `use` statements from a tree-sitter-php AST.
+ *
+ * Handled forms:
+ *   use Foo\Bar;                              → "Foo\\Bar"
+ *   use Foo\Bar as Baz;                       → "Foo\\Bar", alias "Baz"
+ *   use Foo\{Bar, Baz, Qux as Q};             → three imports
+ *   use function Foo\some_fn;                 → "Foo\\some_fn", function-only
+ *   use const Foo\SOME_CONST;                 → "Foo\\SOME_CONST", const-only
+ *
+ * Also handled in a lenient way:
+ *   require / require_once / include / include_once 'path/to/file.php';
+ *     → "path/to/file.php" (the resolver tries to land it on a repo file).
+ *
+ * NOT handled:
+ *   - Dynamic require / include (`require $var`)
+ *   - `extract()` / `class_exists()` reflective imports
+ */
+export declare function extractPhpImports(root: TsNode): AstImport[];
+export {};

package/dist/core/languages/phpImports.js

@@ -0,0 +1,142 @@
+/**
+ * Extract PHP `use` statements from a tree-sitter-php AST.
+ *
+ * Handled forms:
+ *   use Foo\Bar;                              → "Foo\\Bar"
+ *   use Foo\Bar as Baz;                       → "Foo\\Bar", alias "Baz"
+ *   use Foo\{Bar, Baz, Qux as Q};             → three imports
+ *   use function Foo\some_fn;                 → "Foo\\some_fn", function-only
+ *   use const Foo\SOME_CONST;                 → "Foo\\SOME_CONST", const-only
+ *
+ * Also handled in a lenient way:
+ *   require / require_once / include / include_once 'path/to/file.php';
+ *     → "path/to/file.php" (the resolver tries to land it on a repo file).
+ *
+ * NOT handled:
+ *   - Dynamic require / include (`require $var`)
+ *   - `extract()` / `class_exists()` reflective imports
+ */
+export function extractPhpImports(root) {
+    const imports = [];
+    walk(root, (n) => {
+        if (n.type === 'namespace_use_declaration') {
+            collectUseDeclaration(n, imports);
+        }
+        else if (n.type === 'expression_statement') {
+            // require / include statements are expression statements wrapping an
+            // include_expression / require_expression node.
+            for (const child of n.namedChildren) {
+                if (child.type === 'include_expression' ||
+                    child.type === 'include_once_expression' ||
+                    child.type === 'require_expression' ||
+                    child.type === 'require_once_expression') {
+                    collectIncludeStatement(child, imports);
+                }
+            }
+        }
+    });
+    return imports;
+}
+function collectUseDeclaration(node, out) {
+    // Some grammars expose `function` / `const` as a child token; we don't
+    // distinguish those in the AstImport shape but we do parse the path.
+    const line = node.startPosition.row + 1;
+    // Find the qualifier (the `Foo\Bar` prefix) and any use-clauses or use-list.
+    // The grammar can produce one of:
+    //   namespace_use_declaration > namespace_use_clause > qualified_name
+    //   namespace_use_declaration > namespace_name (prefix) + namespace_use_group
+    // The group's prefix is a sibling of the group, not a child.
+    let groupPrefix = '';
+    for (const child of node.namedChildren) {
+        if (child.type === 'namespace_name' || child.type === 'qualified_name') {
+            groupPrefix = readPath(child);
+        }
+    }
+    for (const child of node.namedChildren) {
+        if (child.type === 'namespace_use_clause') {
+            const { source, alias } = extractClause(child);
+            if (source)
+                out.push(makeImport(source, alias, line));
+        }
+        else if (child.type === 'namespace_use_group') {
+            for (const groupChild of child.namedChildren) {
+                if (groupChild.type === 'namespace_use_clause' ||
+                    groupChild.type === 'namespace_use_group_clause') {
+                    const { source, alias } = extractClause(groupChild);
+                    if (!source)
+                        continue;
+                    const full = groupPrefix ? `${groupPrefix}\\${source}` : source;
+                    out.push(makeImport(full, alias, line));
+                }
+            }
+        }
+    }
+}
+function extractClause(node) {
+    let source = '';
+    let alias;
+    for (const c of node.namedChildren) {
+        if (c.type === 'qualified_name' || c.type === 'namespace_name' || c.type === 'name') {
+            if (!source)
+                source = readPath(c);
+        }
+        else if (c.type === 'namespace_aliasing_clause' || c.type === 'name') {
+            // alias clauses look like `as Baz` — the `name` after `as` is the alias.
+            // This branch fires for `name` only when source is already set.
+            const aliasName = node.childForFieldName ? node.childForFieldName('alias') : null;
+            if (aliasName)
+                alias = aliasName.text;
+        }
+    }
+    // Field-based alias (the grammar's preferred shape).
+    if (!alias && node.childForFieldName) {
+        const a = node.childForFieldName('alias');
+        if (a)
+            alias = a.text;
+    }
+    return { source, alias };
+}
+function collectIncludeStatement(expr, out) {
+    // include_expression : `include 'path'` ; first non-include child is the
+    // path expression. Grammar variants put it as a `string` literal child.
+    const line = expr.startPosition.row + 1;
+    for (const c of expr.namedChildren) {
+        if (c.type === 'string' || c.type === 'encapsed_string') {
+            const stringContent = c.namedChildren.find((s) => s.type === 'string_content');
+            const raw = stringContent ? stringContent.text : c.text.replace(/^['"]|['"]$/g, '');
+            if (raw)
+                out.push({ source: raw, kind: 'static', specifiers: [], typeOnly: false, line });
+            return;
+        }
+    }
+}
+function readPath(node) {
+    // qualified_name has children: namespace_name (or names) + name.
+    // Concatenate with backslashes.
+    const parts = [];
+    collectName(node, parts);
+    return parts.join('\\');
+}
+function collectName(node, out) {
+    if (node.type === 'name') {
+        out.push(node.text);
+        return;
+    }
+    for (const c of node.namedChildren)
+        collectName(c, out);
+}
+function makeImport(source, alias, line) {
+    return {
+        source,
+        kind: 'static',
+        specifiers: alias ? [alias] : [],
+        typeOnly: false,
+        line,
+    };
+}
+function walk(node, visit) {
+    visit(node);
+    for (const child of node.namedChildren)
+        walk(child, visit);
+}
+//# sourceMappingURL=phpImports.js.map

package/dist/core/languages/phpImports.js.map

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

package/dist/core/languages/phpManifests.d.ts

@@ -0,0 +1,31 @@
+import type { FileEntry } from '../../types.js';
+export interface PhpProjectInfo {
+    /** Absolute directory containing composer.json. Imports resolve relative to its autoload roots. */
+    projectRoot: string;
+    /**
+     * PSR-4 namespace prefixes mapped to a relative source root. Example:
+     * `[{ prefix: 'App\\', root: 'src' }, { prefix: 'App\\Tests\\', root: 'tests' }]`.
+     * Resolution strategy: longest prefix match wins.
+     */
+    psr4: Array<{
+        prefix: string;
+        root: string;
+    }>;
+    /**
+     * `autoload.classmap` entries (relative dirs / files). PSR-4 covers most
+     * modern PHP; classmap is older but still common in legacy code.
+     */
+    classmap: string[];
+}
+/**
+ * Find the closest composer.json and read its autoload section. Tries the
+ * repo root first, then walks up from any directory containing a `.php`
+ * file. Returns null when no composer.json exists; .php files outside any
+ * Composer project are valid (snippets, scratch files) but their `use`
+ * clauses can't be resolved to local files.
+ *
+ * Both `autoload` and `autoload-dev` are read so that test files importing
+ * from `App\Tests\` resolve. PSR-4 always wins over classmap when both
+ * could resolve a path.
+ */
+export declare function detectPhpProject(rootPath: string, files: FileEntry[]): Promise<PhpProjectInfo | null>;

package/dist/core/languages/phpManifests.js

@@ -0,0 +1,89 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+/**
+ * Find the closest composer.json and read its autoload section. Tries the
+ * repo root first, then walks up from any directory containing a `.php`
+ * file. Returns null when no composer.json exists; .php files outside any
+ * Composer project are valid (snippets, scratch files) but their `use`
+ * clauses can't be resolved to local files.
+ *
+ * Both `autoload` and `autoload-dev` are read so that test files importing
+ * from `App\Tests\` resolve. PSR-4 always wins over classmap when both
+ * could resolve a path.
+ */
+export async function detectPhpProject(rootPath, files) {
+    // 1) Try repo root.
+    const fromRoot = await readComposer(rootPath);
+    if (fromRoot)
+        return fromRoot;
+    // 2) Walk up from .php file directories.
+    const candidates = new Set();
+    for (const f of files) {
+        if (!f.relativePath.endsWith('.php'))
+            continue;
+        let dir = path.posix.dirname(f.relativePath);
+        while (dir && dir !== '.' && dir !== '/') {
+            candidates.add(dir);
+            dir = path.posix.dirname(dir);
+        }
+    }
+    const sorted = [...candidates].sort((a, b) => a.length - b.length);
+    for (const dir of sorted) {
+        const project = await readComposer(path.join(rootPath, dir));
+        if (project)
+            return project;
+    }
+    return null;
+}
+async function readComposer(dir) {
+    const p = path.join(dir, 'composer.json');
+    let raw;
+    try {
+        raw = await fs.readFile(p, 'utf-8');
+    }
+    catch {
+        return null;
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+    const psr4 = [];
+    const classmap = [];
+    for (const key of ['autoload', 'autoload-dev']) {
+        const block = parsed[key];
+        if (!block || typeof block !== 'object')
+            continue;
+        const psr4Block = block['psr-4'];
+        if (psr4Block && typeof psr4Block === 'object') {
+            for (const [prefix, target] of Object.entries(psr4Block)) {
+                if (typeof target === 'string') {
+                    psr4.push({ prefix, root: stripTrailingSlash(target) });
+                }
+                else if (Array.isArray(target)) {
+                    for (const t of target) {
+                        if (typeof t === 'string')
+                            psr4.push({ prefix, root: stripTrailingSlash(t) });
+                    }
+                }
+            }
+        }
+        const cm = block.classmap;
+        if (Array.isArray(cm)) {
+            for (const entry of cm)
+                if (typeof entry === 'string')
+                    classmap.push(stripTrailingSlash(entry));
+        }
+    }
+    // Sort PSR-4 entries by prefix length descending so longest-match resolution
+    // is a single pass.
+    psr4.sort((a, b) => b.prefix.length - a.prefix.length);
+    return { projectRoot: dir, psr4, classmap };
+}
+function stripTrailingSlash(s) {
+    return s.endsWith('/') ? s.slice(0, -1) : s;
+}
+//# sourceMappingURL=phpManifests.js.map

package/dist/core/languages/phpManifests.js.map

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

package/dist/core/languages/pythonFunctions.js

@@ -29,8 +29,8 @@ function walk(node, className, out) {
         const qualifiedName = className ? `${className}.${fnName}` : fnName;
         const line = node.startPosition.row + 1;
         const endLine = node.endPosition.row + 1;
-        const cc = countDecisions(node);
-        out.push({ name: qualifiedName, line, endLine, cyclomaticComplexity: cc });
+        const { cc, callSites } = analyzeBody(node);
+        out.push({ name: qualifiedName, line, endLine, cyclomaticComplexity: cc, callSites });
         // Recurse into the body to find nested functions only - the CC for THIS
         // function already correctly excluded them via the body-walker.
         const body = node.childForFieldName ? node.childForFieldName('body') : null;
@@ -56,19 +56,45 @@ function walk(node, className, out) {
         walk(child, className, out);
 }
 /**
- * Count decision points inside a function body, skipping nested function /
- * class definitions so they don't pollute the enclosing function's CC.
+ * Count decision points and collect call sites inside a function body,
+ * skipping nested function / class definitions.
  */
-function countDecisions(fnNode) {
+function analyzeBody(fnNode) {
     let count = 0;
+    const calls = new Set();
     const body = fnNode.childForFieldName ? fnNode.childForFieldName('body') : null;
     if (!body)
-        return 1;
+        return { cc: 1, callSites: [] };
     walkSkipNested(body, (n) => {
-        if (PY_DECISION_NODES.has(n.type))
+        if (PY_DECISION_NODES.has(n.type)) {
             count++;
+            return;
+        }
+        if (n.type === 'call') {
+            const fn = n.childForFieldName ? n.childForFieldName('function') : (n.namedChildren[0] ?? null);
+            const name = pyCalleeName(fn);
+            if (name)
+                calls.add(name);
+        }
     });
-    return count + 1;
+    return { cc: count + 1, callSites: [...calls] };
+}
+function pyCalleeName(node) {
+    if (!node)
+        return null;
+    switch (node.type) {
+        case 'identifier':
+            return node.text;
+        case 'attribute': {
+            const attr = node.childForFieldName ? node.childForFieldName('attribute') : null;
+            if (attr)
+                return pyCalleeName(attr);
+            const named = node.namedChildren;
+            return named.length > 0 ? pyCalleeName(named[named.length - 1]) : null;
+        }
+        default:
+            return null;
+    }
 }
 function walkSkipNested(node, visit) {
     visit(node);

package/dist/core/languages/pythonFunctions.js.map

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

package/dist/core/languages/registry.js

@@ -5,7 +5,9 @@ import { goAdapter } from './goAdapter.js';
 import { javaAdapter } from './javaAdapter.js';
 import { rubyAdapter } from './rubyAdapter.js';
 import { rustAdapter } from './rustAdapter.js';
-const adapters = [javascriptAdapter, pythonAdapter, goAdapter, javaAdapter, rubyAdapter, rustAdapter];
+import { phpAdapter } from './phpAdapter.js';
+import { csharpAdapter } from './csharpAdapter.js';
+const adapters = [javascriptAdapter, pythonAdapter, goAdapter, javaAdapter, rubyAdapter, rustAdapter, phpAdapter, csharpAdapter];
 const byExtension = new Map();
 function rebuildIndex() {
     byExtension.clear();