cicada-mcp 0.1.7__py3-none-any.whl → 0.2.0__py3-none-any.whl

cicada/extractors/module.py

@@ -31,9 +31,7 @@ def _find_modules_recursive(node, source_code: bytes, modules: list):
 
         # Check if this is a defmodule call
         if target and arguments:
-            target_text = source_code[target.start_byte : target.end_byte].decode(
-                "utf-8"
-            )
+            target_text = source_code[target.start_byte : target.end_byte].decode("utf-8")
 
             if target_text == "defmodule":
                 # Extract module name from arguments
@@ -41,9 +39,9 @@ def _find_modules_recursive(node, source_code: bytes, modules: list):
 
                 for arg_child in arguments.children:
                     if arg_child.type == "alias":
-                        module_name = source_code[
-                            arg_child.start_byte : arg_child.end_byte
-                        ].decode("utf-8")
+                        module_name = source_code[arg_child.start_byte : arg_child.end_byte].decode(
+                            "utf-8"
+                        )
                         break
 
                 if module_name and do_block:
@@ -84,17 +82,15 @@ def _find_moduledoc_recursive(node, source_code: bytes) -> str | None:
             # Check if this is a moduledoc attribute
             for call_child in operand.children:
                 if call_child.type == "identifier":
-                    attr_name = source_code[
-                        call_child.start_byte : call_child.end_byte
-                    ].decode("utf-8")
+                    attr_name = source_code[call_child.start_byte : call_child.end_byte].decode(
+                        "utf-8"
+                    )
 
                     if attr_name == "moduledoc":
                         # Extract the documentation string from the arguments
                         for arg_child in operand.children:
                             if arg_child.type == "arguments":
-                                doc_string = extract_string_from_arguments(
-                                    arg_child, source_code
-                                )
+                                doc_string = extract_string_from_arguments(arg_child, source_code)
                                 if doc_string:
                                     return doc_string
 
@@ -106,9 +102,9 @@ def _find_moduledoc_recursive(node, source_code: bytes) -> str | None:
             is_defmodule = False
             for call_child in child.children:
                 if call_child.type == "identifier":
-                    target_text = source_code[
-                        call_child.start_byte : call_child.end_byte
-                    ].decode("utf-8")
+                    target_text = source_code[call_child.start_byte : call_child.end_byte].decode(
+                        "utf-8"
+                    )
                     if target_text == "defmodule":
                         is_defmodule = True
                         break

cicada/extractors/spec.py

@@ -27,9 +27,9 @@ def _find_specs_recursive(node, source_code: bytes, specs: dict):
             # Check if this is a spec attribute
             for call_child in operand.children:
                 if call_child.type == "identifier":
-                    attr_name = source_code[
-                        call_child.start_byte : call_child.end_byte
-                    ].decode("utf-8")
+                    attr_name = source_code[call_child.start_byte : call_child.end_byte].decode(
+                        "utf-8"
+                    )
 
                     if attr_name == "spec":
                         # Extract the spec definition
@@ -45,9 +45,9 @@ def _find_specs_recursive(node, source_code: bytes, specs: dict):
             is_defmodule_or_def = False
             for call_child in child.children:
                 if call_child.type == "identifier":
-                    target_text = source_code[
-                        call_child.start_byte : call_child.end_byte
-                    ].decode("utf-8")
+                    target_text = source_code[call_child.start_byte : call_child.end_byte].decode(
+                        "utf-8"
+                    )
                     if target_text in ["defmodule", "def", "defp"]:
                         is_defmodule_or_def = True
                         break
@@ -95,9 +95,7 @@ def _parse_spec(spec_node, source_code: bytes) -> dict | None:
                                     fc_child.start_byte : fc_child.end_byte
                                 ].decode("utf-8")
                             elif fc_child.type == "arguments":
-                                param_types = _extract_param_types(
-                                    fc_child, source_code
-                                )
+                                param_types = _extract_param_types(fc_child, source_code)
 
                         if func_name:
                             return {
@@ -137,9 +135,7 @@ def match_specs_to_functions(functions: list, specs: dict) -> list:
                 args_with_types = []
                 for i, arg_name in enumerate(func["args"]):
                     if i < len(spec["param_types"]):
-                        args_with_types.append(
-                            {"name": arg_name, "type": spec["param_types"][i]}
-                        )
+                        args_with_types.append({"name": arg_name, "type": spec["param_types"][i]})
                     else:
                         args_with_types.append({"name": arg_name, "type": None})
                 func["args_with_types"] = args_with_types

cicada/find_dead_code.py

@@ -10,10 +10,9 @@ Author: Cursor(Auto)
 import argparse
 import json
 import sys
-from pathlib import Path
 
 from cicada.dead_code_analyzer import DeadCodeAnalyzer
-from cicada.utils import load_index
+from cicada.utils import get_index_path, load_index
 
 
 def format_markdown(results: dict) -> str:
@@ -34,9 +33,7 @@ def format_markdown(results: dict) -> str:
         f"(skipped {summary['skipped_impl']} with @impl, "
         f"{summary['skipped_files']} in test/script files)"
     )
-    lines.append(
-        f"Found **{summary['total_candidates']} potentially unused functions**\n"
-    )
+    lines.append(f"Found **{summary['total_candidates']} potentially unused functions**\n")
 
     candidates = results["candidates"]
 
@@ -46,9 +43,7 @@ def format_markdown(results: dict) -> str:
         label = f" HIGH CONFIDENCE ({count} function{'s' if count != 1 else ''}) "
         bar_length = 80
         padding = (bar_length - len(label)) // 2
-        lines.append(
-            f"\n{'═' * padding}{label}{'═' * (bar_length - padding - len(label))}"
-        )
+        lines.append(f"\n{'═' * padding}{label}{'═' * (bar_length - padding - len(label))}")
         lines.append("Functions with zero usage in codebase\n")
 
         # Group by module
@@ -62,9 +57,7 @@ def format_markdown(results: dict) -> str:
             lines.append(f"### {module}")
             lines.append(f"{funcs[0]['file']}\n")
             for func in funcs:
-                lines.append(
-                    f"- `{func['function']}/{func['arity']}` (line {func['line']})"
-                )
+                lines.append(f"- `{func['function']}/{func['arity']}` (line {func['line']})")
             lines.append("")
 
     # Medium confidence
@@ -73,9 +66,7 @@ def format_markdown(results: dict) -> str:
         label = f" MEDIUM CONFIDENCE ({count} function{'s' if count != 1 else ''}) "
         bar_length = 80
         padding = (bar_length - len(label)) // 2
-        lines.append(
-            f"\n{'═' * padding}{label}{'═' * (bar_length - padding - len(label))}"
-        )
+        lines.append(f"\n{'═' * padding}{label}{'═' * (bar_length - padding - len(label))}")
         lines.append(
             "Functions with zero usage, but module has behaviors/uses (possible callbacks)\n"
         )
@@ -101,9 +92,7 @@ def format_markdown(results: dict) -> str:
             lines.append("")
 
             for func in funcs:
-                lines.append(
-                    f"- `{func['function']}/{func['arity']}` (line {func['line']})"
-                )
+                lines.append(f"- `{func['function']}/{func['arity']}` (line {func['line']})")
             lines.append("")
 
     # Low confidence
@@ -112,9 +101,7 @@ def format_markdown(results: dict) -> str:
         label = f" LOW CONFIDENCE ({count} function{'s' if count != 1 else ''}) "
         bar_length = 80
         padding = (bar_length - len(label)) // 2
-        lines.append(
-            f"\n{'═' * padding}{label}{'═' * (bar_length - padding - len(label))}"
-        )
+        lines.append(f"\n{'═' * padding}{label}{'═' * (bar_length - padding - len(label))}")
         lines.append(
             "Functions with zero usage, but module passed as value (possible dynamic calls)\n"
         )
@@ -139,9 +126,7 @@ def format_markdown(results: dict) -> str:
             lines.append("")
 
             for func in funcs:
-                lines.append(
-                    f"- `{func['function']}/{func['arity']}` (line {func['line']})"
-                )
+                lines.append(f"- `{func['function']}/{func['arity']}` (line {func['line']})")
             lines.append("")
 
     if summary["total_candidates"] == 0:
@@ -205,18 +190,12 @@ Confidence Levels:
   low    - Zero usage, but module passed as value (possible dynamic calls)
 
 Examples:
-  cicada-find-dead-code                      # Show high confidence candidates
-  cicada-find-dead-code --min-confidence low # Show all candidates
-  cicada-find-dead-code --format json        # Output as JSON
+  cicada find-dead-code                      # Show high confidence candidates
+  cicada find-dead-code --min-confidence low # Show all candidates
+  cicada find-dead-code --format json        # Output as JSON
         """,
     )
 
-    parser.add_argument(
-        "--index",
-        default=".cicada/index.json",
-        help="Path to index file (default: .cicada/index.json)",
-    )
-
     parser.add_argument(
         "--format",
         choices=["markdown", "json"],
@@ -233,11 +212,11 @@ Examples:
 
     args = parser.parse_args()
 
-    # Load index
-    index_path = Path(args.index)
+    # Load index from centralized storage
+    index_path = get_index_path(".")
     if not index_path.exists():
         print(f"Error: Index file not found: {index_path}", file=sys.stderr)
-        print(f"\nRun 'cicada-index' first to create the index.", file=sys.stderr)
+        print("\nRun 'cicada index' first to create the index.", file=sys.stderr)
         sys.exit(1)
 
     try:
@@ -258,10 +237,7 @@ Examples:
     results = filter_by_confidence(results, args.min_confidence)
 
     # Format output
-    if args.format == "json":
-        output = format_json(results)
-    else:
-        output = format_markdown(results)
+    output = format_json(results) if args.format == "json" else format_markdown(results)
 
     print(output)
 

cicada/formatter.py

@@ -6,13 +6,13 @@ This module provides formatting utilities for Cicada MCP server responses,
 supporting both Markdown and JSON output formats.
 """
 
+import argparse
 import json
 import sys
 from pathlib import Path
-from typing import Optional, Dict, Any
-import argparse
+from typing import Any
 
-from cicada.utils import FunctionGrouper, CallSiteFormatter, SignatureBuilder
+from cicada.utils import CallSiteFormatter, FunctionGrouper, SignatureBuilder
 
 
 class ModuleFormatter:
@@ -24,7 +24,7 @@ class ModuleFormatter:
 
     @staticmethod
     def format_module_markdown(
-        module_name: str, data: Dict[str, Any], private_functions: str = "exclude"
+        module_name: str, data: dict[str, Any], private_functions: str = "exclude"
     ) -> str:
         """
         Format module data as Markdown.
@@ -69,9 +69,7 @@ class ModuleFormatter:
         if public_grouped and private_functions != "only":
             lines.extend(["", "Public:", ""])
             # Sort by line number instead of function name
-            for (_, _), clauses in sorted(
-                public_grouped.items(), key=lambda x: x[1][0]["line"]
-            ):
+            for (_, _), clauses in sorted(public_grouped.items(), key=lambda x: x[1][0]["line"]):
                 # Use the first clause for display (they all have same name/arity)
                 func = clauses[0]
                 func_sig = SignatureBuilder.build(func)
@@ -81,9 +79,7 @@ class ModuleFormatter:
         if private_grouped and private_functions in ["include", "only"]:
             lines.extend(["", "Private:", ""])
             # Sort by line number instead of function name
-            for (_, _), clauses in sorted(
-                private_grouped.items(), key=lambda x: x[1][0]["line"]
-            ):
+            for (_, _), clauses in sorted(private_grouped.items(), key=lambda x: x[1][0]["line"]):
                 # Use the first clause for display (they all have same name/arity)
                 func = clauses[0]
                 func_sig = SignatureBuilder.build(func)
@@ -104,7 +100,7 @@ class ModuleFormatter:
 
     @staticmethod
     def format_module_json(
-        module_name: str, data: Dict[str, Any], private_functions: str = "exclude"
+        module_name: str, data: dict[str, Any], private_functions: str = "exclude"
     ) -> str:
         """
         Format module data as JSON.
@@ -203,9 +199,7 @@ Module names are case-sensitive and must match exactly (e.g., `MyApp.User`, not
         return json.dumps(error_result, indent=2)
 
     @staticmethod
-    def format_function_results_markdown(
-        function_name: str, results: list[Dict[str, Any]]
-    ) -> str:
+    def format_function_results_markdown(function_name: str, results: list[dict[str, Any]]) -> str:
         """
         Format function search results as Markdown.
 
@@ -254,7 +248,7 @@ No functions matching `{function_name}` were found in the index.
         else:
             lines = [
                 f"Functions matching {function_name}",
-                f"",
+                "",
                 f"Found {len(consolidated_results)} match(es):",
             ]
 
@@ -287,18 +281,14 @@ No functions matching `{function_name}` were found in the index.
             # Add documentation if present
             if func.get("doc"):
                 if len(consolidated_results) == 1:
-                    lines.extend(
-                        ["", f"{indent}Documentation:", "", f"{indent}{func['doc']}"]
-                    )
+                    lines.extend(["", f"{indent}Documentation:", "", f"{indent}{func['doc']}"])
                 else:
                     lines.extend(["", "Documentation:", "", func["doc"]])
 
             # Add examples if present
             if func.get("examples"):
                 if len(consolidated_results) == 1:
-                    lines.extend(
-                        ["", f"{indent}Examples:", "", f"{indent}{func['examples']}"]
-                    )
+                    lines.extend(["", f"{indent}Examples:", "", f"{indent}{func['examples']}"])
                 else:
                     lines.extend(["", "Examples:", "", func["examples"]])
 
@@ -321,23 +311,17 @@ No functions matching `{function_name}` were found in the index.
                 if has_examples:
                     # Separate into code and test call sites WITH examples
                     code_sites_with_examples = [
-                        s
-                        for s in call_sites_with_examples
-                        if "test" not in s["file"].lower()
+                        s for s in call_sites_with_examples if "test" not in s["file"].lower()
                     ]
                     test_sites_with_examples = [
-                        s
-                        for s in call_sites_with_examples
-                        if "test" in s["file"].lower()
+                        s for s in call_sites_with_examples if "test" in s["file"].lower()
                     ]
 
                     lines.append(f"{indent}Usage Examples:")
 
                     if code_sites_with_examples:
                         # Group code sites by caller
-                        grouped_code = CallSiteFormatter.group_by_caller(
-                            code_sites_with_examples
-                        )
+                        grouped_code = CallSiteFormatter.group_by_caller(code_sites_with_examples)
                         code_count = sum(len(site["lines"]) for site in grouped_code)
                         lines.append(f"{indent}Code ({code_count}):")
                         for site in grouped_code:
@@ -350,12 +334,8 @@ No functions matching `{function_name}` were found in the index.
 
                             # Show consolidated line numbers only if multiple lines
                             if len(site["lines"]) > 1:
-                                line_list = ", ".join(
-                                    f":{line}" for line in site["lines"]
-                                )
-                                lines.append(
-                                    f"{indent}- {caller} at {site['file']}{line_list}"
-                                )
+                                line_list = ", ".join(f":{line}" for line in site["lines"])
+                                lines.append(f"{indent}- {caller} at {site['file']}{line_list}")
                             else:
                                 lines.append(f"{indent}- {caller} at {site['file']}")
 
@@ -371,9 +351,7 @@ No functions matching `{function_name}` were found in the index.
                         if code_sites_with_examples:
                             lines.append("")  # Blank line between sections
                         # Group test sites by caller
-                        grouped_test = CallSiteFormatter.group_by_caller(
-                            test_sites_with_examples
-                        )
+                        grouped_test = CallSiteFormatter.group_by_caller(test_sites_with_examples)
                         test_count = sum(len(site["lines"]) for site in grouped_test)
                         lines.append(f"{indent}Test ({test_count}):")
                         for site in grouped_test:
@@ -386,12 +364,8 @@ No functions matching `{function_name}` were found in the index.
 
                             # Show consolidated line numbers only if multiple lines
                             if len(site["lines"]) > 1:
-                                line_list = ", ".join(
-                                    f":{line}" for line in site["lines"]
-                                )
-                                lines.append(
-                                    f"{indent}- {caller} at {site['file']}{line_list}"
-                                )
+                                line_list = ", ".join(f":{line}" for line in site["lines"])
+                                lines.append(f"{indent}- {caller} at {site['file']}{line_list}")
                             else:
                                 lines.append(f"{indent}- {caller} at {site['file']}")
 
@@ -419,14 +393,10 @@ No functions matching `{function_name}` were found in the index.
                     if remaining_call_sites:
                         # Separate into code and test
                         remaining_code = [
-                            s
-                            for s in remaining_call_sites
-                            if "test" not in s["file"].lower()
+                            s for s in remaining_call_sites if "test" not in s["file"].lower()
                         ]
                         remaining_test = [
-                            s
-                            for s in remaining_call_sites
-                            if "test" in s["file"].lower()
+                            s for s in remaining_call_sites if "test" in s["file"].lower()
                         ]
 
                         lines.append("")
@@ -447,12 +417,8 @@ No functions matching `{function_name}` were found in the index.
                                 else:
                                     caller = site["calling_module"]
 
-                                line_list = ", ".join(
-                                    f":{line}" for line in site["lines"]
-                                )
-                                lines.append(
-                                    f"{indent}- {caller} at {site['file']}{line_list}"
-                                )
+                                line_list = ", ".join(f":{line}" for line in site["lines"])
+                                lines.append(f"{indent}- {caller} at {site['file']}{line_list}")
 
                         if remaining_test:
                             if remaining_code:
@@ -471,17 +437,11 @@ No functions matching `{function_name}` were found in the index.
                                 else:
                                     caller = site["calling_module"]
 
-                                line_list = ", ".join(
-                                    f":{line}" for line in site["lines"]
-                                )
-                                lines.append(
-                                    f"{indent}- {caller} at {site['file']}{line_list}"
-                                )
+                                line_list = ", ".join(f":{line}" for line in site["lines"])
+                                lines.append(f"{indent}- {caller} at {site['file']}{line_list}")
                 else:
                     # Separate into code and test call sites
-                    code_sites = [
-                        s for s in call_sites if "test" not in s["file"].lower()
-                    ]
+                    code_sites = [s for s in call_sites if "test" not in s["file"].lower()]
                     test_sites = [s for s in call_sites if "test" in s["file"].lower()]
 
                     call_count = len(call_sites)
@@ -504,9 +464,7 @@ No functions matching `{function_name}` were found in the index.
 
                             # Show consolidated line numbers
                             line_list = ", ".join(f":{line}" for line in site["lines"])
-                            lines.append(
-                                f"{indent}- {caller} at {site['file']}{line_list}"
-                            )
+                            lines.append(f"{indent}- {caller} at {site['file']}{line_list}")
 
                     if test_sites:
                         if code_sites:
@@ -525,9 +483,7 @@ No functions matching `{function_name}` were found in the index.
 
                             # Show consolidated line numbers
                             line_list = ", ".join(f":{line}" for line in site["lines"])
-                            lines.append(
-                                f"{indent}- {caller} at {site['file']}{line_list}"
-                            )
+                            lines.append(f"{indent}- {caller} at {site['file']}{line_list}")
                 lines.append("")
             else:
                 lines.extend([f"{indent}*No call sites found*"])
@@ -535,9 +491,7 @@ No functions matching `{function_name}` were found in the index.
         return "\n".join(lines)
 
     @staticmethod
-    def format_function_results_json(
-        function_name: str, results: list[Dict[str, Any]]
-    ) -> str:
+    def format_function_results_json(function_name: str, results: list[dict[str, Any]]) -> str:
         """
         Format function search results as JSON.
 
@@ -593,9 +547,7 @@ No functions matching `{function_name}` were found in the index.
         return json.dumps(output, indent=2)
 
     @staticmethod
-    def format_module_usage_markdown(
-        module_name: str, usage_results: Dict[str, Any]
-    ) -> str:
+    def format_module_usage_markdown(module_name: str, usage_results: dict[str, Any]) -> str:
         """
         Format module usage results as Markdown.
 
@@ -624,9 +576,7 @@ No functions matching `{function_name}` were found in the index.
                     if imp["alias_name"] != module_name.split(".")[-1]
                     else ""
                 )
-                lines.append(
-                    f"- `{imp['importing_module']}` {alias_info} — `{imp['file']}`"
-                )
+                lines.append(f"- `{imp['importing_module']}` {alias_info} — `{imp['file']}`")
             lines.append("")
 
         # Show imports section
@@ -674,9 +624,7 @@ No functions matching `{function_name}` were found in the index.
                 lines.append("")
 
                 for call in fc["calls"]:
-                    alias_info = (
-                        f" (via `{call['alias_used']}`)" if call["alias_used"] else ""
-                    )
+                    alias_info = f" (via `{call['alias_used']}`)" if call["alias_used"] else ""
                     # Show unique line numbers for this function
                     line_list = ", ".join(f":{line}" for line in sorted(call["lines"]))
                     lines.append(
@@ -692,9 +640,7 @@ No functions matching `{function_name}` were found in the index.
         return "\n".join(lines)
 
     @staticmethod
-    def format_module_usage_json(
-        module_name: str, usage_results: Dict[str, Any]
-    ) -> str:
+    def format_module_usage_json(module_name: str, usage_results: dict[str, Any]) -> str:
         """
         Format module usage results as JSON.
 
@@ -726,7 +672,7 @@ No functions matching `{function_name}` were found in the index.
 
     @staticmethod
     def format_keyword_search_results_markdown(
-        _keywords: list[str], results: list[Dict[str, Any]]
+        _keywords: list[str], results: list[dict[str, Any]]
     ) -> str:
         """
         Format keyword search results as Markdown.
@@ -814,9 +760,9 @@ class JSONFormatter:
             data = json.loads(json_string)
             return json.dumps(data, indent=self.indent, sort_keys=self.sort_keys)
         except json.JSONDecodeError as e:
-            raise ValueError(f"Invalid JSON: {e}")
+            raise ValueError(f"Invalid JSON: {e}") from e
 
-    def format_file(self, input_path: Path, output_path: Optional[Path] = None) -> str:
+    def format_file(self, input_path: Path, output_path: Path | None = None) -> str:
         """
         Format a JSON file.
 
@@ -835,7 +781,7 @@ class JSONFormatter:
             raise FileNotFoundError(f"Input file not found: {input_path}")
 
         # Read the input file
-        with open(input_path, "r") as f:
+        with open(input_path) as f:
             json_string = f.read()
 
         # Format the JSON