sourcecode 0.10.0__tar.gz → 0.12.0__tar.gz

sourcecode-0.12.0/-o

@@ -0,0 +1,296 @@
+{
+  "metadata": {
+    "schema_version": "1.0",
+    "generated_at": "2026-04-14T20:22:58.957857+00:00",
+    "sourcecode_version": "0.12.0",
+    "analyzed_path": "/Users/user/Downloads/atlas-cli"
+  },
+  "file_tree": {
+    "pyproject.toml": null,
+    "README.md": null,
+    ".gitignore": null,
+    ".ruff.toml": null,
+    "tests": {
+      "test_detector_go_rust_java.py": null,
+      "test_integration_graph_modules.py": null,
+      "test_real_projects.py": null,
+      "conftest.py": null,
+      "test_detector_python.py": null,
+      "test_dependency_analyzer_polyglot.py": null,
+      "test_redactor.py": null,
+      "test_semantic_schema.py": null,
+      "test_integration_detection.py": null,
+      "test_dependency_schema.py": null,
+      "test_packaging.py": null,
+      "test_semantic_analyzer_node.py": null,
+      "test_integration_docs.py": null,
+      "test_coverage_parser.py": null,
+      "test_scanner.py": null,
+      "test_detector_universal_systems.py": null,
+      "test_integration_semantics.py": null,
+      "test_summarizer.py": null,
+      "__init__.py": null,
+      "test_detector_php_ruby_dart.py": null,
+      "test_integration_multistack.py": null,
+      "test_dependency_analyzer_node_python.py": null,
+      "test_architecture_summary.py": null,
+      "test_schema.py": null,
+      "test_integration_dependencies.py": null,
+      "test_workspace_analyzer.py": null,
+      "test_integration_lqn.py": null,
+      "test_doc_analyzer_jsdom.py": null,
+      "test_integration_metrics.py": null,
+      "test_semantic_analyzer_python.py": null,
+      "test_graph_analyzer_python_node.py": null,
+      "test_graph_analyzer_polyglot.py": null,
+      "test_metrics_analyzer.py": null,
+      "test_integration.py": null,
+      "test_semantic_import_resolution.py": null,
+      "test_detector_universal_managed.py": null,
+      "test_cli.py": null,
+      "test_graph_schema.py": null,
+      "test_detector_nodejs.py": null,
+      "test_detectors_base.py": null,
+      "test_doc_analyzer_python.py": null,
+      "test_classifier.py": null,
+      "test_integration_universal.py": null,
+      "fixtures": {
+        "lcov.info": null,
+        "coverage.xml": null,
+        "jacoco.xml": null,
+        "pnpm_monorepo": {
+          "pnpm-workspace.yaml": null,
+          "packages": {},
+          "apps": {}
+        },
+        "fastapi_app": {
+          "pyproject.toml": null,
+          "src": {}
+        },
+        "nextjs_app": {
+          "pnpm-lock.yaml": null,
+          "package.json": null,
+          "app": {}
+        },
+        "go_service": {
+          "go.mod": null,
+          "cmd": {}
+        }
+      }
+    },
+    "docs": {
+      "schema.md": null
+    },
+    "src": {
+      "sourcecode": {
+        "scanner.py": null,
+        "semantic_analyzer.py": null,
+        "classifier.py": null,
+        "doc_analyzer.py": null,
+        "redactor.py": null,
+        "dependency_analyzer.py": null,
+        "__init__.py": null,
+        "metrics_analyzer.py": null,
+        "cli.py": null,
+        "coverage_parser.py": null,
+        "tree_utils.py": null,
+        "serializer.py": null,
+        "summarizer.py": null,
+        "workspace.py": null,
+        "graph_analyzer.py": null,
+        "architecture_summary.py": null,
+        "schema.py": null,
+        "detectors": {
+          "java.py": null,
+          "systems.py": null,
+          "terraform.py": null,
+          "nodejs.py": null,
+          "__init__.py": null,
+          "ruby.py": null,
+          "dart.py": null,
+          "parsers.py": null,
+          "elixir.py": null,
+          "python.py": null,
+          "tooling.py": null,
+          "go.py": null,
+          "php.py": null,
+          "dotnet.py": null,
+          "jvm_ext.py": null,
+          "base.py": null,
+          "project.py": null,
+          "heuristic.py": null,
+          "rust.py": null
+        }
+      }
+    }
+  },
+  "stacks": [
+    {
+      "stack": "python",
+      "detection_method": "manifest",
+      "confidence": "high",
+      "frameworks": [
+        {
+          "name": "Typer",
+          "source": "manifest"
+        }
+      ],
+      "package_manager": "pip",
+      "manifests": [
+        "pyproject.toml"
+      ],
+      "primary": false,
+      "root": ".",
+      "workspace": null,
+      "signals": [
+        "manifest:pyproject.toml",
+        "framework:Typer",
+        "package_manager:pip",
+        "extensions:79"
+      ]
+    },
+    {
+      "stack": "nodejs",
+      "detection_method": "manifest",
+      "confidence": "medium",
+      "frameworks": [],
+      "package_manager": null,
+      "manifests": [
+        "package.json"
+      ],
+      "primary": true,
+      "root": ".claude",
+      "workspace": ".claude",
+      "signals": [
+        "manifest:package.json",
+        "extensions:6"
+      ]
+    }
+  ],
+  "project_type": "fullstack",
+  "entry_points": [],
+  "dependencies": [],
+  "dependency_summary": null,
+  "module_graph": null,
+  "module_graph_summary": null,
+  "docs": [],
+  "doc_summary": null,
+  "file_paths": [
+    "pyproject.toml",
+    "README.md",
+    ".gitignore",
+    ".ruff.toml",
+    "tests",
+    "tests/test_detector_go_rust_java.py",
+    "tests/test_integration_graph_modules.py",
+    "tests/test_real_projects.py",
+    "tests/conftest.py",
+    "tests/test_detector_python.py",
+    "tests/test_dependency_analyzer_polyglot.py",
+    "tests/test_redactor.py",
+    "tests/test_semantic_schema.py",
+    "tests/test_integration_detection.py",
+    "tests/test_dependency_schema.py",
+    "tests/test_packaging.py",
+    "tests/test_semantic_analyzer_node.py",
+    "tests/test_integration_docs.py",
+    "tests/test_coverage_parser.py",
+    "tests/test_scanner.py",
+    "tests/test_detector_universal_systems.py",
+    "tests/test_integration_semantics.py",
+    "tests/test_summarizer.py",
+    "tests/__init__.py",
+    "tests/test_detector_php_ruby_dart.py",
+    "tests/test_integration_multistack.py",
+    "tests/test_dependency_analyzer_node_python.py",
+    "tests/test_architecture_summary.py",
+    "tests/test_schema.py",
+    "tests/test_integration_dependencies.py",
+    "tests/test_workspace_analyzer.py",
+    "tests/test_integration_lqn.py",
+    "tests/test_doc_analyzer_jsdom.py",
+    "tests/test_integration_metrics.py",
+    "tests/test_semantic_analyzer_python.py",
+    "tests/test_graph_analyzer_python_node.py",
+    "tests/test_graph_analyzer_polyglot.py",
+    "tests/test_metrics_analyzer.py",
+    "tests/test_integration.py",
+    "tests/test_semantic_import_resolution.py",
+    "tests/test_detector_universal_managed.py",
+    "tests/test_cli.py",
+    "tests/test_graph_schema.py",
+    "tests/test_detector_nodejs.py",
+    "tests/test_detectors_base.py",
+    "tests/test_doc_analyzer_python.py",
+    "tests/test_classifier.py",
+    "tests/test_integration_universal.py",
+    "tests/fixtures",
+    "tests/fixtures/lcov.info",
+    "tests/fixtures/coverage.xml",
+    "tests/fixtures/jacoco.xml",
+    "tests/fixtures/pnpm_monorepo",
+    "tests/fixtures/pnpm_monorepo/pnpm-workspace.yaml",
+    "tests/fixtures/pnpm_monorepo/packages",
+    "tests/fixtures/pnpm_monorepo/apps",
+    "tests/fixtures/fastapi_app",
+    "tests/fixtures/fastapi_app/pyproject.toml",
+    "tests/fixtures/fastapi_app/src",
+    "tests/fixtures/nextjs_app",
+    "tests/fixtures/nextjs_app/pnpm-lock.yaml",
+    "tests/fixtures/nextjs_app/package.json",
+    "tests/fixtures/nextjs_app/app",
+    "tests/fixtures/go_service",
+    "tests/fixtures/go_service/go.mod",
+    "tests/fixtures/go_service/cmd",
+    "docs",
+    "docs/schema.md",
+    "src",
+    "src/sourcecode",
+    "src/sourcecode/scanner.py",
+    "src/sourcecode/semantic_analyzer.py",
+    "src/sourcecode/classifier.py",
+    "src/sourcecode/doc_analyzer.py",
+    "src/sourcecode/redactor.py",
+    "src/sourcecode/dependency_analyzer.py",
+    "src/sourcecode/__init__.py",
+    "src/sourcecode/metrics_analyzer.py",
+    "src/sourcecode/cli.py",
+    "src/sourcecode/coverage_parser.py",
+    "src/sourcecode/tree_utils.py",
+    "src/sourcecode/serializer.py",
+    "src/sourcecode/summarizer.py",
+    "src/sourcecode/workspace.py",
+    "src/sourcecode/graph_analyzer.py",
+    "src/sourcecode/architecture_summary.py",
+    "src/sourcecode/schema.py",
+    "src/sourcecode/detectors",
+    "src/sourcecode/detectors/java.py",
+    "src/sourcecode/detectors/systems.py",
+    "src/sourcecode/detectors/terraform.py",
+    "src/sourcecode/detectors/nodejs.py",
+    "src/sourcecode/detectors/__init__.py",
+    "src/sourcecode/detectors/ruby.py",
+    "src/sourcecode/detectors/dart.py",
+    "src/sourcecode/detectors/parsers.py",
+    "src/sourcecode/detectors/elixir.py",
+    "src/sourcecode/detectors/python.py",
+    "src/sourcecode/detectors/tooling.py",
+    "src/sourcecode/detectors/go.py",
+    "src/sourcecode/detectors/php.py",
+    "src/sourcecode/detectors/dotnet.py",
+    "src/sourcecode/detectors/jvm_ext.py",
+    "src/sourcecode/detectors/base.py",
+    "src/sourcecode/detectors/project.py",
+    "src/sourcecode/detectors/heuristic.py",
+    "src/sourcecode/detectors/rust.py"
+  ],
+  "project_summary": "Genera un mapa de contexto estructurado de proyectos de software para agentes IA. Stack principal: Python (Typer).",
+  "architecture_summary": "Entry point principal: src/sourcecode/cli.py expone la CLI del proyecto.\nOrquesta modulos internos: dependency_analyzer, detectors, doc_analyzer, graph_analyzer, metrics_analyzer, redactor, scanner, schema.\nActiva analisis opcionales: DependencyAnalyzer (--dependencies), GraphAnalyzer (--graph-modules), DocAnalyzer (--docs), MetricsAnalyzer (--full-metrics), SemanticAnalyzer (--semantics).\nProduce un SourceMap serializado en JSON/YAML y una vista compacta con redaccion de secretos.",
+  "key_dependencies": [],
+  "file_metrics": [],
+  "metrics_summary": null,
+  "semantic_calls": [],
+  "semantic_symbols": [],
+  "semantic_links": [],
+  "semantic_summary": null
+}

{sourcecode-0.10.0 → sourcecode-0.12.0}/PKG-INFO

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

{sourcecode-0.10.0 → sourcecode-0.12.0}/docs/schema.md

@@ -63,7 +63,7 @@ Campos:
 {
   "schema_version": "1.0",
   "generated_at": "2026-04-07T19:41:05.686277+00:00",
-  "sourcecode_version": "0.10.0",
+  "sourcecode_version": "0.12.0",
   "analyzed_path": "/abs/path/to/project"
 }
 ```
@@ -583,7 +583,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.10.0",
+    "sourcecode_version": "0.12.0",
     "analyzed_path": "/abs/path/to/project"
   },
   "file_tree": {

{sourcecode-0.10.0 → sourcecode-0.12.0}/pyproject.toml

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

{sourcecode-0.10.0 → sourcecode-0.12.0}/src/sourcecode/__init__.py

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

{sourcecode-0.10.0 → sourcecode-0.12.0}/src/sourcecode/cli.py

@@ -1,4 +1,5 @@
 """CLI de sourcecode — interfaz de linea de comandos principal."""
+from sourcecode.prepare_context import prepare_context as build_llm_context
 from __future__ import annotations
 
 import json
@@ -473,10 +474,10 @@ def main(
                 semantic_summary=sem_sum,
             )
 
-    # Phase 9: LLM Output Quality — poblar campos derivados
-    from sourcecode.architecture_summary import ArchitectureSummarizer
-    from sourcecode.summarizer import ProjectSummarizer
-    from sourcecode.tree_utils import flatten_file_tree
+    # Phase 9: LLM Output Quality — poblar campos derivados
+    from sourcecode.architecture_summary import ArchitectureSummarizer
+    from sourcecode.summarizer import ProjectSummarizer
+    from sourcecode.tree_utils import flatten_file_tree
 
     # LQN-01: lista plana de paths del file_tree con separador forward-slash
     sm.file_paths = [
@@ -496,9 +497,9 @@ def main(
 
         sm.key_dependencies = sorted(direct_deps, key=_dep_sort_key)[:15]
 
-    # LQN-02: resumen NL deterministico
-    sm.project_summary = ProjectSummarizer(target).generate(sm)
-    sm.architecture_summary = ArchitectureSummarizer(target).generate(sm)
+    # LQN-02: resumen NL deterministico
+    sm.project_summary = ProjectSummarizer(target).generate(sm)
+    sm.architecture_summary = ArchitectureSummarizer(target).generate(sm)
 
     # 4. Serializar (con o sin modo compact)
     if compact:
@@ -535,3 +536,34 @@ def main(
 
     # 5. Escribir output (CLI-04)
     write_output(content, output=output)
+
+    from sourcecode.prepare_context import ContextBuilder
+
+    @app.command("prepare-context")
+    def prepare_context_cmd(
+            task: str = typer.Argument(..., help="Descripción de la tarea"),
+            path: Path = typer.Option(".", help="Directorio del proyecto"),
+    ):
+        """
+        Prepara contexto mínimo optimizado para que un LLM modifique el código.
+        """
+        target = path.resolve()
+
+        if not target.exists() or not target.is_dir():
+            typer.echo(f"Error: '{target}' no es un directorio válido.", err=True)
+            raise typer.Exit(code=1)
+
+        builder = ContextBuilder(target)
+        result = builder.prepare(task)
+
+        output = {
+            "task": result.task,
+            "entry_points": result.entry_points,
+            "relevant_files": [f.__dict__ for f in result.relevant_files],
+            "call_flow": result.call_flow,
+            "snippets": [s.__dict__ for s in result.snippets],
+            "tests": result.tests,
+            "notes": result.notes,
+        }
+
+        typer.echo(json.dumps(output, indent=2, ensure_ascii=False))

sourcecode-0.12.0/src/sourcecode/prepare_context.py

@@ -0,0 +1,197 @@
+from __future__ import annotations
+
+from dataclasses import dataclass
+from pathlib import Path
+from typing import Any, Dict, List, Optional
+
+from sourcecode.semantic_analyzer import SemanticAnalyzer
+
+
+# =========================
+# Output schema (simple)
+# =========================
+
+@dataclass
+class ContextSnippet:
+    file: str
+    symbol: str
+    code: str
+    reason: str
+
+
+@dataclass
+class ContextFile:
+    path: str
+    role: str
+
+
+@dataclass
+class ContextResult:
+    task: str
+    entry_points: List[Dict[str, str]]
+    relevant_files: List[ContextFile]
+    call_flow: List[Dict[str, Any]]
+    snippets: List[ContextSnippet]
+    tests: List[Dict[str, str]]
+    notes: List[str]
+
+
+# =========================
+# Core Builder
+# =========================
+
+class ContextBuilder:
+    def __init__(self, root: Path) -> None:
+        self.root = root
+        self.analyzer = SemanticAnalyzer(root)
+
+    # -------------------------
+    # Public API
+    # -------------------------
+
+    def prepare(self, task: str) -> ContextResult:
+        """
+        Entry point principal.
+        """
+        semantic = self.analyzer.analyze()
+
+        entry_points = self._detect_entrypoints(semantic)
+        relevant_files = self._select_relevant_files(task, entry_points)
+        snippets = self._extract_snippets(relevant_files)
+        tests = self._find_related_tests(relevant_files)
+        call_flow = self._build_call_flow(entry_points)
+
+        notes = self._generate_notes(task)
+
+        return ContextResult(
+            task=task,
+            entry_points=entry_points,
+            relevant_files=relevant_files,
+            call_flow=call_flow,
+            snippets=snippets,
+            tests=tests,
+            notes=notes,
+        )
+
+    # -------------------------
+    # Heurísticas básicas
+    # -------------------------
+
+    def _detect_entrypoints(self, semantic: Any) -> List[Dict[str, str]]:
+        """
+        MVP: detecta cli.py o main functions
+        """
+        entrypoints: List[Dict[str, str]] = []
+
+        for path in semantic.file_paths:
+            if path.endswith("cli.py") or path.endswith("__main__.py"):
+                entrypoints.append({
+                    "file": path,
+                    "symbol": "main",
+                    "reason": "CLI entrypoint"
+                })
+
+        return entrypoints
+
+    def _select_relevant_files(
+        self,
+        task: str,
+        entry_points: List[Dict[str, str]],
+    ) -> List[ContextFile]:
+        """
+        Heurística simple:
+        - incluir entrypoints
+        - incluir archivos con palabras clave del task
+        """
+        files: List[ContextFile] = []
+
+        for ep in entry_points:
+            files.append(ContextFile(path=ep["file"], role="entrypoint"))
+
+        keywords = task.lower().split()
+
+        for path in self.analyzer.scan.file_paths:  # fallback simple
+            if any(k in path.lower() for k in keywords):
+                files.append(ContextFile(path=path, role="matched"))
+
+        # deduplicar
+        seen = set()
+        unique = []
+        for f in files:
+            if f.path not in seen:
+                seen.add(f.path)
+                unique.append(f)
+
+        return unique[:8]
+
+    def _extract_snippets(self, files: List[ContextFile]) -> List[ContextSnippet]:
+        """
+        Extrae primeras ~30 líneas como snippet simple.
+        """
+        snippets: List[ContextSnippet] = []
+
+        for f in files:
+            abs_path = self.root / f.path
+            if not abs_path.exists():
+                continue
+
+            try:
+                content = abs_path.read_text(encoding="utf-8", errors="ignore")
+            except Exception:
+                continue
+
+            snippet = "\n".join(content.splitlines()[:30])
+
+            snippets.append(ContextSnippet(
+                file=f.path,
+                symbol="module",
+                code=snippet,
+                reason=f"contenido inicial de {f.role}"
+            ))
+
+        return snippets[:12]
+
+    def _find_related_tests(self, files: List[ContextFile]) -> List[Dict[str, str]]:
+        """
+        Busca tests por naming convention.
+        """
+        tests: List[Dict[str, str]] = []
+
+        for f in files:
+            name = Path(f.path).name
+            test_name = f"test_{name}"
+
+            test_path = self.root / "tests" / test_name
+            if test_path.exists():
+                tests.append({
+                    "file": f"tests/{test_name}",
+                    "reason": "posible test relacionado"
+                })
+
+        return tests
+
+    def _build_call_flow(self, entry_points: List[Dict[str, str]]) -> List[Dict[str, Any]]:
+        """
+        MVP: placeholder (hasta que uses call graph real)
+        """
+        flow: List[Dict[str, Any]] = []
+
+        for ep in entry_points:
+            flow.append({
+                "from": ep["symbol"],
+                "to": ["unknown"]
+            })
+
+        return flow
+
+    def _generate_notes(self, task: str) -> List[str]:
+        notes: List[str] = []
+
+        if "flag" in task or "--" in task:
+            notes.append("probablemente necesitas modificar argumentos CLI")
+        if "test" in task:
+            notes.append("asegúrate de actualizar tests relacionados")
+        if "refactor" in task:
+            notes.append("mantener compatibilidad hacia atrás")
+
+        return notes