codesift-mcp 0.3.0 → 0.4.0

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

@@ -0,0 +1,152 @@
+/**
+ * Next.js client boundary analyzer (T4).
+ *
+ * Walks `app/**\/*.{tsx,jsx}` files marked with `"use client"` and computes
+ * a deterministic ranking score per file from cheap signals (LOC, import
+ * counts, dynamic imports, third-party imports). Per design D5 the score
+ * is signal-based — no actual bundle bytes are estimated.
+ */
+import { readFile } from "node:fs/promises";
+import { join, relative } from "node:path";
+import { discoverWorkspaces, scanDirective } 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 (Tasks 27, 28)
+// ---------------------------------------------------------------------------
+function isLocalImport(spec) {
+    return spec.startsWith("./") || spec.startsWith("../") || spec.startsWith("@/") || spec.startsWith("~/");
+}
+export function extractComponentSignals(_filePath, source, tree) {
+    const loc = source.split("\n").length;
+    let import_count = 0;
+    let dynamic_import_count = 0;
+    const third_party = new Set();
+    const root = tree.rootNode;
+    for (const imp of root.descendantsOfType("import_statement")) {
+        import_count++;
+        // The module source is a string literal child
+        for (const child of imp.namedChildren) {
+            if (child.type === "string") {
+                const frag = child.namedChildren.find((c) => c.type === "string_fragment");
+                const text = frag?.text ?? child.text.slice(1, -1);
+                if (!isLocalImport(text)) {
+                    third_party.add(text);
+                }
+            }
+        }
+    }
+    // Walk for dynamic(...) calls (next/dynamic) — treat as proxy for code-split modules.
+    for (const call of root.descendantsOfType("call_expression")) {
+        const fn = call.childForFieldName("function") ?? call.namedChild(0);
+        if (fn?.type === "identifier" && fn.text === "dynamic") {
+            dynamic_import_count++;
+        }
+    }
+    return {
+        loc,
+        import_count,
+        dynamic_import_count,
+        third_party_imports: [...third_party],
+    };
+}
+export function rankingScore(signals) {
+    // Formula per D5: loc + (imports * 20) + (dynamic * -30) + (third_party * 15)
+    return (signals.loc +
+        signals.import_count * 20 +
+        signals.dynamic_import_count * -30 +
+        signals.third_party_imports.length * 15);
+}
+// ---------------------------------------------------------------------------
+// Orchestrator (Task 29)
+// ---------------------------------------------------------------------------
+const COMPONENT_EXTS = new Set([".tsx", ".jsx"]);
+const PARSE_CONCURRENCY = 10;
+const MAX_FILE_SIZE_BYTES = 2_097_152;
+const DEFAULT_TOP_N = 20;
+export async function nextjsBoundaryAnalyzer(repo, options) {
+    if (process.env.CODESIFT_DISABLE_TOOLS?.includes("nextjs_boundary_analyzer")) {
+        throw new Error("nextjs_boundary_analyzer 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 top_n = options?.top_n ?? DEFAULT_TOP_N;
+    const allEntries = [];
+    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) => 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);
+            const results = await Promise.all(chunk.map(async (filePath) => {
+                const rel = relative(projectRoot, filePath);
+                try {
+                    const directive = await scanDirective(filePath);
+                    if (directive !== "use client")
+                        return null;
+                    const source = await readFile(filePath, "utf8");
+                    const tree = await parseFile(filePath, source);
+                    if (!tree) {
+                        parse_failures.push(rel);
+                        return null;
+                    }
+                    const signals = extractComponentSignals(rel, source, tree);
+                    const score = rankingScore(signals);
+                    return { rank: 0, path: rel, signals, score };
+                }
+                catch (err) {
+                    parse_failures.push(`${rel}: ${err instanceof Error ? err.message : String(err)}`);
+                    return null;
+                }
+            }));
+            for (const r of results)
+                if (r)
+                    allEntries.push(r);
+        }
+    }
+    allEntries.sort((a, b) => b.score - a.score);
+    const top = allEntries.slice(0, top_n).map((e, i) => ({ ...e, rank: i + 1 }));
+    const total_client_loc = allEntries.reduce((sum, e) => sum + e.signals.loc, 0);
+    return {
+        entries: top,
+        client_count: allEntries.length,
+        total_client_loc,
+        largest_offender: top[0] ?? null,
+        workspaces_scanned,
+        parse_failures,
+        scan_errors,
+        limitations: [
+            "score is signal-based — no actual bundle bytes estimated",
+            "transitive client boundaries via barrel files not detected",
+        ],
+    };
+}
+//# sourceMappingURL=nextjs-boundary-tools.js.map

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

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

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

@@ -0,0 +1,121 @@
+/**
+ * Next.js component classifier: AST-based Server/Client component detection.
+ *
+ * Uses a two-stage directive detection strategy:
+ *   1. Fast-reject: scan first 512 bytes for "use client"/"use server" substring
+ *   2. AST confirm: verify directive is `Program.body[0]` ExpressionStatement
+ *
+ * Then walks the AST for client-component signals (hooks, JSX event handlers,
+ * browser globals, `next/dynamic({ ssr: false })`) and classifies each file
+ * per the 8-row decision table.
+ */
+import type Parser from "web-tree-sitter";
+export type ComponentClassification = "server" | "client_explicit" | "client_inferred" | "ambiguous";
+export interface ComponentSignals {
+    hooks: string[];
+    event_handlers: string[];
+    browser_globals: string[];
+    dynamic_ssr_false: boolean;
+}
+export interface NextjsComponentEntry {
+    path: string;
+    classification: ComponentClassification;
+    directive: "use client" | "use server" | null;
+    signals: ComponentSignals;
+    violations: string[];
+    /**
+     * Actionable remediation text for classification violations.
+     * Set when the entry has `unnecessary_use_client` violation or
+     * `client_inferred` classification; omitted otherwise.
+     */
+    suggested_fix?: string;
+}
+export interface NextjsComponentsCounts {
+    total: number;
+    server: number;
+    client_explicit: number;
+    client_inferred: number;
+    ambiguous: number;
+    unnecessary_use_client: number;
+}
+export interface NextjsComponentsResult {
+    files: NextjsComponentEntry[];
+    counts: NextjsComponentsCounts;
+    parse_failures: string[];
+    scan_errors: string[];
+    truncated: boolean;
+    truncated_at?: number;
+    workspaces_scanned: string[];
+    limitations: string[];
+}
+export interface AnalyzeNextjsComponentsOptions {
+    workspace?: string | undefined;
+    file_pattern?: string | undefined;
+    max_files?: number | undefined;
+}
+export declare const MAX_FILE_SIZE_BYTES = 2097152;
+export declare const DEFAULT_MAX_FILES = 2000;
+export declare const PARSE_CONCURRENCY = 10;
+/** Hooks that are server-safe (or SSR-safe) and don't imply client component. */
+export declare const CLIENT_HOOKS_EXCLUDE: Set<string>;
+/** JSX event attributes that imply client component. */
+export declare const EVENT_HANDLER_ATTRS: Set<string>;
+/** Browser-only globals (detected in MemberExpressions like `window.foo`). */
+export declare const BROWSER_GLOBALS: Set<string>;
+/**
+ * Pure decision table for component classification. No I/O, no AST access.
+ *
+ * Rules (in priority order):
+ *   - directive === "use client":
+ *       has any signal     -> client_explicit
+ *       no signals         -> client_explicit + violation "unnecessary_use_client"
+ *   - directive === "use server" -> server
+ *   - directive === null:
+ *       has any signal     -> client_inferred
+ *       no signals         -> server
+ */
+export declare function applyClassificationTable(directive: "use client" | "use server" | null, signals: ComponentSignals): {
+    classification: ComponentClassification;
+    violations: string[];
+};
+/**
+ * Walk the AST to collect client-component signals:
+ *   - hooks    — call_expression whose callee identifier matches /^use[A-Z]/
+ *   - events   — jsx_attribute property_identifier in EVENT_HANDLER_ATTRS
+ *   - globals  — member_expression object identifier in BROWSER_GLOBALS
+ *   - next/dynamic({ ssr: false }) — import from "next/dynamic" + call with ssr:false
+ */
+export declare function detectSignals(tree: Parser.Tree, _source: string): ComponentSignals;
+/**
+ * Confirm a file-level directive by inspecting `Program.body[0]`.
+ *
+ * Tree-sitter's tsx/typescript grammars expose top-level directive strings as
+ * an `expression_statement` whose first named child is a `string` literal
+ * (a `"use client"` or `"use server"` token). Any other shape — including a
+ * nested block, inline comment, or non-first statement — must return `null`.
+ */
+export declare function confirmDirectiveFromTree(tree: Parser.Tree): "use client" | "use server" | null;
+/**
+ * Classify a single file. Returns a partial entry with the directive field
+ * populated. Signal detection + final classification are added by the
+ * orchestrator (Task 23) via `detectSignals` (Task 21) and
+ * `applyClassificationTable` (Task 22).
+ */
+export declare function classifyFile(filePath: string, repoRoot: string): Promise<NextjsComponentEntry>;
+/**
+ * Analyze a Next.js repository for Server/Client component classification.
+ *
+ * Flow:
+ *   1. Kill switch check (`CODESIFT_DISABLE_TOOLS`)
+ *   2. Resolve project root via `getCodeIndex(repo).root`
+ *   3. Determine workspaces: explicit `workspace` param, `discoverWorkspaces()`,
+ *      or single root.
+ *   4. For each workspace, walk `app/` for `.tsx`/`.jsx` files.
+ *   5. Process in batches of `PARSE_CONCURRENCY` — for each file:
+ *        a. `classifyFile` for directive
+ *        b. `detectSignals` on the parsed tree (re-parses — acceptable for v1)
+ *        c. `applyClassificationTable` to finalize classification + violations
+ *   6. Aggregate counts; honor `max_files`.
+ */
+export declare function analyzeNextjsComponents(repo: string, options?: AnalyzeNextjsComponentsOptions): Promise<NextjsComponentsResult>;
+//# sourceMappingURL=nextjs-component-tools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"nextjs-component-tools.d.ts","sourceRoot":"","sources":["../../src/tools/nextjs-component-tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,KAAK,MAAM,MAAM,iBAAiB,CAAC;AAU1C,MAAM,MAAM,uBAAuB,GAC/B,QAAQ,GACR,iBAAiB,GACjB,iBAAiB,GACjB,WAAW,CAAC;AAEhB,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,iBAAiB,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,EAAE,uBAAuB,CAAC;IACxC,SAAS,EAAE,YAAY,GAAG,YAAY,GAAG,IAAI,CAAC;IAC9C,OAAO,EAAE,gBAAgB,CAAC;IAC1B,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,sBAAsB,EAAE,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,oBAAoB,EAAE,CAAC;IAC9B,MAAM,EAAE,sBAAsB,CAAC;IAC/B,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,SAAS,EAAE,OAAO,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,8BAA8B;IAC7C,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAChC;AAMD,eAAO,MAAM,mBAAmB,UAAY,CAAC;AAC7C,eAAO,MAAM,iBAAiB,OAAO,CAAC;AACtC,eAAO,MAAM,iBAAiB,KAAK,CAAC;AAEpC,iFAAiF;AACjF,eAAO,MAAM,oBAAoB,aAA6B,CAAC;AAE/D,wDAAwD;AACxD,eAAO,MAAM,mBAAmB,aAU9B,CAAC;AAEH,8EAA8E;AAC9E,eAAO,MAAM,eAAe,aAG1B,CAAC;AAMH;;;;;;;;;;;GAWG;AACH,wBAAgB,wBAAwB,CACtC,SAAS,EAAE,YAAY,GAAG,YAAY,GAAG,IAAI,EAC7C,OAAO,EAAE,gBAAgB,GACxB;IAAE,cAAc,EAAE,uBAAuB,CAAC;IAAC,UAAU,EAAE,MAAM,EAAE,CAAA;CAAE,CAqBnE;AAQD;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,MAAM,CAAC,IAAI,EACjB,OAAO,EAAE,MAAM,GACd,gBAAgB,CAgGlB;AAMD;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,MAAM,CAAC,IAAI,GAChB,YAAY,GAAG,YAAY,GAAG,IAAI,CAkBpC;AAED;;;;;GAKG;AACH,wBAAsB,YAAY,CAChC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,oBAAoB,CAAC,CAqD/B;AASD;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,uBAAuB,CAC3C,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,8BAA8B,GACvC,OAAO,CAAC,sBAAsB,CAAC,CA8GjC"}