@winspan/claude-forge 8.54.4 → 9.2.0

package/dist/knowledge/adapters/java-adapter.js

@@ -0,0 +1,260 @@
+/**
+ * @file adapters/java-adapter.ts
+ * v10.1 — Java adapter (Maven/Gradle multi-module support).
+ *
+ * Uses tree-sitter-java for AST parsing. Native module dependency is declared
+ * as optionalDependencies in package.json; if installation fails (e.g. Node
+ * v24 without C++20 compiler), parseSymbols throws a friendly error.
+ *
+ * Supports:
+ * - Maven multi-module projects (discovers star/src/main/java)
+ * - Gradle multi-module projects (discovers star/src/main/java)
+ * - Single-module projects (discovers src/main/java)
+ *
+ * Limitations (v10.1):
+ * - Module discovery uses glob pattern (does NOT parse pom.xml/build.gradle XML)
+ * - Method signatures simplified (no parameter types extracted)
+ * - Generics/lambdas/complex AST nodes may be skipped
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+/**
+ * Normalise a filesystem path to POSIX-style for storage inside the KB.
+ */
+function toPosix(p) {
+    return p.split(path.sep).join('/');
+}
+export class JavaAdapter {
+    name = 'java';
+    fileExtensions = ['.java'];
+    /**
+     * Project is Java iff it has Maven or Gradle manifest.
+     */
+    detect(projectRoot) {
+        return (fs.existsSync(path.join(projectRoot, 'pom.xml')) ||
+            fs.existsSync(path.join(projectRoot, 'build.gradle')) ||
+            fs.existsSync(path.join(projectRoot, 'build.gradle.kts')));
+    }
+    /**
+     * Discover all src/main/java directories (Maven/Gradle convention).
+     * Checks:
+     * 1. Project root's src/main/java (single-module)
+     * 2. First-level subdirectories' src/main/java (multi-module)
+     */
+    discoverSourceRoots(projectRoot) {
+        const roots = [];
+        const check = (dir) => {
+            const candidate = path.join(dir, 'src/main/java');
+            if (fs.existsSync(candidate)) {
+                roots.push(candidate);
+            }
+        };
+        // Check project root
+        check(projectRoot);
+        // Check first-level subdirectories (Maven/Gradle sub-modules)
+        try {
+            const entries = fs.readdirSync(projectRoot, { withFileTypes: true });
+            for (const e of entries) {
+                if (e.isDirectory() && !e.name.startsWith('.') && e.name !== 'target' && e.name !== 'build') {
+                    check(path.join(projectRoot, e.name));
+                }
+            }
+        }
+        catch {
+            // Defensive: if readdirSync fails, continue with what we have
+        }
+        return roots;
+    }
+    /**
+     * Each source root becomes one module.
+     * Module name = subdirectory name (e.g. workbench-api) or root if at project root.
+     */
+    discoverModules(projectRoot) {
+        const roots = this.discoverSourceRoots(projectRoot);
+        return roots.map((r) => {
+            const rel = path.relative(projectRoot, r);
+            const parts = rel.split(path.sep);
+            // If path is `src/main/java` → name = 'root'
+            // If path is `workbench-api/src/main/java` → name = 'workbench-api'
+            const name = parts[0] === 'src' ? 'root' : parts[0];
+            return {
+                name,
+                rootDir: r,
+                refPrefix: name === 'root' ? '' : name,
+            };
+        });
+    }
+    /**
+     * Recursively walk module root, collecting .java files.
+     * Excludes: target/, build/, .mvn/, .gradle/, hidden dirs.
+     */
+    async walkModuleFiles(module) {
+        const files = [];
+        const walk = (dir) => {
+            let entries;
+            try {
+                entries = fs.readdirSync(dir, { withFileTypes: true });
+            }
+            catch {
+                return;
+            }
+            for (const e of entries) {
+                const full = path.join(dir, e.name);
+                if (e.isDirectory()) {
+                    // Skip build artifacts and hidden dirs
+                    if (['target', 'build', '.mvn', '.gradle'].includes(e.name) || e.name.startsWith('.')) {
+                        continue;
+                    }
+                    walk(full);
+                }
+                else if (e.isFile() && e.name.endsWith('.java')) {
+                    const relPath = toPosix(path.relative(module.rootDir, full));
+                    // For multi-module: projectRelPath = <module-name>/<relPath>
+                    // For single-module: projectRelPath = <relPath>
+                    const projectRelPath = module.refPrefix ? toPosix(path.join(module.refPrefix, relPath)) : relPath;
+                    files.push({
+                        relPath,
+                        projectRelPath,
+                        content: fs.readFileSync(full, 'utf-8'),
+                    });
+                }
+            }
+        };
+        walk(module.rootDir);
+        return files;
+    }
+    /**
+     * Extract symbols from Java source using tree-sitter-java.
+     * Lazy-imports tree-sitter to avoid breaking the entire adapter when native
+     * module installation fails.
+     *
+     * Extracts:
+     * - class/interface/enum declarations
+     * - public methods (as ClassName.methodName)
+     * - public static final fields (as ClassName.FIELD_NAME)
+     */
+    async parseSymbols(file) {
+        // Lazy import to isolate native module dependency
+        let Parser, Java;
+        try {
+            // @ts-ignore - optional native module, may not be installed
+            const treeSitter = await import('tree-sitter');
+            // @ts-ignore - optional native module, may not be installed
+            const treeSitterJava = await import('tree-sitter-java');
+            Parser = treeSitter.default;
+            Java = treeSitterJava.default;
+        }
+        catch (err) {
+            // Graceful degradation: return empty symbols when tree-sitter is not available
+            // This allows KB build to continue in degraded mode (no symbol references)
+            return [];
+        }
+        const parser = new Parser();
+        parser.setLanguage(Java);
+        const tree = parser.parse(file.content);
+        const symbols = [];
+        const visit = (node, parentClass) => {
+            // Class/interface/enum declarations
+            if (['class_declaration', 'interface_declaration', 'enum_declaration'].includes(node.type)) {
+                const nameNode = node.childForFieldName('name');
+                if (!nameNode) {
+                    // Recurse children even if no name (defensive)
+                    for (let i = 0; i < node.childCount; i++) {
+                        visit(node.child(i), parentClass);
+                    }
+                    return;
+                }
+                const name = file.content.slice(nameNode.startIndex, nameNode.endIndex);
+                const line = nameNode.startPosition.row + 1;
+                const kind = node.type === 'class_declaration'
+                    ? 'class'
+                    : node.type === 'interface_declaration'
+                        ? 'interface'
+                        : 'enum';
+                symbols.push({
+                    file: file.projectRelPath,
+                    line,
+                    kind,
+                    name,
+                    signature: kind + ' ' + name,
+                    exports: true, // Java public classes are exported by default
+                });
+                // Recurse into class body for methods/fields
+                for (let i = 0; i < node.childCount; i++) {
+                    visit(node.child(i), name);
+                }
+                return;
+            }
+            // Method declarations
+            if (node.type === 'method_declaration') {
+                const nameNode = node.childForFieldName('name');
+                if (!nameNode)
+                    return;
+                const methodName = file.content.slice(nameNode.startIndex, nameNode.endIndex);
+                const line = nameNode.startPosition.row + 1;
+                const fullName = parentClass ? parentClass + '.' + methodName : methodName;
+                symbols.push({
+                    file: file.projectRelPath,
+                    line,
+                    kind: 'method',
+                    name: fullName,
+                    signature: fullName + '(...)', // Simplified: no parameter extraction
+                    exports: false,
+                });
+                return;
+            }
+            // Field declarations (only public static final constants)
+            if (node.type === 'field_declaration') {
+                const modifiers = node.childForFieldName('modifiers');
+                const modText = modifiers ? file.content.slice(modifiers.startIndex, modifiers.endIndex) : '';
+                const isPublicStaticFinal = modText.includes('public') && modText.includes('static') && modText.includes('final');
+                if (!isPublicStaticFinal)
+                    return;
+                // Find declarator node
+                const declarator = node.childForFieldName('declarator');
+                if (!declarator)
+                    return;
+                const nameNode = declarator.childForFieldName('name');
+                if (!nameNode)
+                    return;
+                const fieldName = file.content.slice(nameNode.startIndex, nameNode.endIndex);
+                const line = nameNode.startPosition.row + 1;
+                const fullName = parentClass ? parentClass + '.' + fieldName : fieldName;
+                symbols.push({
+                    file: file.projectRelPath,
+                    line,
+                    kind: 'const',
+                    name: fullName,
+                    signature: fullName,
+                    exports: false,
+                });
+                return;
+            }
+            // Recurse into other nodes
+            for (let i = 0; i < node.childCount; i++) {
+                visit(node.child(i), parentClass);
+            }
+        };
+        visit(tree.rootNode);
+        return symbols;
+    }
+    /**
+     * Describe project metadata files.
+     * Returns the primary manifest (pom.xml or build.gradle) and no config paths
+     * (Java projects don't have a single config file like tsconfig.json).
+     */
+    describeProjectMeta(projectRoot) {
+        const pom = path.join(projectRoot, 'pom.xml');
+        const gradle = path.join(projectRoot, 'build.gradle');
+        const gradleKts = path.join(projectRoot, 'build.gradle.kts');
+        const manifestPath = fs.existsSync(pom)
+            ? pom
+            : fs.existsSync(gradle)
+                ? gradle
+                : fs.existsSync(gradleKts)
+                    ? gradleKts
+                    : null;
+        return { manifestPath, configPaths: [] };
+    }
+}
+//# sourceMappingURL=java-adapter.js.map

package/dist/knowledge/adapters/java-adapter.js.map

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

package/dist/knowledge/adapters/js-vue-adapter.d.ts

@@ -0,0 +1,56 @@
+/**
+ * @file adapters/js-vue-adapter.ts
+ * Phase 2b-1 — JavaScript / Vue adapter (file-walk only).
+ *
+ * Targets plain-JS and Vue SFC projects that are NOT TypeScript.  Registered
+ * AFTER `TypeScriptAdapter` in `index.ts`: a real TS project (tsconfig.json or
+ * `.ts` sources) wins via `TypeScriptAdapter.detect`; a pure Vue/JS project
+ * (no tsconfig, no `.ts`) falls through to this adapter — fixing both the
+ * "collapsed to empty-set hash" path (TS claimed it but walked no `.ts`) and the
+ * "dropped from monorepo" path (no adapter matched at all).
+ *
+ * Vue SFC handling (Q4): `.vue` files contribute ONLY their `<script>` block to
+ * `content` (template/style stripped), extracted by regex — no AST, no native
+ * dependency.  Other JS variants (`.js/.jsx/.mjs/.cjs`) are walked whole.
+ *
+ * Phase 2b-1 is file-walk only: NO `parseSymbols` (deferred to Phase 2b-2).
+ */
+import type { LanguageAdapter, ModuleInfo, SourceFile } from './types.js';
+export declare class JsVueAdapter implements LanguageAdapter {
+    readonly name = "javascript";
+    readonly fileExtensions: readonly [".js", ".jsx", ".mjs", ".cjs", ".vue"];
+    /**
+     * Project is JS/Vue iff `package.json` exists AND at least one JS/Vue source
+     * file is reachable.  Because this adapter is registered AFTER
+     * `TypeScriptAdapter`, a real TS project is already claimed upstream; anything
+     * reaching here is, by construction, non-TS.  The source-existence probe also
+     * lets pure-frontend layouts (no `src/`) match, fixing the monorepo-drop path.
+     */
+    detect(projectRoot: string): boolean;
+    /**
+     * Prefer `<root>/src` (conventional); otherwise the project root itself
+     * (front-end apps frequently use `pages/`+`components/` with no `src/`).
+     */
+    discoverSourceRoots(projectRoot: string): string[];
+    /**
+     * With a `src/` layout each first-level subdir is a module (TS-like). Without
+     * `src/`, the whole project is one module (`root`).  Under a monorepo,
+     * `MonorepoAdapter` overrides the module page key with the sub-project dir
+     * name, so the inner `name` here is not user-facing — same as Java.
+     */
+    discoverModules(projectRoot: string): ModuleInfo[];
+    /**
+     * Recursively collect JS/Vue files.  For `.vue`, only the `<script>` block(s)
+     * are stored as `content` (Q4); other extensions are stored whole.
+     */
+    walkModuleFiles(module: ModuleInfo): Promise<SourceFile[]>;
+    /**
+     * Describe project metadata.  Manifest = `package.json`; config paths gather
+     * the well-known build configs when present.
+     */
+    describeProjectMeta(projectRoot: string): {
+        manifestPath: string | null;
+        configPaths: string[];
+    };
+}
+//# sourceMappingURL=js-vue-adapter.d.ts.map

package/dist/knowledge/adapters/js-vue-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"js-vue-adapter.d.ts","sourceRoot":"","sources":["../../../src/knowledge/adapters/js-vue-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAIH,OAAO,KAAK,EAAE,eAAe,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAkE1E,qBAAa,YAAa,YAAW,eAAe;IAClD,QAAQ,CAAC,IAAI,gBAAgB;IAC7B,QAAQ,CAAC,cAAc,mDAAoD;IAE3E;;;;;;OAMG;IACH,MAAM,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO;IAKpC;;;OAGG;IACH,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE;IAMlD;;;;;OAKG;IACH,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,UAAU,EAAE;IA0BlD;;;OAGG;IACG,eAAe,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAwChE;;;OAGG;IACH,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG;QAAE,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,WAAW,EAAE,MAAM,EAAE,CAAA;KAAE;CAcjG"}

package/dist/knowledge/adapters/js-vue-adapter.js

@@ -0,0 +1,203 @@
+/**
+ * @file adapters/js-vue-adapter.ts
+ * Phase 2b-1 — JavaScript / Vue adapter (file-walk only).
+ *
+ * Targets plain-JS and Vue SFC projects that are NOT TypeScript.  Registered
+ * AFTER `TypeScriptAdapter` in `index.ts`: a real TS project (tsconfig.json or
+ * `.ts` sources) wins via `TypeScriptAdapter.detect`; a pure Vue/JS project
+ * (no tsconfig, no `.ts`) falls through to this adapter — fixing both the
+ * "collapsed to empty-set hash" path (TS claimed it but walked no `.ts`) and the
+ * "dropped from monorepo" path (no adapter matched at all).
+ *
+ * Vue SFC handling (Q4): `.vue` files contribute ONLY their `<script>` block to
+ * `content` (template/style stripped), extracted by regex — no AST, no native
+ * dependency.  Other JS variants (`.js/.jsx/.mjs/.cjs`) are walked whole.
+ *
+ * Phase 2b-1 is file-walk only: NO `parseSymbols` (deferred to Phase 2b-2).
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+/**
+ * Normalise a filesystem path to POSIX-style for storage inside the KB.
+ */
+function toPosix(p) {
+    return p.split(path.sep).join('/');
+}
+/** Directories never worth descending into for JS/Vue projects. */
+const EXCLUDED_DIRS = [
+    'node_modules',
+    'dist',
+    'build',
+    '.next',
+    '.nuxt',
+    'coverage',
+    '.output',
+];
+/** JS-family source extensions (`.vue` handled specially in walk). */
+const JS_EXTS = ['.js', '.jsx', '.mjs', '.cjs', '.vue'];
+function hasExt(name) {
+    return JS_EXTS.some((ext) => name.endsWith(ext));
+}
+/**
+ * Existence probe: does `dir` (recursively, depth-bounded) contain at least one
+ * JS/Vue source file?  Returns on the first hit; skips build/hidden dirs.
+ */
+function hasJsSource(dir, depth = 0) {
+    if (depth > 6)
+        return false;
+    let entries;
+    try {
+        entries = fs.readdirSync(dir, { withFileTypes: true });
+    }
+    catch {
+        return false;
+    }
+    for (const e of entries) {
+        if (e.isFile() && hasExt(e.name))
+            return true;
+        if (e.isDirectory()) {
+            if (EXCLUDED_DIRS.includes(e.name) || e.name.startsWith('.'))
+                continue;
+            if (hasJsSource(path.join(dir, e.name), depth + 1))
+                return true;
+        }
+    }
+    return false;
+}
+/**
+ * Extract the concatenated contents of all `<script>` blocks from a Vue SFC.
+ * Strips `<template>`/`<style>` noise.  Pure regex — no AST.  Handles both
+ * `<script>` and `<script setup>` (and any attributes).  Falls back to the full
+ * file when no `<script>` block is present (rare; defensive).
+ */
+function extractVueScript(content) {
+    const re = /<script\b[^>]*>([\s\S]*?)<\/script>/gi;
+    const blocks = [];
+    let m;
+    while ((m = re.exec(content)) !== null) {
+        blocks.push(m[1].trim());
+    }
+    if (blocks.length === 0)
+        return content;
+    return blocks.join('\n\n');
+}
+export class JsVueAdapter {
+    name = 'javascript';
+    fileExtensions = ['.js', '.jsx', '.mjs', '.cjs', '.vue'];
+    /**
+     * Project is JS/Vue iff `package.json` exists AND at least one JS/Vue source
+     * file is reachable.  Because this adapter is registered AFTER
+     * `TypeScriptAdapter`, a real TS project is already claimed upstream; anything
+     * reaching here is, by construction, non-TS.  The source-existence probe also
+     * lets pure-frontend layouts (no `src/`) match, fixing the monorepo-drop path.
+     */
+    detect(projectRoot) {
+        if (!fs.existsSync(path.join(projectRoot, 'package.json')))
+            return false;
+        return hasJsSource(projectRoot);
+    }
+    /**
+     * Prefer `<root>/src` (conventional); otherwise the project root itself
+     * (front-end apps frequently use `pages/`+`components/` with no `src/`).
+     */
+    discoverSourceRoots(projectRoot) {
+        const srcDir = path.join(projectRoot, 'src');
+        if (fs.existsSync(srcDir))
+            return [srcDir];
+        return [projectRoot];
+    }
+    /**
+     * With a `src/` layout each first-level subdir is a module (TS-like). Without
+     * `src/`, the whole project is one module (`root`).  Under a monorepo,
+     * `MonorepoAdapter` overrides the module page key with the sub-project dir
+     * name, so the inner `name` here is not user-facing — same as Java.
+     */
+    discoverModules(projectRoot) {
+        const srcDir = path.join(projectRoot, 'src');
+        if (fs.existsSync(srcDir)) {
+            let entries;
+            try {
+                entries = fs.readdirSync(srcDir, { withFileTypes: true });
+            }
+            catch {
+                entries = [];
+            }
+            const subModules = entries
+                .filter((e) => e.isDirectory() && !e.name.startsWith('.') && !EXCLUDED_DIRS.includes(e.name))
+                .map((e) => ({
+                name: e.name,
+                rootDir: path.join(srcDir, e.name),
+                refPrefix: e.name,
+            }))
+                .sort((a, b) => a.name.localeCompare(b.name));
+            if (subModules.length > 0)
+                return subModules;
+            // `src/` exists but holds only files → single module at src.
+            return [{ name: 'root', rootDir: srcDir, refPrefix: '' }];
+        }
+        // No src/: whole project is one module.
+        return [{ name: 'root', rootDir: projectRoot, refPrefix: '' }];
+    }
+    /**
+     * Recursively collect JS/Vue files.  For `.vue`, only the `<script>` block(s)
+     * are stored as `content` (Q4); other extensions are stored whole.
+     */
+    async walkModuleFiles(module) {
+        const files = [];
+        const walk = (dir) => {
+            let entries;
+            try {
+                entries = fs.readdirSync(dir, { withFileTypes: true });
+            }
+            catch {
+                return;
+            }
+            for (const e of entries) {
+                const full = path.join(dir, e.name);
+                if (e.isDirectory()) {
+                    if (EXCLUDED_DIRS.includes(e.name) || e.name.startsWith('.'))
+                        continue;
+                    walk(full);
+                }
+                else if (e.isFile() && hasExt(e.name)) {
+                    const relPath = toPosix(path.relative(module.rootDir, full));
+                    const projectRelPath = module.refPrefix
+                        ? toPosix(path.join(module.refPrefix, relPath))
+                        : relPath;
+                    try {
+                        let content = fs.readFileSync(full, 'utf-8');
+                        if (e.name.endsWith('.vue')) {
+                            content = extractVueScript(content);
+                        }
+                        files.push({ relPath, projectRelPath, content });
+                    }
+                    catch {
+                        // Skip unreadable files silently.
+                    }
+                }
+            }
+        };
+        walk(module.rootDir);
+        return files;
+    }
+    // Phase 2b-1: no parseSymbols (file-walk only, zero native dependency).
+    /**
+     * Describe project metadata.  Manifest = `package.json`; config paths gather
+     * the well-known build configs when present.
+     */
+    describeProjectMeta(projectRoot) {
+        const manifestPath = path.join(projectRoot, 'package.json');
+        const candidates = [
+            'vite.config.js',
+            'vite.config.mjs',
+            'vite.config.ts',
+            'vue.config.js',
+            'jsconfig.json',
+        ].map((f) => path.join(projectRoot, f));
+        return {
+            manifestPath: fs.existsSync(manifestPath) ? manifestPath : null,
+            configPaths: candidates.filter((p) => fs.existsSync(p)),
+        };
+    }
+}
+//# sourceMappingURL=js-vue-adapter.js.map

package/dist/knowledge/adapters/js-vue-adapter.js.map

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

package/dist/knowledge/adapters/kotlin-adapter.d.ts

@@ -0,0 +1,55 @@
+/**
+ * @file adapters/kotlin-adapter.ts
+ * Phase 2b-1 — Kotlin adapter (Gradle / Android, file-walk only).
+ *
+ * Mirrors {@link JavaAdapter} but targets `.kt` / `.kts` sources under the
+ * Gradle/Android `src/main/kotlin` convention.  Registered BEFORE
+ * `JavaAdapter` in `index.ts` so a Kotlin project that ships `build.gradle.kts`
+ * (which `JavaAdapter.detect` would otherwise claim) is correctly routed here —
+ * but ONLY when real `.kt` sources exist, so a pure-Java project that merely
+ * uses the Gradle-Kotlin DSL still falls through to `JavaAdapter`.
+ *
+ * Phase 2b-1 is file-walk only: NO `parseSymbols` is implemented (zero native
+ * dependency, no tree-sitter).  `buildRepoMapWithAdapter` degrades gracefully
+ * to empty symbols when an adapter omits `parseSymbols`.  Symbol extraction
+ * (tree-sitter-kotlin or shallow regex) is deferred to Phase 2b-2.
+ */
+import type { LanguageAdapter, ModuleInfo, SourceFile } from './types.js';
+export declare class KotlinAdapter implements LanguageAdapter {
+    readonly name = "kotlin";
+    readonly fileExtensions: readonly [".kt", ".kts"];
+    /**
+     * Project is Kotlin iff a real Kotlin source layout is present.  Crucially we
+     * require actual `.kt` sources (not merely a `.gradle.kts` manifest) so that a
+     * pure-Java project on the Gradle-Kotlin DSL falls through to `JavaAdapter`.
+     *
+     * Hit when ANY of:
+     *  - `<root>/src/main/kotlin` exists (single/multi-module Gradle convention);
+     *  - a first-level subdir has `src/main/kotlin` (Android `app/src/main/kotlin`);
+     *  - a Gradle-Kotlin manifest exists AND a real `.kt`/`.kts` source is found.
+     */
+    detect(projectRoot: string): boolean;
+    /**
+     * Discover `src/main/kotlin` source roots (project root + first-level subdirs,
+     * excluding build/hidden), mirroring {@link JavaAdapter.discoverSourceRoots}.
+     */
+    discoverSourceRoots(projectRoot: string): string[];
+    /**
+     * Each source root becomes one module.  Name = subdirectory name (Android
+     * `app`) or `root` for a project-root source layout.
+     */
+    discoverModules(projectRoot: string): ModuleInfo[];
+    /**
+     * Recursively collect `.kt`/`.kts` files under the module root, excluding
+     * build artifacts and hidden dirs.
+     */
+    walkModuleFiles(module: ModuleInfo): Promise<SourceFile[]>;
+    /**
+     * Describe project metadata.  Manifest = the first existing Gradle file.
+     */
+    describeProjectMeta(projectRoot: string): {
+        manifestPath: string | null;
+        configPaths: string[];
+    };
+}
+//# sourceMappingURL=kotlin-adapter.d.ts.map

package/dist/knowledge/adapters/kotlin-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kotlin-adapter.d.ts","sourceRoot":"","sources":["../../../src/knowledge/adapters/kotlin-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAIH,OAAO,KAAK,EAAE,eAAe,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AA4C1E,qBAAa,aAAc,YAAW,eAAe;IACnD,QAAQ,CAAC,IAAI,YAAY;IACzB,QAAQ,CAAC,cAAc,2BAA4B;IAEnD;;;;;;;;;OASG;IACH,MAAM,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO;IA+BpC;;;OAGG;IACH,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE;IA6BlD;;;OAGG;IACH,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,UAAU,EAAE;IAgBlD;;;OAGG;IACG,eAAe,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAwChE;;OAEG;IACH,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG;QAAE,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,WAAW,EAAE,MAAM,EAAE,CAAA;KAAE;CASjG"}