purecontext-mcp 1.0.1

package/dist/handlers/python.js

@@ -0,0 +1,343 @@
+import { createHash } from 'crypto';
+import { dirname, resolve } from 'path';
+import { fileURLToPath } from 'url';
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const GRAMMARS_DIR = resolve(__dirname, '../../grammars');
+// ─── Symbol ID ────────────────────────────────────────────────────────────────
+function makeId(filePath, name, kind) {
+    return createHash('sha256')
+        .update(`${filePath}:${name}:${kind}`)
+        .digest('hex')
+        .slice(0, 16);
+}
+// ─── Signature building ───────────────────────────────────────────────────────
+/**
+ * Walk the node tree to find the first `block` node (the indented body).
+ * For decorated_definition, the block is nested inside function_definition or
+ * class_definition, not at the decorated_definition level directly.
+ */
+function findFirstBlock(node) {
+    if (node.type === 'block')
+        return node;
+    for (const child of node.children) {
+        const found = findFirstBlock(child);
+        if (found)
+            return found;
+    }
+    return null;
+}
+/**
+ * Build a one-line signature: source from the node start up to (but not
+ * including) the indented body block. Collapses whitespace, caps at 120 chars.
+ */
+function buildSignature(outerNode, source) {
+    const block = findFirstBlock(outerNode);
+    const endByte = block ? block.startIndex : outerNode.endIndex;
+    return source
+        .toString('utf8', outerNode.startIndex, endByte)
+        .replace(/\s+/g, ' ')
+        .trim()
+        .slice(0, 120);
+}
+// ─── Docstring extraction ─────────────────────────────────────────────────────
+/**
+ * Extract a Python docstring: the first expression_statement child of the
+ * function/class block that is a string literal.
+ */
+function extractDocstring(node) {
+    const block = node.children.find((c) => c.type === 'block');
+    if (!block)
+        return null;
+    const firstStmt = block.children.find((c) => c.type === 'expression_statement');
+    if (!firstStmt)
+        return null;
+    const strNode = firstStmt.children.find((c) => c.type === 'string' || c.type === 'concatenated_string');
+    if (!strNode)
+        return null;
+    let raw = strNode.text;
+    // Strip triple-quote delimiters (""" / ''')
+    if (raw.startsWith('"""') || raw.startsWith("'''")) {
+        raw = raw.slice(3, -3);
+    }
+    else if (raw.startsWith('"') || raw.startsWith("'")) {
+        raw = raw.slice(1, -1);
+    }
+    raw = raw.trim();
+    if (!raw)
+        return null;
+    // Collapse the first paragraph (up to first blank line) into one line
+    const firstPara = raw.split(/\n\s*\n/)[0] ?? raw;
+    const collapsed = firstPara
+        .split('\n')
+        .map((l) => l.trim())
+        .filter(Boolean)
+        .join(' ');
+    // Return up to the first sentence-ending punctuation
+    const match = collapsed.match(/^([^.!?]*[.!?]?)/);
+    return ((match ? match[1].trim() : collapsed).slice(0, 200)) || null;
+}
+// ─── Name helpers ─────────────────────────────────────────────────────────────
+/** Get the plain identifier name from a function_definition or class_definition. */
+function getName(node) {
+    return node.children.find((c) => c.type === 'identifier')?.text ?? '';
+}
+/**
+ * If node is a `decorated_definition`, unwrap to the inner function_definition
+ * or class_definition. Otherwise return the node unchanged.
+ */
+function unwrapDecorated(node) {
+    if (node.type === 'decorated_definition') {
+        const inner = node.children.find((c) => c.type === 'function_definition' || c.type === 'class_definition');
+        if (inner)
+            return { outer: node, inner };
+        return null;
+    }
+    if (node.type === 'function_definition' || node.type === 'class_definition') {
+        return { outer: node, inner: node };
+    }
+    return null;
+}
+// ─── Symbol extraction ────────────────────────────────────────────────────────
+function extractClassMembers(classNode, className, source, filePath, symbols) {
+    const block = classNode.children.find((c) => c.type === 'block');
+    if (!block)
+        return;
+    for (const child of block.children) {
+        const pair = unwrapDecorated(child);
+        if (!pair)
+            continue;
+        const { outer, inner } = pair;
+        if (inner.type === 'function_definition') {
+            const name = getName(inner);
+            if (!name)
+                continue;
+            const qualified = `${className}.${name}`;
+            symbols.push({
+                id: makeId(filePath, qualified, 'method'),
+                name: qualified,
+                kind: 'method',
+                filePath,
+                startByte: outer.startIndex,
+                endByte: outer.endIndex,
+                signature: buildSignature(outer, source),
+                summary: extractDocstring(inner) ?? '',
+            });
+        }
+        // Nested classes are not indexed — too noisy for navigation.
+    }
+}
+function extractSymbols(tree, source, filePath) {
+    const symbols = [];
+    for (const node of tree.rootNode.children) {
+        // ── function_definition / class_definition (possibly decorated) ──────────
+        const pair = unwrapDecorated(node);
+        if (pair) {
+            const { outer, inner } = pair;
+            if (inner.type === 'function_definition') {
+                const name = getName(inner);
+                if (!name)
+                    continue;
+                symbols.push({
+                    id: makeId(filePath, name, 'function'),
+                    name,
+                    kind: 'function',
+                    filePath,
+                    startByte: outer.startIndex,
+                    endByte: outer.endIndex,
+                    signature: buildSignature(outer, source),
+                    summary: extractDocstring(inner) ?? '',
+                });
+                continue;
+            }
+            if (inner.type === 'class_definition') {
+                const name = getName(inner);
+                if (!name)
+                    continue;
+                symbols.push({
+                    id: makeId(filePath, name, 'class'),
+                    name,
+                    kind: 'class',
+                    filePath,
+                    startByte: outer.startIndex,
+                    endByte: outer.endIndex,
+                    signature: buildSignature(outer, source),
+                    summary: extractDocstring(inner) ?? '',
+                });
+                extractClassMembers(inner, name, source, filePath, symbols);
+                continue;
+            }
+        }
+        // ── Module-level type alias (Python 3.12+) ────────────────────────────────
+        if (node.type === 'type_alias_statement') {
+            const nameNode = node.children.find((c) => c.type === 'type' || c.type === 'identifier');
+            if (!nameNode)
+                continue;
+            // The first identifier-like child is the alias name
+            const name = nameNode.type === 'type'
+                ? nameNode.children.find((c) => c.type === 'identifier')?.text ?? nameNode.text
+                : nameNode.text;
+            if (!name)
+                continue;
+            symbols.push({
+                id: makeId(filePath, name, 'type'),
+                name,
+                kind: 'type',
+                filePath,
+                startByte: node.startIndex,
+                endByte: node.endIndex,
+                signature: source
+                    .toString('utf8', node.startIndex, node.endIndex)
+                    .replace(/\s+/g, ' ')
+                    .trim()
+                    .slice(0, 120),
+                summary: '',
+            });
+            continue;
+        }
+        // ── Module-level UPPER_CASE constant ─────────────────────────────────────
+        if (node.type === 'expression_statement') {
+            const assignment = node.children.find((c) => c.type === 'assignment');
+            if (!assignment)
+                continue;
+            const lhs = assignment.children.find((c) => c.type === 'identifier');
+            if (!lhs)
+                continue;
+            const constName = lhs.text;
+            // Only extract ALL_CAPS names (Python constant convention: at least 2 chars)
+            if (!/^[A-Z][A-Z0-9_]{1,}$/.test(constName))
+                continue;
+            symbols.push({
+                id: makeId(filePath, constName, 'const'),
+                name: constName,
+                kind: 'const',
+                filePath,
+                startByte: node.startIndex,
+                endByte: node.endIndex,
+                signature: source
+                    .toString('utf8', node.startIndex, node.endIndex)
+                    .replace(/\s+/g, ' ')
+                    .trim()
+                    .slice(0, 120),
+                summary: '',
+            });
+            continue;
+        }
+    }
+    return symbols;
+}
+// ─── Import extraction ────────────────────────────────────────────────────────
+/**
+ * Collect imported names from direct children of an import_from_statement that
+ * appear after the 'import' keyword. Names are dotted_name nodes (e.g. Path,
+ * format_number) or wildcard_import (*).
+ */
+function collectFromImportNames(node) {
+    const names = [];
+    let pastImportKeyword = false;
+    for (const child of node.children) {
+        if (child.type === 'import') {
+            pastImportKeyword = true;
+            continue;
+        }
+        if (!pastImportKeyword)
+            continue;
+        if (child.type === 'wildcard_import') {
+            names.push('*');
+        }
+        else if (child.type === 'dotted_name' || child.type === 'identifier') {
+            // First identifier in dotted_name is the bare import name
+            const ident = child.children.find((c) => c.type === 'identifier') ?? child;
+            names.push(ident.text);
+        }
+        else if (child.type === 'aliased_import') {
+            const original = child.children.find((c) => c.type === 'dotted_name' || c.type === 'identifier');
+            if (original) {
+                const ident = original.children.find((c) => c.type === 'identifier') ?? original;
+                names.push(ident.text);
+            }
+        }
+    }
+    return names;
+}
+function extractImports(tree, _source) {
+    const imports = [];
+    for (const node of tree.rootNode.children) {
+        // import os  /  import os.path  /  import os as o
+        if (node.type === 'import_statement') {
+            for (const child of node.children) {
+                if (child.type === 'dotted_name') {
+                    imports.push({
+                        sourceFile: '',
+                        specifier: child.text,
+                        resolvedPath: null,
+                        importedNames: [],
+                        isTypeOnly: false,
+                    });
+                }
+                else if (child.type === 'aliased_import') {
+                    const modNode = child.children.find((c) => c.type === 'dotted_name');
+                    if (modNode) {
+                        imports.push({
+                            sourceFile: '',
+                            specifier: modNode.text,
+                            resolvedPath: null,
+                            importedNames: [],
+                            isTypeOnly: false,
+                        });
+                    }
+                }
+            }
+            continue;
+        }
+        // from __future__ import annotations
+        // The grammar uses a dedicated `future_import_statement` node for this.
+        if (node.type === 'future_import_statement') {
+            const importedNames = collectFromImportNames(node);
+            imports.push({
+                sourceFile: '',
+                specifier: '__future__',
+                resolvedPath: null,
+                importedNames,
+                isTypeOnly: true, // __future__ imports are always compile-time directives
+            });
+            continue;
+        }
+        // from pathlib import Path  /  from . import foo  /  from ..utils import bar
+        if (node.type === 'import_from_statement') {
+            // Build specifier from the module reference (between 'from' and 'import')
+            let specifier = '';
+            const moduleNode = node.children.find((c) => c.type === 'dotted_name' || c.type === 'relative_import');
+            if (moduleNode) {
+                if (moduleNode.type === 'relative_import') {
+                    // relative_import: import_prefix (dots) + optional dotted_name
+                    const prefix = moduleNode.children.find((c) => c.type === 'import_prefix');
+                    const mod = moduleNode.children.find((c) => c.type === 'dotted_name');
+                    specifier = (prefix?.text ?? '') + (mod?.text ?? '');
+                }
+                else {
+                    specifier = moduleNode.text; // dotted_name
+                }
+            }
+            if (!specifier)
+                continue;
+            const importedNames = collectFromImportNames(node);
+            imports.push({
+                sourceFile: '',
+                specifier,
+                resolvedPath: null,
+                importedNames,
+                isTypeOnly: false,
+            });
+        }
+    }
+    return imports;
+}
+// ─── Handler export ───────────────────────────────────────────────────────────
+export const pythonHandler = {
+    extensions: () => ['.py'],
+    grammarPath: () => resolve(GRAMMARS_DIR, 'tree-sitter-python.wasm'),
+    extractSymbols,
+    extractImports,
+    extractDocstring,
+};
+//# sourceMappingURL=python.js.map

package/dist/handlers/python.js.map

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

package/dist/handlers/r.d.ts

@@ -0,0 +1,9 @@
+import type { LanguageHandler, SyntaxNode } from '../core/types.js';
+/**
+ * Extract Roxygen2 documentation (`#'` lines) immediately preceding `node`.
+ * Walks `previousNamedSibling` looking for `comment` nodes whose text
+ * starts with `#'`. Returns null when no Roxygen2 comment is found.
+ */
+export declare function extractDocstring(node: SyntaxNode): string | null;
+export declare const rHandler: LanguageHandler;
+//# sourceMappingURL=r.d.ts.map

package/dist/handlers/r.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"r.d.ts","sourceRoot":"","sources":["../../src/handlers/r.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,eAAe,EAIf,UAAU,EAEX,MAAM,kBAAkB,CAAC;AAuB1B;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,GAAG,IAAI,CA0BhE;AAqaD,eAAO,MAAM,QAAQ,EAAE,eAMtB,CAAC"}