sourcecode 0.2.0__py3-none-any.whl → 0.4.0__py3-none-any.whl

sourcecode/schema.py

@@ -68,6 +68,79 @@ class EntryPoint:
     source: str = "manifest"
 
 
+@dataclass
+class DependencyRecord:
+    """Dependencia detectada del proyecto."""
+
+    name: str
+    ecosystem: str
+    scope: str = "direct"
+    declared_version: Optional[str] = None
+    resolved_version: Optional[str] = None
+    source: str = "manifest"
+    parent: Optional[str] = None
+    manifest_path: Optional[str] = None
+    workspace: Optional[str] = None
+
+
+@dataclass
+class DependencySummary:
+    """Resumen del analisis de dependencias."""
+
+    requested: bool = False
+    total_count: int = 0
+    direct_count: int = 0
+    transitive_count: int = 0
+    ecosystems: list[str] = field(default_factory=list)
+    sources: list[str] = field(default_factory=list)
+    limitations: list[str] = field(default_factory=list)
+
+
+@dataclass
+class GraphNode:
+    """Nodo del grafo estructural del codigo."""
+
+    id: str
+    kind: str
+    language: str
+    path: str
+    symbol: Optional[str] = None
+    display_name: Optional[str] = None
+    workspace: Optional[str] = None
+
+
+@dataclass
+class GraphEdge:
+    """Arista del grafo estructural del codigo."""
+
+    source: str
+    target: str
+    kind: str
+    confidence: Literal["high", "medium", "low"] = "medium"
+    method: Literal["ast", "heuristic", "unresolved"] = "heuristic"
+
+
+@dataclass
+class ModuleGraphSummary:
+    """Resumen del analisis estructural del grafo."""
+
+    requested: bool = False
+    node_count: int = 0
+    edge_count: int = 0
+    languages: list[str] = field(default_factory=list)
+    methods: list[str] = field(default_factory=list)
+    limitations: list[str] = field(default_factory=list)
+
+
+@dataclass
+class ModuleGraph:
+    """Grafo de modulos, simbolos y relaciones del proyecto."""
+
+    nodes: list[GraphNode] = field(default_factory=list)
+    edges: list[GraphEdge] = field(default_factory=list)
+    summary: ModuleGraphSummary = field(default_factory=ModuleGraphSummary)
+
+
 @dataclass
 class SourceMap:
     """Schema completo del output v1.0.
@@ -85,3 +158,6 @@ class SourceMap:
     stacks: list[StackDetection] = field(default_factory=list)
     project_type: Optional[str] = None                    # relleno en Fase 3
     entry_points: list[EntryPoint] = field(default_factory=list)
+    dependencies: list[DependencyRecord] = field(default_factory=list)
+    dependency_summary: Optional[DependencySummary] = None
+    module_graph: Optional[ModuleGraph] = None

{sourcecode-0.2.0.dist-info → sourcecode-0.4.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sourcecode
-Version: 0.2.0
+Version: 0.4.0
 Summary: Genera un mapa de contexto estructurado de proyectos de software para agentes IA
 License: MIT
 Requires-Python: >=3.9
@@ -46,6 +46,18 @@ Analyze another directory and write YAML to a file:
 sourcecode --format yaml --output sourcecode.yaml /path/to/project
 ```
 
+Include direct dependencies, exact versions, and transitive dependencies when compatible lockfiles are available:
+
+```bash
+sourcecode . --dependencies
+```
+
+Include an internal module graph with imports and simple structural relations:
+
+```bash
+sourcecode . --graph-modules
+```
+
 Show the version:
 
 ```bash
@@ -57,6 +69,8 @@ Main options:
 - `--format json|yaml`: output format.
 - `--output PATH`: write to a file instead of `stdout`.
 - `--compact`: return a reduced view with `schema_version`, `project_type`, `stacks`, `entry_points`, and `file_tree_depth1`.
+- `--dependencies`: include direct dependencies, resolved versions, and transitive relationships when lockfiles make that possible.
+- `--graph-modules`: include a structural graph with modules, imports, and simple relations such as `contains`, `calls`, or `extends`.
 - `--depth INTEGER`: maximum file tree depth.
 - `--no-redact`: disable secret redaction.
 
@@ -152,6 +166,106 @@ The full schema includes:
 - `stacks`: stack detections with confidence, frameworks, manifests, `primary`, `root`, `workspace`, and `signals`.
 - `project_type`: overall project classification.
 - `entry_points`: detected entry points by stack.
+- `dependencies`: optional dependency records with declared and resolved versions.
+- `dependency_summary`: optional summary with ecosystem coverage, counts, and known limitations.
+- `module_graph`: optional structural graph with nodes, edges, and analysis limits.
+
+Example dependency block:
+
+```json
+{
+  "dependencies": [
+    {
+      "name": "fastapi",
+      "ecosystem": "python",
+      "scope": "direct",
+      "declared_version": ">=0.115",
+      "resolved_version": "0.115.2",
+      "source": "lockfile",
+      "parent": null,
+      "manifest_path": "poetry.lock",
+      "workspace": "packages/api"
+    },
+    {
+      "name": "starlette",
+      "ecosystem": "python",
+      "scope": "transitive",
+      "declared_version": null,
+      "resolved_version": "0.38.6",
+      "source": "lockfile",
+      "parent": "fastapi",
+      "manifest_path": "poetry.lock",
+      "workspace": "packages/api"
+    }
+  ],
+  "dependency_summary": {
+    "requested": true,
+    "total_count": 2,
+    "direct_count": 1,
+    "transitive_count": 1,
+    "ecosystems": ["python"],
+    "sources": ["lockfile"],
+    "limitations": []
+  }
+}
+```
+
+Dependency analysis is still offline and conservative: if a lockfile does not expose a reliable transitive graph, `sourcecode` reports direct dependencies and records the limitation instead of guessing.
+
+Example module graph block:
+
+```json
+{
+  "module_graph": {
+    "nodes": [
+      {
+        "id": "module:app/main.py",
+        "kind": "module",
+        "language": "python",
+        "path": "app/main.py",
+        "symbol": null,
+        "display_name": "app/main.py",
+        "workspace": null
+      },
+      {
+        "id": "function:app/main.py:run",
+        "kind": "function",
+        "language": "python",
+        "path": "app/main.py",
+        "symbol": "run",
+        "display_name": "run",
+        "workspace": null
+      }
+    ],
+    "edges": [
+      {
+        "source": "module:app/main.py",
+        "target": "module:app/utils.py",
+        "kind": "imports",
+        "confidence": "high",
+        "method": "ast"
+      },
+      {
+        "source": "function:app/main.py:run",
+        "target": "function:app/utils.py:helper",
+        "kind": "calls",
+        "confidence": "medium",
+        "method": "ast"
+      }
+    ],
+    "summary": {
+      "requested": true,
+      "node_count": 2,
+      "edge_count": 2,
+      "languages": ["python"],
+      "methods": ["ast"],
+      "limitations": []
+    }
+  }
+}
+```
+
+Graph analysis is also offline and conservative. `sourcecode` prefers partial but defensible edges over pretending to build a perfect semantic call graph, and it records parse failures, unresolved imports, or analysis budgets in `module_graph.summary.limitations`.
 
 Detailed reference: [docs/schema.md](/Users/user/Documents/workspace/atlas/atlas-cli/docs/schema.md).
 

{sourcecode-0.2.0.dist-info → sourcecode-0.4.0.dist-info}/RECORD

@@ -1,9 +1,11 @@
-sourcecode/__init__.py,sha256=kSF53Kglqc3H1-xnzSg40MVrMtrK-Fq-mxBVtQDGJig,99
+sourcecode/__init__.py,sha256=iBHGXEsmbN21QO7wvQ3ZZhBy96xjvWrfacPsjTSGcds,99
 sourcecode/classifier.py,sha256=7ubGTn5vfw9z-9eosLIYDtQUu7d8dvB4XKKDxysUVSM,6910
-sourcecode/cli.py,sha256=sf1nf-BmPWzscFvoScNkKIlfU10wepOgTfFE-lf4NO4,6962
+sourcecode/cli.py,sha256=NysuO95KIxpBEpRiwor93_WFvdMvjk0ArDRv8KPX440,10136
+sourcecode/dependency_analyzer.py,sha256=c8tSbUpug-2avKNWCP4-_e2_uhBwWl96LwL1Be8O90M,39067
+sourcecode/graph_analyzer.py,sha256=hskmEr-c5z3HjWr2S_2ccaVSMrpikYdMY-ExbAiaK60,29353
 sourcecode/redactor.py,sha256=abSf5jH_IzYzpjF3lEN6hCwdXxvmyHs-3DHz9fd8Mic,2883
 sourcecode/scanner.py,sha256=TvcuD77m_NF8OlTj3XH1b_jO0qrto8c90fND96ecqb0,6182
-sourcecode/schema.py,sha256=E2_EnuYWHWZOLarxENvL5S66QBkZIpyV1BzKetCJWIY,2487
+sourcecode/schema.py,sha256=h5uemXKCrPVpEslO2iM_Kw3ax-4UmpOpkfK50HgTNo4,4517
 sourcecode/serializer.py,sha256=hezTYOAAvZ2yPn7Te7Eu42ajbMhVCsUkuUZtqx4wjAs,3085
 sourcecode/tree_utils.py,sha256=5WHQc2L-AGqxKFfYYcQftE6hETxgUxP9MWDuaThcAUw,991
 sourcecode/workspace.py,sha256=1L4xH38gU89fLeMYSuF3ft7lSdCyTfMfJ9NQt5q4Ric,6904
@@ -26,7 +28,7 @@ sourcecode/detectors/rust.py,sha256=iUz9lE4HfBy8CBaDwGhfh6kLsNIovrH2ay2v3y6qNDc,
 sourcecode/detectors/systems.py,sha256=qf5M9tio1H6XDorSstTWIxKe0xVLR_QGTJpFGyhDz4A,1690
 sourcecode/detectors/terraform.py,sha256=5EOKQtTViWo7u3tFK0h45YD8GQPwhrww0cOicxGPPn4,1732
 sourcecode/detectors/tooling.py,sha256=wPvudLCJZ8_cr9GIx44C8jkLAlEN9uTUZcJsP7eVYnQ,1937
-sourcecode-0.2.0.dist-info/METADATA,sha256=kfVit3IrZnWnPAtbKcLjMK3SXCfHbNlSP8JrxB6zI0o,4086
-sourcecode-0.2.0.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
-sourcecode-0.2.0.dist-info/entry_points.txt,sha256=voDtdlGU2-jR3wCZpQoOls_0eUKaDVCKIfajGHFDATs,50
-sourcecode-0.2.0.dist-info/RECORD,,
+sourcecode-0.4.0.dist-info/METADATA,sha256=gj14EtCMRfrSsiMpfMN1E2AaRObCQCU3Z_Io7Xpx_b4,7339
+sourcecode-0.4.0.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
+sourcecode-0.4.0.dist-info/entry_points.txt,sha256=voDtdlGU2-jR3wCZpQoOls_0eUKaDVCKIfajGHFDATs,50
+sourcecode-0.4.0.dist-info/RECORD,,