codesift-mcp 0.4.0 → 0.5.3

package/dist/tools/nextjs-component-readers.js

@@ -0,0 +1,287 @@
+/**
+ * Next.js component classifier readers: directive detection, signal walking,
+ * per-file classification logic, and the decision table.
+ *
+ * These readers are pure helpers with no orchestration logic. They are used by
+ * `nextjs-component-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 { readFile } from "node:fs/promises";
+import { relative } from "node:path";
+import { cachedParseFile as parseFile } from "../utils/nextjs-audit-cache.js";
+import { scanDirective } from "../utils/nextjs.js";
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+export const MAX_FILE_SIZE_BYTES = 2_097_152; // 2 MB hard cap per file
+export const DEFAULT_MAX_FILES = 2000;
+export const PARSE_CONCURRENCY = 10;
+/** Hooks that are server-safe (or SSR-safe) and don't imply client component. */
+export const CLIENT_HOOKS_EXCLUDE = new Set(["useId"]);
+/** JSX event attributes that imply client component. */
+export const EVENT_HANDLER_ATTRS = new Set([
+    "onClick", "onChange", "onSubmit", "onInput", "onFocus", "onBlur",
+    "onKeyDown", "onKeyUp", "onKeyPress",
+    "onMouseDown", "onMouseUp", "onMouseMove", "onMouseEnter", "onMouseLeave", "onMouseOver", "onMouseOut",
+    "onTouchStart", "onTouchEnd", "onTouchMove",
+    "onDrag", "onDrop", "onDragOver", "onDragEnd", "onDragStart", "onDragLeave", "onDragEnter",
+    "onScroll", "onWheel",
+    "onAnimationStart", "onAnimationEnd", "onTransitionEnd",
+    "onLoad", "onError",
+    "onCopy", "onCut", "onPaste",
+]);
+/** Browser-only globals (detected in MemberExpressions like `window.foo`). */
+export const BROWSER_GLOBALS = new Set([
+    "window", "document", "localStorage", "sessionStorage",
+    "navigator", "location", "history",
+]);
+export const HOOK_NAME_RE = /^use[A-Z]\w*$/;
+// ---------------------------------------------------------------------------
+// Classification decision table
+// ---------------------------------------------------------------------------
+/**
+ * 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 function applyClassificationTable(directive, signals) {
+    const hasAnySignal = signals.hooks.length > 0 ||
+        signals.event_handlers.length > 0 ||
+        signals.browser_globals.length > 0 ||
+        signals.dynamic_ssr_false;
+    if (directive === "use client") {
+        return {
+            classification: "client_explicit",
+            violations: hasAnySignal ? [] : ["unnecessary_use_client"],
+        };
+    }
+    if (directive === "use server") {
+        return { classification: "server", violations: [] };
+    }
+    // directive === null
+    return {
+        classification: hasAnySignal ? "client_inferred" : "server",
+        violations: [],
+    };
+}
+// ---------------------------------------------------------------------------
+// Signal detection (hooks, JSX event handlers, browser globals, next/dynamic)
+// ---------------------------------------------------------------------------
+/**
+ * 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 function detectSignals(tree, _source) {
+    const hooks = new Set();
+    const event_handlers = new Set();
+    const browser_globals = new Set();
+    const signal_locations = [];
+    let dynamic_ssr_false = false;
+    const root = tree.rootNode;
+    // Hooks: call_expression with identifier callee matching /^use[A-Z]/
+    for (const call of root.descendantsOfType("call_expression")) {
+        const fn = call.childForFieldName("function") ?? call.namedChild(0);
+        if (fn?.type === "identifier") {
+            const name = fn.text;
+            if (HOOK_NAME_RE.test(name) && !CLIENT_HOOKS_EXCLUDE.has(name)) {
+                hooks.add(name);
+                signal_locations.push({
+                    name,
+                    line: fn.startPosition.row + 1,
+                    column: fn.startPosition.column + 1,
+                });
+            }
+        }
+    }
+    // JSX event handlers
+    for (const attr of root.descendantsOfType("jsx_attribute")) {
+        const nameNode = attr.namedChild(0);
+        if (nameNode?.type === "property_identifier" || nameNode?.type === "identifier") {
+            const name = nameNode.text;
+            if (EVENT_HANDLER_ATTRS.has(name)) {
+                event_handlers.add(name);
+                signal_locations.push({
+                    name,
+                    line: nameNode.startPosition.row + 1,
+                    column: nameNode.startPosition.column + 1,
+                });
+            }
+        }
+    }
+    // Browser globals via member_expression (e.g. window.location)
+    for (const mem of root.descendantsOfType("member_expression")) {
+        const obj = mem.childForFieldName("object") ?? mem.namedChild(0);
+        if (obj?.type === "identifier" && BROWSER_GLOBALS.has(obj.text)) {
+            browser_globals.add(obj.text);
+            signal_locations.push({
+                name: obj.text,
+                line: obj.startPosition.row + 1,
+                column: obj.startPosition.column + 1,
+            });
+        }
+    }
+    // next/dynamic with { ssr: false }
+    // Only trust if there's an import from "next/dynamic". We then look for any
+    // call expression with second argument containing { ssr: false }.
+    const importsNextDynamic = root
+        .descendantsOfType("import_statement")
+        .some((imp) => {
+        // The module source is a direct string child of import_statement
+        for (const child of imp.namedChildren) {
+            if (child.type === "string") {
+                const frag = child.namedChild(0);
+                const text = frag?.type === "string_fragment" ? frag.text : child.text.slice(1, -1);
+                if (text === "next/dynamic")
+                    return true;
+            }
+        }
+        return false;
+    });
+    if (importsNextDynamic) {
+        for (const call of root.descendantsOfType("call_expression")) {
+            const fn = call.childForFieldName("function") ?? call.namedChild(0);
+            if (fn?.type !== "identifier" || fn.text !== "dynamic")
+                continue;
+            const args = call.childForFieldName("arguments") ?? call.namedChild(1);
+            if (!args)
+                continue;
+            // Find the second argument (an object with ssr: false)
+            const argChildren = args.namedChildren;
+            if (argChildren.length < 2)
+                continue;
+            const opts = argChildren[1];
+            if (!opts || opts.type !== "object")
+                continue;
+            // Iterate pairs that are direct named children of the options object.
+            for (const pair of opts.namedChildren) {
+                if (pair.type !== "pair")
+                    continue;
+                const key = pair.childForFieldName("key") ?? pair.namedChild(0);
+                if (!key)
+                    continue;
+                const keyText = key.type === "property_identifier" || key.type === "identifier"
+                    ? key.text
+                    : key.type === "string"
+                        ? key.text.slice(1, -1)
+                        : null;
+                if (keyText !== "ssr")
+                    continue;
+                const value = pair.childForFieldName("value") ?? pair.namedChild(1);
+                if (value?.type === "false") {
+                    dynamic_ssr_false = true;
+                    break;
+                }
+            }
+        }
+    }
+    return {
+        hooks: [...hooks],
+        event_handlers: [...event_handlers],
+        browser_globals: [...browser_globals],
+        dynamic_ssr_false,
+        signal_locations,
+    };
+}
+// ---------------------------------------------------------------------------
+// Two-stage directive detection
+// ---------------------------------------------------------------------------
+/**
+ * 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 function confirmDirectiveFromTree(tree) {
+    const root = tree.rootNode;
+    const first = root.namedChildren[0];
+    if (!first)
+        return null;
+    if (first.type !== "expression_statement")
+        return null;
+    const exprChild = first.namedChildren[0];
+    if (!exprChild)
+        return null;
+    if (exprChild.type !== "string")
+        return null;
+    // tree-sitter `string` nodes have fragment children containing the text
+    // between the quotes. Strip the surrounding quotes via .text and compare.
+    const raw = exprChild.text;
+    if (raw.length < 3)
+        return null;
+    const inner = raw.slice(1, -1);
+    if (inner === "use client")
+        return "use client";
+    if (inner === "use server")
+        return "use server";
+    return 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 async function classifyFile(filePath, repoRoot) {
+    const relPath = relative(repoRoot, filePath);
+    const emptySignals = {
+        hooks: [],
+        event_handlers: [],
+        browser_globals: [],
+        dynamic_ssr_false: false,
+    };
+    // Stage 1: fast-reject via 512-byte window
+    const stage1 = await scanDirective(filePath);
+    // Stage 2: parse file via tree-sitter
+    let source;
+    try {
+        source = await readFile(filePath, "utf8");
+    }
+    catch {
+        return {
+            path: relPath,
+            classification: "ambiguous",
+            directive: null,
+            signals: emptySignals,
+            violations: [],
+        };
+    }
+    const tree = await parseFile(filePath, source);
+    if (!tree) {
+        return {
+            path: relPath,
+            classification: "ambiguous",
+            directive: null,
+            signals: emptySignals,
+            violations: [],
+        };
+    }
+    // Stage 3: confirm directive via AST (only if stage 1 matched)
+    let directive = null;
+    if (stage1 !== null) {
+        directive = confirmDirectiveFromTree(tree);
+    }
+    // Note: signal detection and final classification are layered in by
+    // Tasks 21-23. For now we return a stub classification — the orchestrator
+    // rebuilds this via detectSignals + applyClassificationTable.
+    return {
+        path: relPath,
+        classification: directive === "use client" ? "client_explicit" : "server",
+        directive,
+        signals: emptySignals,
+        violations: [],
+    };
+}
+//# sourceMappingURL=nextjs-component-readers.js.map

package/dist/tools/nextjs-component-readers.js.map

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

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

@@ -8,36 +8,15 @@
  * 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.
+ *
+ * This file is the orchestrator. AST reader helpers (`applyClassificationTable`,
+ * `detectSignals`, `confirmDirectiveFromTree`, `classifyFile`) live in
+ * `nextjs-component-readers.ts` and are re-exported from here for backward
+ * compatibility.
  */
-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;
-}
+import type { NextjsComponentEntry, NextjsComponentsCounts } from "./nextjs-component-readers.js";
+export { MAX_FILE_SIZE_BYTES, DEFAULT_MAX_FILES, PARSE_CONCURRENCY, CLIENT_HOOKS_EXCLUDE, EVENT_HANDLER_ATTRS, BROWSER_GLOBALS, HOOK_NAME_RE, applyClassificationTable, detectSignals, confirmDirectiveFromTree, classifyFile, } from "./nextjs-component-readers.js";
+export type { ComponentClassification, SignalLocation, ComponentSignals, NextjsComponentEntry, NextjsComponentsCounts, } from "./nextjs-component-readers.js";
 export interface NextjsComponentsResult {
     files: NextjsComponentEntry[];
     counts: NextjsComponentsCounts;
@@ -53,55 +32,6 @@ export interface AnalyzeNextjsComponentsOptions {
     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.
  *

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

@@ -1 +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"}
+{"version":3,"file":"nextjs-component-tools.d.ts","sourceRoot":"","sources":["../../src/tools/nextjs-component-tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAgBH,OAAO,KAAK,EAEV,oBAAoB,EACpB,sBAAsB,EACvB,MAAM,+BAA+B,CAAC;AAGvC,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EACjB,iBAAiB,EACjB,oBAAoB,EACpB,mBAAmB,EACnB,eAAe,EACf,YAAY,EACZ,wBAAwB,EACxB,aAAa,EACb,wBAAwB,EACxB,YAAY,GACb,MAAM,+BAA+B,CAAC;AACvC,YAAY,EACV,uBAAuB,EACvB,cAAc,EACd,gBAAgB,EAChB,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,+BAA+B,CAAC;AAMvC,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;AASD;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,uBAAuB,CAC3C,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,8BAA8B,GACvC,OAAO,CAAC,sBAAsB,CAAC,CA8GjC"}