codesift-mcp 0.3.0 → 0.5.0

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

@@ -0,0 +1,74 @@
+/**
+ * Next.js metadata audit (T1).
+ *
+ * Walks `app/**\/page.{tsx,jsx,ts,js}` files for `metadata` /
+ * `generateMetadata` exports, scores each page using a weighted formula
+ * (per design D4), and aggregates a per-route audit result with grade
+ * distribution and top issues.
+ */
+import { type MetadataFields } from "../utils/nextjs.js";
+export type MetadataGrade = "poor" | "needs_work" | "good" | "excellent";
+export interface MetadataField {
+    name: string;
+    present: boolean;
+    weight: number;
+}
+export interface MetadataScore {
+    score: number;
+    grade: MetadataGrade;
+    violations: string[];
+}
+export interface NextjsMetadataAuditEntry {
+    url_path: string;
+    file_path: string;
+    score: number;
+    grade: MetadataGrade;
+    violations: string[];
+    missing_fields: string[];
+}
+export interface NextjsMetadataAuditCounts {
+    excellent: number;
+    good: number;
+    needs_work: number;
+    poor: number;
+}
+export interface NextjsMetadataAuditResult {
+    total_pages: number;
+    scores: NextjsMetadataAuditEntry[];
+    counts: NextjsMetadataAuditCounts;
+    top_issues: string[];
+    workspaces_scanned: string[];
+    parse_failures: string[];
+    scan_errors: string[];
+    limitations: string[];
+}
+export interface NextjsMetadataAuditOptions {
+    workspace?: string | undefined;
+    max_routes?: number | undefined;
+}
+export type { MetadataFields };
+/** Field weights per design D4. Sum = 100. */
+export declare const METADATA_WEIGHTS: {
+    readonly title: 25;
+    readonly description: 20;
+    readonly og_image: 20;
+    readonly canonical: 15;
+    readonly twitter: 10;
+    readonly json_ld: 10;
+};
+/**
+ * Score a `MetadataFields` object against the weighted rubric (D4).
+ *
+ * Pure function — no I/O, no AST. Returns a numeric score 0-100, a grade
+ * bucket, and a list of violation tags. Length gates zero out title/desc
+ * scores when below thresholds. Placeholder OG images zero out the OG image
+ * score and flag a violation.
+ */
+export declare function scoreMetadata(fields: MetadataFields): MetadataScore;
+/**
+ * Audit a Next.js project's metadata coverage. Walks app/page.* files,
+ * extracts metadata via tree-sitter, scores each page, and returns a per-route
+ * + aggregate report.
+ */
+export declare function nextjsMetadataAudit(repo: string, options?: NextjsMetadataAuditOptions): Promise<NextjsMetadataAuditResult>;
+//# sourceMappingURL=nextjs-metadata-tools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"nextjs-metadata-tools.d.ts","sourceRoot":"","sources":["../../src/tools/nextjs-metadata-tools.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,EAIL,KAAK,cAAc,EACpB,MAAM,oBAAoB,CAAC;AAS5B,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,YAAY,GAAG,MAAM,GAAG,WAAW,CAAC;AAEzE,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,aAAa,CAAC;IACrB,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,aAAa,CAAC;IACrB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,cAAc,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,yBAAyB;IACxC,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,yBAAyB;IACxC,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,wBAAwB,EAAE,CAAC;IACnC,MAAM,EAAE,yBAAyB,CAAC;IAClC,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,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,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACjC;AAGD,YAAY,EAAE,cAAc,EAAE,CAAC;AAM/B,8CAA8C;AAC9C,eAAO,MAAM,gBAAgB;;;;;;;CAOnB,CAAC;AAoBX;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,cAAc,GAAG,aAAa,CAoDnE;AA+BD;;;;GAIG;AACH,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,0BAA0B,GACnC,OAAO,CAAC,yBAAyB,CAAC,CAuHpC"}

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

@@ -0,0 +1,252 @@
+/**
+ * Next.js metadata audit (T1).
+ *
+ * Walks `app/**\/page.{tsx,jsx,ts,js}` files for `metadata` /
+ * `generateMetadata` exports, scores each page using a weighted formula
+ * (per design D4), and aggregates a per-route audit result with grade
+ * distribution and top issues.
+ */
+import { readFile } from "node:fs/promises";
+import { join, relative } from "node:path";
+import { deriveUrlPath, discoverWorkspaces, parseMetadataExport, } 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 scoring function (Task 9)
+// ---------------------------------------------------------------------------
+/** Field weights per design D4. Sum = 100. */
+export const METADATA_WEIGHTS = {
+    title: 25,
+    description: 20,
+    og_image: 20,
+    canonical: 15,
+    twitter: 10,
+    json_ld: 10,
+};
+const TITLE_MIN_LENGTH = 10;
+const DESCRIPTION_MIN_LENGTH = 50;
+/** Substrings that mark an OG image as a placeholder, not a real per-route asset. */
+const PLACEHOLDER_OG_IMAGES = ["/og-image.png", "/favicon.ico", ""];
+function isPlaceholderOgImage(url) {
+    if (!url || url.trim() === "")
+        return true;
+    return PLACEHOLDER_OG_IMAGES.includes(url);
+}
+function gradeFromScore(score) {
+    if (score >= 90)
+        return "excellent";
+    if (score >= 70)
+        return "good";
+    if (score >= 40)
+        return "needs_work";
+    return "poor";
+}
+/**
+ * Score a `MetadataFields` object against the weighted rubric (D4).
+ *
+ * Pure function — no I/O, no AST. Returns a numeric score 0-100, a grade
+ * bucket, and a list of violation tags. Length gates zero out title/desc
+ * scores when below thresholds. Placeholder OG images zero out the OG image
+ * score and flag a violation.
+ */
+export function scoreMetadata(fields) {
+    let score = 0;
+    const violations = [];
+    // Title (weight 25, length gate)
+    if (fields.title) {
+        if (fields.title.length >= TITLE_MIN_LENGTH) {
+            score += METADATA_WEIGHTS.title;
+        }
+        else {
+            violations.push("title_too_short");
+        }
+    }
+    // Description (weight 20, length gate)
+    if (fields.description) {
+        if (fields.description.length >= DESCRIPTION_MIN_LENGTH) {
+            score += METADATA_WEIGHTS.description;
+        }
+        else {
+            violations.push("description_too_short");
+        }
+    }
+    // Open Graph image (weight 20, placeholder check)
+    const ogImage = fields.openGraph?.images?.[0];
+    if (ogImage) {
+        if (isPlaceholderOgImage(ogImage)) {
+            violations.push("og_image_placeholder");
+        }
+        else {
+            score += METADATA_WEIGHTS.og_image;
+        }
+    }
+    // Canonical (weight 15)
+    if (fields.alternates?.canonical) {
+        score += METADATA_WEIGHTS.canonical;
+    }
+    // Twitter card (weight 10)
+    if (fields.twitter?.card) {
+        score += METADATA_WEIGHTS.twitter;
+    }
+    // JSON-LD (weight 10) — detected via the `other` catch-all
+    if (fields.other && Object.keys(fields.other).length > 0) {
+        score += METADATA_WEIGHTS.json_ld;
+    }
+    return {
+        score,
+        grade: gradeFromScore(score),
+        violations,
+    };
+}
+// ---------------------------------------------------------------------------
+// Orchestrator (Task 10)
+// ---------------------------------------------------------------------------
+const PAGE_FILENAME_RE = /(^|\/)page\.(tsx|jsx|ts|js)$/;
+const PAGE_EXTS = new Set([".tsx", ".jsx", ".ts", ".js"]);
+const DEFAULT_MAX_ROUTES = 1000;
+const PARSE_CONCURRENCY = 10;
+const MAX_FILE_SIZE_BYTES = 2_097_152;
+/** Compute the union of present-but-zero / missing fields per the scorer rubric. */
+function missingFieldsFor(fields, score) {
+    const missing = [];
+    if (!fields.title)
+        missing.push("title");
+    if (!fields.description)
+        missing.push("description");
+    if (!fields.openGraph?.images?.[0])
+        missing.push("og_image");
+    if (!fields.alternates?.canonical)
+        missing.push("canonical");
+    if (!fields.twitter?.card)
+        missing.push("twitter");
+    if (!fields.other || Object.keys(fields.other).length === 0)
+        missing.push("json_ld");
+    // Length-gate violations also count as missing for reporter purposes.
+    if (score.violations.includes("title_too_short") && !missing.includes("title")) {
+        missing.push("title");
+    }
+    if (score.violations.includes("description_too_short") && !missing.includes("description")) {
+        missing.push("description");
+    }
+    return missing;
+}
+/**
+ * Audit a Next.js project's metadata coverage. Walks app/page.* files,
+ * extracts metadata via tree-sitter, scores each page, and returns a per-route
+ * + aggregate report.
+ */
+export async function nextjsMetadataAudit(repo, options) {
+    if (process.env.CODESIFT_DISABLE_TOOLS?.includes("nextjs_metadata_audit")) {
+        throw new Error("nextjs_metadata_audit 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;
+    // Resolve workspaces
+    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 maxRoutes = options?.max_routes ?? DEFAULT_MAX_ROUTES;
+    const scores = [];
+    const parse_failures = [];
+    const scan_errors = [];
+    const workspaces_scanned = [];
+    const top_issues_counter = new Map();
+    for (const workspace of workspaces) {
+        workspaces_scanned.push(workspace);
+        const candidates = [];
+        for (const appDir of ["app", "src/app"]) {
+            const fullAppDir = join(workspace, appDir);
+            try {
+                const walked = await walkDirectory(fullAppDir, {
+                    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(`${fullAppDir}: ${err instanceof Error ? err.message : String(err)}`);
+            }
+        }
+        const remaining = maxRoutes - scores.length;
+        const toProcess = candidates.slice(0, Math.max(0, remaining));
+        for (let i = 0; i < toProcess.length; i += PARSE_CONCURRENCY) {
+            const chunk = toProcess.slice(i, i + PARSE_CONCURRENCY);
+            const entries = await Promise.all(chunk.map(async (filePath) => {
+                try {
+                    const rel = relative(projectRoot, filePath);
+                    const source = await readFile(filePath, "utf8");
+                    const tree = await parseFile(filePath, source);
+                    if (!tree) {
+                        parse_failures.push(rel);
+                        return null;
+                    }
+                    const fields = parseMetadataExport(tree, source);
+                    const score = scoreMetadata(fields);
+                    const missing_fields = missingFieldsFor(fields, score);
+                    const url_path = deriveUrlPath(rel, "app");
+                    const entry = {
+                        url_path,
+                        file_path: rel,
+                        score: score.score,
+                        grade: score.grade,
+                        violations: score.violations,
+                        missing_fields,
+                    };
+                    return entry;
+                }
+                catch (err) {
+                    const rel = relative(projectRoot, filePath);
+                    parse_failures.push(`${rel}: ${err instanceof Error ? err.message : String(err)}`);
+                    return null;
+                }
+            }));
+            for (const e of entries) {
+                if (!e)
+                    continue;
+                scores.push(e);
+                for (const v of e.violations) {
+                    top_issues_counter.set(v, (top_issues_counter.get(v) ?? 0) + 1);
+                }
+            }
+        }
+    }
+    // Aggregate counts by grade
+    const counts = {
+        excellent: 0,
+        good: 0,
+        needs_work: 0,
+        poor: 0,
+    };
+    for (const s of scores) {
+        counts[s.grade]++;
+    }
+    // Sort top issues by frequency desc, take top 5
+    const top_issues = [...top_issues_counter.entries()]
+        .sort((a, b) => b[1] - a[1])
+        .slice(0, 5)
+        .map(([violation, count]) => `${violation} (${count})`);
+    return {
+        total_pages: scores.length,
+        scores,
+        counts,
+        top_issues,
+        workspaces_scanned,
+        parse_failures,
+        scan_errors,
+        limitations: ["does not check remote Open Graph image resolution"],
+    };
+}
+//# sourceMappingURL=nextjs-metadata-tools.js.map

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

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

package/dist/tools/nextjs-middleware-coverage-tools.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Next.js middleware coverage analyzer (T8).
+ *
+ * Cross-references the route map (via `nextjsRouteMap`) with the middleware
+ * matcher config (via existing `traceMiddleware`) to compute coverage:
+ * which routes are protected and which are unprotected. Flags admin routes
+ * without middleware as high-severity warnings.
+ */
+export interface CoverageMap {
+    protected: string[];
+    unprotected: string[];
+    total_routes: number;
+}
+export interface SecurityWarning {
+    severity: "high" | "medium" | "low";
+    route: string;
+    reason: string;
+}
+export interface CoverageEntry {
+    url_path: string;
+    protected: boolean;
+}
+export interface NextjsMiddlewareCoverageResult {
+    coverage: CoverageMap;
+    warnings: SecurityWarning[];
+    total: number;
+    workspaces_scanned: string[];
+    limitations: string[];
+}
+export interface NextjsMiddlewareCoverageOptions {
+    workspace?: string | undefined;
+    flag_admin_prefix?: string | string[] | undefined;
+}
+export declare function calculateCoverage(routes: Array<{
+    url_path: string;
+}>, repoRoot: string): Promise<CoverageMap>;
+export declare function flagSecurityWarnings(coverage: CoverageMap, options?: {
+    flag_admin_prefix?: string | string[];
+}): SecurityWarning[];
+export declare function nextjsMiddlewareCoverage(repo: string, options?: NextjsMiddlewareCoverageOptions): Promise<NextjsMiddlewareCoverageResult>;
+//# sourceMappingURL=nextjs-middleware-coverage-tools.d.ts.map

package/dist/tools/nextjs-middleware-coverage-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nextjs-middleware-coverage-tools.d.ts","sourceRoot":"","sources":["../../src/tools/nextjs-middleware-coverage-tools.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAUH,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,EAAE,WAAW,CAAC;IACtB,QAAQ,EAAE,eAAe,EAAE,CAAC;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,+BAA+B;IAC9C,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,iBAAiB,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC;CACnD;AAQD,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,KAAK,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,EACnC,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,WAAW,CAAC,CAgBtB;AAED,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,WAAW,EACrB,OAAO,CAAC,EAAE;IAAE,iBAAiB,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;CAAE,GAClD,eAAe,EAAE,CAwBnB;AAMD,wBAAsB,wBAAwB,CAC5C,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,+BAA+B,GACxC,OAAO,CAAC,8BAA8B,CAAC,CAiCzC"}

package/dist/tools/nextjs-middleware-coverage-tools.js

@@ -0,0 +1,88 @@
+/**
+ * Next.js middleware coverage analyzer (T8).
+ *
+ * Cross-references the route map (via `nextjsRouteMap`) with the middleware
+ * matcher config (via existing `traceMiddleware`) to compute coverage:
+ * which routes are protected and which are unprotected. Flags admin routes
+ * without middleware as high-severity warnings.
+ */
+import { traceMiddleware } from "../utils/nextjs.js";
+import { getCodeIndex } from "./index-tools.js";
+import { nextjsRouteMap } from "./nextjs-route-tools.js";
+// ---------------------------------------------------------------------------
+// Pure helpers (Tasks 41, 42)
+// ---------------------------------------------------------------------------
+const DEFAULT_ADMIN_PREFIXES = ["/admin", "/dashboard"];
+export async function calculateCoverage(routes, repoRoot) {
+    const protectedRoutes = [];
+    const unprotectedRoutes = [];
+    for (const r of routes) {
+        const trace = await traceMiddleware(repoRoot, r.url_path);
+        if (trace && trace.applies) {
+            protectedRoutes.push(r.url_path);
+        }
+        else {
+            unprotectedRoutes.push(r.url_path);
+        }
+    }
+    return {
+        protected: protectedRoutes,
+        unprotected: unprotectedRoutes,
+        total_routes: routes.length,
+    };
+}
+export function flagSecurityWarnings(coverage, options) {
+    const prefixes = options?.flag_admin_prefix
+        ? Array.isArray(options.flag_admin_prefix)
+            ? options.flag_admin_prefix
+            : [options.flag_admin_prefix]
+        : DEFAULT_ADMIN_PREFIXES;
+    const warnings = [];
+    for (const route of coverage.unprotected) {
+        for (const prefix of prefixes) {
+            if (route === prefix || route.startsWith(`${prefix}/`)) {
+                warnings.push({
+                    severity: "high",
+                    route,
+                    reason: `admin route without middleware (${prefix} prefix)`,
+                });
+                break;
+            }
+        }
+    }
+    // Sort by severity desc (high first)
+    const order = { high: 3, medium: 2, low: 1 };
+    warnings.sort((a, b) => order[b.severity] - order[a.severity]);
+    return warnings;
+}
+// ---------------------------------------------------------------------------
+// Orchestrator (Task 43a)
+// ---------------------------------------------------------------------------
+export async function nextjsMiddlewareCoverage(repo, options) {
+    if (process.env.CODESIFT_DISABLE_TOOLS?.includes("nextjs_middleware_coverage")) {
+        throw new Error("nextjs_middleware_coverage 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;
+    const routeMap = await nextjsRouteMap(repo, options?.workspace ? { workspace: options.workspace } : undefined);
+    // Only consider page/route entries for coverage
+    const pageRoutes = routeMap.routes.filter((r) => r.type === "page" || r.type === "route");
+    const coverage = await calculateCoverage(pageRoutes, projectRoot);
+    const warnings = flagSecurityWarnings(coverage, {
+        ...(options?.flag_admin_prefix !== undefined ? { flag_admin_prefix: options.flag_admin_prefix } : {}),
+    });
+    return {
+        coverage,
+        warnings,
+        total: coverage.total_routes,
+        workspaces_scanned: routeMap.workspaces_scanned,
+        limitations: [
+            "fail-open behavior on computed matcher (treats as protected)",
+            "default admin prefixes: /admin, /dashboard (override with flag_admin_prefix)",
+        ],
+    };
+}
+//# sourceMappingURL=nextjs-middleware-coverage-tools.js.map

package/dist/tools/nextjs-middleware-coverage-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nextjs-middleware-coverage-tools.js","sourceRoot":"","sources":["../../src/tools/nextjs-middleware-coverage-tools.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAoCzD,8EAA8E;AAC9E,8BAA8B;AAC9B,8EAA8E;AAE9E,MAAM,sBAAsB,GAAG,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;AAExD,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,MAAmC,EACnC,QAAgB;IAEhB,MAAM,eAAe,GAAa,EAAE,CAAC;IACrC,MAAM,iBAAiB,GAAa,EAAE,CAAC;IACvC,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QACvB,MAAM,KAAK,GAAG,MAAM,eAAe,CAAC,QAAQ,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC;QAC1D,IAAI,KAAK,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;YAC3B,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;QACnC,CAAC;aAAM,CAAC;YACN,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;QACrC,CAAC;IACH,CAAC;IACD,OAAO;QACL,SAAS,EAAE,eAAe;QAC1B,WAAW,EAAE,iBAAiB;QAC9B,YAAY,EAAE,MAAM,CAAC,MAAM;KAC5B,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,oBAAoB,CAClC,QAAqB,EACrB,OAAmD;IAEnD,MAAM,QAAQ,GAAG,OAAO,EAAE,iBAAiB;QACzC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,iBAAiB,CAAC;YACxC,CAAC,CAAC,OAAO,CAAC,iBAAiB;YAC3B,CAAC,CAAC,CAAC,OAAO,CAAC,iBAAiB,CAAC;QAC/B,CAAC,CAAC,sBAAsB,CAAC;IAE3B,MAAM,QAAQ,GAAsB,EAAE,CAAC;IACvC,KAAK,MAAM,KAAK,IAAI,QAAQ,CAAC,WAAW,EAAE,CAAC;QACzC,KAAK,MAAM,MAAM,IAAI,QAAQ,EAAE,CAAC;YAC9B,IAAI,KAAK,KAAK,MAAM,IAAI,KAAK,CAAC,UAAU,CAAC,GAAG,MAAM,GAAG,CAAC,EAAE,CAAC;gBACvD,QAAQ,CAAC,IAAI,CAAC;oBACZ,QAAQ,EAAE,MAAM;oBAChB,KAAK;oBACL,MAAM,EAAE,mCAAmC,MAAM,UAAU;iBAC5D,CAAC,CAAC;gBACH,MAAM;YACR,CAAC;QACH,CAAC;IACH,CAAC;IACD,qCAAqC;IACrC,MAAM,KAAK,GAAG,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC;IAC7C,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC/D,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,8EAA8E;AAC9E,0BAA0B;AAC1B,8EAA8E;AAE9E,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,IAAY,EACZ,OAAyC;IAEzC,IAAI,OAAO,CAAC,GAAG,CAAC,sBAAsB,EAAE,QAAQ,CAAC,4BAA4B,CAAC,EAAE,CAAC;QAC/E,MAAM,IAAI,KAAK,CAAC,mEAAmE,CAAC,CAAC;IACvF,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,YAAY,CAAC,IAAI,CAAC,CAAC;IACvC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,yBAAyB,IAAI,2BAA2B,CAAC,CAAC;IAC5E,CAAC;IACD,MAAM,WAAW,GAAG,KAAK,CAAC,IAAI,CAAC;IAE/B,MAAM,QAAQ,GAAG,MAAM,cAAc,CACnC,IAAI,EACJ,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,SAAS,CAClE,CAAC;IACF,gDAAgD;IAChD,MAAM,UAAU,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,IAAI,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC;IAE1F,MAAM,QAAQ,GAAG,MAAM,iBAAiB,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;IAClE,MAAM,QAAQ,GAAG,oBAAoB,CAAC,QAAQ,EAAE;QAC9C,GAAG,CAAC,OAAO,EAAE,iBAAiB,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,iBAAiB,EAAE,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACtG,CAAC,CAAC;IAEH,OAAO;QACL,QAAQ;QACR,QAAQ;QACR,KAAK,EAAE,QAAQ,CAAC,YAAY;QAC5B,kBAAkB,EAAE,QAAQ,CAAC,kBAAkB;QAC/C,WAAW,EAAE;YACX,8DAA8D;YAC9D,8EAA8E;SAC/E;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/nextjs-route-readers.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Next.js route readers: AST-based route segment config extraction,
+ * rendering strategy classification, and single-file parsing.
+ *
+ * These readers are pure helpers with no orchestration logic. They are used by
+ * `nextjs-route-tools.ts` (orchestrator) and re-exported from it for backward
+ * compatibility with existing consumers and tests. Split follows the T2/T3
+ * reader + orchestrator precedent.
+ */
+import type Parser from "web-tree-sitter";
+export type RenderingStrategy = "static" | "ssr" | "isr" | "edge" | "client" | "unknown";
+export type RouteEntryType = "page" | "route" | "layout" | "loading" | "error" | "not-found" | "global-error" | "default" | "template" | "parallel" | "intercepting" | "app" | "document" | "error_page";
+export interface RouteSegmentConfig {
+    dynamic?: "auto" | "force-dynamic" | "force-static" | "error";
+    dynamic_non_literal?: boolean;
+    revalidate?: number | false;
+    revalidate_non_literal?: boolean;
+    runtime?: "nodejs" | "edge";
+    runtime_non_literal?: boolean;
+    has_generate_static_params: boolean;
+}
+export interface NextjsRouteEntry {
+    url_path: string;
+    file_path: string;
+    router: "app" | "pages";
+    type: RouteEntryType;
+    rendering: RenderingStrategy;
+    config: RouteSegmentConfig;
+    has_metadata: boolean;
+    methods?: string[];
+    layout_chain: string[];
+    middleware_applies: boolean;
+    is_client_component: boolean;
+    /** Free-text explanation of *why* a route is SSR. Set only when rendering === "ssr". */
+    rendering_reason?: string;
+}
+export interface NextjsRouteConflict {
+    url_path: string;
+    app: string;
+    pages: string;
+}
+export interface PagesRouterSignals {
+    hasGetServerSideProps?: boolean;
+    hasGetStaticProps?: boolean;
+    hasRevalidateInReturn?: boolean;
+}
+/**
+ * Read Next.js route segment config exports from an AST.
+ *
+ * Recognizes:
+ *   export const dynamic = "force-dynamic"
+ *   export const revalidate = 60 | false
+ *   export const runtime = "edge"
+ *   export async function generateStaticParams() {...}
+ *
+ * Non-literal initializers (Identifier, BinaryExpression, etc.) set a
+ * `_non_literal` flag and leave the corresponding value `undefined`.
+ *
+ * @internal exported for unit testing
+ */
+export declare function readRouteSegmentConfig(tree: Parser.Tree, _source: string): RouteSegmentConfig;
+/**
+ * Map a route segment config (+ optional Pages Router signals) to a
+ * rendering strategy.
+ *
+ * Priority (App Router): runtime=edge > force-dynamic > force-static >
+ * revalidate > generateStaticParams > default (static).
+ *
+ * Pages Router: getServerSideProps → ssr; getStaticProps + revalidate → isr;
+ * getStaticProps → static; otherwise unknown.
+ *
+ * @internal exported for unit testing
+ */
+export declare function classifyRendering(config: RouteSegmentConfig, router: "app" | "pages", pagesSignals?: PagesRouterSignals): RenderingStrategy;
+/**
+ * Process a single route file into a `NextjsRouteEntry`.
+ *
+ * @internal exported for unit testing
+ */
+export declare function parseRouteFile(filePath: string, repoRoot: string, router: "app" | "pages"): Promise<NextjsRouteEntry>;
+//# sourceMappingURL=nextjs-route-readers.d.ts.map

package/dist/tools/nextjs-route-readers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nextjs-route-readers.d.ts","sourceRoot":"","sources":["../../src/tools/nextjs-route-readers.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,MAAM,MAAM,iBAAiB,CAAC;AAa1C,MAAM,MAAM,iBAAiB,GACzB,QAAQ,GACR,KAAK,GACL,KAAK,GACL,MAAM,GACN,QAAQ,GACR,SAAS,CAAC;AAEd,MAAM,MAAM,cAAc,GACtB,MAAM,GACN,OAAO,GACP,QAAQ,GACR,SAAS,GACT,OAAO,GACP,WAAW,GACX,cAAc,GACd,SAAS,GACT,UAAU,GACV,UAAU,GACV,cAAc,GACd,KAAK,GACL,UAAU,GACV,YAAY,CAAC;AAEjB,MAAM,WAAW,kBAAkB;IACjC,OAAO,CAAC,EAAE,MAAM,GAAG,eAAe,GAAG,cAAc,GAAG,OAAO,CAAC;IAC9D,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,UAAU,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IAC5B,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,OAAO,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAC;IAC5B,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,0BAA0B,EAAE,OAAO,CAAC;CACrC;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,KAAK,GAAG,OAAO,CAAC;IACxB,IAAI,EAAE,cAAc,CAAC;IACrB,SAAS,EAAE,iBAAiB,CAAC;IAC7B,MAAM,EAAE,kBAAkB,CAAC;IAC3B,YAAY,EAAE,OAAO,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,kBAAkB,EAAE,OAAO,CAAC;IAC5B,mBAAmB,EAAE,OAAO,CAAC;IAC7B,wFAAwF;IACxF,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,kBAAkB;IACjC,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,qBAAqB,CAAC,EAAE,OAAO,CAAC;CACjC;AAmBD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,MAAM,CAAC,IAAI,EACjB,OAAO,EAAE,MAAM,GACd,kBAAkB,CA4BpB;AAkDD;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,kBAAkB,EAC1B,MAAM,EAAE,KAAK,GAAG,OAAO,EACvB,YAAY,CAAC,EAAE,kBAAkB,GAChC,iBAAiB,CAkBnB;AAyFD;;;;GAIG;AACH,wBAAsB,cAAc,CAClC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,KAAK,GAAG,OAAO,GACtB,OAAO,CAAC,gBAAgB,CAAC,CA2G3B"}