@agentxm/client-core 0.1.6

package/dist/src/unstable/packaging/luarocks.js

@@ -0,0 +1,184 @@
+/**
+ * LuaRocks package detector and reader for package-compatibility discovery.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+// Intentional escape hatch: node:os homedir() has no @effect/platform equivalent.
+import * as os from "node:os";
+import * as Effect from "effect/Effect";
+import * as FileSystem from "effect/FileSystem";
+import * as Option from "effect/Option";
+import * as Path from "effect/Path";
+import * as Result from "effect/Result";
+import * as Schema from "effect/Schema";
+import { PackageURL } from "packageurl-js";
+import { AxmPackageMetaSchema } from "./axm-package-meta.js";
+import { PackageTypeSchema } from "./package-type.js";
+import { PackageUrlSchema } from "./package-url.js";
+const luarocksType = Schema.decodeUnknownSync(PackageTypeSchema)("luarocks");
+const decodePurl = Schema.decodeUnknownSync(PackageUrlSchema);
+const decodeAxmMeta = Schema.decodeUnknownResult(AxmPackageMetaSchema);
+/**
+ * Read a file as string, returning Option.none for NotFound and other errors.
+ */
+const readFileOptional = (filePath) => Effect.gen(function* () {
+    const fs = yield* FileSystem.FileSystem;
+    const content = yield* fs.readFileString(filePath).pipe(Effect.option);
+    return content;
+});
+/**
+ * Parse JSON string, returning Option.none and logging a warning on failure.
+ */
+const parseJsonOptional = (content, context) => Effect.gen(function* () {
+    const result = yield* Effect.try({
+        try: () => JSON.parse(content),
+        catch: () => ({ _tag: "JsonParseError" }),
+    }).pipe(Effect.option);
+    if (Option.isNone(result)) {
+        yield* Effect.logWarning(`Malformed JSON in ${context}, skipping`);
+        return Option.none();
+    }
+    return Option.some(result.value);
+});
+/** Dependencies to skip (Lua runtime itself). */
+const SKIP_DEPS = new Set(["lua"]);
+/**
+ * Parse a single dependency string from a rockspec dependencies table.
+ * Format: "name [operator version]"
+ * Examples: "luasocket >= 3.0", "luafilesystem", "cjson == 1.0.0-1"
+ */
+const parseLuaDep = (entry) => {
+    const trimmed = entry.trim().replace(/^["']|["']$/g, "");
+    if (trimmed === "")
+        return undefined;
+    const parts = trimmed.split(/\s+/);
+    const name = parts[0];
+    if (name === undefined || name === "")
+        return undefined;
+    if (SKIP_DEPS.has(name.toLowerCase()))
+        return undefined;
+    // Check for exact version: name == version
+    if (parts[1] === "==" && parts[2] !== undefined) {
+        return { name, version: parts[2] };
+    }
+    // Any other operator or no version => versionless
+    return { name };
+};
+/**
+ * Parse a rockspec dependencies table from file content.
+ * The dependencies table has the form:
+ *   dependencies = { "dep1", "dep2 >= 1.0", ... }
+ * This is a Lua table literal, so we use regex to extract entries.
+ */
+const parseRockspecDeps = (content, source) => {
+    const results = [];
+    // Find dependencies table - may span multiple lines
+    const depsRegex = /dependencies\s*=\s*\{([^}]*)}/s;
+    const match = depsRegex.exec(content);
+    if (match === null || match[1] === undefined)
+        return [];
+    // Extract quoted strings from the table
+    const stringRegex = /["']([^"']+)["']/g;
+    let strMatch;
+    while ((strMatch = stringRegex.exec(match[1])) !== null) {
+        const entry = strMatch[1];
+        if (entry === undefined)
+            continue;
+        const parsed = parseLuaDep(entry);
+        if (parsed === undefined)
+            continue;
+        const purl = new PackageURL("luarocks", null, parsed.name, parsed.version ?? null, null, null);
+        const purlParts = decodePurl(purl.toString());
+        results.push({ purl: purlParts, type: luarocksType, source });
+    }
+    return results;
+};
+/**
+ * LuaRocks package detector.
+ *
+ * Scans `*.rockspec` files in the project directory and extracts
+ * dependencies from the `dependencies` table. Skips the `lua` runtime.
+ * Multiple rockspec files are processed and results deduplicated.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const luarocksDetector = {
+    type: luarocksType,
+    detect: Effect.fn("detect.luarocks")(function* (projectDir) {
+        const path = yield* Path.Path;
+        const fs = yield* FileSystem.FileSystem;
+        const entries = yield* fs.readDirectory(projectDir).pipe(Effect.option);
+        if (Option.isNone(entries))
+            return [];
+        const rockspecFiles = entries.value.filter((e) => e.endsWith(".rockspec"));
+        if (rockspecFiles.length === 0)
+            return [];
+        const allDeps = [];
+        const seenNames = new Set();
+        for (const rockspecFile of rockspecFiles) {
+            const filePath = path.join(projectDir, rockspecFile);
+            const content = yield* readFileOptional(filePath);
+            if (Option.isNone(content))
+                continue;
+            const deps = parseRockspecDeps(content.value, filePath);
+            if (deps.length === 0 && content.value.trim().length > 0) {
+                // Content exists but no deps - check if it looks like a valid rockspec
+                if (!content.value.includes("package") && !content.value.includes("rockspec_format")) {
+                    yield* Effect.logWarning(`Malformed rockspec file: ${rockspecFile}, skipping`);
+                }
+            }
+            for (const dep of deps) {
+                if (!seenNames.has(dep.purl.name)) {
+                    seenNames.add(dep.purl.name);
+                    allDeps.push(dep);
+                }
+            }
+        }
+        return allDeps;
+    }, Effect.annotateLogs({ detector: "luarocks" }), Effect.withSpan("detect.luarocks")),
+};
+/**
+ * LuaRocks package reader.
+ *
+ * Reads `axm.json` sidecar from the LuaRocks install tree.
+ * Checks system tree (`/usr/local/lib/luarocks/rocks-5.x/`) and
+ * user tree (`~/.luarocks/lib/luarocks/rocks-5.x/`).
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const luarocksReader = {
+    type: luarocksType,
+    read: Effect.fn("read.luarocks")(function* (pkg) {
+        const path = yield* Path.Path;
+        const pkgName = pkg.purl.name;
+        const version = pkg.purl.version ?? "0.0.0-0";
+        const home = os.homedir();
+        // Lua version variants to check
+        const luaVersions = ["5.4", "5.3", "5.2", "5.1"];
+        // Candidate base paths
+        const basePaths = [
+            "/usr/local/lib/luarocks",
+            path.join(home, ".luarocks", "lib", "luarocks"),
+        ];
+        for (const basePath of basePaths) {
+            for (const luaVer of luaVersions) {
+                const axmJsonPath = path.join(basePath, `rocks-${luaVer}`, pkgName, version, "axm.json");
+                const content = yield* readFileOptional(axmJsonPath);
+                if (Option.isNone(content))
+                    continue;
+                const parsed = yield* parseJsonOptional(content.value, `${pkgName}/${version}/axm.json`);
+                if (Option.isNone(parsed))
+                    return Option.none();
+                const metaResult = decodeAxmMeta(parsed.value);
+                if (Result.isFailure(metaResult)) {
+                    yield* Effect.logWarning(`Invalid axm metadata in ${pkgName}: schema validation failed`);
+                    return Option.none();
+                }
+                return Option.some(metaResult.success.recommendedExtensions);
+            }
+        }
+        return Option.none();
+    }, Effect.annotateLogs({ reader: "luarocks" }), Effect.withSpan("read.luarocks")),
+};
+//# sourceMappingURL=luarocks.js.map

package/dist/src/unstable/packaging/luarocks.js.map

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

package/dist/src/unstable/packaging/maven.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Maven/Gradle package detector and reader for package-compatibility discovery.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+import type { PackageDetector, PackageReader } from "./types.js";
+/**
+ * Maven package detector.
+ *
+ * Scans `pom.xml`, `build.gradle`, `build.gradle.kts`, and
+ * `gradle/libs.versions.toml` in the project directory.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const mavenDetector: PackageDetector;
+/**
+ * Maven package reader.
+ *
+ * Reads `META-INF/axm.json` from local JAR files in `~/.m2/repository/`
+ * or Gradle cache `~/.gradle/caches/modules-2/files-2.1/`.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const mavenReader: PackageReader;
+//# sourceMappingURL=maven.d.ts.map

package/dist/src/unstable/packaging/maven.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"maven.d.ts","sourceRoot":"","sources":["../../../../src/unstable/packaging/maven.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAcH,OAAO,KAAK,EAAmB,eAAe,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAuXlF;;;;;;;GAOG;AACH,eAAO,MAAM,aAAa,EAAE,eAiD3B,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,WAAW,EAAE,aAqFzB,CAAC"}

package/dist/src/unstable/packaging/maven.js

@@ -0,0 +1,450 @@
+/**
+ * Maven/Gradle package detector and reader for package-compatibility discovery.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+// Intentional escape hatch: node:os homedir() has no @effect/platform equivalent.
+import * as os from "node:os";
+import * as Effect from "effect/Effect";
+import * as FileSystem from "effect/FileSystem";
+import * as Option from "effect/Option";
+import * as Path from "effect/Path";
+import * as Result from "effect/Result";
+import * as Schema from "effect/Schema";
+import { PackageURL } from "packageurl-js";
+import { AxmPackageMetaSchema } from "./axm-package-meta.js";
+import { PackageTypeSchema } from "./package-type.js";
+import { PackageUrlSchema } from "./package-url.js";
+const mavenType = Schema.decodeUnknownSync(PackageTypeSchema)("maven");
+const decodePurl = Schema.decodeUnknownSync(PackageUrlSchema);
+const decodeAxmMeta = Schema.decodeUnknownResult(AxmPackageMetaSchema);
+/**
+ * Returns true if the version string is a Maven version range.
+ * Ranges use brackets/parens like [1.0,2.0), (,1.0], etc.
+ */
+const isMavenVersionRange = (version) => /^[[(]/.test(version) || /[)\]]$/.test(version);
+/**
+ * Returns true if the version string is a property reference like ${foo.bar}.
+ */
+const isPropertyReference = (version) => /^\$\{.+\}$/.test(version);
+/**
+ * Extract the property name from a property reference like ${foo.bar} -> foo.bar.
+ */
+const extractPropertyName = (version) => {
+    const match = /^\$\{(.+)\}$/.exec(version);
+    return match?.[1];
+};
+/**
+ * Parse <properties> from pom.xml content. Returns a map of property name to value.
+ */
+const parseProperties = (content) => {
+    const props = new Map();
+    const propsBlockMatch = /<properties>([\s\S]*?)<\/properties>/i.exec(content);
+    if (propsBlockMatch?.[1] === undefined)
+        return props;
+    const propRegex = /<([a-zA-Z0-9_.:-]+)>\s*(.*?)\s*<\/\1>/g;
+    let match;
+    while ((match = propRegex.exec(propsBlockMatch[1])) !== null) {
+        if (match[1] !== undefined && match[2] !== undefined) {
+            props.set(match[1], match[2]);
+        }
+    }
+    return props;
+};
+/**
+ * Resolve a version string, handling property references.
+ */
+const resolveVersion = (version, properties) => {
+    if (version === undefined)
+        return undefined;
+    if (isMavenVersionRange(version))
+        return undefined;
+    if (isPropertyReference(version)) {
+        const propName = extractPropertyName(version);
+        if (propName === undefined)
+            return undefined;
+        const resolved = properties.get(propName);
+        if (resolved === undefined)
+            return undefined;
+        // Recursively resolve in case the property itself references another
+        return resolveVersion(resolved, properties);
+    }
+    return version;
+};
+/**
+ * Create a DetectedPackage from groupId, artifactId, and optional version.
+ */
+const makeMavenPackage = (groupId, artifactId, version, source) => {
+    const purl = new PackageURL("maven", groupId, artifactId, version ?? null, null, null);
+    const purlParts = decodePurl(purl.toString());
+    return { purl: purlParts, type: mavenType, source };
+};
+/**
+ * Parse pom.xml content and extract dependencies.
+ */
+const parsePomXml = (content, source) => {
+    const properties = parseProperties(content);
+    const results = [];
+    // Match <dependency> blocks
+    const depRegex = /<dependency>([\s\S]*?)<\/dependency>/gi;
+    let depMatch;
+    while ((depMatch = depRegex.exec(content)) !== null) {
+        const block = depMatch[1];
+        if (block === undefined)
+            continue;
+        const groupIdMatch = /<groupId>\s*(.*?)\s*<\/groupId>/i.exec(block);
+        const artifactIdMatch = /<artifactId>\s*(.*?)\s*<\/artifactId>/i.exec(block);
+        const versionMatch = /<version>\s*(.*?)\s*<\/version>/i.exec(block);
+        const groupId = groupIdMatch?.[1];
+        const artifactId = artifactIdMatch?.[1];
+        if (groupId === undefined || artifactId === undefined)
+            continue;
+        const rawVersion = versionMatch?.[1];
+        const version = resolveVersion(rawVersion, properties);
+        results.push(makeMavenPackage(groupId, artifactId, version, source));
+    }
+    return results;
+};
+/** Gradle configuration keywords that declare dependencies. */
+const GRADLE_CONFIGS = [
+    "implementation",
+    "api",
+    "compileOnly",
+    "runtimeOnly",
+    "testImplementation",
+    "testCompileOnly",
+    "testRuntimeOnly",
+    "annotationProcessor",
+    "kapt",
+];
+/**
+ * Parse a Gradle dependency string like "group:name:version" or "group:name".
+ */
+const parseGradleCoordinate = (coordinate, source) => {
+    const parts = coordinate.split(":");
+    if (parts.length < 2)
+        return undefined;
+    const groupId = parts[0];
+    const artifactId = parts[1];
+    if (groupId === undefined || artifactId === undefined)
+        return undefined;
+    if (groupId.trim() === "" || artifactId.trim() === "")
+        return undefined;
+    const version = parts.length >= 3 && parts[2] !== undefined && parts[2].trim() !== ""
+        ? parts[2].trim()
+        : undefined;
+    return makeMavenPackage(groupId.trim(), artifactId.trim(), version, source);
+};
+/**
+ * Parse build.gradle or build.gradle.kts content and extract dependencies.
+ */
+const parseGradleBuild = (content, source) => {
+    const results = [];
+    const configPattern = GRADLE_CONFIGS.join("|");
+    // Groovy DSL: implementation 'group:name:version'
+    const groovyRegex = new RegExp(`(?:${configPattern})\\s+['"]([^'"]+)['"]`, "g");
+    let match;
+    while ((match = groovyRegex.exec(content)) !== null) {
+        if (match[1] === undefined)
+            continue;
+        const detected = parseGradleCoordinate(match[1], source);
+        if (detected !== undefined)
+            results.push(detected);
+    }
+    // Kotlin DSL: implementation("group:name:version")
+    const kotlinRegex = new RegExp(`(?:${configPattern})\\(\\s*['"]([^'"]+)['"]\\s*\\)`, "g");
+    while ((match = kotlinRegex.exec(content)) !== null) {
+        if (match[1] === undefined)
+            continue;
+        const detected = parseGradleCoordinate(match[1], source);
+        if (detected !== undefined)
+            results.push(detected);
+    }
+    return results;
+};
+/**
+ * Parse gradle/libs.versions.toml content and extract library entries.
+ * Supports `module = "group:name"` and separate `group`/`name` keys.
+ */
+const parseVersionCatalog = (content, source) => {
+    const results = [];
+    // Find the [libraries] section
+    const librariesMatch = /\[libraries\]([\s\S]*?)(?:\n\[|\n*$)/i.exec(content);
+    if (librariesMatch?.[1] === undefined)
+        return results;
+    const librariesSection = librariesMatch[1];
+    // Parse [versions] section for version references
+    const versions = new Map();
+    const versionsMatch = /\[versions\]([\s\S]*?)(?:\n\[|\n*$)/i.exec(content);
+    if (versionsMatch?.[1] !== undefined) {
+        const versionLineRegex = /^\s*([a-zA-Z0-9_-]+)\s*=\s*"([^"]+)"/gm;
+        let vMatch;
+        while ((vMatch = versionLineRegex.exec(versionsMatch[1])) !== null) {
+            if (vMatch[1] !== undefined && vMatch[2] !== undefined) {
+                versions.set(vMatch[1], vMatch[2]);
+            }
+        }
+    }
+    // Parse library entries line by line
+    const lines = librariesSection.split("\n");
+    for (const line of lines) {
+        const trimmed = line.trim();
+        if (trimmed === "" || trimmed.startsWith("#"))
+            continue;
+        // Match: name = { ... }
+        const entryMatch = /^[a-zA-Z0-9_-]+\s*=\s*\{(.+)\}/.exec(trimmed);
+        if (entryMatch?.[1] === undefined)
+            continue;
+        const props = entryMatch[1];
+        let groupId;
+        let artifactId;
+        let version;
+        // Check for module = "group:name"
+        const moduleMatch = /module\s*=\s*"([^"]+)"/.exec(props);
+        if (moduleMatch?.[1] !== undefined) {
+            const parts = moduleMatch[1].split(":");
+            groupId = parts[0];
+            artifactId = parts[1];
+        }
+        else {
+            // Check for separate group and name keys
+            const groupMatch = /group\s*=\s*"([^"]+)"/.exec(props);
+            const nameMatch = /name\s*=\s*"([^"]+)"/.exec(props);
+            groupId = groupMatch?.[1];
+            artifactId = nameMatch?.[1];
+        }
+        if (groupId === undefined || artifactId === undefined)
+            continue;
+        // Check for version
+        const versionMatch = /version\s*=\s*"([^"]+)"/.exec(props);
+        const versionRefMatch = /version\.ref\s*=\s*"([^"]+)"/.exec(props);
+        if (versionMatch?.[1] !== undefined) {
+            version = versionMatch[1];
+        }
+        else if (versionRefMatch?.[1] !== undefined) {
+            version = versions.get(versionRefMatch[1]);
+        }
+        results.push(makeMavenPackage(groupId, artifactId, version, source));
+    }
+    return results;
+};
+/**
+ * Read a file as string, returning Option.none for NotFound and other errors.
+ */
+const readFileOptional = (filePath) => Effect.gen(function* () {
+    const fs = yield* FileSystem.FileSystem;
+    const content = yield* fs.readFileString(filePath).pipe(Effect.option);
+    return content;
+});
+/**
+ * Parse JSON string, returning Option.none and logging a warning on failure.
+ */
+const parseJsonOptional = (content, context) => Effect.gen(function* () {
+    const result = yield* Effect.try({
+        try: () => JSON.parse(content),
+        catch: () => ({ _tag: "JsonParseError" }),
+    }).pipe(Effect.option);
+    if (Option.isNone(result)) {
+        yield* Effect.logWarning(`Malformed JSON in ${context}, skipping`);
+        return Option.none();
+    }
+    return Option.some(result.value);
+});
+/**
+ * Deduplicate packages by purl identity (namespace + name).
+ */
+const deduplicatePackages = (packages) => {
+    const seen = new Set();
+    const results = [];
+    for (const pkg of packages) {
+        const key = `${pkg.purl.namespace ?? ""}/${pkg.purl.name}`;
+        if (!seen.has(key)) {
+            seen.add(key);
+            results.push(pkg);
+        }
+    }
+    return results;
+};
+/**
+ * List files matching a glob pattern in a directory.
+ */
+const listDirectory = (dirPath) => Effect.gen(function* () {
+    const fs = yield* FileSystem.FileSystem;
+    const entries = yield* fs.readDirectory(dirPath).pipe(Effect.option);
+    return entries;
+});
+/**
+ * Find JAR files in a directory.
+ */
+const findJarsInDir = (dirPath) => Effect.gen(function* () {
+    const entries = yield* listDirectory(dirPath);
+    if (Option.isNone(entries))
+        return [];
+    return entries.value.filter((e) => e.endsWith(".jar"));
+});
+/**
+ * Read a ZIP file entry using the built-in Bun/Node zip APIs.
+ * Returns Option.none if the entry is not found.
+ */
+const readZipEntry = (zipPath, entryName) => Effect.gen(function* () {
+    const fs = yield* FileSystem.FileSystem;
+    // Read the jar file as bytes
+    const bytes = yield* fs.readFile(zipPath).pipe(Effect.option);
+    if (Option.isNone(bytes))
+        return Option.none();
+    // Use simple ZIP parsing to find the entry
+    // ZIP files have a central directory at the end
+    const data = bytes.value;
+    const content = yield* Effect.try({
+        try: () => {
+            // Search for the local file header matching our entry name
+            const view = new DataView(data.buffer, data.byteOffset, data.byteLength);
+            // Scan for local file headers (PK\x03\x04)
+            for (let i = 0; i < data.length - 30; i++) {
+                if (data[i] === 0x50 &&
+                    data[i + 1] === 0x4b &&
+                    data[i + 2] === 0x03 &&
+                    data[i + 3] === 0x04) {
+                    const nameLength = view.getUint16(i + 26, true);
+                    const extraLength = view.getUint16(i + 28, true);
+                    const compressedSize = view.getUint32(i + 18, true);
+                    const compressionMethod = view.getUint16(i + 8, true);
+                    // Check if filename matches
+                    const fileNameStart = i + 30;
+                    const fileName = new TextDecoder().decode(data.slice(fileNameStart, fileNameStart + nameLength));
+                    if (fileName === entryName) {
+                        // Only handle STORED (0) entries for simplicity
+                        if (compressionMethod !== 0) {
+                            return undefined;
+                        }
+                        const dataStart = fileNameStart + nameLength + extraLength;
+                        const entryData = data.slice(dataStart, dataStart + compressedSize);
+                        return new TextDecoder().decode(entryData);
+                    }
+                }
+            }
+            return undefined;
+        },
+        catch: () => ({ _tag: "ZipReadError" }),
+    }).pipe(Effect.option);
+    if (Option.isNone(content) || content.value === undefined) {
+        return Option.none();
+    }
+    return Option.some(content.value);
+});
+/**
+ * Maven package detector.
+ *
+ * Scans `pom.xml`, `build.gradle`, `build.gradle.kts`, and
+ * `gradle/libs.versions.toml` in the project directory.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const mavenDetector = {
+    type: mavenType,
+    detect: Effect.fn("detect.maven")(function* (projectDir) {
+        const path = yield* Path.Path;
+        const allPackages = [];
+        // Parse pom.xml
+        const pomPath = path.join(projectDir, "pom.xml");
+        const pomContent = yield* readFileOptional(pomPath);
+        if (Option.isSome(pomContent)) {
+            // Basic validation: check for XML-like content
+            if (pomContent.value.includes("<") && pomContent.value.includes(">")) {
+                const pomDeps = parsePomXml(pomContent.value, pomPath);
+                allPackages.push(...pomDeps);
+            }
+            else {
+                yield* Effect.logWarning("Malformed pom.xml: not valid XML, skipping");
+            }
+        }
+        // Parse build.gradle
+        const gradlePath = path.join(projectDir, "build.gradle");
+        const gradleContent = yield* readFileOptional(gradlePath);
+        if (Option.isSome(gradleContent)) {
+            const gradleDeps = parseGradleBuild(gradleContent.value, gradlePath);
+            allPackages.push(...gradleDeps);
+        }
+        // Parse build.gradle.kts
+        const gradleKtsPath = path.join(projectDir, "build.gradle.kts");
+        const gradleKtsContent = yield* readFileOptional(gradleKtsPath);
+        if (Option.isSome(gradleKtsContent)) {
+            const gradleKtsDeps = parseGradleBuild(gradleKtsContent.value, gradleKtsPath);
+            allPackages.push(...gradleKtsDeps);
+        }
+        // Parse gradle/libs.versions.toml
+        const versionCatalogPath = path.join(projectDir, "gradle", "libs.versions.toml");
+        const catalogContent = yield* readFileOptional(versionCatalogPath);
+        if (Option.isSome(catalogContent)) {
+            const catalogDeps = parseVersionCatalog(catalogContent.value, versionCatalogPath);
+            allPackages.push(...catalogDeps);
+        }
+        return deduplicatePackages(allPackages);
+    }, Effect.annotateLogs({ detector: "maven" }), Effect.withSpan("detect.maven")),
+};
+/**
+ * Maven package reader.
+ *
+ * Reads `META-INF/axm.json` from local JAR files in `~/.m2/repository/`
+ * or Gradle cache `~/.gradle/caches/modules-2/files-2.1/`.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const mavenReader = {
+    type: mavenType,
+    read: Effect.fn("read.maven")(function* (pkg) {
+        const path = yield* Path.Path;
+        const home = os.homedir();
+        const groupId = pkg.purl.namespace ?? "";
+        const artifactId = pkg.purl.name;
+        const version = pkg.purl.version ?? "0.0.0";
+        // Convert groupId dots to path separators for Maven repo
+        const groupIdPath = groupId.replace(/\./g, "/");
+        // Try Maven local repository first
+        const m2Dir = path.join(home, ".m2", "repository", groupIdPath, artifactId, version);
+        const m2Jars = yield* findJarsInDir(m2Dir);
+        for (const jarName of m2Jars) {
+            const jarPath = path.join(m2Dir, jarName);
+            const axmContent = yield* readZipEntry(jarPath, "META-INF/axm.json");
+            if (Option.isSome(axmContent)) {
+                const parsed = yield* parseJsonOptional(axmContent.value, `${groupId}:${artifactId}@${version}/META-INF/axm.json`);
+                if (Option.isSome(parsed)) {
+                    const metaResult = decodeAxmMeta(parsed.value);
+                    if (Result.isFailure(metaResult)) {
+                        yield* Effect.logWarning(`Invalid axm metadata in ${groupId}:${artifactId}@${version}: schema validation failed`);
+                        return Option.none();
+                    }
+                    return Option.some(metaResult.success.recommendedExtensions);
+                }
+            }
+        }
+        // Try Gradle cache
+        const gradleCacheDir = path.join(home, ".gradle", "caches", "modules-2", "files-2.1", groupId, artifactId, version);
+        // Gradle cache has hash subdirectories
+        const gradleHashDirs = yield* listDirectory(gradleCacheDir);
+        if (Option.isSome(gradleHashDirs)) {
+            for (const hashDir of gradleHashDirs.value) {
+                const hashDirPath = path.join(gradleCacheDir, hashDir);
+                const jars = yield* findJarsInDir(hashDirPath);
+                for (const jarName of jars) {
+                    const jarPath = path.join(hashDirPath, jarName);
+                    const axmContent = yield* readZipEntry(jarPath, "META-INF/axm.json");
+                    if (Option.isSome(axmContent)) {
+                        const parsed = yield* parseJsonOptional(axmContent.value, `${groupId}:${artifactId}@${version}/META-INF/axm.json`);
+                        if (Option.isSome(parsed)) {
+                            const metaResult = decodeAxmMeta(parsed.value);
+                            if (Result.isFailure(metaResult)) {
+                                yield* Effect.logWarning(`Invalid axm metadata in ${groupId}:${artifactId}@${version}: schema validation failed`);
+                                return Option.none();
+                            }
+                            return Option.some(metaResult.success.recommendedExtensions);
+                        }
+                    }
+                }
+            }
+        }
+        return Option.none();
+    }, Effect.annotateLogs({ reader: "maven" }), Effect.withSpan("read.maven")),
+};
+//# sourceMappingURL=maven.js.map