@pleaseai/ask 0.1.0 → 0.1.3

package/dist/migrate-legacy.js.map

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

package/dist/registry.d.ts

@@ -0,0 +1,71 @@
+import type { RegistryEntry, RegistryStrategy } from '@pleaseai/registry-schema';
+export type { ExpandInput, RegistryAlias, RegistryEntry, RegistryStrategy } from '@pleaseai/registry-schema';
+export { expandStrategies } from '@pleaseai/registry-schema';
+/**
+ * Parse ecosystem prefix from spec.
+ * "npm:next@canary" -> { ecosystem: "npm", spec: "next@canary" }
+ * "next@canary" -> { ecosystem: undefined, spec: "next@canary" }
+ */
+export declare function parseEcosystem(input: string): {
+    ecosystem: string | undefined;
+    spec: string;
+};
+/**
+ * Parsed identifier passed to `ask docs add`.
+ *
+ * Three shapes are supported:
+ *   - `owner/repo[@ref]`        → github fast-path (no registry lookup)
+ *   - `ecosystem:name[@version]` → registry lookup with explicit ecosystem
+ *   - `name[@version]`          → registry lookup with auto-detected ecosystem
+ */
+export type ParsedDocSpec = {
+    kind: 'github';
+    owner: string;
+    repo: string;
+    ref?: string;
+} | {
+    kind: 'ecosystem';
+    ecosystem: string;
+    name: string;
+    version: string;
+} | {
+    kind: 'name';
+    name: string;
+    version: string;
+};
+/**
+ * Parse a `docs add` identifier into a discriminated union.
+ *
+ * Disambiguation rules (checked in order):
+ *   1. Contains `/` and no `:` → github (`owner/repo[@ref]`).
+ *      Exactly one slash is required; more is an error. Empty owner or repo
+ *      is also an error.
+ *   2. Contains `:` (with non-empty prefix) → ecosystem (`prefix:name[@version]`).
+ *   3. Otherwise → bare name (`name[@version]`).
+ *
+ * @throws Error when input is empty or has malformed `owner/repo` shape.
+ */
+export declare function parseDocSpec(input: string): ParsedDocSpec;
+/**
+ * Fetch registry entry from the registry API.
+ *
+ * Accepts either `(owner, repo)` for direct lookup or `(ecosystem, name)`
+ * for alias-based lookup — the API handles both patterns via catch-all slug.
+ */
+export declare function fetchRegistryEntry(first: string, second: string): Promise<RegistryEntry | null>;
+/**
+ * Pick the highest-priority strategy from a list, preserving the original
+ * order for ties (stable sort).
+ */
+export declare function selectBestStrategy(strategies: RegistryStrategy[]): RegistryStrategy;
+/**
+ * Resolve source config from registry.
+ * Returns the highest-priority strategy from the registry entry.
+ */
+export declare function resolveFromRegistry(input: string, projectDir: string): Promise<{
+    ecosystem: string;
+    name: string;
+    version: string;
+    strategy: RegistryStrategy;
+} | null>;
+//# sourceMappingURL=registry.d.ts.map

package/dist/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAA;AAMhF,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAA;AAC5G,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAA;AAI5D;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG;IAAE,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAS7F;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,aAAa,GACnB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,GAC7D;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACvE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAA;AAarD;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa,CAgDzD;AA4BD;;;;;GAKG;AACH,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAe/B;AAgBD;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,gBAAgB,EAAE,GAAG,gBAAgB,CAcnF;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,gBAAgB,CAAA;CAAE,GAAG,IAAI,CAAC,CAwClG"}

package/dist/registry.js

@@ -0,0 +1,201 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { expandStrategies } from '@pleaseai/registry-schema';
+import { consola } from 'consola';
+export { expandStrategies } from '@pleaseai/registry-schema';
+const REGISTRY_BASE_URL = 'https://ask-registry.pages.dev';
+/**
+ * Parse ecosystem prefix from spec.
+ * "npm:next@canary" -> { ecosystem: "npm", spec: "next@canary" }
+ * "next@canary" -> { ecosystem: undefined, spec: "next@canary" }
+ */
+export function parseEcosystem(input) {
+    const colonIdx = input.indexOf(':');
+    if (colonIdx > 0 && !input.includes('/')) {
+        return {
+            ecosystem: input.substring(0, colonIdx),
+            spec: input.substring(colonIdx + 1),
+        };
+    }
+    return { ecosystem: undefined, spec: input };
+}
+function splitNameVersion(spec) {
+    const lastAt = spec.lastIndexOf('@');
+    if (lastAt > 0) {
+        return {
+            name: spec.substring(0, lastAt),
+            version: spec.substring(lastAt + 1),
+        };
+    }
+    return { name: spec, version: 'latest' };
+}
+/**
+ * Parse a `docs add` identifier into a discriminated union.
+ *
+ * Disambiguation rules (checked in order):
+ *   1. Contains `/` and no `:` → github (`owner/repo[@ref]`).
+ *      Exactly one slash is required; more is an error. Empty owner or repo
+ *      is also an error.
+ *   2. Contains `:` (with non-empty prefix) → ecosystem (`prefix:name[@version]`).
+ *   3. Otherwise → bare name (`name[@version]`).
+ *
+ * @throws Error when input is empty or has malformed `owner/repo` shape.
+ */
+export function parseDocSpec(input) {
+    if (!input) {
+        throw new Error('docs spec is empty — expected `owner/repo`, `ecosystem:name`, or `name`');
+    }
+    // 1. github shape: owner/repo[@ref]
+    // Strict: must contain `/` AND no `:`. The `:` exclusion prevents
+    // scoped ecosystem specs (e.g. `npm:@scope/pkg@1.0`) from being
+    // mis-parsed as github — they contain a slash but the colon prefix
+    // means they belong to the ecosystem branch.
+    if (input.includes('/') && !input.includes(':')) {
+        const parts = input.split('/');
+        if (parts.length !== 2) {
+            throw new Error(`invalid docs spec '${input}': github shorthand must contain exactly one slash (owner/repo)`);
+        }
+        const [owner, repoAndRef] = parts;
+        if (!owner) {
+            throw new Error(`invalid docs spec '${input}': owner segment is empty`);
+        }
+        if (!repoAndRef) {
+            throw new Error(`invalid docs spec '${input}': repo segment is empty`);
+        }
+        const atIdx = repoAndRef.indexOf('@');
+        if (atIdx >= 0) {
+            const repo = repoAndRef.substring(0, atIdx);
+            const ref = repoAndRef.substring(atIdx + 1);
+            if (!repo) {
+                throw new Error(`invalid docs spec '${input}': repo segment is empty`);
+            }
+            return ref ? { kind: 'github', owner, repo, ref } : { kind: 'github', owner, repo };
+        }
+        return { kind: 'github', owner, repo: repoAndRef };
+    }
+    // 2. ecosystem shape: prefix:name[@version]
+    const colonIdx = input.indexOf(':');
+    if (colonIdx > 0) {
+        const ecosystem = input.substring(0, colonIdx);
+        const rest = input.substring(colonIdx + 1);
+        const { name, version } = splitNameVersion(rest);
+        return { kind: 'ecosystem', ecosystem, name, version };
+    }
+    // 3. bare name: name[@version]
+    const { name, version } = splitNameVersion(input);
+    return { kind: 'name', name, version };
+}
+/**
+ * Detect ecosystem from project files in cwd.
+ */
+function detectEcosystem(projectDir) {
+    const checks = [
+        ['package.json', 'npm'],
+        ['pubspec.yaml', 'pub'],
+        ['pyproject.toml', 'pypi'],
+        ['requirements.txt', 'pypi'],
+        ['go.mod', 'go'],
+        ['Cargo.toml', 'crates'],
+        ['mix.exs', 'hex'],
+        ['pom.xml', 'maven'],
+        ['build.gradle', 'maven'],
+        ['build.gradle.kts', 'maven'],
+    ];
+    for (const [file, ecosystem] of checks) {
+        if (fs.existsSync(path.join(projectDir, file))) {
+            return ecosystem;
+        }
+    }
+    return 'npm';
+}
+/**
+ * Fetch registry entry from the registry API.
+ *
+ * Accepts either `(owner, repo)` for direct lookup or `(ecosystem, name)`
+ * for alias-based lookup — the API handles both patterns via catch-all slug.
+ */
+export async function fetchRegistryEntry(first, second) {
+    const url = `${REGISTRY_BASE_URL}/api/registry/${first}/${second}`;
+    try {
+        const response = await fetch(url);
+        if (!response.ok) {
+            return null;
+        }
+        const data = await response.json();
+        return data;
+    }
+    catch (error) {
+        consola.debug(`Registry lookup failed for ${first}/${second}:`, error);
+        return null;
+    }
+}
+/**
+ * Source type priority for selecting the best strategy from a registry entry.
+ *
+ * Lower number = higher priority. Based on Nuxt UI eval results (2026-04-07):
+ * GitHub docs achieved 100% pass rate at lowest cost, while llms.txt scored
+ * below baseline. See evals/nuxt-ui/README.md for full methodology.
+ */
+const SOURCE_PRIORITY = {
+    'github': 0,
+    'npm': 1,
+    'web': 2,
+    'llms-txt': 3,
+};
+/**
+ * Pick the highest-priority strategy from a list, preserving the original
+ * order for ties (stable sort).
+ */
+export function selectBestStrategy(strategies) {
+    if (strategies.length === 0) {
+        throw new Error('selectBestStrategy requires at least one strategy');
+    }
+    // Stable sort by priority — lower priority value wins
+    const indexed = Array.from(strategies, (s, i) => ({ s, i }));
+    indexed.sort((a, b) => {
+        const pa = SOURCE_PRIORITY[a.s.source] ?? 99;
+        const pb = SOURCE_PRIORITY[b.s.source] ?? 99;
+        if (pa !== pb)
+            return pa - pb;
+        return a.i - b.i;
+    });
+    return indexed[0].s;
+}
+/**
+ * Resolve source config from registry.
+ * Returns the highest-priority strategy from the registry entry.
+ */
+export async function resolveFromRegistry(input, projectDir) {
+    const { ecosystem: explicitEcosystem, spec } = parseEcosystem(input);
+    const lastAt = spec.lastIndexOf('@');
+    const name = lastAt > 0 ? spec.substring(0, lastAt) : spec;
+    const version = lastAt > 0 ? spec.substring(lastAt + 1) : 'latest';
+    const ecosystem = explicitEcosystem ?? detectEcosystem(projectDir);
+    consola.info(`Looking up ${ecosystem}:${name} in registry...`);
+    const entry = await fetchRegistryEntry(ecosystem, name);
+    if (!entry) {
+        return null;
+    }
+    let strategies;
+    try {
+        strategies = expandStrategies({
+            repo: entry.repo,
+            docsPath: entry.docsPath,
+            strategies: entry.strategies,
+        });
+    }
+    catch (error) {
+        consola.warn(`Registry entry for ${name} is misconfigured: ${error.message}`);
+        return null;
+    }
+    consola.success(`Found ${entry.name} in registry: ${entry.description}`);
+    const strategy = selectBestStrategy(strategies);
+    consola.info(`Using source: ${strategy.source}`);
+    return {
+        ecosystem,
+        name: entry.name,
+        version,
+        strategy,
+    };
+}
+//# sourceMappingURL=registry.js.map

package/dist/registry.js.map

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

package/dist/resolvers/index.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Result of resolving an ecosystem package to a GitHub repository.
+ * Always handed off to the github source for download.
+ */
+export interface ResolveResult {
+    /** GitHub `owner/repo` */
+    repo: string;
+    /** Primary git ref to try first (tag or branch) */
+    ref: string;
+    /**
+     * Fallback refs to try if the primary ref doesn't exist.
+     * Implements FR-5: try `v{version}`, then `{version}`, then default branch.
+     */
+    fallbackRefs?: string[];
+    /** Resolved version string (e.g. `4.17.21`) */
+    resolvedVersion: string;
+}
+/**
+ * Ecosystem resolver: maps a package name + version to a GitHub repository.
+ *
+ * Resolvers are orthogonal to sources — they only perform metadata lookups
+ * and never download documentation themselves. The resolved `repo` + `ref`
+ * are handed to the `github` source for the actual download.
+ */
+export interface EcosystemResolver {
+    resolve: (name: string, version: string) => Promise<ResolveResult>;
+}
+/**
+ * Return the resolver for the given ecosystem, or `null` if unsupported.
+ */
+export declare function getResolver(ecosystem: string): EcosystemResolver | null;
+//# sourceMappingURL=index.d.ts.map

package/dist/resolvers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/resolvers/index.ts"],"names":[],"mappings":"AAKA;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,mDAAmD;IACnD,GAAG,EAAE,MAAM,CAAA;IACX;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;IACvB,+CAA+C;IAC/C,eAAe,EAAE,MAAM,CAAA;CACxB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,aAAa,CAAC,CAAA;CACnE;AAWD;;GAEG;AACH,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI,CAEvE"}

package/dist/resolvers/index.js

@@ -0,0 +1,17 @@
+import { MavenResolver } from './maven.js';
+import { NpmResolver } from './npm.js';
+import { PubResolver } from './pub.js';
+import { PypiResolver } from './pypi.js';
+const resolvers = {
+    maven: new MavenResolver(),
+    npm: new NpmResolver(),
+    pypi: new PypiResolver(),
+    pub: new PubResolver(),
+};
+/**
+ * Return the resolver for the given ecosystem, or `null` if unsupported.
+ */
+export function getResolver(ecosystem) {
+    return resolvers[ecosystem] ?? null;
+}
+//# sourceMappingURL=index.js.map

package/dist/resolvers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/resolvers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAA;AACtC,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAA;AACtC,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAA;AAiCxC,MAAM,SAAS,GAAkD;IAC/D,KAAK,EAAE,IAAI,aAAa,EAAE;IAC1B,GAAG,EAAE,IAAI,WAAW,EAAE;IACtB,IAAI,EAAE,IAAI,YAAY,EAAE;IACxB,GAAG,EAAE,IAAI,WAAW,EAAE;CACvB,CAAA;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,SAAiB;IAC3C,OAAQ,SAA+C,CAAC,SAAS,CAAC,IAAI,IAAI,CAAA;AAC5E,CAAC"}

package/dist/resolvers/maven.d.ts

@@ -0,0 +1,33 @@
+import type { EcosystemResolver, ResolveResult } from './index.js';
+/**
+ * Resolve a Maven Central package to a GitHub repo + git tag.
+ *
+ * 1. Fetch latest version from Maven Central Search API
+ * 2. For explicit versions, use the version directly
+ * 3. Extract GitHub repo from Search API scmUrl, or fallback to POM XML
+ * 4. Return `v{version}` as the git ref with `{version}` fallback
+ */
+export declare class MavenResolver implements EcosystemResolver {
+    resolve(name: string, version: string): Promise<ResolveResult>;
+    /**
+     * Resolve version via Search API. Falls back to POM-based resolution
+     * when the Search API is unavailable.
+     *
+     * For explicit versions, the version is used as-is (no Search API needed
+     * for validation — the POM fetch will fail if it doesn't exist).
+     */
+    private resolveVersion;
+    /**
+     * Fetch version and optional scmUrl from Maven Central Search API.
+     */
+    private fetchSearchApi;
+    /**
+     * Resolve latest version from maven-metadata.xml when Search API is unavailable.
+     */
+    private resolveVersionFromMetadata;
+    /**
+     * Find GitHub repo URL from POM XML. Priority: <scm><url> → <url>
+     */
+    private findRepoFromPom;
+}
+//# sourceMappingURL=maven.d.ts.map

package/dist/resolvers/maven.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"maven.d.ts","sourceRoot":"","sources":["../../src/resolvers/maven.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAqFlE;;;;;;;GAOG;AACH,qBAAa,aAAc,YAAW,iBAAiB;IAC/C,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAsCpE;;;;;;OAMG;YACW,cAAc;IAuB5B;;OAEG;YACW,cAAc;IA0C5B;;OAEG;YACW,0BAA0B;IAyBxC;;OAEG;YACW,eAAe;CAgB9B"}

package/dist/resolvers/maven.js

@@ -0,0 +1,187 @@
+import { consola } from 'consola';
+import { parseRepoUrl } from './utils.js';
+const RE_SCM_URL = /<scm>[\s\S]*?<url>([^<]+)<\/url>/;
+const RE_PROJECT_URL = /<project[^>]*>[\s\S]*?<url>([^<]+)<\/url>/;
+/**
+ * Parse `groupId:artifactId` from the combined name string.
+ * Splits at the last colon — groupId may contain dots but never colons,
+ * while artifactId never contains colons.
+ */
+function parseMavenCoordinate(name) {
+    const lastColon = name.lastIndexOf(':');
+    if (lastColon <= 0 || lastColon === name.length - 1) {
+        throw new Error(`Invalid Maven coordinate '${name}': expected 'groupId:artifactId' format (e.g. 'com.google.guava:guava')`);
+    }
+    return {
+        groupId: name.substring(0, lastColon),
+        artifactId: name.substring(lastColon + 1),
+    };
+}
+const RE_DOT = /\./g;
+const RE_RELEASE = /<release>([^<]+)<\/release>/;
+const RE_LATEST = /<latest>([^<]+)<\/latest>/;
+/**
+ * Build the Maven Central Repository POM URL.
+ * Converts groupId dots to path separators.
+ */
+function buildPomUrl(groupId, artifactId, version) {
+    const groupPath = groupId.replace(RE_DOT, '/');
+    return `https://repo1.maven.org/maven2/${groupPath}/${artifactId}/${version}/${artifactId}-${version}.pom`;
+}
+/**
+ * Extract a GitHub repository URL from POM XML content.
+ * Priority: <scm><url> → top-level <url>
+ */
+function extractRepoFromPom(pomXml) {
+    // Try <scm><url> first
+    const scmMatch = RE_SCM_URL.exec(pomXml);
+    if (scmMatch) {
+        const repo = parseRepoUrl(scmMatch[1].trim());
+        if (repo)
+            return repo;
+    }
+    // Fall back to top-level <url>
+    const urlMatch = RE_PROJECT_URL.exec(pomXml);
+    if (urlMatch) {
+        const repo = parseRepoUrl(urlMatch[1].trim());
+        if (repo)
+            return repo;
+    }
+    return null;
+}
+/**
+ * Resolve a Maven Central package to a GitHub repo + git tag.
+ *
+ * 1. Fetch latest version from Maven Central Search API
+ * 2. For explicit versions, use the version directly
+ * 3. Extract GitHub repo from Search API scmUrl, or fallback to POM XML
+ * 4. Return `v{version}` as the git ref with `{version}` fallback
+ */
+export class MavenResolver {
+    async resolve(name, version) {
+        const { groupId, artifactId } = parseMavenCoordinate(name);
+        // Step 1: Resolve version + optional scmUrl via Search API
+        const versionResult = await this.resolveVersion(groupId, artifactId, version);
+        const resolvedVersion = versionResult.version;
+        // Step 2: Find GitHub repo — priority: (1) Search API scmUrl, (2) POM <scm><url>, (3) POM <url>
+        let repo = null;
+        // (1) Check Search API scmUrl first
+        if (versionResult.scmUrl) {
+            repo = parseRepoUrl(versionResult.scmUrl);
+        }
+        // (2, 3) Fall back to POM XML
+        if (!repo) {
+            repo = await this.findRepoFromPom(groupId, artifactId, resolvedVersion);
+        }
+        if (!repo) {
+            throw new Error(`Cannot resolve GitHub repository for Maven package '${groupId}:${artifactId}'. `
+                + `Neither the Search API nor the POM contains a GitHub URL. `
+                + `Use 'owner/repo' format instead: ask docs add owner/repo`);
+        }
+        consola.debug(`maven: ${groupId}:${artifactId}@${version} → ${repo}@${resolvedVersion}`);
+        return {
+            repo,
+            ref: `v${resolvedVersion}`,
+            fallbackRefs: [resolvedVersion],
+            resolvedVersion,
+        };
+    }
+    /**
+     * Resolve version via Search API. Falls back to POM-based resolution
+     * when the Search API is unavailable.
+     *
+     * For explicit versions, the version is used as-is (no Search API needed
+     * for validation — the POM fetch will fail if it doesn't exist).
+     */
+    async resolveVersion(groupId, artifactId, version) {
+        // Explicit versions can skip Search API for version resolution
+        if (version !== 'latest') {
+            // Still try Search API for scmUrl, but don't fail if unavailable
+            try {
+                return await this.fetchSearchApi(groupId, artifactId, version);
+            }
+            catch {
+                return { version };
+            }
+        }
+        // For 'latest', try Search API first
+        try {
+            return await this.fetchSearchApi(groupId, artifactId, version);
+        }
+        catch {
+            // Search API unavailable — try maven-metadata.xml for latest version
+            consola.debug(`maven: Search API unavailable, trying maven-metadata.xml`);
+            return this.resolveVersionFromMetadata(groupId, artifactId);
+        }
+    }
+    /**
+     * Fetch version and optional scmUrl from Maven Central Search API.
+     */
+    async fetchSearchApi(groupId, artifactId, version) {
+        const isLatest = version === 'latest';
+        const query = isLatest
+            ? `q=g:${encodeURIComponent(groupId)}+AND+a:${encodeURIComponent(artifactId)}&rows=1&wt=json`
+            : `q=g:${encodeURIComponent(groupId)}+AND+a:${encodeURIComponent(artifactId)}+AND+v:${encodeURIComponent(version)}&rows=1&wt=json&core=gav`;
+        const url = `https://search.maven.org/solrsearch/select?${query}`;
+        const response = await fetch(url);
+        if (!response.ok) {
+            throw new Error(`Maven Central Search API returned ${response.status} for ${groupId}:${artifactId}`);
+        }
+        const data = await response.json();
+        if (data.response.numFound === 0) {
+            throw new Error(`Maven package '${groupId}:${artifactId}'${isLatest ? '' : `@${version}`} not found on Maven Central`);
+        }
+        const doc = data.response.docs[0];
+        // Try to get scmUrl from artifact-level search (default core, not GAV)
+        let scmUrl;
+        try {
+            const extUrl = `https://search.maven.org/solrsearch/select?q=g:${encodeURIComponent(groupId)}+AND+a:${encodeURIComponent(artifactId)}&rows=1&wt=json`;
+            const extResponse = await fetch(extUrl);
+            if (extResponse.ok) {
+                const extData = await extResponse.json();
+                scmUrl = extData.response.docs[0]?.['scm.url'];
+            }
+        }
+        catch {
+            // Non-critical — will fall back to POM
+        }
+        return { version: doc.v, scmUrl };
+    }
+    /**
+     * Resolve latest version from maven-metadata.xml when Search API is unavailable.
+     */
+    async resolveVersionFromMetadata(groupId, artifactId) {
+        const groupPath = groupId.replace(RE_DOT, '/');
+        const url = `https://repo1.maven.org/maven2/${groupPath}/${artifactId}/maven-metadata.xml`;
+        const response = await fetch(url);
+        if (!response.ok) {
+            throw new Error(`Cannot resolve Maven package '${groupId}:${artifactId}': `
+                + `Search API unavailable and maven-metadata.xml returned ${response.status}`);
+        }
+        const xml = await response.text();
+        const versionMatch = RE_RELEASE.exec(xml) ?? RE_LATEST.exec(xml);
+        if (!versionMatch) {
+            throw new Error(`Cannot resolve latest version for Maven package '${groupId}:${artifactId}': `
+                + `no <release> or <latest> tag in maven-metadata.xml`);
+        }
+        return { version: versionMatch[1] };
+    }
+    /**
+     * Find GitHub repo URL from POM XML. Priority: <scm><url> → <url>
+     */
+    async findRepoFromPom(groupId, artifactId, version) {
+        const pomUrl = buildPomUrl(groupId, artifactId, version);
+        try {
+            const response = await fetch(pomUrl);
+            if (response.ok) {
+                const pomXml = await response.text();
+                return extractRepoFromPom(pomXml);
+            }
+        }
+        catch {
+            consola.debug(`maven: POM fetch failed for ${groupId}:${artifactId}@${version}`);
+        }
+        return null;
+    }
+}
+//# sourceMappingURL=maven.js.map

package/dist/resolvers/maven.js.map

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

package/dist/resolvers/npm.d.ts

@@ -0,0 +1,13 @@
+import type { EcosystemResolver, ResolveResult } from './index.js';
+/**
+ * Resolve an npm package to a GitHub repo + git tag.
+ *
+ * 1. Fetch `https://registry.npmjs.org/<name>`
+ * 2. Resolve version: dist-tag → exact, semver range → best match, exact → passthrough
+ * 3. Extract `repository.url` → `owner/repo`
+ * 4. Return `v{version}` as the git ref
+ */
+export declare class NpmResolver implements EcosystemResolver {
+    resolve(name: string, version: string): Promise<ResolveResult>;
+}
+//# sourceMappingURL=npm.d.ts.map

package/dist/resolvers/npm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"npm.d.ts","sourceRoot":"","sources":["../../src/resolvers/npm.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAgBlE;;;;;;;GAOG;AACH,qBAAa,WAAY,YAAW,iBAAiB;IAC7C,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;CAkErE"}