codesift-mcp 0.9.5 → 0.10.0

package/dist/tools/python-audit.d.ts

@@ -1,40 +1,4 @@
-export interface PythonAuditGate {
-    name: string;
-    status: "ok" | "error" | "timeout" | "skipped";
-    findings_count: number;
-    duration_ms: number;
-    error?: string;
-}
-export interface PythonAuditResult {
-    repo: string;
-    duration_ms: number;
-    checks_run: string[];
-    gates: PythonAuditGate[];
-    summary: {
-        total_findings: number;
-        critical: number;
-        high: number;
-        medium: number;
-        low: number;
-        health_score: number;
-        top_risks: string[];
-    };
-    findings: {
-        circular_imports?: number;
-        django_critical?: number;
-        django_high?: number;
-        anti_patterns?: number;
-        orphan_tasks?: number;
-        unpinned_deps?: number;
-        dead_code?: number;
-        fixture_count?: number;
-    };
-}
-/**
- * Run a compound Python project audit: 8 parallel checks with unified scoring.
- */
-export declare function pythonAudit(repo: string, options?: {
-    file_pattern?: string;
-    checks?: string[];
-}): Promise<PythonAuditResult>;
+import type { PythonAuditOptions, PythonAuditResult } from "./python-audit/types.js";
+export type { PythonAuditGate, PythonAuditResult, PythonAuditOptions } from "./python-audit/types.js";
+export declare function pythonAudit(repo: string, options?: PythonAuditOptions): Promise<PythonAuditResult>;
 //# sourceMappingURL=python-audit.d.ts.map

package/dist/tools/python-audit.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"python-audit.d.ts","sourceRoot":"","sources":["../../src/tools/python-audit.ts"],"names":[],"mappings":"AA0BA,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,IAAI,GAAG,OAAO,GAAG,SAAS,GAAG,SAAS,CAAC;IAC/C,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,KAAK,EAAE,eAAe,EAAE,CAAC;IACzB,OAAO,EAAE;QACP,cAAc,EAAE,MAAM,CAAC;QACvB,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,GAAG,EAAE,MAAM,CAAC;QACZ,YAAY,EAAE,MAAM,CAAC;QACrB,SAAS,EAAE,MAAM,EAAE,CAAC;KACrB,CAAC;IACF,QAAQ,EAAE;QACR,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,aAAa,CAAC,EAAE,MAAM,CAAC;KACxB,CAAC;CACH;AAoCD;;GAEG;AACH,wBAAsB,WAAW,CAC/B,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;IACR,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB,GACA,OAAO,CAAC,iBAAiB,CAAC,CA0N5B"}
+{"version":3,"file":"python-audit.d.ts","sourceRoot":"","sources":["../../src/tools/python-audit.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAY,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAE/F,YAAY,EAAE,eAAe,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAOtG,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAqBxG"}

package/dist/tools/python-audit.js

@@ -1,244 +1,45 @@
-/**
- * python_audit — compound Python project health check.
- *
- * Runs 8 checks in parallel with per-check timeouts:
- *   1. Circular imports (find_python_circular_imports)
- *   2. Django settings (analyze_django_settings) — only if Django project
- *   3. Python anti-patterns (search_patterns across 17 Python patterns)
- *   4. Framework wiring (find_framework_wiring)
- *   5. Celery orphan tasks (trace_celery_chain)
- *   6. pytest fixture issues (get_test_fixtures)
- *   7. pyproject dependency freshness (parse_pyproject)
- *   8. Dead code (find_dead_code on Python files)
- *
- * Produces a unified health score (0-100), severity counts, and a
- * prioritized top_risks list. Mirrors the shape of php_project_audit
- * so downstream report tooling can reuse formatters.
- */
+/** Public facade for the compound Python project health check. */
 import { getCodeIndex } from "./index-tools.js";
-import { findPythonCircularImports } from "./python-circular-imports.js";
-import { analyzeDjangoSettings } from "./django-settings.js";
-import { searchPatterns } from "./pattern-tools.js";
-import { findFrameworkWiring } from "./wiring-tools.js";
-import { traceCeleryChain } from "./celery-tools.js";
-import { getTestFixtures } from "./pytest-tools.js";
-import { parsePyproject } from "./pyproject-tools.js";
-const AUDIT_TIMEOUT = 10000;
-const PYTHON_PATTERNS = [
-    "mutable-default",
-    "bare-except",
-    "broad-except",
-    "eval-exec",
-    "shell-true",
-    "pickle-load",
-    "yaml-unsafe",
-    "shadow-builtin",
-    "n-plus-one-django",
-    "late-binding",
-    "assert-tuple",
+import { runCheck } from "./python-audit/runner.js";
+import { aggregateAudit } from "./python-audit/aggregate.js";
+import { runCircularImports } from "./python-audit/checks/circular-imports.js";
+import { runDjangoSettings } from "./python-audit/checks/django-settings.js";
+import { runAntiPatterns } from "./python-audit/checks/anti-patterns.js";
+import { runFrameworkWiring } from "./python-audit/checks/framework-wiring.js";
+import { runCelery } from "./python-audit/checks/celery.js";
+import { runPytestFixtures } from "./python-audit/checks/pytest-fixtures.js";
+import { runDependencies } from "./python-audit/checks/dependencies.js";
+import { runDeadCode } from "./python-audit/checks/dead-code.js";
+const ALL_CHECKS = [
+    "circular_imports", "django_settings", "anti_patterns", "framework_wiring",
+    "celery", "pytest_fixtures", "dependencies", "dead_code",
 ];
-/** Run one check with timeout and capture result + duration. */
-async function runCheck(name, fn) {
-    const start = Date.now();
-    try {
-        const result = await Promise.race([
-            fn(),
-            new Promise((resolve) => setTimeout(() => resolve("TIMEOUT"), AUDIT_TIMEOUT)),
-        ]);
-        return { name, result, ms: Date.now() - start };
-    }
-    catch (err) {
-        const msg = err instanceof Error ? err.message : String(err);
-        return { name, result: "ERROR", ms: Date.now() - start, error: msg };
-    }
-}
-/**
- * Run a compound Python project audit: 8 parallel checks with unified scoring.
- */
 export async function pythonAudit(repo, options) {
     const startTime = Date.now();
     const index = await getCodeIndex(repo);
     if (!index)
         throw new Error(`Repository "${repo}" not found.`);
-    // Detect if this is a Django project (only then run django settings check)
-    const hasDjangoFiles = index.files.some((f) => /\/settings\.py$|\/settings\/[\w_]+\.py$/.test(f.path));
-    const allChecks = [
-        "circular_imports",
-        "django_settings",
-        "anti_patterns",
-        "framework_wiring",
-        "celery",
-        "pytest_fixtures",
-        "dependencies",
-        "dead_code",
-    ];
-    const enabled = new Set(options?.checks ?? allChecks);
+    const hasDjangoFiles = index.files.some((file) => /\/settings\.py$|\/settings\/[\w_]+\.py$/.test(file.path));
+    const enabled = new Set(options?.checks ?? ALL_CHECKS);
+    const filePattern = options?.file_pattern;
     const tasks = [];
-    if (enabled.has("circular_imports")) {
-        tasks.push(runCheck("circular_imports", () => findPythonCircularImports(repo, options?.file_pattern ? { file_pattern: options.file_pattern } : undefined)));
-    }
-    if (enabled.has("django_settings") && hasDjangoFiles) {
-        tasks.push(runCheck("django_settings", () => analyzeDjangoSettings(repo)));
-    }
-    if (enabled.has("anti_patterns")) {
-        // Run all Python patterns in parallel, aggregate counts
-        tasks.push(runCheck("anti_patterns", async () => {
-            const results = await Promise.all(PYTHON_PATTERNS.map((p) => searchPatterns(repo, p, options?.file_pattern ? { file_pattern: options.file_pattern } : undefined)
-                .catch(() => ({ matches: [] }))));
-            const allMatches = results.flatMap((r) => r.matches ?? []);
-            return { matches: allMatches, total: allMatches.length };
-        }));
-    }
-    if (enabled.has("framework_wiring")) {
-        tasks.push(runCheck("framework_wiring", () => findFrameworkWiring(repo, options?.file_pattern ? { file_pattern: options.file_pattern } : undefined)));
-    }
-    if (enabled.has("celery")) {
-        tasks.push(runCheck("celery", () => traceCeleryChain(repo, options?.file_pattern ? { file_pattern: options.file_pattern } : undefined)));
-    }
-    if (enabled.has("pytest_fixtures")) {
-        tasks.push(runCheck("pytest_fixtures", () => getTestFixtures(repo, options?.file_pattern ? { file_pattern: options.file_pattern } : undefined)));
-    }
-    if (enabled.has("dependencies")) {
-        tasks.push(runCheck("dependencies", () => parsePyproject(repo)));
-    }
-    if (enabled.has("dead_code")) {
-        tasks.push(runCheck("dead_code", async () => {
-            const { findDeadCode } = await import("./symbol-tools.js");
-            return findDeadCode(repo, { file_pattern: ".py" });
-        }));
-    }
+    if (enabled.has("circular_imports"))
+        tasks.push(runCheck("circular_imports", () => runCircularImports(repo, filePattern)));
+    if (enabled.has("django_settings") && hasDjangoFiles)
+        tasks.push(runCheck("django_settings", () => runDjangoSettings(repo)));
+    if (enabled.has("anti_patterns"))
+        tasks.push(runCheck("anti_patterns", () => runAntiPatterns(repo, filePattern)));
+    if (enabled.has("framework_wiring"))
+        tasks.push(runCheck("framework_wiring", () => runFrameworkWiring(repo, filePattern)));
+    if (enabled.has("celery"))
+        tasks.push(runCheck("celery", () => runCelery(repo, filePattern)));
+    if (enabled.has("pytest_fixtures"))
+        tasks.push(runCheck("pytest_fixtures", () => runPytestFixtures(repo, filePattern)));
+    if (enabled.has("dependencies"))
+        tasks.push(runCheck("dependencies", () => runDependencies(repo)));
+    if (enabled.has("dead_code"))
+        tasks.push(runCheck("dead_code", () => runDeadCode(repo)));
     const results = await Promise.all(tasks);
-    // Build gates + aggregate findings
-    const gates = [];
-    const findings = {};
-    let critical = 0;
-    let high = 0;
-    let medium = 0;
-    let low = 0;
-    for (const r of results) {
-        if (r.result === "TIMEOUT") {
-            gates.push({ name: r.name, status: "timeout", findings_count: 0, duration_ms: r.ms });
-            continue;
-        }
-        if (r.result === "ERROR") {
-            const g = { name: r.name, status: "error", findings_count: 0, duration_ms: r.ms };
-            if (r.error)
-                g.error = r.error;
-            gates.push(g);
-            continue;
-        }
-        let count = 0;
-        const res = r.result;
-        switch (r.name) {
-            case "circular_imports": {
-                count = res.total ?? 0;
-                findings.circular_imports = count;
-                // Short cycles (≤3) are errors — count as high severity
-                const cycles = res.cycles ?? [];
-                high += cycles.filter((c) => c.severity === "error").length;
-                medium += cycles.filter((c) => c.severity === "warning").length;
-                break;
-            }
-            case "django_settings": {
-                const dj = res;
-                count = dj.findings?.length ?? 0;
-                findings.django_critical = dj.by_severity?.critical ?? 0;
-                findings.django_high = dj.by_severity?.high ?? 0;
-                critical += dj.by_severity?.critical ?? 0;
-                high += dj.by_severity?.high ?? 0;
-                medium += dj.by_severity?.medium ?? 0;
-                low += dj.by_severity?.low ?? 0;
-                break;
-            }
-            case "anti_patterns": {
-                count = res.total ?? 0;
-                findings.anti_patterns = count;
-                // All Python anti-patterns are medium unless proven otherwise
-                medium += count;
-                break;
-            }
-            case "framework_wiring": {
-                // Informational — not a finding
-                count = 0;
-                break;
-            }
-            case "celery": {
-                const orphans = res.orphan_tasks ?? [];
-                count = orphans.length;
-                findings.orphan_tasks = count;
-                low += count;
-                break;
-            }
-            case "pytest_fixtures": {
-                // Informational
-                count = 0;
-                findings.fixture_count = res.fixture_count ?? 0;
-                break;
-            }
-            case "dependencies": {
-                if (res && typeof res === "object" && "dependencies" in res) {
-                    const deps = res.dependencies ?? [];
-                    const unpinned = deps.filter((d) => d.version === "*" || d.version === "").length;
-                    count = unpinned;
-                    findings.unpinned_deps = unpinned;
-                    low += unpinned;
-                }
-                break;
-            }
-            case "dead_code": {
-                const candidates = res.candidates ?? [];
-                count = candidates.length;
-                findings.dead_code = count;
-                low += count;
-                break;
-            }
-        }
-        gates.push({ name: r.name, status: "ok", findings_count: count, duration_ms: r.ms });
-    }
-    // Skipped checks (not run because not applicable)
-    if (enabled.has("django_settings") && !hasDjangoFiles) {
-        gates.push({ name: "django_settings", status: "skipped", findings_count: 0, duration_ms: 0 });
-    }
-    // Compute health score: 100 - weighted penalties
-    //   critical = -15, high = -8, medium = -3, low = -1, floor at 0
-    const rawScore = 100 - critical * 15 - high * 8 - medium * 3 - low;
-    const health_score = Math.max(0, Math.min(100, rawScore));
-    const total_findings = critical + high + medium + low;
-    // Top risks: most severe categories first
-    const top_risks = [];
-    if ((findings.django_critical ?? 0) > 0) {
-        top_risks.push(`Django: ${findings.django_critical} critical security issues in settings.py`);
-    }
-    if ((findings.circular_imports ?? 0) > 0) {
-        top_risks.push(`${findings.circular_imports} circular import cycles detected`);
-    }
-    if ((findings.anti_patterns ?? 0) > 5) {
-        top_risks.push(`${findings.anti_patterns} Python anti-pattern matches`);
-    }
-    if ((findings.orphan_tasks ?? 0) > 0) {
-        top_risks.push(`${findings.orphan_tasks} orphan Celery tasks (defined but never called)`);
-    }
-    if ((findings.unpinned_deps ?? 0) > 0) {
-        top_risks.push(`${findings.unpinned_deps} unpinned dependencies`);
-    }
-    if ((findings.dead_code ?? 0) > 10) {
-        top_risks.push(`${findings.dead_code} dead code candidates`);
-    }
-    return {
-        repo,
-        duration_ms: Date.now() - startTime,
-        checks_run: gates.map((g) => g.name),
-        gates,
-        summary: {
-            total_findings,
-            critical,
-            high,
-            medium,
-            low,
-            health_score,
-            top_risks,
-        },
-        findings,
-    };
+    return aggregateAudit(repo, startTime, results, enabled, hasDjangoFiles);
 }
 //# sourceMappingURL=python-audit.js.map

package/dist/tools/python-audit.js.map

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

package/dist/tools/react-compiler-tools.d.ts

@@ -0,0 +1,37 @@
+export interface CompilerReadinessResult {
+    /** 0-100 readiness score (100 = fully compatible) */
+    readiness_score: number;
+    total_components: number;
+    /** Components with 0 bailout patterns */
+    compatible_components: number;
+    /** Components with ≥1 bailout pattern */
+    bailout_components: number;
+    /** Count of redundant manual memoization (safe to remove post-adoption) */
+    redundant_memoization: number;
+    /** Bailout issues by pattern, sorted by frequency */
+    issues: Array<{
+        pattern: string;
+        count: number;
+        description: string;
+    }>;
+    /** Top components with most bailout issues */
+    top_bailout_components: Array<{
+        name: string;
+        file: string;
+        issues: number;
+    }>;
+}
+/**
+ * Audit a React codebase for React Compiler (v1.0) adoption readiness.
+ *
+ * Scans all components for patterns that cause the compiler to silently
+ * bail out of auto-memoization. Returns a readiness score (0-100) with
+ * prioritized fix list.
+ *
+ * No competitor offers codebase-wide compiler readiness analysis.
+ */
+export declare function auditCompilerReadiness(repo: string, options?: {
+    file_pattern?: string | undefined;
+    include_tests?: boolean | undefined;
+}): Promise<CompilerReadinessResult>;
+//# sourceMappingURL=react-compiler-tools.d.ts.map

package/dist/tools/react-compiler-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"react-compiler-tools.d.ts","sourceRoot":"","sources":["../../src/tools/react-compiler-tools.ts"],"names":[],"mappings":"AAoBA,MAAM,WAAW,uBAAuB;IACtC,qDAAqD;IACrD,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,EAAE,MAAM,CAAC;IACzB,yCAAyC;IACzC,qBAAqB,EAAE,MAAM,CAAC;IAC9B,yCAAyC;IACzC,kBAAkB,EAAE,MAAM,CAAC;IAC3B,2EAA2E;IAC3E,qBAAqB,EAAE,MAAM,CAAC;IAC9B,qDAAqD;IACrD,MAAM,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACvE,8CAA8C;IAC9C,sBAAsB,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC/E;AAED;;;;;;;;GAQG;AACH,wBAAsB,sBAAsB,CAC1C,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;IACR,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,aAAa,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CACrC,GACA,OAAO,CAAC,uBAAuB,CAAC,CAsFlC"}

package/dist/tools/react-compiler-tools.js

@@ -0,0 +1,104 @@
+/**
+ * React Compiler adoption readiness analysis.
+ */
+import { getCodeIndex } from "./index-tools.js";
+import { isTestFileStrict as isTestFile } from "../utils/test-file.js";
+// ─────────────────────────────────────────────────────────────
+// audit_compiler_readiness — React Compiler adoption readiness
+// ─────────────────────────────────────────────────────────────
+const COMPILER_PATTERNS = [
+    "compiler-side-effect-in-render",
+    "compiler-ref-read-in-render",
+    "compiler-prop-mutation",
+    "compiler-state-mutation",
+    "compiler-try-catch-bailout",
+    "compiler-redundant-memo",
+    "compiler-redundant-usecallback",
+];
+/**
+ * Audit a React codebase for React Compiler (v1.0) adoption readiness.
+ *
+ * Scans all components for patterns that cause the compiler to silently
+ * bail out of auto-memoization. Returns a readiness score (0-100) with
+ * prioritized fix list.
+ *
+ * No competitor offers codebase-wide compiler readiness analysis.
+ */
+export async function auditCompilerReadiness(repo, options) {
+    const { searchPatterns } = await import("./pattern-tools.js");
+    const index = await getCodeIndex(repo);
+    if (!index)
+        throw new Error(`Repository not found: ${repo}`);
+    const includeTests = options?.include_tests ?? false;
+    const filePattern = options?.file_pattern;
+    // Count total components
+    let components = index.symbols.filter((s) => s.kind === "component");
+    if (!includeTests)
+        components = components.filter((s) => !isTestFile(s.file));
+    if (filePattern)
+        components = components.filter((s) => s.file.includes(filePattern));
+    const totalComponents = components.length;
+    // Run all compiler patterns in parallel
+    const patternResults = await Promise.all(COMPILER_PATTERNS.map(async (pattern) => {
+        try {
+            const result = await searchPatterns(repo, pattern, {
+                file_pattern: filePattern,
+                include_tests: includeTests,
+                max_results: 200,
+            });
+            return { pattern, matches: result.matches, description: result.pattern };
+        }
+        catch {
+            return { pattern, matches: [], description: pattern };
+        }
+    }));
+    // Aggregate: which components have bailout issues
+    const componentIssues = new Map(); // "name@file" → issue count
+    let redundantMemoization = 0;
+    const issues = [];
+    for (const { pattern, matches, description } of patternResults) {
+        if (matches.length === 0)
+            continue;
+        const isRedundant = pattern === "compiler-redundant-memo" || pattern === "compiler-redundant-usecallback";
+        if (isRedundant) {
+            redundantMemoization += matches.length;
+        }
+        issues.push({
+            pattern,
+            count: matches.length,
+            description: description.split(": ").slice(1).join(": ") || description,
+        });
+        for (const m of matches) {
+            if (!isRedundant) {
+                const key = `${m.name}@${m.file}`;
+                componentIssues.set(key, (componentIssues.get(key) ?? 0) + 1);
+            }
+        }
+    }
+    // Sort issues by count descending
+    issues.sort((a, b) => b.count - a.count);
+    // Top bailout components
+    const top_bailout_components = [...componentIssues.entries()]
+        .sort((a, b) => b[1] - a[1])
+        .slice(0, 10)
+        .map(([key, count]) => {
+        const [name, file] = key.split("@");
+        return { name: name, file: file, issues: count };
+    });
+    const bailoutCount = componentIssues.size;
+    const compatibleCount = Math.max(0, totalComponents - bailoutCount);
+    // Readiness score: percentage of components without bailout issues
+    const readiness_score = totalComponents > 0
+        ? Math.round((compatibleCount / totalComponents) * 100)
+        : 100; // empty repo = ready
+    return {
+        readiness_score,
+        total_components: totalComponents,
+        compatible_components: compatibleCount,
+        bailout_components: bailoutCount,
+        redundant_memoization: redundantMemoization,
+        issues,
+        top_bailout_components,
+    };
+}
+//# sourceMappingURL=react-compiler-tools.js.map

package/dist/tools/react-compiler-tools.js.map

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

package/dist/tools/react-component-tree-tools.d.ts

@@ -0,0 +1,58 @@
+import type { CodeSymbol, CallNode } from "../types.js";
+interface JsxAdjacency {
+    /** component id → components it renders */
+    children: Map<string, CodeSymbol[]>;
+}
+/**
+ * Extract PascalCase JSX element names from source code.
+ * Returns the set of component names used via `<ComponentName ...>` or `<ComponentName/>`.
+ * HTML elements (lowercase) are skipped.
+ */
+declare function extractJsxComponents(source: string): Set<string>;
+/**
+ * Build component → rendered-components adjacency from the index.
+ * Only considers symbols with kind "component" (requires Wave 1 extractor).
+ */
+declare function buildJsxAdjacency(symbols: CodeSymbol[]): JsxAdjacency;
+/**
+ * Invert JsxAdjacency to a reverse adjacency: child id → sorted list of parent ids.
+ *
+ * Used by computePropChainDepth to walk UP the render tree (from a leaf back toward
+ * roots) and measure render-tree depth. Sorts each parent list alphabetically for
+ * deterministic output on cyclic graphs.
+ */
+declare function buildReverseAdjacency(adjacency: JsxAdjacency): Map<string, string[]>;
+/**
+ * Compute the longest path (in edges) from componentId UP to the deepest root in
+ * the reverse JSX adjacency. This is render-tree depth — NOT prop-flow depth.
+ *
+ * Iterative implementation using an explicit 2-phase ("enter"/"exit") stack to
+ * avoid recursive blowup on deep linear chains (V8 stack ~10-15K frames).
+ *
+ * Uses shared `memo` and `inProgress` across all calls in one analyzeRenders run
+ * to amortize cost to O(V+E) total.
+ */
+declare function computePropChainDepth(componentId: string, reverseAdjacency: Map<string, string[]>, memo: Map<string, number>, inProgress: Set<string>): number;
+/**
+ * BFS the component composition tree from a root component.
+ * Returns a CallNode tree of rendered components up to maxDepth.
+ */
+declare function buildComponentTree(root: CodeSymbol, adjacency: JsxAdjacency, maxDepth: number): CallNode;
+export interface TraceComponentTreeOptions {
+    depth?: number | undefined;
+    output_format?: "json" | "mermaid" | undefined;
+    include_source?: boolean | undefined;
+    include_tests?: boolean | undefined;
+}
+/**
+ * Trace the React component composition tree from a root component.
+ * Returns a tree of JSX children (which components the root renders,
+ * and recursively their children).
+ */
+export declare function traceComponentTree(repo: string, rootComponent: string, options?: TraceComponentTreeOptions): Promise<CallNode | {
+    mermaid: string;
+    root: string;
+    depth: number;
+}>;
+export { buildJsxAdjacency, buildComponentTree, extractJsxComponents, buildReverseAdjacency, computePropChainDepth };
+//# sourceMappingURL=react-component-tree-tools.d.ts.map

package/dist/tools/react-component-tree-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"react-component-tree-tools.d.ts","sourceRoot":"","sources":["../../src/tools/react-component-tree-tools.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAUxD,UAAU,YAAY;IACpB,2CAA2C;IAC3C,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;CACrC;AAED;;;;GAIG;AACH,iBAAS,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CAQzD;AAED;;;GAGG;AACH,iBAAS,iBAAiB,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,YAAY,CA2E9D;AAMD;;;;;;GAMG;AACH,iBAAS,qBAAqB,CAAC,SAAS,EAAE,YAAY,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAY7E;AAED;;;;;;;;;GASG;AACH,iBAAS,qBAAqB,CAC5B,WAAW,EAAE,MAAM,EACnB,gBAAgB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,EACvC,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EACzB,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,GACtB,MAAM,CAuCR;AAED;;;GAGG;AACH,iBAAS,kBAAkB,CACzB,IAAI,EAAE,UAAU,EAChB,SAAS,EAAE,YAAY,EACvB,QAAQ,EAAE,MAAM,GACf,QAAQ,CAsBV;AA8CD,MAAM,WAAW,yBAAyB;IACxC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAAC;IAC/C,cAAc,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACrC,aAAa,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CACrC;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,MAAM,EACZ,aAAa,EAAE,MAAM,EACrB,OAAO,CAAC,EAAE,yBAAyB,GAClC,OAAO,CAAC,QAAQ,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAmCtE;AAED,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,CAAC"}