@launchsecure/launch-kit 0.0.11 → 0.0.12

package/dist/server/cli.js

@@ -9159,7 +9159,7 @@ Returns: { pattern, filter, files_searched, total_matches, matches: [{file, line
     name: "inspect_node",
     description: `Get deep AST data for specific graph nodes \u2014 what's INSIDE a component or endpoint. Returns elements (JSX), state hooks, conditions, variables, responses, and request params. Use INSTEAD of Grep/Read when you need to understand component internals without reading source.
 
-USE THIS FOR: "what elements does LoginPage have?", "what conditions does the login endpoint check?", "what state does SettingsPage manage?", "what responses can this endpoint return?", "what validation does this API do?", "what props does this component accept?"
+USE THIS FOR: "what elements does LoginPage have?", "what conditions does the login endpoint check?", "what state does SettingsPage manage?", "what responses can this endpoint return?", "what validation does this API do?", "what props does this component accept?", "which endpoints check for isAdmin?", "find all conditions mentioning rateLimit"
 
 DO NOT USE FOR: structural queries (use read_graph), content search (use grep_nodes).
 
@@ -9184,6 +9184,14 @@ Returns deep fields only \u2014 not structural metadata (use read_graph for that
           type: "array",
           items: { type: "string" },
           description: "Specific deep fields to return. Options: elements, stateVars, conditions, variables, responses, params. Omit for all."
+        },
+        filter: {
+          type: "string",
+          description: "Regex pattern to search WITHIN deep field values. Only returns nodes where at least one deep field matches. Searches across all string values in the requested fields (condition tests, variable inits, element tags/props, response bodies, etc.). When set, search becomes optional and node limit is raised to 50."
+        },
+        case_insensitive: {
+          type: "boolean",
+          description: "Case-insensitive filter matching. Default true."
         }
       },
       required: ["layer"]
@@ -9660,8 +9668,10 @@ function handleInspectNode(args) {
   const nodeId = args.node_id;
   const search = args.search;
   const fields = args.fields;
+  const filter = args.filter;
+  const caseInsensitive = args.case_insensitive ?? true;
   if (!layer) return err("layer is required.");
-  if (!nodeId && !search) return err("Either node_id or search is required.");
+  if (!nodeId && !search && !filter) return err("Either node_id, search, or filter is required.");
   const graph = readGraph(rootDir, layer);
   if (!graph) return err(`No graph found for layer "${layer}". Run generate_graph first.`);
   let matched;
@@ -9669,30 +9679,66 @@ function handleInspectNode(args) {
     const node = graph.nodes.find((n) => n.id === nodeId);
     if (!node) return err(`Node "${nodeId}" not found in ${layer} layer.`);
     matched = [node];
-  } else {
+  } else if (search) {
     const searchLower = search.toLowerCase();
     matched = graph.nodes.filter(
       (n) => n.id.toLowerCase().includes(searchLower) || n.name.toLowerCase().includes(searchLower) || n.route?.toLowerCase().includes(searchLower)
     );
-  }
-  if (matched.length === 0) return err(`No nodes matching "${search}" in ${layer} layer.`);
-  if (matched.length > 5) {
-    return err(`${matched.length} nodes match "${search}". Narrow your search (max 5 for inspect_node).`);
+  } else {
+    matched = graph.nodes;
   }
   const allDeepFields = ["elements", "stateVars", "conditions", "variables", "responses", "params"];
   const requestedFields = fields ?? allDeepFields;
-  const results = matched.map((node) => {
+  let filterRegex = null;
+  if (filter) {
+    try {
+      filterRegex = new RegExp(filter, caseInsensitive ? "i" : "");
+    } catch {
+      return err(`Invalid regex pattern: "${filter}"`);
+    }
+  }
+  function deepMatch(obj, regex) {
+    if (typeof obj === "string") return regex.test(obj);
+    if (Array.isArray(obj)) return obj.some((item) => deepMatch(item, regex));
+    if (obj && typeof obj === "object") {
+      return Object.values(obj).some((val) => deepMatch(val, regex));
+    }
+    return false;
+  }
+  const results = [];
+  const maxResults = filter ? 50 : 5;
+  for (const node of matched) {
     const deep = { id: node.id, name: node.name, type: node.type };
+    let hasData = false;
     for (const field of requestedFields) {
       if (allDeepFields.includes(field) && node[field] != null) {
         deep[field] = node[field];
+        hasData = true;
       }
     }
-    return deep;
-  });
+    if (filterRegex) {
+      let fieldMatches = false;
+      for (const field of requestedFields) {
+        if (node[field] != null && deepMatch(node[field], filterRegex)) {
+          fieldMatches = true;
+          break;
+        }
+      }
+      if (!fieldMatches) continue;
+    }
+    if (hasData || !filter) {
+      results.push(deep);
+    }
+    if (results.length >= maxResults) break;
+  }
+  if (results.length === 0) {
+    const hint = filter ? `No nodes with deep fields matching /${filter}/${caseInsensitive ? "i" : ""} in ${layer} layer.` : `No nodes matching "${search}" in ${layer} layer.`;
+    return err(hint);
+  }
   return okJson({
     layer,
     matched: results.length,
+    ...results.length >= maxResults ? { truncated: true, hint: `Showing first ${maxResults} matches. Narrow with search param.` } : {},
     nodes: results
   });
 }

package/dist/server/graph-mcp-entry.js

@@ -3519,8 +3519,10 @@ function handleInspectNode(args) {
   const nodeId = args.node_id;
   const search = args.search;
   const fields = args.fields;
+  const filter = args.filter;
+  const caseInsensitive = args.case_insensitive ?? true;
   if (!layer) return err("layer is required.");
-  if (!nodeId && !search) return err("Either node_id or search is required.");
+  if (!nodeId && !search && !filter) return err("Either node_id, search, or filter is required.");
   const graph = readGraph(rootDir, layer);
   if (!graph) return err(`No graph found for layer "${layer}". Run generate_graph first.`);
   let matched;
@@ -3528,30 +3530,66 @@ function handleInspectNode(args) {
     const node = graph.nodes.find((n) => n.id === nodeId);
     if (!node) return err(`Node "${nodeId}" not found in ${layer} layer.`);
     matched = [node];
-  } else {
+  } else if (search) {
     const searchLower = search.toLowerCase();
     matched = graph.nodes.filter(
       (n) => n.id.toLowerCase().includes(searchLower) || n.name.toLowerCase().includes(searchLower) || n.route?.toLowerCase().includes(searchLower)
     );
-  }
-  if (matched.length === 0) return err(`No nodes matching "${search}" in ${layer} layer.`);
-  if (matched.length > 5) {
-    return err(`${matched.length} nodes match "${search}". Narrow your search (max 5 for inspect_node).`);
+  } else {
+    matched = graph.nodes;
   }
   const allDeepFields = ["elements", "stateVars", "conditions", "variables", "responses", "params"];
   const requestedFields = fields ?? allDeepFields;
-  const results = matched.map((node) => {
+  let filterRegex = null;
+  if (filter) {
+    try {
+      filterRegex = new RegExp(filter, caseInsensitive ? "i" : "");
+    } catch {
+      return err(`Invalid regex pattern: "${filter}"`);
+    }
+  }
+  function deepMatch(obj, regex) {
+    if (typeof obj === "string") return regex.test(obj);
+    if (Array.isArray(obj)) return obj.some((item) => deepMatch(item, regex));
+    if (obj && typeof obj === "object") {
+      return Object.values(obj).some((val) => deepMatch(val, regex));
+    }
+    return false;
+  }
+  const results = [];
+  const maxResults = filter ? 50 : 5;
+  for (const node of matched) {
     const deep = { id: node.id, name: node.name, type: node.type };
+    let hasData = false;
     for (const field of requestedFields) {
       if (allDeepFields.includes(field) && node[field] != null) {
         deep[field] = node[field];
+        hasData = true;
       }
     }
-    return deep;
-  });
+    if (filterRegex) {
+      let fieldMatches = false;
+      for (const field of requestedFields) {
+        if (node[field] != null && deepMatch(node[field], filterRegex)) {
+          fieldMatches = true;
+          break;
+        }
+      }
+      if (!fieldMatches) continue;
+    }
+    if (hasData || !filter) {
+      results.push(deep);
+    }
+    if (results.length >= maxResults) break;
+  }
+  if (results.length === 0) {
+    const hint = filter ? `No nodes with deep fields matching /${filter}/${caseInsensitive ? "i" : ""} in ${layer} layer.` : `No nodes matching "${search}" in ${layer} layer.`;
+    return err(hint);
+  }
   return okJson({
     layer,
     matched: results.length,
+    ...results.length >= maxResults ? { truncated: true, hint: `Showing first ${maxResults} matches. Narrow with search param.` } : {},
     nodes: results
   });
 }
@@ -4074,7 +4112,7 @@ Returns: { pattern, filter, files_searched, total_matches, matches: [{file, line
         name: "inspect_node",
         description: `Get deep AST data for specific graph nodes \u2014 what's INSIDE a component or endpoint. Returns elements (JSX), state hooks, conditions, variables, responses, and request params. Use INSTEAD of Grep/Read when you need to understand component internals without reading source.
 
-USE THIS FOR: "what elements does LoginPage have?", "what conditions does the login endpoint check?", "what state does SettingsPage manage?", "what responses can this endpoint return?", "what validation does this API do?", "what props does this component accept?"
+USE THIS FOR: "what elements does LoginPage have?", "what conditions does the login endpoint check?", "what state does SettingsPage manage?", "what responses can this endpoint return?", "what validation does this API do?", "what props does this component accept?", "which endpoints check for isAdmin?", "find all conditions mentioning rateLimit"
 
 DO NOT USE FOR: structural queries (use read_graph), content search (use grep_nodes).
 
@@ -4099,6 +4137,14 @@ Returns deep fields only \u2014 not structural metadata (use read_graph for that
               type: "array",
               items: { type: "string" },
               description: "Specific deep fields to return. Options: elements, stateVars, conditions, variables, responses, params. Omit for all."
+            },
+            filter: {
+              type: "string",
+              description: "Regex pattern to search WITHIN deep field values. Only returns nodes where at least one deep field matches. Searches across all string values in the requested fields (condition tests, variable inits, element tags/props, response bodies, etc.). When set, search becomes optional and node limit is raised to 50."
+            },
+            case_insensitive: {
+              type: "boolean",
+              description: "Case-insensitive filter matching. Default true."
             }
           },
           required: ["layer"]

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@launchsecure/launch-kit",
-  "version": "0.0.11",
+  "version": "0.0.12",
   "description": "LaunchSecure toolkit — launch-pod (pipeline pod), launch-chart (project graph MCP), and more.",
   "license": "MIT",
   "author": "LaunchSecure - AutomateWithUs",