@winspan/claude-forge 8.54.4 → 9.12.0

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"}

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

@@ -0,0 +1,209 @@
+/**
+ * @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 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 Kotlin/Gradle/Android projects. */
+const EXCLUDED_DIRS = ['build', '.gradle', '.idea', 'target', 'node_modules'];
+/**
+ * Existence probe: does `dir` (recursively, depth-bounded) contain at least one
+ * `.kt`/`.kts` file?  Returns on the first hit; skips build/hidden dirs.
+ */
+function hasKotlinSource(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() && (e.name.endsWith('.kt') || e.name.endsWith('.kts'))) {
+            // A bare `build.gradle.kts` at the root is a Gradle DSL file, not Kotlin
+            // *source*. Only count `.kts` when it is NOT a top-level gradle manifest.
+            if (e.name.endsWith('.kts') && depth === 0 && isGradleDsl(e.name))
+                continue;
+            return true;
+        }
+        if (e.isDirectory()) {
+            if (EXCLUDED_DIRS.includes(e.name) || e.name.startsWith('.'))
+                continue;
+            if (hasKotlinSource(path.join(dir, e.name), depth + 1))
+                return true;
+        }
+    }
+    return false;
+}
+/** True for the well-known Gradle-Kotlin-DSL manifest filenames. */
+function isGradleDsl(name) {
+    return name === 'build.gradle.kts' || name === 'settings.gradle.kts';
+}
+export class KotlinAdapter {
+    name = 'kotlin';
+    fileExtensions = ['.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) {
+        if (fs.existsSync(path.join(projectRoot, 'src/main/kotlin')))
+            return true;
+        // First-level `app/src/main/kotlin` (Android) — but ONLY when this root is
+        // itself a single Gradle project (has a root manifest). Without that guard
+        // we would hijack a MONOREPO root whose sub-project happens to be Kotlin,
+        // forcing the whole monorepo down the single-project path. (JavaAdapter is
+        // immune to this because its detect only probes root-level manifests.)
+        const hasGradleManifest = fs.existsSync(path.join(projectRoot, 'build.gradle.kts')) ||
+            fs.existsSync(path.join(projectRoot, 'settings.gradle.kts')) ||
+            fs.existsSync(path.join(projectRoot, 'build.gradle'));
+        if (hasGradleManifest) {
+            try {
+                const entries = fs.readdirSync(projectRoot, { withFileTypes: true });
+                for (const e of entries) {
+                    if (e.isDirectory() && !e.name.startsWith('.') && !EXCLUDED_DIRS.includes(e.name)) {
+                        if (fs.existsSync(path.join(projectRoot, e.name, 'src/main/kotlin')))
+                            return true;
+                    }
+                }
+            }
+            catch {
+                // Defensive: continue to manifest+source probe.
+            }
+            if (hasKotlinSource(projectRoot))
+                return true;
+        }
+        return false;
+    }
+    /**
+     * Discover `src/main/kotlin` source roots (project root + first-level subdirs,
+     * excluding build/hidden), mirroring {@link JavaAdapter.discoverSourceRoots}.
+     */
+    discoverSourceRoots(projectRoot) {
+        const roots = [];
+        const check = (dir) => {
+            const candidate = path.join(dir, 'src/main/kotlin');
+            if (fs.existsSync(candidate))
+                roots.push(candidate);
+        };
+        check(projectRoot);
+        try {
+            const entries = fs.readdirSync(projectRoot, { withFileTypes: true });
+            for (const e of entries) {
+                if (e.isDirectory() && !e.name.startsWith('.') && !EXCLUDED_DIRS.includes(e.name)) {
+                    check(path.join(projectRoot, e.name));
+                }
+            }
+        }
+        catch {
+            // Defensive: return what we have.
+        }
+        // Fallback: no conventional src/main/kotlin (loose Kotlin layout). Treat the
+        // project root itself as the source root so `.kt` files are still walked.
+        if (roots.length === 0 && hasKotlinSource(projectRoot)) {
+            roots.push(projectRoot);
+        }
+        return roots;
+    }
+    /**
+     * Each source root becomes one module.  Name = subdirectory name (Android
+     * `app`) or `root` for a project-root source layout.
+     */
+    discoverModules(projectRoot) {
+        const roots = this.discoverSourceRoots(projectRoot);
+        return roots.map((r) => {
+            const rel = path.relative(projectRoot, r);
+            const parts = rel.split(path.sep);
+            // `src/main/kotlin` → name 'root'; `app/src/main/kotlin` → name 'app';
+            // `` (root fallback) → name 'root'.
+            const name = rel === '' || parts[0] === 'src' ? 'root' : parts[0];
+            return {
+                name,
+                rootDir: r,
+                refPrefix: name === 'root' ? '' : name,
+            };
+        });
+    }
+    /**
+     * Recursively collect `.kt`/`.kts` files under the module root, excluding
+     * build artifacts and 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()) {
+                    if (EXCLUDED_DIRS.includes(e.name) || e.name.startsWith('.'))
+                        continue;
+                    walk(full);
+                }
+                else if (e.isFile() && (e.name.endsWith('.kt') || e.name.endsWith('.kts'))) {
+                    const relPath = toPosix(path.relative(module.rootDir, full));
+                    const projectRelPath = module.refPrefix
+                        ? toPosix(path.join(module.refPrefix, relPath))
+                        : relPath;
+                    try {
+                        files.push({
+                            relPath,
+                            projectRelPath,
+                            content: fs.readFileSync(full, 'utf-8'),
+                        });
+                    }
+                    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 = the first existing Gradle file.
+     */
+    describeProjectMeta(projectRoot) {
+        const candidates = [
+            path.join(projectRoot, 'build.gradle.kts'),
+            path.join(projectRoot, 'build.gradle'),
+            path.join(projectRoot, 'settings.gradle.kts'),
+        ];
+        const manifestPath = candidates.find((p) => fs.existsSync(p)) ?? null;
+        return { manifestPath, configPaths: [] };
+    }
+}
+//# sourceMappingURL=kotlin-adapter.js.map

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

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

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

@@ -0,0 +1,77 @@
+/**
+ * @file adapters/monorepo-adapter.ts
+ * Aggregating adapter for polyglot / multi-package monorepos.
+ *
+ * A monorepo root has NO single-language manifest of its own; instead it
+ * contains ≥ 2 direct sub-directories, each recognised by some per-language
+ * `LanguageAdapter` (TypeScript / Java / Python / Go / Rust). `MonorepoAdapter`
+ * treats **each sub-project as exactly one KB module**, with the module name
+ * forced to the sub-project's directory name (e.g. `AIPin-android`, NOT the
+ * Java adapter's default `app`).
+ *
+ * Two-phase delegation (Risk 2 in the spec):
+ *   - `discoverModules` emits one `ModuleInfo` per sub-project whose `rootDir`
+ *     is the sub-project directory itself.
+ *   - `walkModuleFiles` / `parseSymbolsForModule` re-resolve the sub-project's
+ *     own adapter and ask IT to `discoverModules(subprojectRoot)` so we get the
+ *     adapter-correct inner `rootDir` (e.g. `src/main/java`), then delegate the
+ *     file walk to those inner modules. File paths are prefixed with the
+ *     sub-project directory name so `KBRef.file` stays anchored at the monorepo
+ *     root (e.g. `aipin-consumer/src/main/java/...`).
+ *
+ * The KB is written to the monorepo ROOT's `.forge-knowledge/`, so injection
+ * (which resolves up to the `.git` root) works from any sub-project cwd for
+ * free.
+ */
+import type { LanguageAdapter, ModuleInfo, SourceFile } from './types.js';
+import type { RepoMapSymbol } from '../types.js';
+import type { SubprojectInfo } from '../project-detector.js';
+export declare class MonorepoAdapter implements LanguageAdapter {
+    readonly subprojects: SubprojectInfo[];
+    readonly name = "monorepo";
+    readonly fileExtensions: readonly [];
+    /** Resolved per-sub-project adapters, keyed by sub-project (module) name. */
+    private readonly adapterByName;
+    constructor(subprojects: SubprojectInfo[]);
+    /**
+     * Mirror of `detectMonorepo`: true when ≥ 2 direct sub-directories each have
+     * a language adapter. Kept lightweight so the registry / builder can probe an
+     * already-constructed instance without re-scanning.
+     */
+    detect(_root: string): boolean;
+    /** Union of sub-project roots. */
+    discoverSourceRoots(_root: string): string[];
+    /**
+     * One `ModuleInfo` per sub-project. The module name is the sub-project
+     * directory name (verbatim — monorepo OQ2), `rootDir` is the sub-project
+     * directory, and `refPrefix` is the directory name so refs are anchored at
+     * the monorepo root.
+     */
+    discoverModules(_root: string): ModuleInfo[];
+    /**
+     * Resolve (and memoise) the per-language adapter for a given module name.
+     */
+    private adapterFor;
+    /**
+     * Two-phase delegation: ask the sub-project's own adapter to discover its
+     * inner modules (so we get the adapter-correct inner `rootDir`), walk every
+     * inner module's files, and re-anchor each file's `projectRelPath` under the
+     * sub-project directory name.
+     */
+    walkModuleFiles(module: ModuleInfo): Promise<SourceFile[]>;
+    /**
+     * Per-file symbol extraction, delegated to the owning sub-project adapter.
+     *
+     * `buildRepoMapWithAdapter` calls `adapter.parseSymbols(file)` per file but
+     * has no module context, so a plain `MonorepoAdapter.parseSymbols` cannot
+     * know which sub-project the file belongs to. Instead the builder routes
+     * symbol extraction per-module via this helper (see builder.ts
+     * `buildRepoMapWithAdapter`).
+     */
+    parseSymbolsForModule(moduleName: string, file: SourceFile): Promise<RepoMapSymbol[]>;
+    describeProjectMeta(_root: string): {
+        manifestPath: string | null;
+        configPaths: string[];
+    };
+}
+//# sourceMappingURL=monorepo-adapter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"monorepo-adapter.d.ts","sourceRoot":"","sources":["../../../src/knowledge/adapters/monorepo-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAIH,OAAO,KAAK,EAAE,eAAe,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC1E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAQ7D,qBAAa,eAAgB,YAAW,eAAe;aAOzB,WAAW,EAAE,cAAc,EAAE;IANzD,QAAQ,CAAC,IAAI,cAAc;IAC3B,QAAQ,CAAC,cAAc,cAAe;IAEtC,6EAA6E;IAC7E,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA6C;gBAE/C,WAAW,EAAE,cAAc,EAAE;IAEzD;;;;OAIG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAI9B,kCAAkC;IAClC,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE;IAI5C;;;;;OAKG;IACH,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,EAAE;IAQ5C;;OAEG;IACH,OAAO,CAAC,UAAU;IAiBlB;;;;;OAKG;IACG,eAAe,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAsChE;;;;;;;;OAQG;IACG,qBAAqB,CACzB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,UAAU,GACf,OAAO,CAAC,aAAa,EAAE,CAAC;IAU3B,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG;QAClC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;QAC5B,WAAW,EAAE,MAAM,EAAE,CAAC;KACvB;CAgBF"}