codesift-mcp 0.3.0 → 0.4.0

package/dist/tools/nextjs-data-flow-tools.js

@@ -0,0 +1,158 @@
+/**
+ * Next.js data flow analyzer (T6).
+ *
+ * Walks `app/**\/page.{tsx,jsx}` files for `fetch()`, `cookies()`, `headers()`
+ * calls (via the shared `extractFetchCalls` helper) and classifies fetch
+ * patterns as waterfall vs parallel, plus cache strategy. Returns per-page
+ * data flow entries with aggregate counts.
+ */
+import { readFile } from "node:fs/promises";
+import { join, relative } from "node:path";
+import { deriveUrlPath, discoverWorkspaces, extractFetchCalls, } 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";
+// ---------------------------------------------------------------------------
+// Pure helpers
+// ---------------------------------------------------------------------------
+export function classifyFetches(fetches) {
+    const waterfall_pairs = [];
+    for (let i = 0; i < fetches.length; i++) {
+        const cur = fetches[i];
+        if (cur.isSequential) {
+            // Find the previous fetch that triggered this
+            const prev = i > 0 ? fetches[i - 1] : null;
+            if (prev) {
+                waterfall_pairs.push({ first: prev.line, second: cur.line });
+            }
+        }
+    }
+    return { fetches, waterfall_pairs };
+}
+export function classifyCacheStrategy(fetch) {
+    if (fetch.callee !== "fetch")
+        return "default";
+    const opt = fetch.cacheOption;
+    if (!opt)
+        return "default";
+    if (opt === "no-store")
+        return "no-cache";
+    if (opt === "force-cache")
+        return "cached";
+    if (opt.startsWith("isr-"))
+        return opt;
+    return opt;
+}
+// ---------------------------------------------------------------------------
+// Orchestrator
+// ---------------------------------------------------------------------------
+const PAGE_FILENAME_RE = /(^|\/)page\.(tsx|jsx|ts|js)$/;
+const PAGE_EXTS = new Set([".tsx", ".jsx", ".ts", ".js"]);
+const PARSE_CONCURRENCY = 10;
+const MAX_FILE_SIZE_BYTES = 2_097_152;
+export async function nextjsDataFlow(repo, options) {
+    if (process.env.CODESIFT_DISABLE_TOOLS?.includes("nextjs_data_flow")) {
+        throw new Error("nextjs_data_flow 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;
+    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 entries = [];
+    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"]) {
+            const fullDir = join(workspace, dir);
+            try {
+                const walked = await walkDirectory(fullDir, {
+                    followSymlinks: true,
+                    fileFilter: (ext) => PAGE_EXTS.has(ext),
+                    maxFileSize: MAX_FILE_SIZE_BYTES,
+                });
+                for (const f of walked) {
+                    if (PAGE_FILENAME_RE.test(f))
+                        candidates.push(f);
+                }
+            }
+            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);
+            const results = 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 null;
+                    }
+                    const fetches = extractFetchCalls(tree, source);
+                    const analysis = classifyFetches(fetches);
+                    const cache_distribution = {};
+                    for (const f of fetches) {
+                        const strategy = classifyCacheStrategy(f);
+                        cache_distribution[strategy] = (cache_distribution[strategy] ?? 0) + 1;
+                    }
+                    const url_path = deriveUrlPath(rel, "app");
+                    const entry = {
+                        url_path,
+                        file: rel,
+                        fetches,
+                        waterfall_count: analysis.waterfall_pairs.length,
+                        cache_distribution,
+                    };
+                    return entry;
+                }
+                catch (err) {
+                    parse_failures.push(`${rel}: ${err instanceof Error ? err.message : String(err)}`);
+                    return null;
+                }
+            }));
+            for (const r of results)
+                if (r)
+                    entries.push(r);
+        }
+    }
+    // Optional URL path filter
+    const filtered = options?.url_path
+        ? entries.filter((e) => e.url_path === options.url_path)
+        : entries;
+    let total_waterfalls = 0;
+    const cache_summary = {};
+    for (const e of filtered) {
+        total_waterfalls += e.waterfall_count;
+        for (const [k, v] of Object.entries(e.cache_distribution)) {
+            cache_summary[k] = (cache_summary[k] ?? 0) + v;
+        }
+    }
+    return {
+        entries: filtered,
+        total_pages: filtered.length,
+        total_waterfalls,
+        cache_summary,
+        workspaces_scanned,
+        parse_failures,
+        scan_errors,
+        limitations: [
+            "waterfall detection limited to same-scope sequential awaits",
+            "Promise.all parallel detection requires identifier match heuristic",
+        ],
+    };
+}
+//# sourceMappingURL=nextjs-data-flow-tools.js.map

package/dist/tools/nextjs-data-flow-tools.js.map

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

package/dist/tools/nextjs-framework-audit-tools.d.ts

@@ -0,0 +1,37 @@
+/**
+ * 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`.
+ */
+export type AuditDimension = "components" | "routes" | "metadata" | "security" | "api_contract" | "boundary" | "links" | "data_flow" | "middleware_coverage";
+export interface DimensionScore {
+    score: number;
+    weight: number;
+    contribution: number;
+}
+export interface AuditSummary {
+    overall_score: number;
+    grade: "poor" | "needs_work" | "good" | "excellent";
+    dimensions: Partial<Record<AuditDimension, DimensionScore>>;
+    top_issues: string[];
+}
+export interface FrameworkAuditResult {
+    summary: AuditSummary;
+    sub_results: Partial<Record<AuditDimension, unknown>>;
+    tool_errors: Array<{
+        tool: string;
+        error: string;
+    }>;
+    cache_size: number;
+    duration_ms: number;
+}
+export interface FrameworkAuditOptions {
+    workspace?: string | undefined;
+    tools?: AuditDimension[] | undefined;
+}
+export declare function aggregateScores(sub_results: Partial<Record<AuditDimension, unknown>>): AuditSummary;
+export declare function frameworkAudit(repo: string, options?: FrameworkAuditOptions): Promise<FrameworkAuditResult>;
+//# sourceMappingURL=nextjs-framework-audit-tools.d.ts.map

package/dist/tools/nextjs-framework-audit-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nextjs-framework-audit-tools.d.ts","sourceRoot":"","sources":["../../src/tools/nextjs-framework-audit-tools.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAiBH,MAAM,MAAM,cAAc,GACtB,YAAY,GACZ,QAAQ,GACR,UAAU,GACV,UAAU,GACV,cAAc,GACd,UAAU,GACV,OAAO,GACP,WAAW,GACX,qBAAqB,CAAC;AAE1B,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,YAAY;IAC3B,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,GAAG,YAAY,GAAG,MAAM,GAAG,WAAW,CAAC;IACpD,UAAU,EAAE,OAAO,CAAC,MAAM,CAAC,cAAc,EAAE,cAAc,CAAC,CAAC,CAAC;IAC5D,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,YAAY,CAAC;IACtB,WAAW,EAAE,OAAO,CAAC,MAAM,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC,CAAC;IACtD,WAAW,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACpD,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,qBAAqB;IACpC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,KAAK,CAAC,EAAE,cAAc,EAAE,GAAG,SAAS,CAAC;CACtC;AA8FD,wBAAgB,eAAe,CAC7B,WAAW,EAAE,OAAO,CAAC,MAAM,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC,GACpD,YAAY,CA6Bd;AA0CD,wBAAsB,cAAc,CAClC,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,qBAAqB,GAC9B,OAAO,CAAC,oBAAoB,CAAC,CAwC/B"}

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

@@ -0,0 +1,211 @@
+/**
+ * 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),
+    };
+}
+// ---------------------------------------------------------------------------
+// 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),
+};
+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 summary = aggregateScores(sub_results);
+    const duration_ms = Date.now() - start;
+    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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"}