codesift-mcp 0.3.0 → 0.5.0

package/dist/tools/nextjs-framework-audit-tools.js

@@ -0,0 +1,394 @@
+/**
+ * Next.js framework audit meta-tool (T11).
+ *
+ * Dispatches to all 9 sub-tools (component classifier, route map, metadata
+ * audit, security audit, API contract, boundary analyzer, link integrity,
+ * data flow, middleware coverage), aggregates results into a weighted
+ * overall score, and returns a unified `FrameworkAuditResult`.
+ */
+import { activateGlobalCache, deactivateGlobalCache } from "../utils/nextjs-audit-cache.js";
+import { analyzeNextjsComponents } from "./nextjs-component-tools.js";
+import { nextjsRouteMap } from "./nextjs-route-tools.js";
+import { nextjsMetadataAudit } from "./nextjs-metadata-tools.js";
+import { nextjsAuditServerActions } from "./nextjs-security-tools.js";
+import { nextjsApiContract } from "./nextjs-api-contract-tools.js";
+import { nextjsBoundaryAnalyzer } from "./nextjs-boundary-tools.js";
+import { nextjsLinkIntegrity } from "./nextjs-link-tools.js";
+import { nextjsDataFlow } from "./nextjs-data-flow-tools.js";
+import { nextjsMiddlewareCoverage } from "./nextjs-middleware-coverage-tools.js";
+// ---------------------------------------------------------------------------
+// Aggregate scoring (Task 47)
+// ---------------------------------------------------------------------------
+const DIMENSION_WEIGHTS = {
+    metadata: 15,
+    security: 25,
+    components: 15,
+    routes: 10,
+    api_contract: 10,
+    boundary: 10,
+    links: 5,
+    data_flow: 5,
+    middleware_coverage: 5,
+};
+function gradeFor(score) {
+    if (score >= 90)
+        return "excellent";
+    if (score >= 70)
+        return "good";
+    if (score >= 40)
+        return "needs_work";
+    return "poor";
+}
+/** Normalize a sub-tool result to a 0-100 score. */
+function normalizeScore(dim, result) {
+    if (!result || typeof result !== "object")
+        return null;
+    const r = result;
+    switch (dim) {
+        case "metadata": {
+            const counts = r.counts;
+            const total = r.total_pages ?? 0;
+            if (!counts || total === 0)
+                return 0;
+            // Weighted by grade
+            return Math.round((counts.excellent * 100 + counts.good * 75 + counts.needs_work * 50 + counts.poor * 0) / total);
+        }
+        case "security": {
+            const actions = r.actions;
+            if (!actions || actions.length === 0)
+                return 100; // No actions = no risk
+            const avg = actions.reduce((sum, a) => sum + a.score, 0) / actions.length;
+            return Math.round(avg);
+        }
+        case "components": {
+            const counts = r.counts;
+            if (!counts || counts.total === 0)
+                return 100;
+            // Penalize unnecessary use client
+            const penalty = (counts.unnecessary_use_client / counts.total) * 100;
+            return Math.max(0, Math.round(100 - penalty));
+        }
+        case "routes": {
+            const conflicts = r.conflicts;
+            const routes = r.routes;
+            if (!routes)
+                return 0;
+            // Penalize conflicts
+            return conflicts && conflicts.length > 0 ? 70 : 100;
+        }
+        case "api_contract": {
+            return r.completeness_score ?? 0;
+        }
+        case "boundary": {
+            // No simple score — use largest_offender presence as a hint
+            const entries = r.entries;
+            if (!entries || entries.length === 0)
+                return 100;
+            // More client components = lower score
+            const count = entries.length;
+            return Math.max(0, Math.round(100 - count * 2));
+        }
+        case "links": {
+            const total = r.total_refs;
+            const resolved = r.resolved_count;
+            const broken = r.broken_count;
+            if (!total || total === 0)
+                return 100;
+            return Math.round(((resolved ?? 0) / (total - (broken ?? 0) || 1)) * 100);
+        }
+        case "data_flow": {
+            const totalPages = r.total_pages;
+            const totalWaterfalls = r.total_waterfalls;
+            if (!totalPages || totalPages === 0)
+                return 100;
+            const ratio = (totalWaterfalls ?? 0) / totalPages;
+            return Math.max(0, Math.round(100 - ratio * 50));
+        }
+        case "middleware_coverage": {
+            const warnings = r.warnings;
+            if (!warnings)
+                return 100;
+            const high = warnings.filter((w) => w.severity === "high").length;
+            return Math.max(0, 100 - high * 25);
+        }
+        default:
+            return null;
+    }
+}
+export function aggregateScores(sub_results) {
+    const dimensions = {};
+    let totalWeight = 0;
+    let weightedSum = 0;
+    const top_issues = [];
+    for (const dim of Object.keys(sub_results)) {
+        const result = sub_results[dim];
+        if (result === undefined)
+            continue;
+        const score = normalizeScore(dim, result);
+        if (score === null)
+            continue;
+        const weight = DIMENSION_WEIGHTS[dim];
+        const contribution = (score * weight) / 100;
+        dimensions[dim] = { score, weight, contribution };
+        totalWeight += weight;
+        weightedSum += contribution;
+        if (score < 70) {
+            top_issues.push(`${dim}: ${score}/100`);
+        }
+    }
+    const overall_score = totalWeight > 0 ? Math.round((weightedSum / totalWeight) * 100) : 0;
+    return {
+        overall_score,
+        grade: gradeFor(overall_score),
+        dimensions,
+        top_issues: top_issues.slice(0, 10),
+    };
+}
+// ---------------------------------------------------------------------------
+// Priority findings extractor (A2)
+// ---------------------------------------------------------------------------
+const SEVERITY_WEIGHT = {
+    high: 3,
+    medium: 2,
+    low: 1,
+};
+export function extractPriorityFindings(sub_results) {
+    const findings = [];
+    // metadata: pages with score < 70
+    const meta = sub_results.metadata;
+    if (meta?.scores) {
+        for (const s of meta.scores) {
+            if (s.score >= 70)
+                continue;
+            const severity = s.score < 40 ? "high" : "medium";
+            findings.push({
+                severity,
+                tool: "metadata",
+                file: s.file_path,
+                issue: `SEO metadata incomplete (${s.score}/100, grade: ${s.grade})`,
+                suggested_fix: s.missing && s.missing.length > 0 ? `Add: ${s.missing.join(", ")}` : undefined,
+                weight: SEVERITY_WEIGHT[severity],
+            });
+        }
+    }
+    // security: server actions with score < 70
+    const sec = sub_results.security;
+    if (sec?.actions) {
+        for (const a of sec.actions) {
+            if (a.score >= 70)
+                continue;
+            const severity = a.score < 40 ? "high" : "medium";
+            findings.push({
+                severity,
+                tool: "security",
+                file: a.file,
+                issue: `Server action "${a.name}" security score ${a.score}/100 (${a.grade})`,
+                suggested_fix: a.top_missing && a.top_missing.length > 0 ? `Missing: ${a.top_missing.join(", ")}` : undefined,
+                weight: SEVERITY_WEIGHT[severity],
+            });
+        }
+    }
+    // components: client_inferred or unnecessary_use_client
+    const comp = sub_results.components;
+    if (comp?.files) {
+        for (const f of comp.files) {
+            if (f.classification === "client_inferred") {
+                findings.push({
+                    severity: "medium",
+                    tool: "components",
+                    file: f.path,
+                    line: f.signals?.signal_locations?.[0]?.line,
+                    issue: "Component uses client-only APIs without 'use client' directive",
+                    suggested_fix: f.suggested_fix,
+                    weight: SEVERITY_WEIGHT.medium,
+                });
+            }
+            else if (f.violations.includes("unnecessary_use_client")) {
+                findings.push({
+                    severity: "low",
+                    tool: "components",
+                    file: f.path,
+                    issue: "Unnecessary 'use client' directive",
+                    suggested_fix: f.suggested_fix,
+                    weight: SEVERITY_WEIGHT.low,
+                });
+            }
+        }
+    }
+    // links: broken internal links
+    const links = sub_results.links;
+    if (links?.broken) {
+        for (const b of links.broken) {
+            findings.push({
+                severity: "high",
+                tool: "links",
+                file: b.file,
+                line: b.line,
+                issue: `Broken internal link: ${b.href}`,
+                weight: SEVERITY_WEIGHT.high,
+            });
+        }
+    }
+    // data_flow: pages with waterfalls
+    const df = sub_results.data_flow;
+    if (df?.entries) {
+        for (const e of df.entries) {
+            if (e.waterfall_count === 0)
+                continue;
+            findings.push({
+                severity: "medium",
+                tool: "data_flow",
+                file: e.file_path,
+                issue: `Fetch waterfall detected (${e.waterfall_count} sequential awaits)`,
+                suggested_fix: "Parallelize with Promise.all or use dependent data in single request",
+                weight: SEVERITY_WEIGHT.medium,
+            });
+        }
+    }
+    // middleware_coverage: unprotected admin routes
+    const mw = sub_results.middleware_coverage;
+    if (mw?.warnings) {
+        for (const w of mw.warnings) {
+            if (w.severity !== "high")
+                continue;
+            findings.push({
+                severity: "high",
+                tool: "middleware_coverage",
+                file: w.route,
+                issue: w.reason,
+                suggested_fix: "Add middleware matcher to protect this route",
+                weight: SEVERITY_WEIGHT.high,
+            });
+        }
+    }
+    // routes: hybrid conflicts
+    const routes = sub_results.routes;
+    if (routes?.conflicts) {
+        for (const c of routes.conflicts) {
+            findings.push({
+                severity: "high",
+                tool: "routes",
+                file: c.app,
+                issue: `Hybrid routing conflict at ${c.url_path} (also in ${c.pages})`,
+                suggested_fix: "Next.js prioritizes App Router; remove Pages Router entry or rename",
+                weight: SEVERITY_WEIGHT.high,
+            });
+        }
+    }
+    // api_contract: handlers with low completeness
+    const api = sub_results.api_contract;
+    if (api?.handlers) {
+        for (const h of api.handlers) {
+            if (h.completeness >= 0.5)
+                continue;
+            findings.push({
+                severity: "medium",
+                tool: "api_contract",
+                file: h.file,
+                issue: `${h.method} ${h.path} has incomplete contract (${Math.round(h.completeness * 100)}%)`,
+                suggested_fix: "Add Zod schema for body/query validation",
+                weight: SEVERITY_WEIGHT.medium,
+            });
+        }
+    }
+    // Sort by severity weight desc, then file for stable ordering
+    findings.sort((a, b) => b.weight - a.weight || a.file.localeCompare(b.file));
+    return findings;
+}
+// ---------------------------------------------------------------------------
+// Dispatcher (Task 46)
+// ---------------------------------------------------------------------------
+const ALL_DIMENSIONS = [
+    "components",
+    "routes",
+    "metadata",
+    "security",
+    "api_contract",
+    "boundary",
+    "links",
+    "data_flow",
+    "middleware_coverage",
+];
+const TOOL_DISPATCHERS = {
+    components: (repo, workspace) => analyzeNextjsComponents(repo, workspace ? { workspace } : undefined),
+    routes: (repo, workspace) => nextjsRouteMap(repo, workspace ? { workspace } : undefined),
+    metadata: (repo, workspace) => nextjsMetadataAudit(repo, workspace ? { workspace } : undefined),
+    security: (repo, workspace) => nextjsAuditServerActions(repo, workspace ? { workspace } : undefined),
+    api_contract: (repo, workspace) => nextjsApiContract(repo, workspace ? { workspace } : undefined),
+    boundary: (repo, workspace) => nextjsBoundaryAnalyzer(repo, workspace ? { workspace } : undefined),
+    links: (repo, workspace) => nextjsLinkIntegrity(repo, workspace ? { workspace } : undefined),
+    data_flow: (repo, workspace) => nextjsDataFlow(repo, workspace ? { workspace } : undefined),
+    middleware_coverage: (repo, workspace) => nextjsMiddlewareCoverage(repo, workspace ? { workspace } : undefined),
+};
+/** Convert a glob-like pattern to a RegExp for file path filtering. */
+function globToRegex(pattern) {
+    const escaped = pattern
+        .replace(/[.+?^${}()|[\]\\]/g, "\\$&")
+        .replace(/\*\*/g, "__DOUBLESTAR__")
+        .replace(/\*/g, "[^/]*")
+        .replace(/__DOUBLESTAR__/g, ".*");
+    return new RegExp(`^${escaped}$`);
+}
+export async function frameworkAudit(repo, options) {
+    if (process.env.CODESIFT_DISABLE_TOOLS?.includes("framework_audit")) {
+        throw new Error("framework_audit is disabled via CODESIFT_DISABLE_TOOLS");
+    }
+    const start = Date.now();
+    const cache = activateGlobalCache();
+    const sub_results = {};
+    const tool_errors = [];
+    const tools = options?.tools ?? ALL_DIMENSIONS;
+    try {
+        // Sequential invocation — sub-tools share the global cache for parseFile + walkDirectory.
+        for (const dim of tools) {
+            const dispatcher = TOOL_DISPATCHERS[dim];
+            if (!dispatcher)
+                continue;
+            try {
+                sub_results[dim] = await dispatcher(repo, options?.workspace);
+            }
+            catch (err) {
+                tool_errors.push({
+                    tool: dim,
+                    error: err instanceof Error ? err.message : String(err),
+                });
+            }
+        }
+    }
+    finally {
+        deactivateGlobalCache();
+    }
+    const duration_ms = Date.now() - start;
+    if (options?.mode === "priority") {
+        let allFindings = extractPriorityFindings(sub_results);
+        // Filter: min_severity
+        if (options.min_severity) {
+            const severityRank = { low: 1, medium: 2, high: 3 };
+            const minRank = severityRank[options.min_severity];
+            allFindings = allFindings.filter((f) => severityRank[f.severity] >= minRank);
+        }
+        // Filter: path_glob (simple substring + wildcard support)
+        if (options.path_glob) {
+            const pattern = options.path_glob;
+            const rx = globToRegex(pattern);
+            allFindings = allFindings.filter((f) => rx.test(f.file));
+        }
+        const limit = options.priority_limit ?? 20;
+        return {
+            mode: "priority",
+            findings: allFindings.slice(0, limit),
+            total_findings: allFindings.length,
+            tools_run: tools,
+            duration_ms,
+        };
+    }
+    const summary = aggregateScores(sub_results);
+    return {
+        summary,
+        sub_results,
+        tool_errors,
+        cache_size: cache.size(),
+        duration_ms,
+    };
+}
+//# sourceMappingURL=nextjs-framework-audit-tools.js.map

package/dist/tools/nextjs-framework-audit-tools.js.map

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

package/dist/tools/nextjs-link-tools.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Next.js link integrity checker (T5).
+ *
+ * Walks `app/**\/*.{tsx,jsx}` files for `<Link href>` JSX components and
+ * `router.push/.replace` calls, then cross-references each href against the
+ * route map (via `nextjsRouteMap`) to flag broken links. Template-literal
+ * hrefs are bucketed as "unresolved" rather than guessed.
+ */
+import { type LinkRef } from "../utils/nextjs.js";
+export type { LinkRef };
+export interface BrokenLink {
+    href: string;
+    file: string;
+    line: number;
+    kind: LinkRef["kind"];
+}
+export interface UnresolvedLink {
+    reason: "template_literal" | "non_literal";
+    file: string;
+    line: number;
+    raw: string;
+}
+export interface LinkIntegrityResult {
+    total_refs: number;
+    resolved_count: number;
+    broken_count: number;
+    unresolved_count: number;
+    broken: BrokenLink[];
+    unresolved: UnresolvedLink[];
+    workspaces_scanned: string[];
+    parse_failures: string[];
+    scan_errors: string[];
+    limitations: string[];
+}
+export interface NextjsLinkIntegrityOptions {
+    workspace?: string | undefined;
+    max_files?: number | undefined;
+}
+export declare function matchRoutePattern(href: string, routes: string[]): boolean;
+export declare function nextjsLinkIntegrity(repo: string, options?: NextjsLinkIntegrityOptions): Promise<LinkIntegrityResult>;
+//# sourceMappingURL=nextjs-link-tools.d.ts.map

package/dist/tools/nextjs-link-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nextjs-link-tools.d.ts","sourceRoot":"","sources":["../../src/tools/nextjs-link-tools.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,EAGL,KAAK,OAAO,EACb,MAAM,oBAAoB,CAAC;AAO5B,YAAY,EAAE,OAAO,EAAE,CAAC;AAMxB,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;CACvB;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,kBAAkB,GAAG,aAAa,CAAC;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,UAAU,EAAE,cAAc,EAAE,CAAC;IAC7B,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,0BAA0B;IACzC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAChC;AAuBD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CASzE;AAUD,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,0BAA0B,GACnC,OAAO,CAAC,mBAAmB,CAAC,CA4G9B"}

package/dist/tools/nextjs-link-tools.js

@@ -0,0 +1,157 @@
+/**
+ * Next.js link integrity checker (T5).
+ *
+ * Walks `app/**\/*.{tsx,jsx}` files for `<Link href>` JSX components and
+ * `router.push/.replace` calls, then cross-references each href against the
+ * route map (via `nextjsRouteMap`) to flag broken links. Template-literal
+ * hrefs are bucketed as "unresolved" rather than guessed.
+ */
+import { readFile } from "node:fs/promises";
+import { join, relative } from "node:path";
+import { discoverWorkspaces, extractLinkHrefs, } from "../utils/nextjs.js";
+import { cachedParseFile as parseFile } from "../utils/nextjs-audit-cache.js";
+import { cachedWalkDirectory as walkDirectory } from "../utils/nextjs-audit-cache.js";
+import { getCodeIndex } from "./index-tools.js";
+import { nextjsRouteMap } from "./nextjs-route-tools.js";
+// ---------------------------------------------------------------------------
+// Route pattern matcher (Task 32)
+// ---------------------------------------------------------------------------
+/**
+ * Convert a Next.js route pattern (`/products/[id]`, `/blog/[...slug]`,
+ * `/shop/[[...slug]]`) into a regex matching literal href strings.
+ */
+function patternToRegex(pattern) {
+    let s = pattern;
+    // [[...slug]] → optional catch-all (any chars including empty)
+    s = s.replace(/\[\[\.\.\.[\w]+\]\]/g, ".*");
+    // [...slug] → required catch-all (one or more chars)
+    s = s.replace(/\[\.\.\.[\w]+\]/g, ".+");
+    // [id] → single segment
+    s = s.replace(/\[[\w]+\]/g, "[^/]+");
+    // Escape remaining regex metacharacters except / and the substituted patterns
+    // (already substituted; safe to escape literal characters now)
+    return new RegExp(`^${s}$`);
+}
+export function matchRoutePattern(href, routes) {
+    if (routes.length === 0)
+        return false;
+    // Strip query string + hash
+    const path = href.split("?")[0].split("#")[0];
+    for (const route of routes) {
+        const re = patternToRegex(route);
+        if (re.test(path))
+            return true;
+    }
+    return false;
+}
+// ---------------------------------------------------------------------------
+// Orchestrator (Task 33)
+// ---------------------------------------------------------------------------
+const COMPONENT_EXTS = new Set([".tsx", ".jsx"]);
+const PARSE_CONCURRENCY = 10;
+const MAX_FILE_SIZE_BYTES = 2_097_152;
+export async function nextjsLinkIntegrity(repo, options) {
+    if (process.env.CODESIFT_DISABLE_TOOLS?.includes("nextjs_link_integrity")) {
+        throw new Error("nextjs_link_integrity is disabled via CODESIFT_DISABLE_TOOLS");
+    }
+    const index = await getCodeIndex(repo);
+    if (!index) {
+        throw new Error(`Repository not found: ${repo}. Run index_folder first.`);
+    }
+    const projectRoot = index.root;
+    // Get the route map
+    const routeMap = await nextjsRouteMap(repo, options?.workspace ? { workspace: options.workspace } : undefined);
+    const knownRoutes = routeMap.routes
+        .filter((r) => r.type === "page" || r.type === "route")
+        .map((r) => r.url_path);
+    let workspaces;
+    if (options?.workspace) {
+        workspaces = [join(projectRoot, options.workspace)];
+    }
+    else {
+        const discovered = await discoverWorkspaces(projectRoot);
+        workspaces = discovered.length > 0 ? discovered.map((w) => w.root) : [projectRoot];
+    }
+    const broken = [];
+    const unresolved = [];
+    let total_refs = 0;
+    let resolved_count = 0;
+    const parse_failures = [];
+    const scan_errors = [];
+    const workspaces_scanned = [];
+    for (const workspace of workspaces) {
+        workspaces_scanned.push(workspace);
+        const candidates = [];
+        for (const dir of ["app", "src/app", "pages", "src/pages"]) {
+            const fullDir = join(workspace, dir);
+            try {
+                const walked = await walkDirectory(fullDir, {
+                    followSymlinks: true,
+                    fileFilter: (ext) => COMPONENT_EXTS.has(ext),
+                    maxFileSize: MAX_FILE_SIZE_BYTES,
+                });
+                candidates.push(...walked);
+            }
+            catch (err) {
+                scan_errors.push(`${fullDir}: ${err instanceof Error ? err.message : String(err)}`);
+            }
+        }
+        for (let i = 0; i < candidates.length; i += PARSE_CONCURRENCY) {
+            const chunk = candidates.slice(i, i + PARSE_CONCURRENCY);
+            await Promise.all(chunk.map(async (filePath) => {
+                const rel = relative(projectRoot, filePath);
+                try {
+                    const source = await readFile(filePath, "utf8");
+                    const tree = await parseFile(filePath, source);
+                    if (!tree) {
+                        parse_failures.push(rel);
+                        return;
+                    }
+                    const refs = extractLinkHrefs(tree, source);
+                    for (const ref of refs) {
+                        total_refs++;
+                        if (ref.isDynamic) {
+                            unresolved.push({
+                                reason: "template_literal",
+                                file: rel,
+                                line: ref.line,
+                                raw: ref.href,
+                            });
+                            continue;
+                        }
+                        if (matchRoutePattern(ref.href, knownRoutes)) {
+                            resolved_count++;
+                        }
+                        else {
+                            broken.push({
+                                href: ref.href,
+                                file: rel,
+                                line: ref.line,
+                                kind: ref.kind,
+                            });
+                        }
+                    }
+                }
+                catch (err) {
+                    parse_failures.push(`${rel}: ${err instanceof Error ? err.message : String(err)}`);
+                }
+            }));
+        }
+    }
+    return {
+        total_refs,
+        resolved_count,
+        broken_count: broken.length,
+        unresolved_count: unresolved.length,
+        broken,
+        unresolved,
+        workspaces_scanned,
+        parse_failures,
+        scan_errors,
+        limitations: [
+            "literal-only matching: template-literal hrefs bucketed as unresolved",
+            "external links (http://, https://) and mailto: not validated",
+        ],
+    };
+}
+//# sourceMappingURL=nextjs-link-tools.js.map

package/dist/tools/nextjs-link-tools.js.map

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