codesift-mcp 0.3.0 → 0.5.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-readers.d.ts

@@ -0,0 +1,101 @@
+/**
+ * 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 type Parser from "web-tree-sitter";
+export type ComponentClassification = "server" | "client_explicit" | "client_inferred" | "ambiguous";
+export interface SignalLocation {
+    name: string;
+    line: number;
+    column: number;
+}
+export interface ComponentSignals {
+    hooks: string[];
+    event_handlers: string[];
+    browser_globals: string[];
+    dynamic_ssr_false: boolean;
+    /**
+     * Precise source locations for each detected signal. Agents use this to
+     * jump directly to the fix site without re-parsing the file. Populated
+     * for hooks, event_handlers, and browser_globals. dynamic_ssr_false is
+     * file-level so no location is tracked.
+     */
+    signal_locations: SignalLocation[];
+}
+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 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>;
+export declare const HOOK_NAME_RE: RegExp;
+/**
+ * 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>;
+//# sourceMappingURL=nextjs-component-readers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"nextjs-component-readers.d.ts","sourceRoot":"","sources":["../../src/tools/nextjs-component-readers.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,MAAM,MAAM,iBAAiB,CAAC;AAQ1C,MAAM,MAAM,uBAAuB,GAC/B,QAAQ,GACR,iBAAiB,GACjB,iBAAiB,GACjB,WAAW,CAAC;AAEhB,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,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;IAC3B;;;;;OAKG;IACH,gBAAgB,EAAE,cAAc,EAAE,CAAC;CACpC;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;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;AAEH,eAAO,MAAM,YAAY,QAAkB,CAAC;AAM5C;;;;;;;;;;;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;AAMD;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,MAAM,CAAC,IAAI,EACjB,OAAO,EAAE,MAAM,GACd,gBAAgB,CAiHlB;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"}

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

@@ -0,0 +1,51 @@
+/**
+ * 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.
+ *
+ * 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 { 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;
+    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;
+}
+/**
+ * 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;;;;;;;;;;;;;;;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"}