sourcecode 0.8.0__tar.gz → 0.9.0__tar.gz

{sourcecode-0.8.0 → sourcecode-0.9.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sourcecode
-Version: 0.8.0
+Version: 0.9.0
 Summary: Genera un mapa de contexto estructurado de proyectos de software para agentes IA
 License: MIT
 Requires-Python: >=3.9

{sourcecode-0.8.0 → sourcecode-0.9.0}/docs/schema.md

@@ -61,7 +61,7 @@ Campos:
 {
   "schema_version": "1.0",
   "generated_at": "2026-04-07T19:41:05.686277+00:00",
-  "sourcecode_version": "0.8.0",
+  "sourcecode_version": "0.9.0",
   "analyzed_path": "/abs/path/to/project"
 }
 ```
@@ -582,7 +582,7 @@ Ejemplo de salida para un monorepo con web Node.js y API Python con `--dependenc
   "metadata": {
     "schema_version": "1.0",
     "generated_at": "2026-04-07T19:41:05.686277+00:00",
-    "sourcecode_version": "0.8.0",
+    "sourcecode_version": "0.9.0",
     "analyzed_path": "/abs/path/to/project"
   },
   "file_tree": {

{sourcecode-0.8.0 → sourcecode-0.9.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "sourcecode"
-version = "0.8.0"
+version = "0.9.0"
 description = "Genera un mapa de contexto estructurado de proyectos de software para agentes IA"
 readme = "README.md"
 requires-python = ">=3.9"

{sourcecode-0.8.0 → sourcecode-0.9.0}/src/sourcecode/__init__.py

@@ -1,3 +1,3 @@
 """sourcecode — Genera mapas de contexto estructurado para agentes IA."""
 
-__version__ = "0.8.0"
+__version__ = "0.9.0"

{sourcecode-0.8.0 → sourcecode-0.9.0}/src/sourcecode/cli.py

@@ -112,6 +112,11 @@ def main(
         "--full-metrics",
         help="Incluir metricas de calidad: LOC, simbolos, complejidad, tests y cobertura por fichero",
     ),
+    semantics: bool = typer.Option(
+        False,
+        "--semantics",
+        help="Incluir call graph semantico, linking cross-file de simbolos y resolucion avanzada de imports",
+    ),
 ) -> None:
     """Genera un mapa de contexto estructurado del proyecto en formato JSON o YAML."""
     # Validar formato
@@ -228,6 +233,9 @@ def main(
     doc_analyzer = DocAnalyzer() if docs else None
     metrics_analyzer = MetricsAnalyzer() if full_metrics else None
 
+    from sourcecode.semantic_analyzer import SemanticAnalyzer
+    semantic_analyzer = SemanticAnalyzer() if semantics else None
+
     root_manifests = [
         manifest
         for manifest in manifests
@@ -424,6 +432,47 @@ def main(
         metrics_summary=metrics_summary,
     )
 
+    # Semantic analysis (--semantics flag)
+    if semantic_analyzer is not None:
+        if workspace_analysis.workspaces:
+            all_sem_calls: list[Any] = []
+            all_sem_symbols: list[Any] = []
+            all_sem_links: list[Any] = []
+            all_sem_summaries: list[Any] = []
+            for ws in workspace_analysis.workspaces:
+                ws_calls, ws_syms, ws_links, ws_sum = semantic_analyzer.analyze(
+                    target / ws.path,
+                    (
+                        filter_sensitive_files(
+                            FileScanner(target / ws.path, max_depth=depth).scan_tree()
+                        )
+                    ),
+                    workspace=ws.path,
+                )
+                all_sem_calls.extend(ws_calls)
+                all_sem_symbols.extend(ws_syms)
+                all_sem_links.extend(ws_links)
+                all_sem_summaries.append(ws_sum)
+            merged_sem = semantic_analyzer.merge_summaries(all_sem_summaries)
+            sm = replace(
+                sm,
+                semantic_calls=all_sem_calls,
+                semantic_symbols=all_sem_symbols,
+                semantic_links=all_sem_links,
+                semantic_summary=merged_sem,
+            )
+        else:
+            sem_calls, sem_syms, sem_links, sem_sum = semantic_analyzer.analyze(
+                target, file_tree
+            )
+            sm = replace(
+                sm,
+                semantic_calls=sem_calls,
+                semantic_symbols=sem_syms,
+                semantic_links=sem_links,
+                semantic_summary=sem_sum,
+            )
+
     # Phase 9: LLM Output Quality — poblar campos derivados
     from sourcecode.summarizer import ProjectSummarizer
     from sourcecode.tree_utils import flatten_file_tree

{sourcecode-0.8.0 → sourcecode-0.9.0}/src/sourcecode/schema.py

@@ -236,6 +236,66 @@ class DocSummary:
     limitations: list[str] = field(default_factory=list)
 
 
+@dataclass
+class SymbolRecord:
+    """Symbol definition found in a source file."""
+
+    symbol: str               # local name: "MyClass" or "my_func"
+    kind: str                 # "function" | "class" | "constant" | "method"
+    language: str
+    path: str                 # relative path to defining file
+    line: Optional[int] = None
+    qualified_name: Optional[str] = None  # "pkg.module.MyClass"
+    exported: bool = True     # False if name starts with _ and no __all__ override
+    workspace: Optional[str] = None
+
+
+@dataclass
+class CallRecord:
+    """A resolved call from one symbol to another, possibly across files."""
+
+    caller_path: str
+    caller_symbol: str
+    callee_path: str
+    callee_symbol: str
+    call_line: Optional[int] = None
+    confidence: Literal["high", "medium", "low"] = "medium"
+    method: Literal["ast", "heuristic", "unresolved"] = "heuristic"
+    args: list[str] = field(default_factory=list)
+    kwargs: dict[str, str] = field(default_factory=dict)
+    workspace: Optional[str] = None
+
+
+@dataclass
+class SymbolLink:
+    """A symbol imported in one file, resolved to its definition in another."""
+
+    importer_path: str
+    symbol: str
+    source_path: Optional[str] = None
+    source_line: Optional[int] = None
+    is_external: bool = False
+    confidence: Literal["high", "medium", "low"] = "high"
+    method: Literal["ast", "heuristic", "unresolved"] = "ast"
+    workspace: Optional[str] = None
+
+
+@dataclass
+class SemanticSummary:
+    """Summary of the --semantics analysis."""
+
+    requested: bool = False
+    call_count: int = 0
+    symbol_count: int = 0
+    link_count: int = 0
+    languages: list[str] = field(default_factory=list)
+    language_coverage: dict[str, str] = field(default_factory=dict)
+    files_analyzed: int = 0
+    files_skipped: int = 0
+    truncated: bool = False
+    limitations: list[str] = field(default_factory=list)
+
+
 @dataclass
 class SourceMap:
     """Schema completo del output v1.0.
@@ -266,3 +326,8 @@ class SourceMap:
     # Phase 10: Code Quality Metrics
     file_metrics: list[FileMetrics] = field(default_factory=list)
     metrics_summary: Optional[MetricsSummary] = None
+    # Phase 12: Static Semantics
+    semantic_calls: list[CallRecord] = field(default_factory=list)
+    semantic_symbols: list[SymbolRecord] = field(default_factory=list)
+    semantic_links: list[SymbolLink] = field(default_factory=list)
+    semantic_summary: Optional[SemanticSummary] = None