kmp-api-lookup-mcp 0.1.0

package/README.md

@@ -0,0 +1,219 @@
+# kmp-api-lookup-mcp
+
+MCP server for fast lookup of Kotlin/Native iOS klib APIs.
+
+The server indexes local Kotlin/Native platform klibs into a persistent SQLite database and exposes a compact MCP API for symbol lookup and index maintenance.
+
+## Current Scope
+
+- TypeScript npm ESM MCP server over stdio
+- Persistent SQLite cache in the user cache directory
+- Discovery of Kotlin/Native prebuilt installations via `KONAN_HOME`, `~/.konan`, or an explicit path
+- Manual index rebuild from `klib dump-metadata-signatures`
+- On-demand enrichment from `klib dump-metadata` for full Kotlin signatures, class hierarchy, and imports
+- Structured JSON MCP responses with short text summaries
+
+## Implemented Tools
+
+### `lookup_symbol`
+
+Resolve a Kotlin/Native Apple platform class, member, or top-level platform alias/constant into a compact development card.
+
+Input:
+
+```json
+{
+	"query": "AVPlayer",
+	"frameworks": ["AVFoundation"],
+	"detail": "compact",
+	"queryKind": "auto"
+}
+```
+
+Behavior:
+
+- A class query like `AVPlayer` returns one class card with:
+	- full Kotlin class signature
+	- superclass and implemented interfaces
+	- all constructors, instance methods, and class methods when `detail` is omitted or set to `compact`, grouped by member name to reduce output size
+	- a separate `properties` list in compact mode with explicit `accessors.getter` and `accessors.setter` flags when matching getter/setter methods exist for that property
+	- compact mode removes only duplicated property accessor methods; it does not trim unrelated methods from the class surface
+	- the full direct member set, ObjC bridge extension members, and `Meta` class members when `detail` is set to `full`
+	- `requiredImports` for code generation
+- A member query like `AVPlayer.play` or `play` returns a compact grouped card with overload signatures and imports.
+- Exact top-level platform aliases and constants like `AVPlayerStatus`, `AVLayerVideoGravity`, or `AVPlayerItemDidPlayToEndTimeNotification` resolve to package-scoped member cards instead of degrading into fuzzy class matches.
+- If the query is ambiguous, the tool returns a short alternatives list instead of dumping raw search rows.
+- Output intentionally omits noisy fields like DB paths, internal IDs, raw metadata dumps, match stages, and installation paths.
+- `detail` defaults to `compact`. Use `"detail": "full"` only when you really need the entire class surface.
+
+### `get_klib_index_status`
+
+Return a compact index summary.
+
+Input:
+
+```json
+{}
+```
+
+Output includes:
+
+- `ready`
+- discovered Kotlin/Native versions and targets
+- indexed datasets with counts
+- aggregate symbol counts
+- `lastRebuildAt`
+
+### `rebuild_klib_index`
+
+Build or refresh the SQLite index from local klibs.
+
+Input:
+
+```json
+{
+	"kotlinVersion": "2.2.21",
+	"target": "ios_simulator_arm64",
+	"frameworks": ["Foundation", "UIKit"],
+	"force": false,
+	"dryRun": false,
+	"cleanBefore": true
+}
+```
+
+Rules:
+
+- `kotlinVersion` and `konanHome` are optional, but you may provide at most one of them.
+- If both are omitted, the latest discovered local Kotlin/Native installation is used.
+- If `target` is omitted, the server prefers `ios_simulator_arm64`, then `ios_arm64`, then `ios_x64`.
+- If `frameworks` is omitted, the rebuild covers all frameworks for the selected target.
+- `dryRun=true` computes the rebuild plan without writing to SQLite.
+- `force=true` ignores freshness checks.
+- `cleanBefore=true` removes existing rows for the affected frameworks before writing fresh records.
+
+## Storage Layout
+
+The server stores data outside the repository.
+
+- SQLite DB: user cache dir + `klib-index.sqlite`
+- Service metadata: user cache dir + `state.json`
+
+Typical cache locations:
+
+- macOS: `~/Library/Caches/kmp-api-lookup-mcp/`
+- Linux: `${XDG_CACHE_HOME:-~/.cache}/kmp-api-lookup-mcp/`
+- Windows: `%LOCALAPPDATA%/kmp-api-lookup-mcp/`
+
+## Discovery Rules
+
+Installations are discovered in this order:
+
+1. Explicit `konanHome` argument when a tool provides it
+2. `KONAN_HOME`
+3. `~/.konan/kotlin-native-prebuilt-*`
+
+Each installation is validated by checking for:
+
+- `bin/klib`
+- `klib/platform/`
+
+## MCP Configuration
+
+### Run From Source
+
+```json
+{
+	"mcpServers": {
+		"kmp-api-lookup": {
+			"command": "node",
+			"args": ["/absolute/path/to/kmp-api-lookup-mcp/dist/index.js"]
+		}
+	}
+}
+```
+
+Optional environment override:
+
+```json
+{
+	"mcpServers": {
+		"kmp-api-lookup": {
+			"command": "node",
+			"args": ["/absolute/path/to/kmp-api-lookup-mcp/dist/index.js"],
+			"env": {
+				"KONAN_HOME": "/Users/you/.konan/kotlin-native-prebuilt-macos-aarch64-2.2.21"
+			}
+		}
+	}
+}
+```
+
+### Run As Installed Binary
+
+```json
+{
+	"mcpServers": {
+		"kmp-api-lookup": {
+			"command": "kmp-api-lookup-mcp"
+		}
+	}
+}
+```
+
+## Development
+
+### Scripts
+
+- `npm run dev` starts the server from TypeScript sources
+- `npm run build` compiles to `dist/`
+- `npm start` runs the compiled server
+- `npm run typecheck` runs TypeScript type checking
+- `npm test` runs Vitest
+- `npm run test:watch` starts Vitest in watch mode
+
+### Local Workflow
+
+```bash
+npm install
+npm run typecheck
+npm run build
+npm test
+```
+
+## Publishing
+
+npm publication is handled by GitHub Actions.
+
+- Push a tag in the form `vX.Y.Z` where `X.Y.Z` matches the `version` in `package.json`.
+- The `Publish Package` workflow validates the package and publishes it to npm.
+- The npm package must be configured for trusted publishing from the `SuLG-ik/kmp-api-lookup-mcp` GitHub repository.
+- See [PUBLISHING.md](./PUBLISHING.md) for the one-time npm setup and the exact release steps.
+
+## Test Coverage
+
+The current test suite covers:
+
+- MCP tool registration
+- `dump-metadata-signatures` line parsing
+- SQLite storage and search behavior on synthetic fixtures
+- server runtime creation
+
+## Project Structure
+
+```text
+.
+├── src/
+│   ├── index.ts
+│   ├── config/
+│   ├── indexer/
+│   ├── server/
+│   ├── storage/
+│   ├── tools/
+│   ├── search-utils.ts
+│   └── types.ts
+├── test/
+├── package.json
+├── tsconfig.json
+├── tsconfig.build.json
+└── vitest.config.ts
+```

package/dist/config/index.d.ts

@@ -0,0 +1,4 @@
+import type { ServerConfigSummary } from '../types.js';
+export interface AppConfig extends ServerConfigSummary {
+}
+export declare function loadAppConfig(overrides?: Partial<AppConfig>): AppConfig;

package/dist/config/index.js

@@ -0,0 +1,33 @@
+import os from 'node:os';
+import path from 'node:path';
+export function loadAppConfig(overrides = {}) {
+    const cacheDir = overrides.cacheDir ?? path.join(resolveBaseCacheDir(), 'kmp-api-lookup-mcp');
+    return {
+        serverName: overrides.serverName ?? 'kmp-api-lookup-mcp',
+        version: overrides.version ?? '0.1.0',
+        cacheDir,
+        dbPath: overrides.dbPath ?? path.join(cacheDir, 'klib-index.sqlite'),
+        metadataPath: overrides.metadataPath ?? path.join(cacheDir, 'state.json'),
+        konanScanRoot: overrides.konanScanRoot ?? path.join(os.homedir(), '.konan'),
+        defaultSearchLimit: overrides.defaultSearchLimit ?? 20,
+        defaultMatchMode: overrides.defaultMatchMode ?? 'auto',
+        defaultIncludeMetaClasses: overrides.defaultIncludeMetaClasses ?? false,
+        defaultIncludeRawSignature: overrides.defaultIncludeRawSignature ?? false,
+        storageDriver: overrides.storageDriver ?? 'better-sqlite3',
+        freshnessStrategy: overrides.freshnessStrategy
+            ?? 'version + target + selected frameworks + source directory mtime',
+        autoIndexing: overrides.autoIndexing ?? 'manual-error',
+        searchTargetFallback: overrides.searchTargetFallback ?? 'all-indexed-targets',
+        searchVersionFallback: overrides.searchVersionFallback ?? 'latest-indexed-version',
+    };
+}
+function resolveBaseCacheDir() {
+    if (process.platform === 'darwin') {
+        return path.join(os.homedir(), 'Library', 'Caches');
+    }
+    if (process.platform === 'win32') {
+        return process.env.LOCALAPPDATA ?? path.join(os.homedir(), 'AppData', 'Local');
+    }
+    return process.env.XDG_CACHE_HOME ?? path.join(os.homedir(), '.cache');
+}
+//# sourceMappingURL=index.js.map

package/dist/config/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAM7B,MAAM,UAAU,aAAa,CAAC,YAAgC,EAAE;IAC9D,MAAM,QAAQ,GAAG,SAAS,CAAC,QAAQ,IAAI,IAAI,CAAC,IAAI,CAAC,mBAAmB,EAAE,EAAE,oBAAoB,CAAC,CAAC;IAE9F,OAAO;QACL,UAAU,EAAE,SAAS,CAAC,UAAU,IAAI,oBAAoB;QACxD,OAAO,EAAE,SAAS,CAAC,OAAO,IAAI,OAAO;QACrC,QAAQ;QACR,MAAM,EAAE,SAAS,CAAC,MAAM,IAAI,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,mBAAmB,CAAC;QACpE,YAAY,EAAE,SAAS,CAAC,YAAY,IAAI,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,YAAY,CAAC;QACzE,aAAa,EAAE,SAAS,CAAC,aAAa,IAAI,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,QAAQ,CAAC;QAC3E,kBAAkB,EAAE,SAAS,CAAC,kBAAkB,IAAI,EAAE;QACtD,gBAAgB,EAAE,SAAS,CAAC,gBAAgB,IAAI,MAAM;QACtD,yBAAyB,EAAE,SAAS,CAAC,yBAAyB,IAAI,KAAK;QACvE,0BAA0B,EAAE,SAAS,CAAC,0BAA0B,IAAI,KAAK;QACzE,aAAa,EAAE,SAAS,CAAC,aAAa,IAAI,gBAAgB;QAC1D,iBAAiB,EACf,SAAS,CAAC,iBAAiB;eACxB,iEAAiE;QACtE,YAAY,EAAE,SAAS,CAAC,YAAY,IAAI,cAAc;QACtD,oBAAoB,EAAE,SAAS,CAAC,oBAAoB,IAAI,qBAAqB;QAC7E,qBAAqB,EAAE,SAAS,CAAC,qBAAqB,IAAI,wBAAwB;KACnF,CAAC;AACJ,CAAC;AAED,SAAS,mBAAmB;IAC1B,IAAI,OAAO,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAClC,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;IACtD,CAAC;IAED,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;QACjC,OAAO,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;IACjF,CAAC;IAED,OAAO,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,QAAQ,CAAC,CAAC;AACzE,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,29 @@
+#!/usr/bin/env node
+import { StdioServerTransport } from '@modelcontextprotocol/server';
+import { createServerRuntime } from './server/index.js';
+async function main() {
+    const runtime = createServerRuntime();
+    const transport = new StdioServerTransport();
+    let isShuttingDown = false;
+    const shutdown = async (signal) => {
+        if (isShuttingDown) {
+            return;
+        }
+        isShuttingDown = true;
+        console.error(`Received ${signal}, shutting down kmp-api-lookup-mcp...`);
+        await runtime.close();
+    };
+    process.on('SIGINT', () => {
+        void shutdown('SIGINT').finally(() => process.exit(0));
+    });
+    process.on('SIGTERM', () => {
+        void shutdown('SIGTERM').finally(() => process.exit(0));
+    });
+    await runtime.server.connect(transport);
+    console.error('kmp-api-lookup-mcp server running on stdio');
+}
+await main().catch((error) => {
+    console.error('Fatal error while starting kmp-api-lookup-mcp:', error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAExD,KAAK,UAAU,IAAI;IACjB,MAAM,OAAO,GAAG,mBAAmB,EAAE,CAAC;IACtC,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,IAAI,cAAc,GAAG,KAAK,CAAC;IAE3B,MAAM,QAAQ,GAAG,KAAK,EAAE,MAAc,EAAiB,EAAE;QACvD,IAAI,cAAc,EAAE,CAAC;YACnB,OAAO;QACT,CAAC;QAED,cAAc,GAAG,IAAI,CAAC;QACtB,OAAO,CAAC,KAAK,CAAC,YAAY,MAAM,uCAAuC,CAAC,CAAC;QACzE,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC,CAAC;IAEF,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE;QACxB,KAAK,QAAQ,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IACzD,CAAC,CAAC,CAAC;IAEH,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE;QACzB,KAAK,QAAQ,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1D,CAAC,CAAC,CAAC;IAEH,MAAM,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IACxC,OAAO,CAAC,KAAK,CAAC,4CAA4C,CAAC,CAAC;AAC9D,CAAC;AAED,MAAM,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;IACpC,OAAO,CAAC,KAAK,CAAC,gDAAgD,EAAE,KAAK,CAAC,CAAC;IACvE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/indexer/index.d.ts

@@ -0,0 +1,12 @@
+import type { AppConfig } from '../config/index.js';
+import type { DiscoveredInstallation, FrameworkSource, ParsedSignatureRecord } from '../types.js';
+export declare function discoverKotlinNativeInstallations(config: AppConfig, explicitKonanHome?: string, options?: {
+    onlyExplicit?: boolean;
+}): Promise<DiscoveredInstallation[]>;
+export declare function listFrameworkSources(installation: DiscoveredInstallation, target: string, requestedFrameworks?: string[]): Promise<FrameworkSource[]>;
+export declare function parseSignatureLine(line: string): ParsedSignatureRecord | null;
+export declare function dumpFrameworkSignatures(installation: DiscoveredInstallation, framework: FrameworkSource): Promise<{
+    lineCount: number;
+    records: ParsedSignatureRecord[];
+}>;
+export declare function dumpFrameworkMetadata(installation: DiscoveredInstallation, framework: FrameworkSource): Promise<string[]>;

package/dist/indexer/index.js

@@ -0,0 +1,245 @@
+import { execFile } from 'node:child_process';
+import { access, readdir, realpath, stat } from 'node:fs/promises';
+import path from 'node:path';
+import { promisify } from 'node:util';
+import { compactSelector, compareVersionStrings, normalizeSelector, uniqueSorted } from '../search-utils.js';
+const execFileAsync = promisify(execFile);
+const FRAMEWORK_PREFIX = 'org.jetbrains.kotlin.native.platform.';
+export async function discoverKotlinNativeInstallations(config, explicitKonanHome, options = {}) {
+    const candidates = new Map();
+    const installations = new Map();
+    const addCandidate = (candidatePath, source) => {
+        const resolvedPath = path.resolve(candidatePath);
+        const sources = candidates.get(resolvedPath) ?? new Set();
+        sources.add(source);
+        candidates.set(resolvedPath, sources);
+    };
+    if (explicitKonanHome) {
+        addCandidate(explicitKonanHome, 'explicit');
+    }
+    if (!options.onlyExplicit) {
+        if (process.env.KONAN_HOME) {
+            addCandidate(process.env.KONAN_HOME, 'env');
+        }
+        try {
+            const scanEntries = await readdir(config.konanScanRoot, { withFileTypes: true });
+            for (const entry of scanEntries) {
+                if (entry.isDirectory() && entry.name.startsWith('kotlin-native-prebuilt-')) {
+                    addCandidate(path.join(config.konanScanRoot, entry.name), 'scan');
+                }
+            }
+        }
+        catch {
+            // Ignore missing ~/.konan roots.
+        }
+    }
+    for (const [candidatePath, sources] of candidates.entries()) {
+        const installation = await inspectKonanHome(candidatePath, [...sources]);
+        if (!installation) {
+            continue;
+        }
+        const existing = installations.get(installation.konanHome);
+        if (existing) {
+            installations.set(installation.konanHome, {
+                ...existing,
+                sources: uniqueSorted([...existing.sources, ...installation.sources]),
+            });
+        }
+        else {
+            installations.set(installation.konanHome, installation);
+        }
+    }
+    return [...installations.values()].sort((left, right) => {
+        const versionOrder = compareVersionStrings(right.kotlinVersion, left.kotlinVersion);
+        if (versionOrder !== 0) {
+            return versionOrder;
+        }
+        return left.konanHome.localeCompare(right.konanHome);
+    });
+}
+export async function listFrameworkSources(installation, target, requestedFrameworks) {
+    const targetRoot = path.join(installation.platformRootPath, target);
+    const entries = await readdir(targetRoot, { withFileTypes: true });
+    const availableFrameworks = new Map();
+    for (const entry of entries) {
+        if (!entry.isDirectory() || !entry.name.startsWith(FRAMEWORK_PREFIX)) {
+            continue;
+        }
+        const frameworkName = entry.name.slice(FRAMEWORK_PREFIX.length);
+        availableFrameworks.set(frameworkName, path.join(targetRoot, entry.name));
+    }
+    const selectedFrameworks = requestedFrameworks ?? [...availableFrameworks.keys()];
+    const missingFrameworks = selectedFrameworks.filter((framework) => !availableFrameworks.has(framework));
+    if (missingFrameworks.length > 0) {
+        throw new Error(`Frameworks not found for target ${target}: ${missingFrameworks.join(', ')}`);
+    }
+    const frameworkSources = [];
+    for (const frameworkName of uniqueSorted(selectedFrameworks)) {
+        const directoryPath = availableFrameworks.get(frameworkName);
+        if (!directoryPath) {
+            continue;
+        }
+        const frameworkStat = await stat(directoryPath);
+        frameworkSources.push({
+            name: frameworkName,
+            directoryPath,
+            sourceMtimeMs: frameworkStat.mtimeMs,
+        });
+    }
+    return frameworkSources;
+}
+export function parseSignatureLine(line) {
+    const trimmedLine = line.trim();
+    if (!trimmedLine) {
+        return null;
+    }
+    const classMatch = trimmedLine.match(/^(?<container>[^|]+)\|null\[(?<version>\d+)\]$/);
+    if (classMatch?.groups) {
+        const [packageName, symbolPath] = classMatch.groups.container.split('/', 2);
+        if (!packageName || !symbolPath) {
+            return null;
+        }
+        const framework = packageName.startsWith('platform.')
+            ? packageName.slice('platform.'.length)
+            : packageName;
+        const memberName = symbolPath.includes('.') ? symbolPath.slice(symbolPath.lastIndexOf('.') + 1) : symbolPath;
+        return {
+            framework,
+            packageName,
+            className: symbolPath,
+            memberName,
+            memberSearchName: memberName,
+            memberKind: 'class',
+            declarationForm: 'class',
+            objcSelector: null,
+            objcSelectorNormalized: null,
+            objcSelectorCompact: null,
+            rawSignature: trimmedLine,
+            isMetaClass: symbolPath.endsWith('Meta'),
+        };
+    }
+    const propertyMatch = trimmedLine.match(/^(?<container>[^|]+)\|\{\}(?<property>[^\[]+)\[(?<version>\d+)\]$/);
+    if (propertyMatch?.groups) {
+        const [packageName, symbolPath] = propertyMatch.groups.container.split('/', 2);
+        if (!packageName || !symbolPath) {
+            return null;
+        }
+        const dotIndex = symbolPath.lastIndexOf('.');
+        const className = dotIndex >= 0 ? symbolPath.slice(0, dotIndex) : null;
+        const memberName = propertyMatch.groups.property;
+        if (memberName.startsWith('<get-') || memberName.startsWith('<set-')) {
+            return null;
+        }
+        const framework = packageName.startsWith('platform.')
+            ? packageName.slice('platform.'.length)
+            : packageName;
+        return {
+            framework,
+            packageName,
+            className,
+            memberName,
+            memberSearchName: memberName,
+            memberKind: 'member',
+            declarationForm: 'direct_member',
+            objcSelector: null,
+            objcSelectorNormalized: null,
+            objcSelectorCompact: null,
+            rawSignature: trimmedLine,
+            isMetaClass: className?.endsWith('Meta') ?? false,
+        };
+    }
+    const lineMatch = trimmedLine.match(/^(?<container>[^|]+)\|(?:(?<receiver>.+)\.)?objc:(?<selector>[^\[]+)\[(?<version>\d+)\]$/);
+    if (!lineMatch?.groups) {
+        return null;
+    }
+    const [packageName, symbolPath] = lineMatch.groups.container.split('/', 2);
+    if (!packageName || !symbolPath) {
+        return null;
+    }
+    const dotIndex = symbolPath.lastIndexOf('.');
+    const className = lineMatch.groups.receiver ?? (dotIndex >= 0 ? symbolPath.slice(0, dotIndex) : null);
+    const memberName = dotIndex >= 0 ? symbolPath.slice(dotIndex + 1) : symbolPath;
+    if (memberName.startsWith('<get-') || memberName.startsWith('<set-')) {
+        return null;
+    }
+    const normalizedSelector = lineMatch.groups.selector.replace(/#Constructor$/, '');
+    const framework = packageName.startsWith('platform.')
+        ? packageName.slice('platform.'.length)
+        : packageName;
+    return {
+        framework,
+        packageName,
+        className,
+        memberName,
+        memberSearchName: memberName === '<init>' ? 'init' : memberName,
+        memberKind: memberName === '<init>' ? 'constructor' : 'member',
+        declarationForm: lineMatch.groups.receiver ? 'objc_bridge_extension' : 'direct_member',
+        objcSelector: normalizedSelector,
+        objcSelectorNormalized: normalizeSelector(normalizedSelector),
+        objcSelectorCompact: compactSelector(normalizedSelector),
+        rawSignature: trimmedLine,
+        isMetaClass: className?.endsWith('Meta') ?? false,
+    };
+}
+export async function dumpFrameworkSignatures(installation, framework) {
+    try {
+        const { stdout } = await execFileAsync(installation.klibBinaryPath, ['dump-metadata-signatures', framework.directoryPath], {
+            encoding: 'utf8',
+            maxBuffer: 64 * 1024 * 1024,
+        });
+        const lines = stdout.split(/\r?\n/).filter(Boolean);
+        return {
+            lineCount: lines.length,
+            records: lines
+                .map((line) => parseSignatureLine(line))
+                .filter((record) => record !== null),
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new Error(`Failed to dump metadata signatures for ${framework.name}: ${message}`);
+    }
+}
+export async function dumpFrameworkMetadata(installation, framework) {
+    try {
+        const { stdout } = await execFileAsync(installation.klibBinaryPath, ['dump-metadata', framework.directoryPath, '-print-signatures', 'true'], {
+            encoding: 'utf8',
+            maxBuffer: 64 * 1024 * 1024,
+        });
+        return stdout.split(/\r?\n/);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new Error(`Failed to dump metadata for ${framework.name}: ${message}`);
+    }
+}
+async function inspectKonanHome(konanHome, sources) {
+    try {
+        const resolvedKonanHome = await realpath(konanHome);
+        const klibBinaryPath = path.join(resolvedKonanHome, 'bin', 'klib');
+        const platformRootPath = path.join(resolvedKonanHome, 'klib', 'platform');
+        await access(klibBinaryPath);
+        await access(platformRootPath);
+        const targetEntries = await readdir(platformRootPath, { withFileTypes: true });
+        return {
+            kotlinVersion: parseVersionFromKonanHome(resolvedKonanHome),
+            konanHome: resolvedKonanHome,
+            klibBinaryPath,
+            platformRootPath,
+            availableTargets: uniqueSorted(targetEntries.filter((entry) => entry.isDirectory()).map((entry) => entry.name)),
+            sources: uniqueSorted(sources),
+        };
+    }
+    catch {
+        return null;
+    }
+}
+function parseVersionFromKonanHome(konanHome) {
+    const baseName = path.basename(konanHome);
+    const versionMatch = baseName.match(/-(\d+\.\d+\.\d+(?:[-A-Za-z0-9.]+)?)$/);
+    if (versionMatch) {
+        return versionMatch[1];
+    }
+    return baseName.replace(/^kotlin-native-prebuilt-/, '');
+}
+//# sourceMappingURL=index.js.map

package/dist/indexer/index.js.map

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

package/dist/search-utils.d.ts

@@ -0,0 +1,10 @@
+export declare function normalizeText(value: string): string;
+export declare function normalizeSelector(value: string | null | undefined): string | null;
+export declare function compactSelector(value: string | null | undefined): string | null;
+export declare function tokenizeSearchText(value: string): string[];
+export declare function buildFtsQuery(value: string): string | null;
+export declare function escapeLikePattern(value: string): string;
+export declare function uniqueSorted(values: readonly string[]): string[];
+export declare function compareVersionStrings(left: string, right: string): number;
+export declare function pickLatestVersion(values: readonly string[]): string | null;
+export declare function toIsoNow(): string;

package/dist/search-utils.js

@@ -0,0 +1,81 @@
+export function normalizeText(value) {
+    return value.trim().toLowerCase();
+}
+export function normalizeSelector(value) {
+    if (!value) {
+        return null;
+    }
+    return normalizeText(value);
+}
+export function compactSelector(value) {
+    if (!value) {
+        return null;
+    }
+    return normalizeText(value).replace(/:/g, '');
+}
+export function tokenizeSearchText(value) {
+    const withCamelCaseSplit = value.replace(/([a-z0-9])([A-Z])/g, '$1 $2');
+    const normalized = withCamelCaseSplit
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, ' ')
+        .trim();
+    if (!normalized) {
+        return [];
+    }
+    return [...new Set(normalized.split(/\s+/).filter(Boolean))];
+}
+export function buildFtsQuery(value) {
+    const tokens = tokenizeSearchText(value);
+    if (tokens.length === 0) {
+        return null;
+    }
+    return tokens.map((token) => `${token}*`).join(' OR ');
+}
+export function escapeLikePattern(value) {
+    return value.replace(/[\\%_]/g, '\\$&');
+}
+export function uniqueSorted(values) {
+    return [...new Set(values)].sort((left, right) => left.localeCompare(right));
+}
+export function compareVersionStrings(left, right) {
+    const leftParts = splitVersion(left);
+    const rightParts = splitVersion(right);
+    const maxLength = Math.max(leftParts.numbers.length, rightParts.numbers.length);
+    for (let index = 0; index < maxLength; index += 1) {
+        const leftNumber = leftParts.numbers[index] ?? 0;
+        const rightNumber = rightParts.numbers[index] ?? 0;
+        if (leftNumber !== rightNumber) {
+            return leftNumber - rightNumber;
+        }
+    }
+    if (!leftParts.suffix && rightParts.suffix) {
+        return 1;
+    }
+    if (leftParts.suffix && !rightParts.suffix) {
+        return -1;
+    }
+    return leftParts.suffix.localeCompare(rightParts.suffix);
+}
+export function pickLatestVersion(values) {
+    if (values.length === 0) {
+        return null;
+    }
+    return [...values].sort((left, right) => compareVersionStrings(right, left))[0] ?? null;
+}
+export function toIsoNow() {
+    return new Date().toISOString();
+}
+function splitVersion(value) {
+    const match = value.match(/(\d+(?:\.\d+)*)(.*)/);
+    if (!match) {
+        return {
+            numbers: [],
+            suffix: value.toLowerCase(),
+        };
+    }
+    return {
+        numbers: match[1].split('.').map((part) => Number.parseInt(part, 10)),
+        suffix: match[2].replace(/^[^a-z0-9]+/i, '').toLowerCase(),
+    };
+}
+//# sourceMappingURL=search-utils.js.map