@winspan/claude-forge 8.54.3 → 9.2.0

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":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAG7B;;GAEG;AACH,SAAS,OAAO,CAAC,CAAS;IACxB,OAAO,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACrC,CAAC;AAED,kFAAkF;AAClF,MAAM,aAAa,GAAG,CAAC,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE,cAAc,CAAC,CAAC;AAE9E;;;GAGG;AACH,SAAS,eAAe,CAAC,GAAW,EAAE,KAAK,GAAG,CAAC;IAC7C,IAAI,KAAK,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC;IAC5B,IAAI,OAAoB,CAAC;IACzB,IAAI,CAAC;QACH,OAAO,GAAG,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IACzD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;IACD,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,IAAI,CAAC,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC;YACtE,yEAAyE;YACzE,0EAA0E;YAC1E,IAAI,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,KAAK,KAAK,CAAC,IAAI,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC;gBAAE,SAAS;YAC5E,OAAO,IAAI,CAAC;QACd,CAAC;QACD,IAAI,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC;YACpB,IAAI,aAAa,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;gBAAE,SAAS;YACvE,IAAI,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,GAAG,CAAC,CAAC;gBAAE,OAAO,IAAI,CAAC;QACtE,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,oEAAoE;AACpE,SAAS,WAAW,CAAC,IAAY;IAC/B,OAAO,IAAI,KAAK,kBAAkB,IAAI,IAAI,KAAK,qBAAqB,CAAC;AACvE,CAAC;AAED,MAAM,OAAO,aAAa;IACf,IAAI,GAAG,QAAQ,CAAC;IAChB,cAAc,GAAG,CAAC,KAAK,EAAE,MAAM,CAAU,CAAC;IAEnD;;;;;;;;;OASG;IACH,MAAM,CAAC,WAAmB;QACxB,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,iBAAiB,CAAC,CAAC;YAAE,OAAO,IAAI,CAAC;QAE1E,2EAA2E;QAC3E,2EAA2E;QAC3E,0EAA0E;QAC1E,2EAA2E;QAC3E,uEAAuE;QACvE,MAAM,iBAAiB,GACrB,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,kBAAkB,CAAC,CAAC;YACzD,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,qBAAqB,CAAC,CAAC;YAC5D,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC,CAAC;QAExD,IAAI,iBAAiB,EAAE,CAAC;YACtB,IAAI,CAAC;gBACH,MAAM,OAAO,GAAG,EAAE,CAAC,WAAW,CAAC,WAAW,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;gBACrE,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;oBACxB,IAAI,CAAC,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;wBAClF,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,IAAI,EAAE,iBAAiB,CAAC,CAAC;4BAAE,OAAO,IAAI,CAAC;oBACpF,CAAC;gBACH,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,gDAAgD;YAClD,CAAC;YAED,IAAI,eAAe,CAAC,WAAW,CAAC;gBAAE,OAAO,IAAI,CAAC;QAChD,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;;OAGG;IACH,mBAAmB,CAAC,WAAmB;QACrC,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,MAAM,KAAK,GAAG,CAAC,GAAW,EAAE,EAAE;YAC5B,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,iBAAiB,CAAC,CAAC;YACpD,IAAI,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC;gBAAE,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACtD,CAAC,CAAC;QAEF,KAAK,CAAC,WAAW,CAAC,CAAC;QAEnB,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,EAAE,CAAC,WAAW,CAAC,WAAW,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;YACrE,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;gBACxB,IAAI,CAAC,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;oBAClF,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;gBACxC,CAAC;YACH,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,kCAAkC;QACpC,CAAC;QAED,6EAA6E;QAC7E,0EAA0E;QAC1E,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,eAAe,CAAC,WAAW,CAAC,EAAE,CAAC;YACvD,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAC1B,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;;OAGG;IACH,eAAe,CAAC,WAAmB;QACjC,MAAM,KAAK,GAAG,IAAI,CAAC,mBAAmB,CAAC,WAAW,CAAC,CAAC;QACpD,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;YACrB,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;YAC1C,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAClC,uEAAuE;YACvE,oCAAoC;YACpC,MAAM,IAAI,GAAG,GAAG,KAAK,EAAE,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YAClE,OAAO;gBACL,IAAI;gBACJ,OAAO,EAAE,CAAC;gBACV,SAAS,EAAE,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI;aACvC,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,eAAe,CAAC,MAAkB;QACtC,MAAM,KAAK,GAAiB,EAAE,CAAC;QAE/B,MAAM,IAAI,GAAG,CAAC,GAAW,EAAQ,EAAE;YACjC,IAAI,OAAoB,CAAC;YACzB,IAAI,CAAC;gBACH,OAAO,GAAG,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;YACzD,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO;YACT,CAAC;YAED,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;gBACxB,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;gBACpC,IAAI,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC;oBACpB,IAAI,aAAa,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;wBAAE,SAAS;oBACvE,IAAI,CAAC,IAAI,CAAC,CAAC;gBACb,CAAC;qBAAM,IAAI,CAAC,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC;oBAC7E,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;oBAC7D,MAAM,cAAc,GAAG,MAAM,CAAC,SAAS;wBACrC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;wBAC/C,CAAC,CAAC,OAAO,CAAC;oBACZ,IAAI,CAAC;wBACH,KAAK,CAAC,IAAI,CAAC;4BACT,OAAO;4BACP,cAAc;4BACd,OAAO,EAAE,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC;yBACxC,CAAC,CAAC;oBACL,CAAC;oBAAC,MAAM,CAAC;wBACP,kCAAkC;oBACpC,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC,CAAC;QAEF,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACrB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,wEAAwE;IAExE;;OAEG;IACH,mBAAmB,CAAC,WAAmB;QACrC,MAAM,UAAU,GAAG;YACjB,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,kBAAkB,CAAC;YAC1C,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,cAAc,CAAC;YACtC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,qBAAqB,CAAC;SAC9C,CAAC;QACF,MAAM,YAAY,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;QACtE,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC;IAC3C,CAAC;CACF"}

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

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

@@ -0,0 +1,170 @@
+/**
+ * @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 path from 'node:path';
+import { getAdapter } from './index.js';
+/** Normalise a filesystem path to POSIX-style for storage inside the KB. */
+function toPosix(p) {
+    return p.split(path.sep).join('/');
+}
+export class MonorepoAdapter {
+    subprojects;
+    name = 'monorepo';
+    fileExtensions = [];
+    /** Resolved per-sub-project adapters, keyed by sub-project (module) name. */
+    adapterByName = new Map();
+    constructor(subprojects) {
+        this.subprojects = subprojects;
+    }
+    /**
+     * 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) {
+        return this.subprojects.length >= 2;
+    }
+    /** Union of sub-project roots. */
+    discoverSourceRoots(_root) {
+        return this.subprojects.map((s) => s.path);
+    }
+    /**
+     * 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) {
+        return this.subprojects.map((s) => ({
+            name: s.name,
+            rootDir: s.path,
+            refPrefix: s.name,
+        }));
+    }
+    /**
+     * Resolve (and memoise) the per-language adapter for a given module name.
+     */
+    adapterFor(moduleName) {
+        if (this.adapterByName.has(moduleName)) {
+            return this.adapterByName.get(moduleName) ?? null;
+        }
+        const sub = this.subprojects.find((s) => s.name === moduleName);
+        let adapter = null;
+        if (sub) {
+            try {
+                adapter = getAdapter(sub.path);
+            }
+            catch {
+                adapter = null;
+            }
+        }
+        this.adapterByName.set(moduleName, adapter);
+        return adapter;
+    }
+    /**
+     * 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.
+     */
+    async walkModuleFiles(module) {
+        const sub = this.subprojects.find((s) => s.name === module.name);
+        if (!sub)
+            return [];
+        const adapter = this.adapterFor(module.name);
+        if (!adapter)
+            return [];
+        const out = [];
+        let innerModules;
+        try {
+            innerModules = adapter.discoverModules(sub.path);
+        }
+        catch {
+            innerModules = [];
+        }
+        for (const inner of innerModules) {
+            let files;
+            try {
+                files = await adapter.walkModuleFiles(inner);
+            }
+            catch {
+                continue;
+            }
+            for (const f of files) {
+                // The inner adapter's projectRelPath is anchored at the SUB-PROJECT
+                // root. Re-anchor it at the monorepo root by prefixing the sub-project
+                // directory name. relPath (module-local, used for hashing) is left as
+                // the inner adapter produced it but kept unique by prefixing too.
+                const projectRelPath = toPosix(path.join(sub.name, f.projectRelPath));
+                out.push({
+                    relPath: projectRelPath,
+                    projectRelPath,
+                    content: f.content,
+                });
+            }
+        }
+        return out;
+    }
+    /**
+     * 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`).
+     */
+    async parseSymbolsForModule(moduleName, file) {
+        const adapter = this.adapterFor(moduleName);
+        if (!adapter || !adapter.parseSymbols)
+            return [];
+        try {
+            return await adapter.parseSymbols(file);
+        }
+        catch {
+            return [];
+        }
+    }
+    describeProjectMeta(_root) {
+        // The monorepo root has no single manifest. Surface each sub-project's
+        // manifest (best-effort) as config paths for the tech-stack prompt.
+        const configPaths = [];
+        for (const s of this.subprojects) {
+            const adapter = this.adapterFor(s.name);
+            if (!adapter)
+                continue;
+            try {
+                const meta = adapter.describeProjectMeta(s.path);
+                if (meta.manifestPath)
+                    configPaths.push(meta.manifestPath);
+            }
+            catch {
+                // ignore
+            }
+        }
+        return { manifestPath: null, configPaths };
+    }
+}
+//# sourceMappingURL=monorepo-adapter.js.map

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

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

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

@@ -0,0 +1,89 @@
+/**
+ * @file adapters/python-adapter.ts
+ * v10.2 — Python adapter (src-layout + flat-layout support).
+ *
+ * Uses tree-sitter-python for AST parsing. Native module dependency is declared
+ * as optionalDependencies in package.json; if installation fails, parseSymbols
+ * throws a friendly error.
+ *
+ * Supports:
+ * - src-layout: src/<package>/ (PEP 420 namespace packages)
+ * - flat-layout: <package>/ at project root
+ * - pyproject.toml / setup.py / requirements.txt detection
+ *
+ * Module discovery:
+ * - Treats each top-level package (directory with __init__.py or PEP 420 namespace)
+ *   as one module
+ * - For src-layout: discovers packages under src/
+ * - For flat-layout: discovers packages at project root
+ *
+ * Limitations (v10.2):
+ * - Does NOT parse pyproject.toml/setup.py for package metadata
+ * - Method signatures simplified (no parameter types extracted)
+ * - Decorators/async/complex AST nodes may be skipped
+ */
+import type { LanguageAdapter, ModuleInfo, SourceFile } from './types.js';
+import type { RepoMapSymbol } from '../types.js';
+export declare class PythonAdapter implements LanguageAdapter {
+    readonly name = "python";
+    readonly fileExtensions: readonly [".py"];
+    /**
+     * Project is Python iff it has pyproject.toml, setup.py, or requirements.txt.
+     */
+    detect(projectRoot: string): boolean;
+    /**
+     * Discover source roots:
+     * 1. Check for src/ directory (src-layout)
+     * 2. Fall back to project root (flat-layout)
+     */
+    discoverSourceRoots(projectRoot: string): string[];
+    /**
+     * Discover Python packages (modules).
+     * A package is a directory containing:
+     * - __init__.py (traditional package), OR
+     * - At least one .py file (PEP 420 namespace package)
+     *
+     * For src-layout: discovers packages under src/
+     * For flat-layout: discovers packages at project root
+     *
+     * Excludes: hidden dirs, __pycache__, .venv, venv, tests, test, build, dist, .egg-info
+     */
+    discoverModules(projectRoot: string): ModuleInfo[];
+    /**
+     * Find all top-level Python packages in a directory.
+     * Returns absolute paths to package directories.
+     */
+    private findPackages;
+    /**
+     * Check if a directory is a Python package.
+     * Returns true if:
+     * - Contains __init__.py (traditional package), OR
+     * - Contains at least one .py file (PEP 420 namespace package)
+     */
+    private isPackage;
+    /**
+     * Recursively walk module root, collecting .py files.
+     * Excludes: __pycache__, .venv, venv, tests, test, hidden dirs.
+     */
+    walkModuleFiles(module: ModuleInfo): Promise<SourceFile[]>;
+    /**
+     * Extract symbols from Python source using tree-sitter-python.
+     * Lazy-imports tree-sitter to avoid breaking the entire adapter when native
+     * module installation fails.
+     *
+     * Extracts:
+     * - class declarations
+     * - function definitions (top-level and class methods)
+     * - module-level constants (UPPER_CASE variables)
+     */
+    parseSymbols(file: SourceFile): Promise<RepoMapSymbol[]>;
+    /**
+     * Describe project metadata files.
+     * Returns the primary manifest (pyproject.toml or setup.py) and common config files.
+     */
+    describeProjectMeta(projectRoot: string): {
+        manifestPath: string | null;
+        configPaths: string[];
+    };
+}
+//# sourceMappingURL=python-adapter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"python-adapter.d.ts","sourceRoot":"","sources":["../../../src/knowledge/adapters/python-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAIH,OAAO,KAAK,EAAE,eAAe,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC1E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AASjD,qBAAa,aAAc,YAAW,eAAe;IACnD,QAAQ,CAAC,IAAI,YAAY;IACzB,QAAQ,CAAC,cAAc,mBAAoB;IAE3C;;OAEG;IACH,MAAM,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO;IAQpC;;;;OAIG;IACH,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE;IAQlD;;;;;;;;;;OAUG;IACH,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,UAAU,EAAE;IAoBlD;;;OAGG;IACH,OAAO,CAAC,YAAY;IAyCpB;;;;;OAKG;IACH,OAAO,CAAC,SAAS;IAgBjB;;;OAGG;IACG,eAAe,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IA+ChE;;;;;;;;;OASG;IACG,YAAY,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IA2I9D;;;OAGG;IACH,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG;QAAE,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,WAAW,EAAE,MAAM,EAAE,CAAA;KAAE;CAyBjG"}