purecontext-mcp 1.0.1

package/dist/handlers/go.js

@@ -0,0 +1,262 @@
+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);
+}
+// ─── Visibility ───────────────────────────────────────────────────────────────
+/** Go exports only names that start with an uppercase letter. */
+function isExported(name) {
+    return name.length > 0 && name[0] === name[0].toUpperCase() && name[0] !== name[0].toLowerCase();
+}
+// ─── Signature building ───────────────────────────────────────────────────────
+/**
+ * Build a one-line signature by taking source from the node start up to (but
+ * not including) the opening brace block. Collapses whitespace, caps at 120 chars.
+ */
+function buildSignature(node, source) {
+    const blockNode = node.children.find((c) => c.type === 'block');
+    const endByte = blockNode ? blockNode.startIndex : node.endIndex;
+    return source
+        .toString('utf8', node.startIndex, endByte)
+        .replace(/\s+/g, ' ')
+        .trim()
+        .slice(0, 120);
+}
+/**
+ * Build a compact signature for a type declaration.
+ * Shows the keyword + name + type keyword (struct/interface), truncated body preview.
+ */
+function buildTypeSignature(typeDecl, source) {
+    // Full text is "type Name struct { ... }" — collapse to one line and truncate
+    return source
+        .toString('utf8', typeDecl.startIndex, typeDecl.endIndex)
+        .replace(/\s+/g, ' ')
+        .trim()
+        .slice(0, 120);
+}
+/**
+ * Build a signature for a const spec (single constant).
+ * "const NAME = value" or "const NAME Type = value"
+ */
+function buildConstSignature(spec, source) {
+    return 'const ' + source
+        .toString('utf8', spec.startIndex, spec.endIndex)
+        .replace(/\s+/g, ' ')
+        .trim()
+        .slice(0, 116); // 116 + "const " = 122, then sliced to 120
+}
+// ─── Docstring extraction ─────────────────────────────────────────────────────
+/**
+ * Extract a Go doc comment: one or more `// ...` comment lines that immediately
+ * precede the declaration node (as the previousNamedSibling chain).
+ */
+function extractDocstring(node) {
+    // Walk backwards through named siblings to collect adjacent comment lines
+    const lines = [];
+    let prev = node.previousNamedSibling;
+    while (prev?.type === 'comment') {
+        lines.unshift(prev.text.replace(/^\/\/\s?/, '').trim());
+        prev = prev.previousNamedSibling;
+    }
+    if (lines.length === 0)
+        return null;
+    const text = lines.join(' ').trim();
+    if (!text)
+        return null;
+    // Return up to the first sentence-ending punctuation
+    const match = text.match(/^([^.!?]*[.!?]?)/);
+    return ((match ? match[1].trim() : text).slice(0, 200)) || null;
+}
+// ─── Receiver type extraction ─────────────────────────────────────────────────
+/**
+ * Extract the receiver type name from the first parameter_list of a method_declaration.
+ * Handles both pointer receivers `(s *AuthService)` and value receivers `(s AuthService)`.
+ */
+function extractReceiverType(methodNode) {
+    const receiverList = methodNode.children.find((c) => c.type === 'parameter_list');
+    if (!receiverList)
+        return '';
+    const paramDecl = receiverList.children.find((c) => c.type === 'parameter_declaration');
+    if (!paramDecl)
+        return '';
+    // Pointer receiver: parameter_declaration → pointer_type → type_identifier
+    const ptrType = paramDecl.children.find((c) => c.type === 'pointer_type');
+    if (ptrType) {
+        return ptrType.children.find((c) => c.type === 'type_identifier')?.text ?? '';
+    }
+    // Value receiver: parameter_declaration → type_identifier
+    return paramDecl.children.find((c) => c.type === 'type_identifier')?.text ?? '';
+}
+// ─── Symbol extraction ────────────────────────────────────────────────────────
+function extractSymbols(tree, source, filePath) {
+    const symbols = [];
+    for (const node of tree.rootNode.children) {
+        // ── function_declaration ─────────────────────────────────────────────────
+        if (node.type === 'function_declaration') {
+            const nameNode = node.children.find((c) => c.type === 'identifier');
+            if (!nameNode)
+                continue;
+            const name = nameNode.text;
+            if (!isExported(name))
+                continue;
+            symbols.push({
+                id: makeId(filePath, name, 'function'),
+                name,
+                kind: 'function',
+                filePath,
+                startByte: node.startIndex,
+                endByte: node.endIndex,
+                signature: buildSignature(node, source),
+                summary: extractDocstring(node) ?? '',
+            });
+            continue;
+        }
+        // ── method_declaration ───────────────────────────────────────────────────
+        if (node.type === 'method_declaration') {
+            const nameNode = node.children.find((c) => c.type === 'field_identifier');
+            if (!nameNode)
+                continue;
+            const methodName = nameNode.text;
+            if (!isExported(methodName))
+                continue;
+            const receiverType = extractReceiverType(node);
+            const qualifiedName = receiverType ? `${receiverType}.${methodName}` : methodName;
+            symbols.push({
+                id: makeId(filePath, qualifiedName, 'method'),
+                name: qualifiedName,
+                kind: 'method',
+                filePath,
+                startByte: node.startIndex,
+                endByte: node.endIndex,
+                signature: buildSignature(node, source),
+                summary: extractDocstring(node) ?? '',
+            });
+            continue;
+        }
+        // ── type_declaration (struct / interface / type alias / custom type) ─────
+        if (node.type === 'type_declaration') {
+            // Go uses type_spec for `type Foo struct{}`/`type Foo Bar`
+            // and type_alias for `type Foo = Bar`
+            const typeSpec = node.children.find((c) => c.type === 'type_spec' || c.type === 'type_alias');
+            if (!typeSpec)
+                continue;
+            const nameNode = typeSpec.children.find((c) => c.type === 'type_identifier');
+            if (!nameNode)
+                continue;
+            const name = nameNode.text;
+            if (!isExported(name))
+                continue;
+            // Determine kind from the type body (type_alias is always kind 'type')
+            const typeBody = typeSpec.type === 'type_spec'
+                ? typeSpec.children.find((c) => c.type !== 'type_identifier' && c.type !== 'type_parameters')
+                : null;
+            let kind = 'type';
+            if (typeBody?.type === 'struct_type')
+                kind = 'class';
+            else if (typeBody?.type === 'interface_type')
+                kind = 'interface';
+            symbols.push({
+                id: makeId(filePath, name, kind),
+                name,
+                kind,
+                filePath,
+                startByte: node.startIndex,
+                endByte: node.endIndex,
+                signature: buildTypeSignature(node, source),
+                summary: extractDocstring(node) ?? '',
+            });
+            continue;
+        }
+        // ── const_declaration ────────────────────────────────────────────────────
+        if (node.type === 'const_declaration') {
+            // May contain multiple const_spec children (grouped const block)
+            for (const child of node.children) {
+                if (child.type !== 'const_spec')
+                    continue;
+                const nameNode = child.children.find((c) => c.type === 'identifier');
+                if (!nameNode)
+                    continue;
+                const name = nameNode.text;
+                if (!isExported(name))
+                    continue;
+                symbols.push({
+                    id: makeId(filePath, name, 'const'),
+                    name,
+                    kind: 'const',
+                    filePath,
+                    startByte: child.startIndex,
+                    endByte: child.endIndex,
+                    signature: buildConstSignature(child, source),
+                    summary: extractDocstring(node) ?? '',
+                });
+            }
+            continue;
+        }
+    }
+    return symbols;
+}
+// ─── Import extraction ────────────────────────────────────────────────────────
+/**
+ * Extract the path string from an import_spec's interpreted_string_literal.
+ * e.g. `"fmt"` → `fmt`, `"math/rand"` → `math/rand`
+ */
+function getImportPath(spec) {
+    const strLit = spec.children.find((c) => c.type === 'interpreted_string_literal');
+    if (!strLit)
+        return '';
+    const content = strLit.children.find((c) => c.type === 'interpreted_string_literal_content');
+    return content?.text ?? '';
+}
+function extractImports(tree, _source) {
+    const imports = [];
+    for (const node of tree.rootNode.children) {
+        if (node.type !== 'import_declaration')
+            continue;
+        // Collect all import_spec nodes (either direct child or inside import_spec_list)
+        const specs = [];
+        for (const child of node.children) {
+            if (child.type === 'import_spec') {
+                specs.push(child);
+            }
+            else if (child.type === 'import_spec_list') {
+                for (const inner of child.children) {
+                    if (inner.type === 'import_spec')
+                        specs.push(inner);
+                }
+            }
+        }
+        for (const spec of specs) {
+            const specifier = getImportPath(spec);
+            if (!specifier)
+                continue;
+            // Detect blank imports (`_ "pkg"`) — skip entirely (side-effect only)
+            const isBlank = spec.children.some((c) => c.type === 'blank_identifier');
+            if (isBlank)
+                continue;
+            imports.push({
+                sourceFile: '',
+                specifier,
+                resolvedPath: null, // Go uses module paths — resolution requires go.mod parsing
+                importedNames: [], // Go imports are package-level, not named symbol imports
+                isTypeOnly: false,
+            });
+        }
+    }
+    return imports;
+}
+// ─── Handler export ───────────────────────────────────────────────────────────
+export const goHandler = {
+    extensions: () => ['.go'],
+    grammarPath: () => resolve(GRAMMARS_DIR, 'tree-sitter-go.wasm'),
+    extractSymbols,
+    extractImports,
+    extractDocstring,
+};
+//# sourceMappingURL=go.js.map

package/dist/handlers/go.js.map

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

package/dist/handlers/handler-registry.d.ts

@@ -0,0 +1,20 @@
+import type { LanguageHandler } from '../core/types.js';
+/**
+ * Register a language handler. Each extension it claims maps to this handler.
+ * If two handlers claim the same extension, the last registration wins.
+ */
+export declare function registerHandler(handler: LanguageHandler): void;
+/** Resolve the handler for a given file path by its extension. Returns null if unsupported. */
+export declare function getHandler(filePath: string): LanguageHandler | null;
+/** All registered handlers, in registration order. */
+export declare function getAllHandlers(): LanguageHandler[];
+/** All file extensions currently supported across all registered handlers. */
+export declare function getSupportedExtensions(): string[];
+/**
+ * Resolve a handler by language name ('typescript' → .ts handler, 'javascript' → .js handler).
+ * Used by the adapter pipeline to route pre-processed blocks.
+ */
+export declare function getHandlerByLanguage(language: string): LanguageHandler | null;
+/** Remove all registrations (use only in tests). */
+export declare function _resetForTesting(): void;
+//# sourceMappingURL=handler-registry.d.ts.map

package/dist/handlers/handler-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler-registry.d.ts","sourceRoot":"","sources":["../../src/handlers/handler-registry.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AASxD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI,CAO9D;AAED,+FAA+F;AAC/F,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CAGnE;AAED,sDAAsD;AACtD,wBAAgB,cAAc,IAAI,eAAe,EAAE,CAElD;AAED,8EAA8E;AAC9E,wBAAgB,sBAAsB,IAAI,MAAM,EAAE,CAEjD;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CA4B7E;AAED,oDAAoD;AACpD,wBAAgB,gBAAgB,IAAI,IAAI,CAGvC"}

package/dist/handlers/handler-registry.js

@@ -0,0 +1,69 @@
+import { extname } from 'path';
+// ─── Registry state ───────────────────────────────────────────────────────────
+const byExtension = new Map();
+const handlers = [];
+// ─── Public API ───────────────────────────────────────────────────────────────
+/**
+ * Register a language handler. Each extension it claims maps to this handler.
+ * If two handlers claim the same extension, the last registration wins.
+ */
+export function registerHandler(handler) {
+    for (const ext of handler.extensions()) {
+        byExtension.set(ext.toLowerCase(), handler);
+    }
+    if (!handlers.includes(handler)) {
+        handlers.push(handler);
+    }
+}
+/** Resolve the handler for a given file path by its extension. Returns null if unsupported. */
+export function getHandler(filePath) {
+    const ext = extname(filePath).toLowerCase();
+    return byExtension.get(ext) ?? null;
+}
+/** All registered handlers, in registration order. */
+export function getAllHandlers() {
+    return [...handlers];
+}
+/** All file extensions currently supported across all registered handlers. */
+export function getSupportedExtensions() {
+    return [...byExtension.keys()];
+}
+/**
+ * Resolve a handler by language name ('typescript' → .ts handler, 'javascript' → .js handler).
+ * Used by the adapter pipeline to route pre-processed blocks.
+ */
+export function getHandlerByLanguage(language) {
+    const langToExt = {
+        typescript: '.ts',
+        javascript: '.js',
+        python: '.py',
+        go: '.go',
+        rust: '.rs',
+        java: '.java',
+        csharp: '.cs',
+        php: '.php',
+        ruby: '.rb',
+        kotlin: '.kt',
+        c: '.c',
+        cpp: '.cpp',
+        lua: '.lua',
+        dart: '.dart',
+        swift: '.swift',
+        elixir: '.ex',
+        elixir_script: '.exs',
+        haskell: '.hs',
+        lhs: '.lhs',
+        scala: '.scala',
+        scala_script: '.sc',
+        r: '.r',
+        rmd: '.Rmd',
+    };
+    const ext = langToExt[language.toLowerCase()];
+    return ext ? (byExtension.get(ext) ?? null) : null;
+}
+/** Remove all registrations (use only in tests). */
+export function _resetForTesting() {
+    byExtension.clear();
+    handlers.length = 0;
+}
+//# sourceMappingURL=handler-registry.js.map

package/dist/handlers/handler-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler-registry.js","sourceRoot":"","sources":["../../src/handlers/handler-registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAG/B,iFAAiF;AAEjF,MAAM,WAAW,GAAG,IAAI,GAAG,EAA2B,CAAC;AACvD,MAAM,QAAQ,GAAsB,EAAE,CAAC;AAEvC,iFAAiF;AAEjF;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,OAAwB;IACtD,KAAK,MAAM,GAAG,IAAI,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC;QACvC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,WAAW,EAAE,EAAE,OAAO,CAAC,CAAC;IAC9C,CAAC;IACD,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QAChC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACzB,CAAC;AACH,CAAC;AAED,+FAA+F;AAC/F,MAAM,UAAU,UAAU,CAAC,QAAgB;IACzC,MAAM,GAAG,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC;IAC5C,OAAO,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC;AACtC,CAAC;AAED,sDAAsD;AACtD,MAAM,UAAU,cAAc;IAC5B,OAAO,CAAC,GAAG,QAAQ,CAAC,CAAC;AACvB,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,sBAAsB;IACpC,OAAO,CAAC,GAAG,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC;AACjC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAAC,QAAgB;IACnD,MAAM,SAAS,GAA2B;QACxC,UAAU,EAAE,KAAK;QACjB,UAAU,EAAE,KAAK;QACjB,MAAM,EAAE,KAAK;QACb,EAAE,EAAE,KAAK;QACT,IAAI,EAAE,KAAK;QACX,IAAI,EAAE,OAAO;QACb,MAAM,EAAE,KAAK;QACb,GAAG,EAAE,MAAM;QACX,IAAI,EAAE,KAAK;QACX,MAAM,EAAE,KAAK;QACb,CAAC,EAAE,IAAI;QACP,GAAG,EAAE,MAAM;QACX,GAAG,EAAE,MAAM;QACX,IAAI,EAAE,OAAO;QACb,KAAK,EAAE,QAAQ;QACf,MAAM,EAAE,KAAK;QACb,aAAa,EAAE,MAAM;QACrB,OAAO,EAAE,KAAK;QACd,GAAG,EAAE,MAAM;QACX,KAAK,EAAE,QAAQ;QACf,YAAY,EAAE,KAAK;QACnB,CAAC,EAAE,IAAI;QACP,GAAG,EAAE,MAAM;KACZ,CAAC;IACF,MAAM,GAAG,GAAG,SAAS,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC;IAC9C,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AACrD,CAAC;AAED,oDAAoD;AACpD,MAAM,UAAU,gBAAgB;IAC9B,WAAW,CAAC,KAAK,EAAE,CAAC;IACpB,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;AACtB,CAAC"}

package/dist/handlers/haskell.d.ts

@@ -0,0 +1,17 @@
+import type { LanguageHandler, SyntaxNode } from '../core/types.js';
+/**
+ * Find the Haddock comment that precedes `node` inside a `declarations` block.
+ *
+ * The tree-sitter-haskell grammar places haddock nodes in two locations:
+ * - Inside `declarations`: as a named sibling immediately before the
+ *   next declaration.
+ * - At root level: when the haddock precedes the very first declaration,
+ *   it becomes a sibling of `declarations` itself (i.e., a child of the
+ *   root `haskell` node).
+ *
+ * Strategy: check `previousNamedSibling`; if the node is the first
+ * in `declarations`, also check `declarations.previousNamedSibling`.
+ */
+export declare function extractDocstring(node: SyntaxNode): string | null;
+export declare const haskellHandler: LanguageHandler;
+//# sourceMappingURL=haskell.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"haskell.d.ts","sourceRoot":"","sources":["../../src/handlers/haskell.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,eAAe,EAIf,UAAU,EAEX,MAAM,kBAAkB,CAAC;AA2C1B;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,GAAG,IAAI,CA6BhE;AA2RD,eAAO,MAAM,cAAc,EAAE,eAM5B,CAAC"}