codesift-mcp 0.5.24 → 0.5.28

package/dist/utils/ts-imports.js

@@ -0,0 +1,168 @@
+/**
+ * ts-imports.ts — tree-sitter AST extractor for TypeScript/TSX imports + re-exports.
+ *
+ * Mirrors the structure of `python-imports.ts`. The graph builder calls
+ * `extractTypeScriptImports(tree)` to walk `import_statement` and
+ * `export_statement` (with `source` field) nodes; it returns flat edges with
+ * an `is_type_only` flag derived from statement-level OR per-specifier `type`
+ * modifiers.
+ *
+ * Detection rules:
+ *   - statement-level `import type { X } from "y"` → all specifiers type-only
+ *   - per-specifier `import { type X, Y } from "y"` → type_only:false (any
+ *     runtime specifier present makes the entire edge runtime; the import is
+ *     loaded at runtime regardless of which subset is used as types only)
+ *   - `import * as ns from "y"` / default / side-effect → runtime
+ *   - `export { X } from "y"` → runtime; `export type { X } from "y"` → type_only:true
+ *   - `export * from "y"` → runtime; `export type * from "y"` → type_only:true
+ */
+/** True when this statement node has a top-level `type` keyword child
+ * (e.g., `import type {...}` or `export type {...}`).
+ *
+ * Some grammar versions wrap `type` inside an ERROR node for niche syntaxes
+ * like `export type * from "y"`. We walk one level into ERROR children to
+ * handle that case. */
+function statementIsTypeOnly(node) {
+    for (const child of node.children) {
+        if (child.type === "type" && child.text === "type")
+            return true;
+        if (child.type === "ERROR") {
+            for (const inner of child.children) {
+                if (inner.type === "type" && inner.text === "type")
+                    return true;
+            }
+        }
+    }
+    return false;
+}
+/** Extract source string from `import_statement` or `export_statement` source field.
+ * Returns undefined when the statement has no `from` clause (e.g. local export). */
+function getSourcePath(node) {
+    // import_statement: source field directly
+    // export_statement: also exposes source field when `from` is present
+    const sourceField = node.childForFieldName("source");
+    if (sourceField) {
+        return sourceField.text.replace(/^['"`]|['"`]$/g, "");
+    }
+    // Fallback: scan named children for a `string` node (some grammar variants
+    // expose it without a named field)
+    for (const child of node.namedChildren) {
+        if (child.type === "string") {
+            return child.text.replace(/^['"`]|['"`]$/g, "");
+        }
+    }
+    return undefined;
+}
+/** Walk an `import_clause` to collect specifiers.
+ * Returns { specifiers, anyRuntimeSpecifier }. anyRuntimeSpecifier is true when
+ * at least one specifier is NOT prefixed with `type` (per-specifier modifier).
+ * For default + namespace imports (no named clause) anyRuntimeSpecifier=true. */
+function walkImportClause(clause) {
+    const specifiers = [];
+    let anyRuntimeSpecifier = false;
+    for (const child of clause.namedChildren) {
+        if (child.type === "named_imports") {
+            // import_specifier nodes; check each for leading `type` keyword
+            for (const spec of child.namedChildren) {
+                if (spec.type !== "import_specifier")
+                    continue;
+                const nameNode = spec.childForFieldName("name");
+                const aliasNode = spec.childForFieldName("alias");
+                const emitName = (aliasNode ?? nameNode)?.text;
+                if (emitName)
+                    specifiers.push(emitName);
+                // Per-specifier `type`: an `import_specifier` with the keyword `type`
+                // as its first child token.
+                const isTyped = spec.children.some((c) => c.type === "type" && c.text === "type");
+                if (!isTyped)
+                    anyRuntimeSpecifier = true;
+            }
+        }
+        else if (child.type === "namespace_import") {
+            // import * as ns — runtime
+            anyRuntimeSpecifier = true;
+            const id = child.namedChildren.find((c) => c.type === "identifier");
+            if (id)
+                specifiers.push(id.text);
+        }
+        else if (child.type === "identifier") {
+            // default import — runtime
+            anyRuntimeSpecifier = true;
+            specifiers.push(child.text);
+        }
+    }
+    return { specifiers, anyRuntimeSpecifier };
+}
+/** Walk an `export_clause` (named re-exports) to collect names.
+ * Returns specifiers list. Type-only-ness is derived from the parent
+ * export_statement, not per-specifier here (TS does not distinguish at the
+ * specifier level inside `export {X} from "y"` to the same extent as imports). */
+function walkExportClause(clause) {
+    const specifiers = [];
+    for (const spec of clause.namedChildren) {
+        if (spec.type !== "export_specifier")
+            continue;
+        const nameNode = spec.childForFieldName("name");
+        const aliasNode = spec.childForFieldName("alias");
+        const emitName = (aliasNode ?? nameNode)?.text;
+        if (emitName)
+            specifiers.push(emitName);
+    }
+    return specifiers;
+}
+/** Walk the tree and return all import + re-export edges. */
+export function extractTypeScriptImports(tree) {
+    const edges = [];
+    function visit(node) {
+        if (node.type === "import_statement") {
+            const path = getSourcePath(node);
+            if (!path)
+                return; // malformed; skip
+            const stmtTypeOnly = statementIsTypeOnly(node);
+            const importClause = node.namedChildren.find((c) => c.type === "import_clause");
+            if (!importClause) {
+                // side-effect import: `import "x"`
+                edges.push({ path, is_type_only: stmtTypeOnly, specifiers: [] });
+                return;
+            }
+            const { specifiers, anyRuntimeSpecifier } = walkImportClause(importClause);
+            // Edge is type_only only when statement-level `type` modifier is present
+            // OR when every named specifier is per-specifier-typed (no runtime member).
+            const is_type_only = stmtTypeOnly || !anyRuntimeSpecifier;
+            edges.push({ path, is_type_only, specifiers });
+            return;
+        }
+        if (node.type === "export_statement") {
+            const path = getSourcePath(node);
+            if (!path) {
+                // Local export with no `from` clause; recurse into children for nested
+                // re-exports (rare). Continue walking.
+                for (const c of node.namedChildren)
+                    visit(c);
+                return;
+            }
+            const is_type_only = statementIsTypeOnly(node);
+            let specifiers = [];
+            for (const child of node.namedChildren) {
+                if (child.type === "export_clause") {
+                    specifiers = walkExportClause(child);
+                }
+                // namespace_export `export * as ns from "y"` → record `ns` as specifier
+                if (child.type === "namespace_export") {
+                    const id = child.namedChildren.find((c) => c.type === "identifier");
+                    if (id)
+                        specifiers.push(id.text);
+                }
+            }
+            edges.push({ path, is_type_only, specifiers });
+            return;
+        }
+        // Recurse into children for top-level scan (most imports are at root, but
+        // some declarations nest them — e.g., declare module).
+        for (const c of node.namedChildren)
+            visit(c);
+    }
+    visit(tree.rootNode);
+    return edges;
+}
+//# sourceMappingURL=ts-imports.js.map

package/dist/utils/ts-imports.js.map

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

package/dist/utils/tsconfig-paths.d.ts

@@ -0,0 +1,59 @@
+/**
+ * tsconfig-paths.ts — resolves `@/foo` style aliased imports against the nearest
+ * `tsconfig.json`, using `get-tsconfig` for `extends`-chain + paths handling.
+ *
+ * Two-level cache keeps long-running MCP server processes happy:
+ *   - `dirToConfigCache`: directory absolute path → nearest tsconfig.json path
+ *     (or null when none found up to repoRoot).
+ *   - `configCache`: tsconfig.json absolute path → parsed { matcher, baseUrl }.
+ *
+ * Both caches are cleared on `clearTsconfigCache()`. The graph builder calls
+ * this at the start of every `index_folder` so config edits between runs take
+ * effect.
+ *
+ * IMPORTANT: when probing `TS_EXTENSIONS`, the empty-string entry that handles
+ * exact-file aliases (`paths: { "foo": ["src/foo.ts"] }`) MUST gate on
+ * `statSync(candidate).isFile()` — `existsSync` returns true for both files
+ * and directories, and a directory match would return the dir path, then fail
+ * the downstream `normalizedPaths.get(resolved)` lookup (file-only), silently
+ * dropping the edge for `@/components/Button` style aliases pointing at a
+ * directory with `index.ts`.
+ */
+interface ResolvedTsconfig {
+    pathsMatcher: ((specifier: string) => string[]) | null;
+    baseUrl: string | null;
+    configPath: string;
+}
+/** Clear both caches. Called at the start of `index_folder`. */
+export declare function clearTsconfigCache(): void;
+/** Walk up from `dir` to `repoRoot`, find nearest `tsconfig.json`.
+ * Returns absolute path of the config file, or null if none found.
+ * Caches every ancestor visited during the walk, not just the input dir,
+ * so sibling lookups under the same parent are O(1). */
+declare function findNearestTsconfig(dir: string, repoRoot: string): string | null;
+/** Parse a tsconfig.json (with `extends` chain) and build a paths matcher.
+ * Returns null on parse error. Caches successful parses only — failures are
+ * NOT cached so a user fixing a malformed tsconfig.json mid-session does not
+ * stay broken until the next full index_folder. */
+declare function loadTsconfig(configPath: string): ResolvedTsconfig | null;
+/** Probe candidate path against TS_EXTENSIONS. Returns the first existing FILE
+ * (not directory) match, or null. */
+declare function probeFile(candidate: string): string | null;
+/** Resolve a TS aliased import against the nearest tsconfig.json.
+ *
+ * @param importerFile  absolute path of the file containing the import
+ * @param importPath    raw import specifier (e.g., "@/components/x")
+ * @param repoRoot      walk-up termination boundary (absolute path)
+ * @returns absolute path of the resolved file, or null when no alias matches
+ *          OR no real file exists with any candidate extension. */
+export declare function resolveTsAliasedImport(importerFile: string, importPath: string, repoRoot: string): string | null;
+export declare const __test: {
+    findNearestTsconfig: typeof findNearestTsconfig;
+    loadTsconfig: typeof loadTsconfig;
+    probeFile: typeof probeFile;
+    TS_EXTENSIONS: string[];
+    getConfigCacheSize: () => number;
+    getDirCacheSize: () => number;
+};
+export {};
+//# sourceMappingURL=tsconfig-paths.d.ts.map

package/dist/utils/tsconfig-paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tsconfig-paths.d.ts","sourceRoot":"","sources":["../../src/utils/tsconfig-paths.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAMH,UAAU,gBAAgB;IACxB,YAAY,EAAE,CAAC,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,EAAE,CAAC,GAAG,IAAI,CAAC;IACvD,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;CACpB;AAoBD,gEAAgE;AAChE,wBAAgB,kBAAkB,IAAI,IAAI,CAGzC;AAED;;;wDAGwD;AACxD,iBAAS,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAsBzE;AAED;;;mDAGmD;AACnD,iBAAS,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI,CA8BjE;AAED;qCACqC;AACrC,iBAAS,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAcnD;AAED;;;;;;mEAMmE;AACnE,wBAAgB,sBAAsB,CACpC,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,GACf,MAAM,GAAG,IAAI,CA4Bf;AAGD,eAAO,MAAM,MAAM;;;;;;;CAQlB,CAAC"}

package/dist/utils/tsconfig-paths.js

@@ -0,0 +1,176 @@
+/**
+ * tsconfig-paths.ts — resolves `@/foo` style aliased imports against the nearest
+ * `tsconfig.json`, using `get-tsconfig` for `extends`-chain + paths handling.
+ *
+ * Two-level cache keeps long-running MCP server processes happy:
+ *   - `dirToConfigCache`: directory absolute path → nearest tsconfig.json path
+ *     (or null when none found up to repoRoot).
+ *   - `configCache`: tsconfig.json absolute path → parsed { matcher, baseUrl }.
+ *
+ * Both caches are cleared on `clearTsconfigCache()`. The graph builder calls
+ * this at the start of every `index_folder` so config edits between runs take
+ * effect.
+ *
+ * IMPORTANT: when probing `TS_EXTENSIONS`, the empty-string entry that handles
+ * exact-file aliases (`paths: { "foo": ["src/foo.ts"] }`) MUST gate on
+ * `statSync(candidate).isFile()` — `existsSync` returns true for both files
+ * and directories, and a directory match would return the dir path, then fail
+ * the downstream `normalizedPaths.get(resolved)` lookup (file-only), silently
+ * dropping the edge for `@/components/Button` style aliases pointing at a
+ * directory with `index.ts`.
+ */
+import { existsSync, statSync } from "node:fs";
+import { dirname, join, resolve } from "node:path";
+import { getTsconfig, createPathsMatcher } from "get-tsconfig";
+const configCache = new Map();
+const dirToConfigCache = new Map();
+// Empty string FIRST: probes the raw candidate path so exact-file aliases work.
+// `/index.ts` etc. cover directory-as-module aliases.
+const TS_EXTENSIONS = [
+    "",
+    ".ts",
+    ".tsx",
+    ".d.ts",
+    ".js",
+    ".jsx",
+    "/index.ts",
+    "/index.tsx",
+    "/index.d.ts",
+    "/index.js",
+];
+/** Clear both caches. Called at the start of `index_folder`. */
+export function clearTsconfigCache() {
+    configCache.clear();
+    dirToConfigCache.clear();
+}
+/** Walk up from `dir` to `repoRoot`, find nearest `tsconfig.json`.
+ * Returns absolute path of the config file, or null if none found.
+ * Caches every ancestor visited during the walk, not just the input dir,
+ * so sibling lookups under the same parent are O(1). */
+function findNearestTsconfig(dir, repoRoot) {
+    const cached = dirToConfigCache.get(dir);
+    if (cached !== undefined)
+        return cached;
+    const repoRootAbs = resolve(repoRoot);
+    const visited = [];
+    let cur = resolve(dir);
+    // `startsWith(repoRootAbs)` is true when cur === repoRootAbs, so the
+    // explicit equality check would be redundant.
+    while (cur.startsWith(repoRootAbs)) {
+        visited.push(cur);
+        const candidate = join(cur, "tsconfig.json");
+        if (existsSync(candidate)) {
+            for (const v of visited)
+                dirToConfigCache.set(v, candidate);
+            return candidate;
+        }
+        const parent = dirname(cur);
+        if (parent === cur)
+            break;
+        cur = parent;
+    }
+    for (const v of visited)
+        dirToConfigCache.set(v, null);
+    return null;
+}
+/** Parse a tsconfig.json (with `extends` chain) and build a paths matcher.
+ * Returns null on parse error. Caches successful parses only — failures are
+ * NOT cached so a user fixing a malformed tsconfig.json mid-session does not
+ * stay broken until the next full index_folder. */
+function loadTsconfig(configPath) {
+    const cached = configCache.get(configPath);
+    if (cached !== undefined)
+        return cached;
+    try {
+        const result = getTsconfig(configPath);
+        if (!result) {
+            // Don't cache: the file might appear on a retry.
+            return null;
+        }
+        const matcher = createPathsMatcher(result);
+        const baseUrlRaw = result.config.compilerOptions?.baseUrl;
+        const baseUrl = baseUrlRaw
+            ? resolve(dirname(result.path), baseUrlRaw)
+            : null;
+        const resolved = {
+            pathsMatcher: matcher,
+            baseUrl,
+            configPath: result.path,
+        };
+        configCache.set(configPath, resolved);
+        return resolved;
+    }
+    catch (err) {
+        console.warn(`[tsconfig-paths] failed to parse ${configPath}: ${err instanceof Error ? err.message : String(err)}`);
+        // Don't cache parse failures — let the next call retry once the user
+        // fixes the malformed config.
+        return null;
+    }
+}
+/** Probe candidate path against TS_EXTENSIONS. Returns the first existing FILE
+ * (not directory) match, or null. */
+function probeFile(candidate) {
+    for (const ext of TS_EXTENSIONS) {
+        const probe = candidate + ext;
+        if (!existsSync(probe))
+            continue;
+        // CRITICAL: empty-string probe matches both files and directories.
+        // Without this isFile() gate, `@/components/Button` (a directory) resolves
+        // to the directory path, then fails downstream normalizedPaths.get lookup.
+        try {
+            if (statSync(probe).isFile())
+                return probe;
+        }
+        catch {
+            // statSync race; treat as not-a-file
+        }
+    }
+    return null;
+}
+/** Resolve a TS aliased import against the nearest tsconfig.json.
+ *
+ * @param importerFile  absolute path of the file containing the import
+ * @param importPath    raw import specifier (e.g., "@/components/x")
+ * @param repoRoot      walk-up termination boundary (absolute path)
+ * @returns absolute path of the resolved file, or null when no alias matches
+ *          OR no real file exists with any candidate extension. */
+export function resolveTsAliasedImport(importerFile, importPath, repoRoot) {
+    // Relative paths are not aliases — short-circuit.
+    if (importPath.startsWith("."))
+        return null;
+    const importerDir = dirname(resolve(importerFile));
+    const configPath = findNearestTsconfig(importerDir, repoRoot);
+    if (!configPath)
+        return null;
+    const config = loadTsconfig(configPath);
+    if (!config)
+        return null;
+    // Try paths matcher first (alias mappings).
+    if (config.pathsMatcher) {
+        const candidates = config.pathsMatcher(importPath);
+        for (const candidate of candidates) {
+            const hit = probeFile(candidate);
+            if (hit)
+                return hit;
+        }
+    }
+    // Fallback: bare specifier resolved against baseUrl.
+    if (config.baseUrl) {
+        const candidate = join(config.baseUrl, importPath);
+        const hit = probeFile(candidate);
+        if (hit)
+            return hit;
+    }
+    return null;
+}
+// Internal helpers exported for testing only.
+export const __test = {
+    findNearestTsconfig,
+    loadTsconfig,
+    probeFile,
+    TS_EXTENSIONS,
+    // Allow tests to assert cache state without exposing it broadly.
+    getConfigCacheSize: () => configCache.size,
+    getDirCacheSize: () => dirToConfigCache.size,
+};
+//# sourceMappingURL=tsconfig-paths.js.map

package/dist/utils/tsconfig-paths.js.map

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

package/dist/utils/walk.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"walk.d.ts","sourceRoot":"","sources":["../../src/utils/walk.ts"],"names":[],"mappings":"AAIA;;;GAGG;AACH,eAAO,MAAM,WAAW,aAMtB,CAAC;AAEH;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,EAAE,CAE3C;AAID;;;;;;;;GAQG;AACH,eAAO,MAAM,oBAAoB,EAAE,MAAM,EAQxC,CAAC;AAEF,MAAM,WAAW,WAAW;IAC1B;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;IAEpC;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAEjC;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAE9B;;;;;OAKG;IACH,UAAU,CAAC,EAAE,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,GAAG,SAAS,CAAC;IAEnE;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAE/B;;;;OAIG;IACH,cAAc,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAErC;;;;OAIG;IACH,eAAe,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;CACxC;AAED;;;GAGG;AACH,wBAAsB,aAAa,CACjC,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,MAAM,EAAE,CAAC,CAiHnB"}
+{"version":3,"file":"walk.d.ts","sourceRoot":"","sources":["../../src/utils/walk.ts"],"names":[],"mappings":"AAIA;;;GAGG;AACH,eAAO,MAAM,WAAW,aAOtB,CAAC;AAEH;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,EAAE,CAE3C;AAID;;;;;;;;GAQG;AACH,eAAO,MAAM,oBAAoB,EAAE,MAAM,EAQxC,CAAC;AAEF,MAAM,WAAW,WAAW;IAC1B;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;IAEpC;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAEjC;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAE9B;;;;;OAKG;IACH,UAAU,CAAC,EAAE,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,GAAG,SAAS,CAAC;IAEnE;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAE/B;;;;OAIG;IACH,cAAc,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAErC;;;;OAIG;IACH,eAAe,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;CACxC;AAED;;;GAGG;AACH,wBAAsB,aAAa,CACjC,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,MAAM,EAAE,CAAC,CAiHnB"}

package/dist/utils/walk.js

@@ -11,6 +11,7 @@ export const IGNORE_DIRS = new Set([
     ".venv", "venv", ".tox", ".mypy_cache", ".turbo",
     "generated", "audit-results", ".backup", "jscpd-report",
     "helpscout_export", ".output",
+    ".pnpm", // pnpm symlink forest — recursing here can blow up file count
 ]);
 /**
  * Convert IGNORE_DIRS to chokidar-compatible glob patterns.

package/dist/utils/walk.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "codesift-mcp",
-  "version": "0.5.24",
+  "version": "0.5.28",
   "description": "MCP server for code intelligence — 146 tools for symbol search, call graph, semantic search, route tracing, community detection, LSP bridge, secret detection, conversation search, and Hono framework intelligence",
   "license": "BSL-1.1",
   "author": "Greg Laskowski",
@@ -30,28 +30,38 @@
     "postinstall": "node ./dist/cli.js setup all 2>/dev/null && echo '\n  ✨ CodeSift MCP installed and configured for all platforms.\n  ⚠️  Restart your AI client (Cmd+Q for Claude Code) to load new MCP server.\n' || echo '\n  ✨ CodeSift MCP installed. Run: codesift setup all\n'"
   },
   "dependencies": {
+    "@manypkg/get-packages": "^3.1.0",
     "@modelcontextprotocol/sdk": "^1.0.0",
     "@mrleebo/prisma-ast": "^0.15.0",
+    "@parcel/watcher": "^2.5.6",
     "@sanity-labs/secret-scan": "^1.1.0",
-    "chokidar": "^4.0.0",
+    "get-tsconfig": "^4.14.0",
+    "graphology": "^0.26.0",
+    "graphology-metrics": "^2.4.0",
     "ignore": "^6.0.0",
     "picomatch": "^4.0.4",
     "web-tree-sitter": "^0.24.0",
     "zod": "^4.3.6"
   },
   "optionalDependencies": {
+    "@anthropic-ai/sdk": "^0.70.0",
     "@huggingface/transformers": "^3.0.0",
     "openai": "^6.0.0",
-    "voyageai": "^0.2.1"
+    "voyageai": "^0.2.1",
+    "yaml": "^2.7.0"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",
     "@types/picomatch": "^4.0.2",
     "@vitest/coverage-v8": "^3.0.0",
+    "ajv": "^8.18.0",
     "tsx": "^4.0.0",
     "typescript": "^5.7.0",
     "vitest": "^3.0.0"
   },
+  "overrides": {
+    "lodash-es": ">=4.18.1"
+  },
   "engines": {
     "node": ">=20.0.0"
   },

package/rules/codesift.md

@@ -23,12 +23,12 @@ Note: The Explore subagent does NOT have access to CodeSift MCP tools. For code
 
 ## Tool Discovery
 
-**146 MCP tools total** (51 core visible + 95 discoverable).
+**150 MCP tools total** (55 core visible + 95 discoverable).
 
 51 core tools appear in ListTools. The remaining 95 niche tools are discovered on demand:
 
 - `plan_turn(query="find dead code in auth")` — natural-language router: ranked tool/symbol/file recommendations with auto-reveal of hidden tools (preferred entry point at start of a task)
-- `discover_tools(query="dead code")` — keyword search across all 146 tools
+- `discover_tools(query="dead code")` — keyword search across all 150 tools
 - `describe_tools(names=["find_dead_code"])` — get full parameter schema
 - `describe_tools(names=["find_dead_code"], reveal=true)` — also reveal in ListTools
 
@@ -159,6 +159,12 @@ Use this table to pick the right tool for each task:
 | starting a task, want tool recommendations | `plan_turn(query=...)` |
 | React codebase | `trace_component_tree("App")` + `analyze_hooks` |
 | React anti-patterns | `search_patterns("hook-in-condition")` |
+| React derived state | `search_patterns("derived-state")` |
+| React stale closure | `search_patterns("stale-closure-setstate")` |
+| React context perf trap | `search_patterns("context-provider-value-inline")` |
+| React tabnabbing security | `search_patterns("jsx-no-target-blank")` |
+| React button submit foot-gun | `search_patterns("button-no-type")` |
+| React render-tree depth | `analyze_renders` → `entry.prop_chain_depth` (NOT prop-flow depth) |
 | React call graph (clean) | `trace_call_chain(filter_react_hooks=true)` |
 | new Next.js project (first look) | `framework_audit` |
 | SEO audit / metadata review | `nextjs_metadata_audit` |
@@ -266,3 +272,14 @@ Installs hooks in `.claude/settings.local.json` and rules in `~/.claude/rules/co
 - **PreCompact** (`precompact-snapshot`) — injects session snapshot before context compaction
 
 This ensures the index stays current and sub-agents use CodeSift tools automatically.
+
+## Monorepo (Turbo / pnpm-workspace / Nx) — workspace tools
+
+| Task | Tool |
+|------|------|
+| list workspace packages | `list_workspaces` |
+| workspace dependency DAG | `workspace_graph(format=mermaid)` |
+| affected packages on diff | `affected_workspaces(since="HEAD~1")` |
+| boundary rules | `workspace_boundaries(rules=[…])` |
+| package-level cycles | `find_circular_deps` (output gains `package_cycles[]` in monorepo mode) |
+| scope a framework audit | pass `workspace=<name|path>` to `framework_audit`, `nextjs_route_map`, `nextjs_metadata_audit`, `analyze_hono_app`, `nest_audit`, `astro_audit` |

package/rules/codesift.mdc

@@ -15,12 +15,12 @@ For multi-repo sessions, call `list_repos()` to discover available repos.
 
 ## Tool Discovery
 
-**146 MCP tools total** (51 core visible + 95 discoverable).
+**150 MCP tools total** (55 core visible + 95 discoverable).
 
 51 core tools appear in ListTools. The remaining 95 niche tools are discovered on demand:
 
 - `plan_turn(query="...")` — natural-language router with auto-reveal (preferred start-of-task entry point)
-- `discover_tools(query="dead code")` — keyword search across all 146 tools
+- `discover_tools(query="dead code")` — keyword search across all 150 tools
 - `describe_tools(names=["find_dead_code"])` — get full parameter schema
 - `describe_tools(names=["find_dead_code"], reveal=true)` — also reveal in ListTools
 

package/rules/codex.md

@@ -10,12 +10,12 @@ For multi-repo sessions, call `list_repos()` to discover available repos.
 
 ## Tool Discovery
 
-**146 MCP tools total** (51 core visible + 95 discoverable).
+**150 MCP tools total** (55 core visible + 95 discoverable).
 
 51 core tools appear in ListTools. The remaining 95 niche tools are discovered on demand:
 
 - `plan_turn(query="...")` — natural-language router with auto-reveal (preferred start-of-task entry point)
-- `discover_tools(query="dead code")` — keyword search across all 146 tools
+- `discover_tools(query="dead code")` — keyword search across all 150 tools
 - `describe_tools(names=["find_dead_code"])` — get full parameter schema
 - `describe_tools(names=["find_dead_code"], reveal=true)` — also reveal in ListTools
 
@@ -251,3 +251,14 @@ Installs two hooks in `.claude/settings.local.json`:
 - **PostToolUse** (`postindex-file`) — auto-runs `index_file` after `Edit` or `Write`
 
 This ensures the index stays current without manual `index_file` calls after every edit.
+
+## Monorepo (Turbo / pnpm-workspace / Nx) — workspace tools
+
+| Task | Tool |
+|------|------|
+| list workspace packages | `list_workspaces` |
+| workspace dependency DAG | `workspace_graph(format=mermaid)` |
+| affected packages on diff | `affected_workspaces(since="HEAD~1")` |
+| boundary rules | `workspace_boundaries(rules=[…])` |
+| package-level cycles | `find_circular_deps` (output gains `package_cycles[]` in monorepo mode) |
+| scope a framework audit | pass `workspace=<name|path>` to `framework_audit`, `nextjs_route_map`, `nextjs_metadata_audit`, `analyze_hono_app`, `nest_audit`, `astro_audit` |

package/rules/gemini.md

@@ -11,12 +11,12 @@ If the repo is not yet indexed, run `index_folder(path="/full/path/to/project")`
 
 ## Tool Discovery
 
-**146 MCP tools total** (51 core visible + 95 discoverable).
+**150 MCP tools total** (55 core visible + 95 discoverable).
 
 51 core tools appear in ListTools. The remaining 95 niche tools are discovered on demand:
 
 - `plan_turn(query="...")` — natural-language router with auto-reveal (preferred start-of-task entry point)
-- `discover_tools(query="dead code")` — keyword search across all 146 tools
+- `discover_tools(query="dead code")` — keyword search across all 150 tools
 - `describe_tools(names=["find_dead_code"])` — get full parameter schema
 - `describe_tools(names=["find_dead_code"], reveal=true)` — also reveal in ListTools
 
@@ -252,3 +252,14 @@ Installs two hooks in `.claude/settings.local.json`:
 - **PostToolUse** (`postindex-file`) — auto-runs `index_file` after `Edit` or `Write`
 
 This ensures the index stays current without manual `index_file` calls after every edit.
+
+## Monorepo (Turbo / pnpm-workspace / Nx) — workspace tools
+
+| Task | Tool |
+|------|------|
+| list workspace packages | `list_workspaces` |
+| workspace dependency DAG | `workspace_graph(format=mermaid)` |
+| affected packages on diff | `affected_workspaces(since="HEAD~1")` |
+| boundary rules | `workspace_boundaries(rules=[…])` |
+| package-level cycles | `find_circular_deps` (output gains `package_cycles[]` in monorepo mode) |
+| scope a framework audit | pass `workspace=<name|path>` to `framework_audit`, `nextjs_route_map`, `nextjs_metadata_audit`, `analyze_hono_app`, `nest_audit`, `astro_audit` |