feat(v0.3.0): multi-language temporal analysis, multi-model

  support, platform-wide standardization

  Multi-language temporal analysis
  - Protocol-based analyzer architecture with central registry
  - Python (ast), JavaScript (tree-sitter), Java (tree-sitter), Go (tree-sitter)
  - Automatic language detection by file extension
  - --language CLI flag for single-language restriction
  - Per-language directory exclusions
  - language field on TemporalEvaluation and EvaluationResponse

  Multi-model support
  - Default: claude-sonnet-4-5-20250929
  - Supported: claude-opus-4-6, claude-sonnet-4-6
  - Agent runtime wired through get_claude_config() contract
  - Default max_tokens raised to 8192

  Infrastructure
  - anthropic >= 0.80.0, langchain-anthropic >= 1.0.0
  - tree-sitter grammars for JavaScript, Java, Go
  - Fixed max_tokens never passed to ChatAnthropic
  - Corrected stale model identifiers returning HTTP 404

  Output
  - CLI indicators: [+] improving, [-] declining, [~] stable
  - Agent branded as GitVoyant
  - Tool descriptions generalized to source files

  Documentation
  - All markdown rewritten for declarative register
  - COMPLEXITY_REQUIREMENTS.md corrected to match
  implementation
  - CITATION.cff updated for multi-language scope

  Testing
  - 64 tests, zero failures
  - 39 new analyzer unit tests
  - All three models verified E2E against live API
  - 64 tests, zero failures
  - 39 new analyzer unit tests
  - All three models verified E2E against live API
  - CI pipeline: Makefile idempotent venv creation (--allow-existing), deprecated tool.uv.dev-dependencies migrated to dependency-groups, ruff format applied to all source files

Author: Cre4T3Tiv3

src/gitvoyant/cli/analyze.py

@@ -112,7 +112,9 @@ def analyze_temporal(
                 raise typer.Exit(code=1)
 
         languages = [language] if language else None
-        asyncio.run(_analyze_temporal_async(repo_input, file_path, window_days, languages))
+        asyncio.run(
+            _analyze_temporal_async(repo_input, file_path, window_days, languages)
+        )
         success("Temporal evaluation complete.")
 
     except typer.Exit:
@@ -123,7 +125,9 @@ def analyze_temporal(
 
 
 async def _analyze_temporal_async(
-    repo_input: str, file_path: Optional[str], window_days: int,
+    repo_input: str,
+    file_path: Optional[str],
+    window_days: int,
     languages: Optional[list[str]] = None,
 ):
     """Asynchronous implementation of temporal evaluation logic.
@@ -237,9 +241,7 @@ def launch_agent():
 
     agent = create_gitvoyant_agent()
 
-    typer.echo(
-        "\nAI agent initialized. Ask anything about repo quality or code decay."
-    )
+    typer.echo("\nAI agent initialized. Ask anything about repo quality or code decay.")
     typer.echo("Type 'exit' or 'q' to quit.\n")
 
     while True:

src/gitvoyant/infrastructure/analyzers/__init__.py

@@ -23,11 +23,16 @@
 # Directories to exclude during file discovery, per language.
 EXCLUSION_DIRS: Set[str] = {
     # Python
-    ".venv", "__pycache__", "site-packages",
+    ".venv",
+    "__pycache__",
+    "site-packages",
     # JavaScript / TypeScript
-    "node_modules", "dist", ".next",
+    "node_modules",
+    "dist",
+    ".next",
     # Java
-    "target", ".gradle",
+    "target",
+    ".gradle",
     # Go
     "vendor",
     # General
@@ -64,7 +69,8 @@ def supported_extensions(languages: Optional[List[str]] = None) -> List[str]:
     if languages is None:
         return list(_ANALYZERS.keys())
     return [
-        ext for ext, analyzer in _ANALYZERS.items()
+        ext
+        for ext, analyzer in _ANALYZERS.items()
         if analyzer.language_name in languages
     ]
 

src/gitvoyant/infrastructure/analyzers/go.py

@@ -24,28 +24,34 @@
 _PARSER = tree_sitter.Parser(_GO_LANGUAGE)
 
 # Node types that contribute to cyclomatic complexity.
-_DECISION_TYPES = frozenset({
-    "if_statement",
-    "for_statement",
-    "expression_case",       # case clauses in switch
-    "communication_case",    # case clauses in select
-    "type_case",             # case clauses in type switch
-})
+_DECISION_TYPES = frozenset(
+    {
+        "if_statement",
+        "for_statement",
+        "expression_case",  # case clauses in switch
+        "communication_case",  # case clauses in select
+        "type_case",  # case clauses in type switch
+    }
+)
 
 # Logical operators within binary_expression that add a branch.
 _LOGICAL_OPS = frozenset({"&&", "||"})
 
 # Node types counted as function/method declarations.
-_FUNC_TYPES = frozenset({
-    "function_declaration",
-    "method_declaration",
-    "func_literal",
-})
+_FUNC_TYPES = frozenset(
+    {
+        "function_declaration",
+        "method_declaration",
+        "func_literal",
+    }
+)
 
 # Node types counted as type definitions (struct, interface).
-_TYPE_TYPES = frozenset({
-    "type_declaration",
-})
+_TYPE_TYPES = frozenset(
+    {
+        "type_declaration",
+    }
+)
 
 
 def _walk(node):
@@ -72,9 +78,7 @@ def extract_metrics(self, content: str, commit) -> Dict:
             function_count = sum(
                 1 for n in _walk(tree.root_node) if n.type in _FUNC_TYPES
             )
-            class_count = sum(
-                1 for n in _walk(tree.root_node) if n.type in _TYPE_TYPES
-            )
+            class_count = sum(1 for n in _walk(tree.root_node) if n.type in _TYPE_TYPES)
         except Exception as e:
             logger.debug(f"Parse error in commit {commit.hexsha[:8]}: {e}")
             complexity = 0

src/gitvoyant/infrastructure/analyzers/java.py

@@ -24,32 +24,38 @@
 _PARSER = tree_sitter.Parser(_JAVA_LANGUAGE)
 
 # Node types that contribute to cyclomatic complexity.
-_DECISION_TYPES = frozenset({
-    "if_statement",
-    "for_statement",
-    "enhanced_for_statement",
-    "while_statement",
-    "do_statement",
-    "switch_block_statement_group",
-    "catch_clause",
-    "ternary_expression",
-})
+_DECISION_TYPES = frozenset(
+    {
+        "if_statement",
+        "for_statement",
+        "enhanced_for_statement",
+        "while_statement",
+        "do_statement",
+        "switch_block_statement_group",
+        "catch_clause",
+        "ternary_expression",
+    }
+)
 
 # Logical operators within binary_expression that add a branch.
 _LOGICAL_OPS = frozenset({"&&", "||"})
 
 # Node types counted as function/method definitions.
-_METHOD_TYPES = frozenset({
-    "method_declaration",
-    "constructor_declaration",
-})
+_METHOD_TYPES = frozenset(
+    {
+        "method_declaration",
+        "constructor_declaration",
+    }
+)
 
 # Node types counted as class/interface definitions.
-_CLASS_TYPES = frozenset({
-    "class_declaration",
-    "interface_declaration",
-    "enum_declaration",
-})
+_CLASS_TYPES = frozenset(
+    {
+        "class_declaration",
+        "interface_declaration",
+        "enum_declaration",
+    }
+)
 
 
 def _walk(node):

src/gitvoyant/infrastructure/analyzers/javascript.py

@@ -24,33 +24,39 @@
 _PARSER = tree_sitter.Parser(_JS_LANGUAGE)
 
 # Node types that contribute to cyclomatic complexity.
-_DECISION_TYPES = frozenset({
-    "if_statement",
-    "for_statement",
-    "for_in_statement",
-    "while_statement",
-    "do_statement",
-    "switch_case",
-    "catch_clause",
-    "ternary_expression",
-})
+_DECISION_TYPES = frozenset(
+    {
+        "if_statement",
+        "for_statement",
+        "for_in_statement",
+        "while_statement",
+        "do_statement",
+        "switch_case",
+        "catch_clause",
+        "ternary_expression",
+    }
+)
 
 # Logical operators within binary_expression that add a branch.
 _LOGICAL_OPS = frozenset({"&&", "||"})
 
 # Node types counted as function definitions.
-_FUNCTION_TYPES = frozenset({
-    "function_declaration",
-    "function_expression",
-    "arrow_function",
-    "method_definition",
-    "generator_function_declaration",
-})
+_FUNCTION_TYPES = frozenset(
+    {
+        "function_declaration",
+        "function_expression",
+        "arrow_function",
+        "method_definition",
+        "generator_function_declaration",
+    }
+)
 
 # Node types counted as class definitions.
-_CLASS_TYPES = frozenset({
-    "class_declaration",
-})
+_CLASS_TYPES = frozenset(
+    {
+        "class_declaration",
+    }
+)
 
 
 def _walk(node):

src/gitvoyant/infrastructure/config.py

@@ -234,9 +234,7 @@ def check_configuration() -> None:
 
     api_status = settings.validate_api_keys()
     logger.info("API Keys:")
-    logger.info(
-        f"  Anthropic: {'Configured' if api_status['claude'] else 'Missing'}"
-    )
+    logger.info(f"  Anthropic: {'Configured' if api_status['claude'] else 'Missing'}")
 
     if not api_status["any_configured"]:
         logger.warning("No AI API keys configured.")

src/gitvoyant/infrastructure/temporal_evaluator.py

@@ -116,7 +116,12 @@ class TemporalEvaluator:
         window_days (int): Analysis window in days for temporal evaluation.
     """
 
-    def __init__(self, repository_path: str, window_days: int = 180, analyzer: Optional[Analyzer] = None) -> None:
+    def __init__(
+        self,
+        repository_path: str,
+        window_days: int = 180,
+        analyzer: Optional[Analyzer] = None,
+    ) -> None:
         """Initialize the temporal evaluator for a specific repository.
 
         Sets up Git repository access and configures the analysis window for

src/gitvoyant/presentation/agents/langchain_bindings.py

@@ -307,7 +307,10 @@ def evaluate_repo(repo_path: str, max_files: int = 20) -> str:
                     continue
 
                 for file in files:
-                    if any(file.endswith(ext) for ext in exts) and len(results) < max_files:
+                    if (
+                        any(file.endswith(ext) for ext in exts)
+                        and len(results) < max_files
+                    ):
                         full_path = os.path.join(root, file)
                         rel_path = os.path.relpath(full_path, repo_path)
                         if not os.path.exists(os.path.join(repo_path, rel_path)):