purecontext-mcp 1.0.1

package/dist/handlers/typescript.js

@@ -0,0 +1,325 @@
+import { createHash } from 'crypto';
+import { dirname, resolve } from 'path';
+import { fileURLToPath } from 'url';
+const __dirname = dirname(fileURLToPath(import.meta.url));
+// dist/handlers/ → ../../grammars/
+const GRAMMARS_DIR = resolve(__dirname, '../../grammars');
+const BODY_NODE_TYPES = new Set([
+    'statement_block', 'class_body', 'interface_body', 'enum_body',
+]);
+const SKIP_IN_EXPORT = new Set(['export', 'default', ';']);
+// ─── Symbol ID ────────────────────────────────────────────────────────────────
+function makeId(filePath, name, kind) {
+    return createHash('sha256')
+        .update(`${filePath}:${name}:${kind}`)
+        .digest('hex')
+        .slice(0, 16);
+}
+// ─── Signature building ───────────────────────────────────────────────────────
+function buildSignature(node, source) {
+    let endByte = node.endIndex;
+    // If this is an export_statement, unwrap to the inner declaration before
+    // searching for a body node so we don't miss class_body / statement_block.
+    const declNode = node.type === 'export_statement'
+        ? (node.children.find((c) => !SKIP_IN_EXPORT.has(c.type)) ?? node)
+        : node;
+    const bodyNode = findBodyNode(declNode);
+    if (bodyNode)
+        endByte = bodyNode.startIndex;
+    return source
+        .toString('utf8', node.startIndex, endByte)
+        .replace(/\s+/g, ' ')
+        .trim()
+        .slice(0, 120);
+}
+function findBodyNode(node) {
+    for (const child of node.children) {
+        if (BODY_NODE_TYPES.has(child.type))
+            return child;
+        if (child.type === 'variable_declarator') {
+            const inner = findBodyNode(child);
+            if (inner)
+                return inner;
+        }
+        if (child.type === 'arrow_function') {
+            for (const c of child.children) {
+                if (BODY_NODE_TYPES.has(c.type))
+                    return c;
+            }
+        }
+    }
+    return null;
+}
+// ─── Docstring extraction ─────────────────────────────────────────────────────
+function extractDocstring(node) {
+    // The JSDoc comment precedes either the declaration or its wrapping export_statement
+    const outer = node.parent?.type === 'export_statement' ? node.parent : node;
+    const prev = outer.previousNamedSibling;
+    if (!prev || prev.type !== 'comment')
+        return null;
+    const text = prev.text;
+    if (!text.startsWith('/**'))
+        return null;
+    // Strip /** ... */ delimiters, leading * per line, and collapse whitespace
+    const body = text
+        .slice(2, -2) // remove /** and */
+        .split('\n')
+        .map((l) => l.replace(/^\s*\*\s?/, '').trim())
+        .filter(Boolean)
+        .join(' ');
+    // First sentence: up to first period followed by whitespace or end
+    const match = body.match(/^([^.!?]+[.!?]?)/);
+    return match ? match[1].trim().slice(0, 200) : body.slice(0, 200);
+}
+// ─── Name extraction helpers ──────────────────────────────────────────────────
+// node.startIndex / endIndex are JavaScript character indices (not byte offsets)
+// because web-tree-sitter's callback mode indexes by character.
+function getChildText(node, sourceStr, ...types) {
+    for (const child of node.children) {
+        if (types.includes(child.type)) {
+            return sourceStr.slice(child.startIndex, child.endIndex);
+        }
+    }
+    return '';
+}
+// ─── Symbol extraction ────────────────────────────────────────────────────────
+function processDeclaration(declNode, outerNode, // export_statement if exported, same as declNode otherwise
+source, sourceStr, // source.toString('utf8') — for character-indexed text extraction
+filePath, symbols, tsOnly) {
+    switch (declNode.type) {
+        case 'function_declaration': {
+            const name = getChildText(declNode, sourceStr, 'identifier');
+            if (!name)
+                break;
+            const summary = extractDocstring(declNode) ?? '';
+            symbols.push({
+                id: makeId(filePath, name, 'function'),
+                name,
+                kind: 'function',
+                filePath,
+                startByte: outerNode.startIndex,
+                endByte: outerNode.endIndex,
+                signature: buildSignature(outerNode, source),
+                summary,
+            });
+            break;
+        }
+        case 'class_declaration':
+        case 'abstract_class_declaration': {
+            const name = getChildText(declNode, sourceStr, 'type_identifier');
+            if (!name)
+                break;
+            const summary = extractDocstring(declNode) ?? '';
+            symbols.push({
+                id: makeId(filePath, name, 'class'),
+                name,
+                kind: 'class',
+                filePath,
+                startByte: outerNode.startIndex,
+                endByte: outerNode.endIndex,
+                signature: buildSignature(outerNode, source),
+                summary,
+            });
+            // Extract methods from class_body
+            const body = declNode.children.find((c) => c.type === 'class_body');
+            if (body) {
+                for (const member of body.children) {
+                    if (member.type === 'method_definition') {
+                        const methodName = getChildText(member, sourceStr, 'property_identifier', 'identifier');
+                        if (!methodName || methodName.startsWith('#'))
+                            continue; // skip private
+                        const qualified = `${name}.${methodName}`;
+                        const methodDoc = member.previousNamedSibling?.type === 'comment'
+                            ? extractDocstring(member)
+                            : null;
+                        symbols.push({
+                            id: makeId(filePath, qualified, 'method'),
+                            name: qualified,
+                            kind: 'method',
+                            filePath,
+                            startByte: member.startIndex,
+                            endByte: member.endIndex,
+                            signature: buildSignature(member, source),
+                            summary: methodDoc ?? '',
+                        });
+                    }
+                }
+            }
+            break;
+        }
+        case 'lexical_declaration': {
+            // const/let at top level — only extract named declarators
+            for (const child of declNode.children) {
+                if (child.type !== 'variable_declarator')
+                    continue;
+                const name = getChildText(child, sourceStr, 'identifier');
+                if (!name)
+                    continue;
+                const hasArrow = child.children.some((c) => c.type === 'arrow_function');
+                const kind = hasArrow ? 'function' : 'const';
+                const summary = extractDocstring(declNode) ?? '';
+                symbols.push({
+                    id: makeId(filePath, name, kind),
+                    name,
+                    kind,
+                    filePath,
+                    startByte: outerNode.startIndex,
+                    endByte: outerNode.endIndex,
+                    signature: buildSignature(outerNode, source),
+                    summary,
+                });
+            }
+            break;
+        }
+        case 'type_alias_declaration': {
+            if (!tsOnly)
+                break;
+            const name = getChildText(declNode, sourceStr, 'type_identifier');
+            if (!name)
+                break;
+            symbols.push({
+                id: makeId(filePath, name, 'type'),
+                name,
+                kind: 'type',
+                filePath,
+                startByte: outerNode.startIndex,
+                endByte: outerNode.endIndex,
+                signature: buildSignature(outerNode, source),
+                summary: extractDocstring(declNode) ?? '',
+            });
+            break;
+        }
+        case 'interface_declaration': {
+            if (!tsOnly)
+                break;
+            const name = getChildText(declNode, sourceStr, 'type_identifier');
+            if (!name)
+                break;
+            symbols.push({
+                id: makeId(filePath, name, 'interface'),
+                name,
+                kind: 'interface',
+                filePath,
+                startByte: outerNode.startIndex,
+                endByte: outerNode.endIndex,
+                signature: buildSignature(outerNode, source),
+                summary: extractDocstring(declNode) ?? '',
+            });
+            break;
+        }
+        case 'enum_declaration': {
+            if (!tsOnly)
+                break;
+            const name = getChildText(declNode, sourceStr, 'identifier');
+            if (!name)
+                break;
+            symbols.push({
+                id: makeId(filePath, name, 'enum'),
+                name,
+                kind: 'enum',
+                filePath,
+                startByte: outerNode.startIndex,
+                endByte: outerNode.endIndex,
+                signature: buildSignature(outerNode, source),
+                summary: extractDocstring(declNode) ?? '',
+            });
+            break;
+        }
+    }
+}
+function extractSymbols(tree, source, filePath, tsOnly) {
+    const sourceStr = source.toString('utf8');
+    const symbols = [];
+    for (const node of tree.rootNode.children) {
+        if (node.type === 'export_statement') {
+            // Find the declaration inside, skipping export/default keywords
+            for (const child of node.children) {
+                if (!SKIP_IN_EXPORT.has(child.type)) {
+                    processDeclaration(child, node, source, sourceStr, filePath, symbols, tsOnly);
+                    break;
+                }
+            }
+        }
+        else {
+            // Also index non-exported top-level declarations (useful for navigation)
+            processDeclaration(node, node, source, sourceStr, filePath, symbols, tsOnly);
+        }
+    }
+    return symbols;
+}
+// ─── Import extraction ────────────────────────────────────────────────────────
+function extractImports(tree, source) {
+    const sourceStr = source.toString('utf8');
+    const imports = [];
+    // Detect source file path from the tree (needed for ImportRecord.sourceFile)
+    // Caller sets this — we leave it empty here and fill it in the handler wrapper
+    const sourceFile = '';
+    for (const node of tree.rootNode.children) {
+        if (node.type !== 'import_statement')
+            continue;
+        // Detect `import type`
+        const isTypeOnly = node.children.some((c) => c.type === 'type');
+        // Extract specifier string (the path after 'from')
+        const stringNode = node.children.find((c) => c.type === 'string');
+        const specifier = stringNode
+            ? getChildText(stringNode, sourceStr, 'string_fragment')
+            : '';
+        if (!specifier)
+            continue;
+        const importedNames = [];
+        const clause = node.children.find((c) => c.type === 'import_clause');
+        if (clause) {
+            for (const child of clause.children) {
+                if (child.type === 'identifier') {
+                    // default import: `import Foo from '...'`
+                    importedNames.push(sourceStr.slice(child.startIndex, child.endIndex));
+                }
+                else if (child.type === 'namespace_import') {
+                    // `import * as ns from '...'`
+                    const alias = child.children.find((c) => c.type === 'identifier');
+                    if (alias)
+                        importedNames.push(`* as ${sourceStr.slice(alias.startIndex, alias.endIndex)}`);
+                }
+                else if (child.type === 'named_imports') {
+                    // `import { foo, bar as baz } from '...'`
+                    for (const spec of child.children) {
+                        if (spec.type !== 'import_specifier')
+                            continue;
+                        const idents = spec.children.filter((c) => c.type === 'identifier');
+                        // idents[0] = original name, idents[1] = alias (if present)
+                        if (idents[0])
+                            importedNames.push(sourceStr.slice(idents[0].startIndex, idents[0].endIndex));
+                    }
+                }
+            }
+        }
+        // Side-effect import: `import './foo'` has no clause — importedNames stays []
+        imports.push({
+            sourceFile,
+            specifier,
+            resolvedPath: null, // resolved by path-resolver in Task 7
+            importedNames,
+            isTypeOnly,
+        });
+    }
+    return imports;
+}
+// ─── Handler implementations ─────────────────────────────────────────────────
+export const typescriptHandler = {
+    extensions: () => ['.ts', '.mts', '.cts'],
+    grammarPath: () => resolve(GRAMMARS_DIR, 'tree-sitter-typescript.wasm'),
+    extractSymbols: (tree, source, filePath) => extractSymbols(tree, source, filePath, true),
+    extractImports: (tree, source) => {
+        const imports = extractImports(tree, source);
+        return imports;
+    },
+    extractDocstring,
+};
+export const tsxHandler = {
+    extensions: () => ['.tsx'],
+    grammarPath: () => resolve(GRAMMARS_DIR, 'tree-sitter-tsx.wasm'),
+    extractSymbols: (tree, source, filePath) => extractSymbols(tree, source, filePath, true),
+    extractImports: (tree, source) => extractImports(tree, source),
+    extractDocstring,
+};
+//# sourceMappingURL=typescript.js.map

package/dist/handlers/typescript.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,44 @@
+#!/usr/bin/env node
+/**
+ * PureContext MCP — entry point.
+ *
+ * Usage:
+ *   purecontext-mcp                    Start the MCP server (stdio transport)
+ *   purecontext-mcp config             Show effective configuration
+ *   purecontext-mcp config --init      Generate ~/.purecontext/config.json
+ *   purecontext-mcp config --check     Validate config + check prerequisites
+ *   purecontext-mcp --version / -v     Print version and exit
+ *   purecontext-mcp --help / -h        Print usage and exit
+ */
+import './adapters/vue.js';
+import './adapters/nuxt.js';
+import './adapters/react.js';
+import './adapters/nextjs.js';
+import './adapters/angular.js';
+import './adapters/nestjs.js';
+import './adapters/express.js';
+import './adapters/fastify.js';
+import './adapters/flask.js';
+import './adapters/fastapi.js';
+import './adapters/django.js';
+import './adapters/gin.js';
+import './adapters/echo.js';
+import './adapters/fiber.js';
+import './adapters/laravel.js';
+import './adapters/symfony.js';
+import './adapters/rails.js';
+import './adapters/sinatra.js';
+import './adapters/ktor.js';
+import './adapters/spring-kotlin.js';
+import './adapters/flutter.js';
+import './adapters/vapor.js';
+import './adapters/axum.js';
+import './adapters/actix-web.js';
+import './adapters/rocket.js';
+import './adapters/spring-boot.js';
+import './adapters/micronaut.js';
+import './adapters/quarkus.js';
+import './adapters/hibernate.js';
+import './adapters/sqlalchemy.js';
+import './adapters/django-orm.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;;;;;;GAUG;AA4BH,OAAO,mBAAmB,CAAC;AAC3B,OAAO,oBAAoB,CAAC;AAC5B,OAAO,qBAAqB,CAAC;AAC7B,OAAO,sBAAsB,CAAC;AAC9B,OAAO,uBAAuB,CAAC;AAC/B,OAAO,sBAAsB,CAAC;AAC9B,OAAO,uBAAuB,CAAC;AAC/B,OAAO,uBAAuB,CAAC;AAC/B,OAAO,qBAAqB,CAAC;AAC7B,OAAO,uBAAuB,CAAC;AAC/B,OAAO,sBAAsB,CAAC;AAC9B,OAAO,mBAAmB,CAAC;AAC3B,OAAO,oBAAoB,CAAC;AAC5B,OAAO,qBAAqB,CAAC;AAC7B,OAAO,uBAAuB,CAAC;AAC/B,OAAO,uBAAuB,CAAC;AAC/B,OAAO,qBAAqB,CAAC;AAC7B,OAAO,uBAAuB,CAAC;AAC/B,OAAO,oBAAoB,CAAC;AAC5B,OAAO,6BAA6B,CAAC;AACrC,OAAO,uBAAuB,CAAC;AAC/B,OAAO,qBAAqB,CAAC;AAC7B,OAAO,oBAAoB,CAAC;AAC5B,OAAO,yBAAyB,CAAC;AACjC,OAAO,sBAAsB,CAAC;AAC9B,OAAO,2BAA2B,CAAC;AACnC,OAAO,yBAAyB,CAAC;AACjC,OAAO,uBAAuB,CAAC;AAC/B,OAAO,yBAAyB,CAAC;AACjC,OAAO,0BAA0B,CAAC;AAClC,OAAO,0BAA0B,CAAC"}

package/dist/index.js

@@ -0,0 +1,266 @@
+#!/usr/bin/env node
+/**
+ * PureContext MCP — entry point.
+ *
+ * Usage:
+ *   purecontext-mcp                    Start the MCP server (stdio transport)
+ *   purecontext-mcp config             Show effective configuration
+ *   purecontext-mcp config --init      Generate ~/.purecontext/config.json
+ *   purecontext-mcp config --check     Validate config + check prerequisites
+ *   purecontext-mcp --version / -v     Print version and exit
+ *   purecontext-mcp --help / -h        Print usage and exit
+ */
+import { createRequire } from 'module';
+import { fileURLToPath } from 'url';
+import { dirname, resolve } from 'path';
+import { logger } from './core/logger.js';
+import { initParser } from './core/parse-dispatcher.js';
+import { registerHandler } from './handlers/handler-registry.js';
+import { typescriptHandler, tsxHandler } from './handlers/typescript.js';
+import { javascriptHandler } from './handlers/javascript.js';
+import { pythonHandler } from './handlers/python.js';
+import { goHandler } from './handlers/go.js';
+import { rustHandler } from './handlers/rust.js';
+import { javaHandler } from './handlers/java.js';
+import { csharpHandler } from './handlers/csharp.js';
+import { phpHandler } from './handlers/php.js';
+import { rubyHandler } from './handlers/ruby.js';
+import { kotlinHandler } from './handlers/kotlin.js';
+import { cHandler } from './handlers/c.js';
+import { cppHandler } from './handlers/cpp.js';
+import { luaHandler } from './handlers/lua.js';
+import { dartHandler } from './handlers/dart.js';
+import { swiftHandler } from './handlers/swift.js';
+import { elixirHandler } from './handlers/elixir.js';
+import { haskellHandler } from './handlers/haskell.js';
+import { scalaHandler } from './handlers/scala.js';
+import { rHandler } from './handlers/r.js';
+// Framework adapters — imported for side-effect self-registration
+import './adapters/vue.js';
+import './adapters/nuxt.js';
+import './adapters/react.js';
+import './adapters/nextjs.js';
+import './adapters/angular.js';
+import './adapters/nestjs.js';
+import './adapters/express.js';
+import './adapters/fastify.js';
+import './adapters/flask.js';
+import './adapters/fastapi.js';
+import './adapters/django.js';
+import './adapters/gin.js';
+import './adapters/echo.js';
+import './adapters/fiber.js';
+import './adapters/laravel.js';
+import './adapters/symfony.js';
+import './adapters/rails.js';
+import './adapters/sinatra.js';
+import './adapters/ktor.js';
+import './adapters/spring-kotlin.js';
+import './adapters/flutter.js';
+import './adapters/vapor.js';
+import './adapters/axum.js';
+import './adapters/actix-web.js';
+import './adapters/rocket.js';
+import './adapters/spring-boot.js';
+import './adapters/micronaut.js';
+import './adapters/quarkus.js';
+import './adapters/hibernate.js';
+import './adapters/sqlalchemy.js';
+import './adapters/django-orm.js';
+import { startServer } from './server/mcp-server.js';
+import { cmdInit, cmdCheck, cmdShow, cmdHealth } from './config/cli.js';
+import { runKeysCommand } from './config/keys-cli.js';
+import { runWorkspacesCommand } from './config/workspaces-cli.js';
+import { VERSION } from './version.js';
+import { PureContextError, formatErrorBox } from './core/errors.js';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const require = createRequire(import.meta.url);
+const pkg = require(resolve(__dirname, '../package.json'));
+const NAME = pkg.name;
+// ─── Helpers ──────────────────────────────────────────────────────────────────
+function printHelp() {
+    process.stdout.write(`
+${NAME} v${VERSION} — token-efficient source code navigation for AI agents
+
+Usage:
+  purecontext-mcp                         Start the MCP server (stdio)
+  purecontext-mcp --server                Start as a shared HTTP server (team mode)
+  purecontext-mcp --server --port 3001    Override HTTP port
+  purecontext-mcp --server --host 0.0.0.0 Bind to all interfaces
+  purecontext-mcp --server --no-auth      Disable auth (local testing only)
+  purecontext-mcp --transport http        Start HTTP/SSE server on port 3000
+  purecontext-mcp --transport both        Start stdio AND HTTP simultaneously
+  purecontext-mcp config                  Show effective configuration
+  purecontext-mcp config --init           Generate default config file
+  purecontext-mcp config --check          Validate config and prerequisites
+  purecontext-mcp keys create             Create an API key for HTTP access
+  purecontext-mcp keys list               List tenants and API keys
+  purecontext-mcp keys revoke <prefix>    Revoke an API key
+  purecontext-mcp workspaces list         List workspaces
+  purecontext-mcp workspaces create --name   Create a workspace
+  purecontext-mcp --version               Print version
+  purecontext-mcp --help                  Print this help
+
+Environment variables:
+  PCTX_ADMIN_KEY    Admin key for /admin/* endpoints
+  PCTX_DATA_DIR     Override data directory (default: ~/.purecontext)
+  PCTX_PORT         Override HTTP port
+  PCTX_HOST         Override HTTP host
+
+Claude Code integration:
+  claude mcp add purecontext-mcp -- npx purecontext-mcp
+`.trimStart());
+}
+// ─── Startup ──────────────────────────────────────────────────────────────────
+async function bootstrap() {
+    // Register all language handlers before any indexing can happen
+    registerHandler(typescriptHandler);
+    registerHandler(tsxHandler);
+    registerHandler(javascriptHandler);
+    registerHandler(pythonHandler);
+    registerHandler(goHandler);
+    registerHandler(rustHandler);
+    registerHandler(javaHandler);
+    registerHandler(csharpHandler);
+    registerHandler(phpHandler);
+    registerHandler(rubyHandler);
+    registerHandler(kotlinHandler);
+    registerHandler(cHandler);
+    registerHandler(cppHandler);
+    registerHandler(luaHandler);
+    registerHandler(dartHandler);
+    registerHandler(swiftHandler);
+    registerHandler(elixirHandler);
+    registerHandler(haskellHandler);
+    registerHandler(scalaHandler);
+    registerHandler(rHandler);
+    // Initialise tree-sitter (loads WASM runtime + grammars lazily on first use)
+    await initParser();
+}
+// ─── Main ─────────────────────────────────────────────────────────────────────
+async function main() {
+    const args = process.argv.slice(2);
+    // ── Version / help / health flags (before bootstrap) ────────────────────
+    if (args.includes('--version') || args.includes('-v')) {
+        process.stdout.write(`${NAME} v${VERSION}\n`);
+        process.exit(0);
+    }
+    if (args.includes('--help') || args.includes('-h')) {
+        printHelp();
+        process.exit(0);
+    }
+    if (args.includes('--health')) {
+        const ok = cmdHealth();
+        process.exit(ok ? 0 : 1);
+    }
+    // ── keys sub-command ─────────────────────────────────────────────────────
+    if (args[0] === 'keys') {
+        runKeysCommand(args.slice(1));
+        // runKeysCommand handles process.exit() internally for synchronous paths;
+        // for async paths (keys list) it calls .then(() => process.exit(0))
+        return;
+    }
+    // ── workspaces sub-command ────────────────────────────────────────────────
+    if (args[0] === 'workspaces') {
+        runWorkspacesCommand(args.slice(1));
+        return;
+    }
+    // ── config sub-command ────────────────────────────────────────────────────
+    if (args[0] === 'config') {
+        const flag = args[1];
+        if (flag === '--init') {
+            await cmdInit();
+            process.exit(0);
+        }
+        if (flag === '--check') {
+            // --check needs grammars path, which requires bootstrap
+            await bootstrap();
+            const ok = cmdCheck();
+            process.exit(ok ? 0 : 1);
+        }
+        // Default: show effective config (no bootstrap needed)
+        cmdShow();
+        process.exit(0);
+    }
+    // ── Parse server flags ────────────────────────────────────────────────────
+    const serverMode = args.includes('--server');
+    const noAuth = args.includes('--no-auth');
+    const knownServerFlags = new Set(['--transport', '--port', '--host']);
+    const knownBoolFlags = new Set(['--server', '--no-auth']);
+    const remainingArgs = args.filter((a, i) => {
+        // Drop known bool flags
+        if (knownBoolFlags.has(a))
+            return false;
+        // Drop known value flags and their values
+        if (knownServerFlags.has(a))
+            return false;
+        if (i > 0 && knownServerFlags.has(args[i - 1]))
+            return false;
+        return true;
+    });
+    // ── Unknown sub-command ───────────────────────────────────────────────────
+    if (remainingArgs.length > 0) {
+        process.stderr.write(`Unknown command: ${remainingArgs[0]}\n`);
+        process.stderr.write(`Run 'purecontext-mcp --help' for usage.\n`);
+        process.exit(1);
+    }
+    // ── Resolve flags ─────────────────────────────────────────────────────────
+    const transportIdx = args.indexOf('--transport');
+    const transportFlag = transportIdx >= 0 ? args[transportIdx + 1] : undefined;
+    const portIdx = args.indexOf('--port');
+    const portRaw = portIdx >= 0 ? parseInt(args[portIdx + 1], 10) : undefined;
+    const portFlag = portRaw !== undefined && !isNaN(portRaw) ? portRaw : undefined;
+    const hostIdx = args.indexOf('--host');
+    const hostFlag = hostIdx >= 0 ? args[hostIdx + 1] : undefined;
+    // --server implies HTTP transport; defaults host to 0.0.0.0 for team use
+    const effectiveTransport = serverMode
+        ? 'http'
+        : transportFlag;
+    const effectiveHost = serverMode
+        ? (hostFlag ?? '0.0.0.0')
+        : hostFlag;
+    // --server enables auth by default; --no-auth disables it (dev only)
+    const effectiveRequireAuth = serverMode ? !noAuth : undefined;
+    try {
+        await bootstrap();
+        logger.info(`${NAME} v${VERSION} starting`);
+        // Print a startup hint only when running in an interactive terminal.
+        // stdin.isTTY is undefined when piped — writing to stdout when piped
+        // would corrupt the MCP stdio protocol stream. Always use stderr here.
+        if (!serverMode && process.stdin.isTTY) {
+            process.stderr.write(`${NAME} v${VERSION} — ready for MCP connections (stdio)\n` +
+                `Run with --help for usage, --health to verify installation.\n`);
+        }
+        await startServer({
+            transport: effectiveTransport,
+            port: portFlag,
+            host: effectiveHost,
+            requireAuth: effectiveRequireAuth,
+            serverMode,
+        });
+    }
+    catch (err) {
+        printFatalError(err);
+        process.exit(1);
+    }
+}
+function printFatalError(err) {
+    if (err instanceof PureContextError && err.userMessage) {
+        process.stderr.write(formatErrorBox(err.userMessage, err.suggestion ?? '') + '\n');
+    }
+    else {
+        process.stderr.write('Unexpected error — please report this at https://github.com/gococ/purecontext-mcp/issues\n');
+        if (err instanceof Error && err.stack) {
+            process.stderr.write(err.stack + '\n');
+        }
+        else {
+            process.stderr.write(String(err) + '\n');
+        }
+    }
+}
+main().catch((err) => {
+    printFatalError(err);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map