sourcecode 0.5.0__tar.gz → 0.6.0__tar.gz

{sourcecode-0.5.0 → sourcecode-0.6.0}/.gitignore

@@ -1,3 +1,4 @@
+# Python cache and build artifacts
 __pycache__/
 *.pyc
 *.pyo
@@ -11,8 +12,7 @@ build/
 .mypy_cache/
 .ruff_cache/
 .pytest_cache/
-*.pyc
-/src/*.egg-info/
+src/*.egg-info/
 
 # Editor / IDE
 .idea/
@@ -22,6 +22,12 @@ build/
 .claude/
 .codex/
 
+# Environment / secrets
+*.env
+*.secret.json
+
 # OS cruft
 .DS_Store
 Thumbs.db
+
+.planning

{sourcecode-0.5.0 → sourcecode-0.6.0}/PKG-INFO

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

{sourcecode-0.5.0 → sourcecode-0.6.0}/docs/schema.md

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

{sourcecode-0.5.0 → sourcecode-0.6.0}/pyproject.toml

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

{sourcecode-0.5.0 → sourcecode-0.6.0}/src/sourcecode/__init__.py

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

sourcecode-0.5.0/.github/workflows/ci.yml

@@ -1,42 +0,0 @@
-name: CI
-
-on:
-  push:
-    branches:
-      - main
-  pull_request:
-
-jobs:
-  test:
-    runs-on: ubuntu-latest
-    strategy:
-      fail-fast: false
-      matrix:
-        python-version: ["3.9", "3.10", "3.11", "3.12"]
-
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-
-      - name: Set up Python
-        uses: actions/setup-python@v5
-        with:
-          python-version: ${{ matrix.python-version }}
-
-      - name: Upgrade pip
-        run: python -m pip install --upgrade pip
-
-      - name: Install project and dev dependencies
-        run: python -m pip install -e ".[dev]"
-
-      - name: Ruff
-        run: ruff check src tests
-
-      - name: Mypy
-        run: mypy src
-
-      - name: Pytest
-        run: pytest -q
-
-      - name: Smoke test console script
-        run: sourcecode --version

sourcecode-0.5.0/.github/workflows/release.yml

@@ -1,101 +0,0 @@
-name: Release
-
-on:
-  workflow_dispatch:
-    inputs:
-      target:
-        description: "Repositorio de publicacion"
-        required: true
-        default: "testpypi"
-        type: choice
-        options:
-          - testpypi
-          - pypi
-  release:
-    types:
-      - published
-
-permissions:
-  contents: read
-  id-token: write
-
-jobs:
-  build:
-    runs-on: ubuntu-latest
-
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-
-      - name: Set up Python
-        uses: actions/setup-python@v5
-        with:
-          python-version: "3.12"
-
-      - name: Upgrade pip
-        run: python -m pip install --upgrade pip
-
-      - name: Install build tooling
-        run: python -m pip install build
-
-      - name: Build sdist and wheel
-        run: python -m build
-
-      - name: Smoke test built wheel
-        run: |
-          python -m venv .venv-smoke
-          .venv-smoke/bin/python -m pip install --upgrade pip
-          .venv-smoke/bin/python -m pip install dist/*.whl
-          .venv-smoke/bin/sourcecode --version
-
-      - name: Upload distribution artifacts
-        uses: actions/upload-artifact@v4
-        with:
-          name: python-dist
-          path: dist/
-
-  publish-testpypi:
-    needs: build
-    runs-on: ubuntu-latest
-    if: >-
-      ${{
-        github.event_name == 'workflow_dispatch' && github.event.inputs.target == 'testpypi'
-        || github.event_name == 'release' && github.event.release.prerelease
-      }}
-    environment:
-      name: testpypi
-      url: https://test.pypi.org/p/sourcecode
-
-    steps:
-      - name: Download distribution artifacts
-        uses: actions/download-artifact@v4
-        with:
-          name: python-dist
-          path: dist/
-
-      - name: Publish to TestPyPI with trusted publishing
-        uses: pypa/gh-action-pypi-publish@release/v1
-        with:
-          repository-url: https://test.pypi.org/legacy/
-
-  publish-pypi:
-    needs: build
-    runs-on: ubuntu-latest
-    if: >-
-      ${{
-        github.event_name == 'workflow_dispatch' && github.event.inputs.target == 'pypi'
-        || github.event_name == 'release' && !github.event.release.prerelease
-      }}
-    environment:
-      name: pypi
-      url: https://pypi.org/p/sourcecode
-
-    steps:
-      - name: Download distribution artifacts
-        uses: actions/download-artifact@v4
-        with:
-          name: python-dist
-          path: dist/
-
-      - name: Publish to PyPI with trusted publishing
-        uses: pypa/gh-action-pypi-publish@release/v1

sourcecode-0.5.0/.planning/PROJECT.md

@@ -1,79 +0,0 @@
-# SourceMap Gen
-
-## Qué es esto
-
-Herramienta CLI de Python (instalable via pip) que analiza cualquier proyecto de software desde su directorio raíz y genera ficheros JSON/YAML con contexto estructurado del proyecto: árbol de archivos, stack tecnológico, arquitectura inferida (cliente/servidor/monorepo), módulos principales, puntos de entrada y APIs expuestas. El output está diseñado para ser inyectado como contexto inicial en agentes IA de desarrollo.
-
-## Valor Core
-
-Un agente IA que recibe el output de esta herramienta llega al proyecto ya informado — no necesita preguntar lo obvio ni explorar ciegamente el código.
-
-## Requisitos
-
-### Validados
-
-(Ninguno aún — pendiente de publicar para validar)
-
-### Activos
-
-- [ ] CLI instalable via `pip install` y ejecutable con un solo comando en la raíz del proyecto
-- [ ] Detección automática del stack tecnológico (lenguajes, frameworks, gestores de dependencias)
-- [ ] Generación de árbol de archivos filtrado (excluyendo node_modules, .git, build artifacts, etc.)
-- [ ] Inferencia de arquitectura: cliente, servidor, fullstack, monorepo, librería
-- [ ] Análisis profundo de ficheros clave para extraer: módulos principales, puntos de entrada, APIs expuestas
-- [ ] Output en formato JSON y/o YAML machine-readable
-- [ ] Funciona sobre proyectos reales de cualquier stack sin configuración previa
-
-### Fuera de Alcance
-
-- Interfaz web o GUI — herramienta de línea de comandos únicamente
-- Análisis de rendimiento o métricas de código — el foco es contexto estructural, no calidad
-- Integración directa con IDEs en v1 — primero CLI, luego extensiones
-- Servidor MCP en v1 — posible en versión futura una vez validada la herramienta
-
-## Contexto
-
-El problema que resuelve: los agentes IA que asisten en desarrollo pierden tiempo (y tokens) explorando la estructura del proyecto haciendo preguntas básicas que deberían conocer de antemano. Esta herramienta genera ese "mapa mental" del proyecto de forma automática y en formato que los agentes pueden consumir directamente.
-
-El output tiene dos usos principales:
-1. **Inyección al inicio de sesión**: el desarrollador pasa el fichero generado como contexto al agente antes de empezar a trabajar
-2. **Consulta bajo demanda**: el agente puede invocar la herramienta cuando necesita entender una parte del proyecto
-
-La herramienta debe funcionar correctamente sobre proyectos reales desde el día 1, con soporte universal y detección especializada para los stacks más comunes (Node.js, Python, Go, Java, Rust).
-
-## Restricciones
-
-- **Lenguaje**: Python — la herramienta en sí está escrita en Python
-- **Distribución**: pip — instalable como paquete estándar de Python
-- **Sin dependencias pesadas**: debe poder instalarse y ejecutarse sin entornos complejos
-- **Rendimiento**: el análisis no debe tardar más de unos segundos en proyectos de tamaño normal
-- **Stack agnóstico**: no puede depender de herramientas del stack analizado para funcionar
-
-## Decisiones Clave
-
-| Decisión | Justificación | Estado |
-|----------|---------------|--------|
-| Output JSON/YAML (no Markdown) | Machine-readable para consumo directo por agentes | — Pendiente |
-| Análisis profundo de ficheros clave | Un árbol de archivos solo no es suficiente para que el agente entienda la arquitectura | — Pendiente |
-| CLI pip en v1 (no MCP server) | Validar el valor primero con el formato más simple | — Pendiente |
-| Detección universal desde v1 | Los proyectos reales no son solo Node o solo Python | — Pendiente |
-
-## Evolución
-
-Este documento evoluciona en cada transición de fase y al cerrar hitos.
-
-**Tras cada fase** (via `/gsd-transition`):
-1. ¿Requisitos invalidados? → Mover a Fuera de Alcance con motivo
-2. ¿Requisitos validados? → Mover a Validados con referencia de fase
-3. ¿Nuevos requisitos emergidos? → Añadir a Activos
-4. ¿Decisiones que registrar? → Añadir a Decisiones Clave
-5. ¿"Qué es esto" sigue siendo preciso? → Actualizar si ha derivado
-
-**Tras cada hito** (via `/gsd-complete-milestone`):
-1. Revisión completa de todas las secciones
-2. Check del Valor Core — ¿sigue siendo la prioridad correcta?
-3. Auditoría de Fuera de Alcance — ¿los motivos siguen siendo válidos?
-4. Actualizar Contexto con el estado actual
-
----
-*Última actualización: 2026-04-07 tras inicialización*

sourcecode-0.5.0/.planning/REQUIREMENTS.md

@@ -1,111 +0,0 @@
-# Requisitos: SourceMap Gen
-
-**Definido:** 2026-04-07
-**Valor Core:** Un agente IA que recibe el output de esta herramienta llega al proyecto ya informado — no necesita preguntar lo obvio ni explorar ciegamente el código.
-
-## Requisitos v1
-
-Requisitos para la publicación inicial. Cada uno mapea a fases del roadmap.
-
-### CLI
-
-- [ ] **CLI-01**: El usuario puede ejecutar `sourcemap-gen` en la raíz de cualquier proyecto sin argumentos y obtener output
-- [ ] **CLI-02**: El usuario puede especificar directorio objetivo con `sourcemap-gen [ruta]`
-- [ ] **CLI-03**: El usuario puede elegir formato de salida con `--format json|yaml` (por defecto: json)
-- [ ] **CLI-04**: El usuario puede especificar fichero de salida con `--output [fichero]` (por defecto: stdout)
-- [ ] **CLI-05**: El usuario puede activar el modo compacto con `--compact` para output reducido (~500 tokens)
-- [ ] **CLI-06**: La herramienta muestra versión con `--version` y ayuda con `--help`
-
-### Escáner
-
-- [x] **SCAN-01**: La herramienta traversa el árbol de directorios respetando las reglas de `.gitignore` del proyecto analizado
-- [x] **SCAN-02**: La herramienta excluye directorios de dependencias por defecto: `node_modules`, `__pycache__`, `.git`, `vendor`, `venv`, `.venv`, `dist`, `build`, `target`
-- [x] **SCAN-03**: La herramienta no sigue symlinks (protección frente a bucles infinitos)
-- [x] **SCAN-04**: La herramienta limita la profundidad de búsqueda de manifiestos a nivel raíz (profundidad 0-1) para evitar falsos positivos
-- [x] **SCAN-05**: El árbol de ficheros resultante se limita a una profundidad configurable (por defecto: 4 niveles)
-
-### Detección de Stack
-
-- [ ] **DETECT-01**: La herramienta detecta el stack tecnológico mediante ficheros indicadores (no ejecutando código del proyecto)
-- [ ] **DETECT-02**: La herramienta detecta con soporte completo: Node.js, Python, Go, Rust, Java, PHP, Ruby, Dart/Flutter
-- [ ] **DETECT-03**: La herramienta detecta lenguajes por extensión de fichero para proyectos sin manifiesto formal
-- [ ] **DETECT-04**: La herramienta identifica el framework principal dentro de cada stack (Express, FastAPI, Django, Gin, etc.) parseando los manifiestos de dependencias
-- [ ] **DETECT-05**: El output refleja múltiples stacks cuando el proyecto es multi-stack o monorepo
-- [ ] **DETECT-06**: La herramienta infiere el tipo de proyecto: `webapp`, `api`, `library`, `cli`, `monorepo`, `fullstack`, `unknown`
-- [ ] **DETECT-07**: Cada detección incluye un nivel de confianza: `high`, `medium`, `low`
-
-### Output
-
-- [ ] **OUT-01**: El output JSON sigue un schema versionado (`schema_version: "1.0"`) estable y documentado
-- [ ] **OUT-02**: El output incluye: metadatos del análisis, árbol de ficheros filtrado, stacks detectados, frameworks, tipo de proyecto, puntos de entrada detectados
-- [ ] **OUT-03**: El output está disponible en JSON (canónico) y YAML (alias con el mismo schema)
-- [ ] **OUT-04**: El modo `--compact` emite solo: tipo de proyecto, stacks principales, puntos de entrada y árbol de primer nivel (~500 tokens)
-- [ ] **OUT-05**: Los proyectos sin manifiesto emiten output válido con `detection_confidence: low` en lugar de error
-
-### Seguridad
-
-- [x] **SEC-01**: La herramienta redacta por defecto valores que coincidan con patrones de secretos conocidos (tokens GitHub `ghp_`, claves OpenAI `sk-`, AWS keys `AKIA`, etc.) en cualquier campo de texto del output
-- [x] **SEC-02**: Los ficheros `.env` y `*.secret` se excluyen del análisis de contenido por defecto
-- [x] **SEC-03**: La redacción de secretos está activa por defecto y requiere `--no-redact` para desactivarla
-
-### Distribución
-
-- [ ] **DIST-01**: La herramienta es instalable con `pip install sourcemap-gen` en Python 3.9+
-- [ ] **DIST-02**: El paquete usa `pyproject.toml` con `hatchling` como build backend
-- [ ] **DIST-03**: La herramienta no requiere dependencias del stack analizado para funcionar
-- [ ] **DIST-04**: El paquete incluye tests de integración ejecutables con `pytest`
-
-## Requisitos v2
-
-Diferidos a versión futura. Reconocidos pero fuera del roadmap actual.
-
-### Extensibilidad
-
-- **EXT-01**: Sistema de plugins via entry points de setuptools (`[project.entry-points."sourcemap_gen.detectors"]`)
-- **EXT-02**: Fichero `.sourcemapignore` para reglas de exclusión personalizadas por proyecto
-- **EXT-03**: Detector de stack instalable como paquete pip separado sin modificar el núcleo
-
-### Análisis Profundo
-
-- **DEEP-01**: Extracción de endpoints REST por framework (decoradores FastAPI/Flask, routes Express, config/routes.rb Rails)
-- **DEEP-02**: Análisis de imports para identificar módulos más referenciados (estilo RepoMap de Aider)
-- **DEEP-03**: Flag `--deep` que activa análisis de contenido de ficheros clave con `magika` para detección por contenido
-
-### Integración
-
-- **INT-01**: Servidor MCP para que agentes IA invoquen la herramienta directamente
-- **INT-02**: Flag `--git-metadata` para incluir rama actual, último commit, autores principales
-
-## Fuera de Alcance
-
-| Funcionalidad | Motivo |
-|---------------|--------|
-| Interfaz web o GUI | Herramienta de línea de comandos por diseño; GUI añade complejidad sin valor para el caso de uso principal |
-| Integración con IDEs en v1 | Web-first (CLI), extensiones IDE en versiones futuras |
-| Análisis de rendimiento o calidad de código | El foco es contexto estructural para agentes IA, no métricas de calidad |
-| Detección basada en ML/modelos | Rules-based es más fiable, predecible y sin dependencias pesadas |
-| Ejecución de código del proyecto analizado | Riesgo de seguridad inaceptable; toda detección debe ser estática |
-| Output en Markdown (para consumo humano) | El output JSON/YAML ya es el formato óptimo; Markdown puede generarse encima si se necesita |
-
-## Trazabilidad
-
-Actualizada durante la creación del roadmap.
-
-| Requisito | Fase | Estado |
-|-----------|------|--------|
-| CLI-01 a CLI-06 | Fase 1 | Pendiente |
-| SCAN-01 a SCAN-05 | Fase 1 | Pendiente |
-| SEC-01 a SEC-03 | Fase 1 | Pendiente |
-| DIST-01 a DIST-04 | Fase 1 | Pendiente |
-| OUT-01 a OUT-05 | Fase 1-2 | Pendiente |
-| DETECT-01 a DETECT-04 | Fase 2 | Pendiente |
-| DETECT-05 a DETECT-07 | Fase 3 | Pendiente |
-
-**Cobertura:**
-- Requisitos v1: 27 total
-- Mapeados a fases: 27
-- Sin mapear: 0 ✓
-
----
-*Requisitos definidos: 2026-04-07*
-*Última actualización: 2026-04-07 tras definición inicial*

sourcecode-0.5.0/.planning/ROADMAP.md

@@ -1,204 +0,0 @@
-# Roadmap: Sourcecode
-
-## Descripcion General
-
-Sourcecode se construye en diez fases que van desde el scaffold del proyecto hasta la publicacion y evolucion hacia un scanner de proyectos cada vez mas universal. La Fase 1 entrega una CLI funcional con escaner, seguridad y output estructurado. La Fase 2 implementa los detectores de los 8 ecosistemas principales y el pipeline de deteccion. La Fase 3 anade clasificacion de tipo de proyecto y soporte multi-stack. La Fase 4 pule, prueba sobre proyectos reales y publica en PyPI. La Fase 5 expande cobertura de stacks, ecosistemas y senales. Las Fases 6 a 10 anaden inteligencia opcional para dependencias, grafos internos, documentacion estructurada, metricas de calidad e historia operativa, manteniendo `sourcecode .` como comando base rapido.
-
-## Fases
-
-- [x] **Fase 1: Fundaciones** - CLI instalable, escaner con respeto a .gitignore, schema JSON versionado, redaccion de secretos y packaging
-- [x] **Fase 2: Deteccion Core** - AbstractDetector + detectores para 8 ecosistemas, parseo de manifiestos, deteccion de frameworks y puntos de entrada
-- [x] **Fase 3: Clasificacion y Multi-Stack** - TypeClassifier, soporte monorepo/fullstack y niveles de confianza
-- [x] **Fase 4: Pulido y Publicacion** - Tests de integracion sobre proyectos reales, documentacion, CI/CD y publicacion en PyPI
-- [x] **Fase 5: Scanner Universal** - Ampliar stacks, ecosistemas y senales de deteccion para cubrir mas tipos de proyectos reales
-- [x] **Fase 6: Dependencias Inteligentes** - Dependencias exactas, transitivas y resolucion multi-ecosistema con `--dependencies`
-- [x] **Fase 7: Grafos de Codigo** - Grafo de modulos, imports, llamadas y jerarquias estructurales con `--graph-modules`
-- [ ] **Fase 8: Documentacion Extraida** - Docstrings, comentarios y resúmenes de modulos consumibles por IA con `--docs`
-- [ ] **Fase 9: Metricas de Calidad** - LOC, complejidad, tests asociados y cobertura con `--full-metrics`
-- [ ] **Fase 10: Contexto Git y Operativo** - Historia git, volatilidad, CI/CD, Docker y metadata de entorno con `--git-history`
-
-## Detalles de Fases
-
-### Fase 1: Fundaciones
-**Goal**: El usuario puede instalar `sourcemap-gen` via pip, ejecutarlo en cualquier directorio y obtener un JSON/YAML valido con metadatos del proyecto, arbol de ficheros filtrado y sin secretos expuestos.
-**Depends on**: Nothing (primera fase)
-**Requirements**: CLI-01, CLI-02, CLI-03, CLI-04, CLI-05, CLI-06, SCAN-01, SCAN-02, SCAN-03, SCAN-04, SCAN-05, SEC-01, SEC-02, SEC-03, DIST-01, DIST-02, DIST-03, DIST-04, OUT-01, OUT-02, OUT-03, OUT-04
-**Status**: COMPLETE — verified 2026-04-07 (5/5 success criteria)
-**Success Criteria** (what must be TRUE):
-  1. El usuario ejecuta `sourcemap-gen` en la raiz de un proyecto y obtiene JSON valido en stdout sin configuracion previa
-  2. El usuario ejecuta `sourcemap-gen --format yaml --output mapa.yaml` y el fichero se genera con el mismo schema que el JSON
-  3. El arbol de ficheros en el output no contiene entradas de `node_modules/`, `.git/`, `__pycache__/`, `venv/` ni artefactos de build
-  4. El usuario ejecuta `sourcemap-gen --compact` y el output tiene como maximo ~500 tokens con tipo de proyecto, stack principal, puntos de entrada y arbol de primer nivel
-  5. El output nunca expone valores de ficheros `.env` ni patrones de secreto conocidos (`ghp_`, `sk-`, `AKIA`); el schema incluye `schema_version: "1.0"`
-**Plans**: 4 planes
-
-Plans:
-- [x] 01-01-PLAN.md — Scaffold Python: pyproject.toml con hatchling, src-layout, CLI Typer con todos los flags (CLI-01..06, DIST-01..04)
-- [x] 01-02-PLAN.md — Scanner de ficheros: FileScanner con pathspec/GitIgnoreSpec, exclusiones por defecto, symlinks, profundidad (SCAN-01..05)
-- [x] 01-03-PLAN.md — Schema JSON v1.0 y serializer: dataclasses AnalysisMetadata+SourceMap, to_json/to_yaml/compact_view (OUT-01..04)
-- [x] 01-04-PLAN.md — Redactor de secretos e integracion CLI: SecretRedactor, conexion scanner+schema+redactor+serializer en main() (SEC-01..03)
-
-### Fase 2: Deteccion Core
-**Goal**: La herramienta detecta el stack tecnologico y los frameworks de los 8 ecosistemas principales (Node.js, Python, Go, Rust, Java, PHP, Ruby, Dart) parseando ficheros indicadores y manifiestos, e identifica los puntos de entrada del proyecto.
-**Depends on**: Fase 1
-**Requirements**: DETECT-01, DETECT-02, DETECT-03, DETECT-04
-**Success Criteria** (what must be TRUE):
-  1. Ejecutado sobre un proyecto Next.js, el output incluye `stack: nodejs`, `frameworks: [Next.js]`, `package_manager: pnpm/npm/yarn` sin ejecutar ningun codigo del proyecto
-  2. Ejecutado sobre un proyecto FastAPI, el output incluye `stack: python`, `frameworks: [FastAPI]` inferido del `pyproject.toml` o `requirements.txt`
-  3. Ejecutado sobre un proyecto sin manifiesto formal (solo ficheros `.py` sueltos), el output incluye `stack: python` con `detection_method: heuristic` inferido por extension de fichero
-  4. El output incluye `entry_points` con al menos un punto de entrada valido para proyectos Node.js, Python, Go y Rust (inferido de manifiestos o patrones de nombre)
-**Plans**: 4 planes
-
-Plans:
-- [x] 02-01: `AbstractDetector` + orquestador — clase base con contrato `can_detect`/`detect`, `DetectionResult` con stack/confidence/frameworks/package_manager, orquestador `ProjectDetector` que ejecuta todos los detectores sobre el file index
-- [x] 02-02: Detectores Node.js y Python — `NodejsDetector` (package.json, tsconfig, lock files; frameworks via deps: react/next/express/fastapi-equivalentes), `PythonDetector` (pyproject.toml, requirements.txt, setup.py, Pipfile, uv.lock; frameworks: django/flask/fastapi/typer)
-- [x] 02-03: Detectores Go, Rust y Java — `GoDetector` (go.mod, cmd/; frameworks: gin/echo/cobra), `RustDetector` (Cargo.toml, src/main.rs vs src/lib.rs; frameworks: axum/actix/clap), `JavaDetector` (pom.xml, build.gradle; frameworks: spring-boot/quarkus/android)
-- [x] 02-04: Detectores PHP, Ruby y Dart — `PhpDetector` (composer.json, artisan; frameworks: laravel/symfony), `RubyDetector` (Gemfile, config/routes.rb; frameworks: rails/sinatra), `DartDetector` (pubspec.yaml, lib/main.dart; flutter vs dart puro); deteccion heuristica por extension como fallback universal (DETECT-03)
-**UI hint**: no
-
-### Fase 3: Clasificacion y Multi-Stack
-**Goal**: El output refleja correctamente proyectos multi-stack y monorepos, clasifica el tipo de proyecto (webapp/api/library/cli/monorepo/fullstack/unknown) e incluye niveles de confianza en cada deteccion.
-**Depends on**: Fase 2
-**Requirements**: DETECT-05, DETECT-06, DETECT-07, OUT-05
-**Success Criteria** (what must be TRUE):
-  1. Ejecutado sobre un monorepo con `pnpm-workspace.yaml` o `go.work`, el output tiene `project_type: monorepo` y lista los sub-proyectos con sus propios stacks
-  2. Ejecutado sobre un proyecto fullstack (Next.js + FastAPI en el mismo repo), el output lista ambos stacks con `primary: true/false` en lugar de reportar solo uno
-  3. Cada stack detectado incluye `confidence: high|medium|low` basado en el numero y peso de los indicadores encontrados
-  4. Ejecutado sobre un directorio sin ningun manifiesto conocido, el output es JSON valido con `detection_confidence: low` y `project_type: unknown` en lugar de error
-**Plans**: 2 planes
-
-Plans:
-- [x] 03-01: `TypeClassifier` — logica de clasificacion webapp/api/library/cli/monorepo/fullstack/unknown basada en senales (directorios pages/, routes/, components/, presencia de bin en package.json, src/lib.rs, etc.); niveles de confianza high/medium/low por numero y peso de indicadores (DETECT-06, DETECT-07)
-- [x] 03-02: Soporte monorepo y multi-stack — deteccion de senales de monorepo (pnpm-workspace.yaml, go.work, Cargo.toml [workspace], lerna.json, turbo.json); analisis recursivo limitado a profundidad 3; output estructurado con lista de workspaces y sus stacks (DETECT-05); proyectos sin manifiesto emiten output valido con confidence low (OUT-05)
-**UI hint**: no
-
-### Fase 4: Pulido y Publicacion
-**Goal**: La herramienta supera tests de integracion sobre proyectos reales de los stacks principales, tiene documentacion de usuario completa y esta publicada en PyPI como `sourcemap-gen`.
-**Depends on**: Fase 3
-**Requirements**: (ninguno nuevo — esta fase valida y publica lo construido en las fases anteriores)
-**Success Criteria** (what must be TRUE):
-  1. Los tests de integracion sobre proyectos reales (un repo Next.js, un repo FastAPI, un repo Go, un monorepo) pasan en CI sin fallos
-  2. `pip install sourcemap-gen` en Python 3.9, 3.10, 3.11 y 3.12 instala la herramienta correctamente y `sourcemap-gen --version` devuelve la version
-  3. El README explica en menos de 5 minutos de lectura como instalar, usar y que contiene el output; la documentacion del schema esta disponible en el repositorio
-  4. El repositorio tiene CI/CD con GitHub Actions que ejecuta tests en la matriz Python 3.9-3.12 y publica a PyPI automaticamente en cada tag de release
-**Status**: COMPLETE — implemented 2026-04-07; pytest green, docs and workflows added, lint/type debt remains visible in CI
-**Plans**: 3 planes
-
-Plans:
-- [x] 04-01: Tests de integracion — suite de tests contra proyectos reales como fixtures (Next.js, FastAPI, Go stdlib, monorepo pnpm); verificacion del schema completo y smoke de packaging local
-- [x] 04-02: Documentacion de usuario — README con instalacion, uso rapido, descripcion del schema y ejemplos de output; documentacion del schema JSON v1.0 en `docs/schema.md`
-- [x] 04-03: CI/CD y publicacion PyPI — GitHub Actions con matriz Python 3.9-3.12 (lint, typecheck, tests); publicacion automatizada via trusted publishing (OIDC) para TestPyPI/PyPI
-**UI hint**: no
-
-## Progreso
-
-### Fase 5: Scanner Universal
-**Goal**: La herramienta aumenta significativamente su cobertura y se comporta mas cerca de un scanner universal, detectando mas ecosistemas, manifests, build systems y senales heuristicas en proyectos reales que hoy quedan como `unknown` o parcialmente clasificados.
-**Depends on**: Fase 4
-**Requirements**: DETECT-08, DETECT-09, DETECT-10, OUT-06
-**Success Criteria** (what must be TRUE):
-  1. Ejecutado sobre proyectos de ecosistemas adicionales o tooling menos comun, la herramienta detecta correctamente el stack principal sin depender de un unico manifiesto convencional
-  2. Ejecutado sobre repos con combinaciones de manifests/build files (`Dockerfile`, `Makefile`, `Procfile`, `bun.lockb`, `poetry.lock`, `composer.lock`, `Gemfile.lock`, etc.), el output usa esas senales para elevar confianza o completar clasificacion
-  3. Ejecutado sobre proyectos mixtos o legacy con estructura irregular, la herramienta reduce de forma visible los casos `project_type: unknown` y `stacks: []`
-  4. El schema conserva compatibilidad hacia atras, pero incorpora senales mas expresivas para justificar detecciones multi-fuente
-**Status**: COMPLETE — implemented 2026-04-07; new stacks added, universal signals integrated, full suite green
-**Plans**: 4 planes
-
-Plans:
-- [x] 05-01: Base universal de senales — manifests alternativos, tooling transversal, scoring multi-fuente y deduplicacion del pipeline
-- [x] 05-02: Nuevos ecosistemas managed — detectores para .NET/C#, Elixir/Phoenix y JVM ampliado (Kotlin/Scala)
-- [x] 05-03: Ecosistemas infra/systems — Terraform, C/C++, build files y capa de tooling universal
-- [x] 05-04: Integracion universal end-to-end — fixtures adicionales, fusion heuristica final y regresion completa de CLI/suite
-**UI hint**: no
-
-### Fase 6: Dependencias Inteligentes
-**Goal**: La herramienta puede enumerar dependencias externas con versiones exactas y, cuando haya lockfiles o metadata suficiente, resolver tambien dependencias transitivas sin sacrificar la velocidad del comando base.
-**Depends on**: Fase 5
-**Requirements**: DEPS-01, DEPS-02, DEPS-03, OUT-07
-**Success Criteria** (what must be TRUE):
-  1. Ejecutado como `sourcecode . --dependencies` sobre proyectos Python, Node.js, PHP, Ruby, Rust, Go y .NET, el output lista dependencias directas con nombre, version exacta o constraint y origen del dato (`manifest`, `lockfile`, `tooling`)
-  2. Cuando existe lockfile compatible (`package-lock.json`, `pnpm-lock.yaml`, `poetry.lock`, `uv.lock`, `Gemfile.lock`, `composer.lock`, etc.), el output incluye dependencias transitivas y las relaciona con su dependencia padre o grafo de resolucion
-  3. El comando base `sourcecode .` mantiene su latencia habitual y no resuelve arboles transitivos salvo que el usuario active `--dependencies`
-  4. El schema expone dependencias de forma uniforme entre ecosistemas para que agentes IA puedan detectar incompatibilidades, duplicados o riesgos de version
-**Status**: COMPLETE — implemented 2026-04-08; dependency analysis integrated behind `--dependencies`, full suite green
-**Plans**: 4 planes
-
-Plans:
-- [x] 06-01: Base de dependencias — schema, flag `--dependencies` y analizador lazy desacoplado
-- [x] 06-02: Node.js y Python — manifests + lockfiles con deps directas, resueltas y transitivas
-- [x] 06-03: PHP, Ruby, Rust, Go y .NET — cobertura polyglot con limites explicitos donde la transitividad offline sea parcial
-- [x] 06-04: Integracion final — workspaces/monorepo, tests end-to-end y documentacion publica del contrato
-**UI hint**: no
-
-### Fase 7: Grafos de Codigo
-**Goal**: La herramienta construye una vista estructural del codigo con relaciones entre modulos, imports, llamadas y jerarquias basicas para ayudar a agentes y humanos a entender flujo y acoplamiento.
-**Depends on**: Fase 6
-**Requirements**: GRAPH-01, GRAPH-02, GRAPH-03, OUT-08
-**Success Criteria** (what must be TRUE):
-  1. Ejecutado como `sourcecode . --graph-modules`, el output incluye un grafo de imports internos entre modulos o paquetes del proyecto en al menos Python, Node.js/TypeScript, Java y Go cuando la informacion estatico-sintactica sea suficiente
-  2. El output identifica nodos clave como funciones top-level, clases o entry points y, cuando sea factible con analisis seguro, relaciones de llamada o uso entre ellos
-  3. En proyectos grandes o multi-stack, el analisis se degrada con seguridad mediante limites de profundidad/tamano en lugar de bloquearse o intentar parseo total no acotado
-  4. El schema deja claro el nivel de confianza y el metodo de construccion del grafo (`ast`, `heuristic`, `unresolved`) para que el consumidor sepa cuanto confiar en cada arista
-**Status**: COMPLETE — implemented 2026-04-08; module graph integrated behind `--graph-modules`, full suite green
-**Plans**: 4 planes
-
-Plans:
-- [x] 07-01: Base del grafo — schema, flag `--graph-modules` y analizador lazy desacoplado
-- [x] 07-02: Python y Node.js/TypeScript — imports internos, nodos de modulo y degradacion segura
-- [x] 07-03: Relaciones estructurales y soporte polyglot — llamadas simples, jerarquias basicas y soporte inicial Go/JVM
-- [x] 07-04: Integracion final — workspaces, limites de analisis, tests end-to-end y documentacion publica del contrato
-**UI hint**: no
-
-### Fase 8: Documentacion Extraida
-**Goal**: La herramienta extrae documentacion util del codigo y la transforma en un resumen estructurado por modulo, clase o funcion para consumo de agentes IA y onboarding tecnico.
-**Depends on**: Fase 7
-**Requirements**: DOCS-01, DOCS-02, DOCS-03, OUT-09
-**Success Criteria** (what must be TRUE):
-  1. Ejecutado como `sourcecode . --docs`, el output incluye docstrings, comentarios de cabecera y descripciones resumidas por modulo para lenguajes soportados donde el parseo sea fiable
-  2. El output distingue entre documentacion explicita del autor y resumen inferido por la herramienta para evitar mezclar texto original con interpretaciones
-  3. Los modulos principales del proyecto incluyen un resumen compacto con proposito, simbolos destacados y relaciones con otros componentes
-  4. El schema sigue siendo consumible por maquinas y evita volcar bloques enormes de texto sin estructura ni procedencia
-**Plans**: 0 planes
-**UI hint**: no
-
-### Fase 9: Metricas de Calidad
-**Goal**: La herramienta aporta senales cuantitativas sobre complejidad, tamano, tests y cobertura para priorizar refactors, auditorias y trabajo de agentes automaticos.
-**Depends on**: Fase 8
-**Requirements**: METRICS-01, METRICS-02, METRICS-03, OUT-10
-**Success Criteria** (what must be TRUE):
-  1. Ejecutado como `sourcecode . --full-metrics`, el output incluye lineas por archivo o modulo, recuentos de simbolos y una medida de complejidad al menos para los lenguajes donde haya analisis estatico seguro
-  2. La herramienta detecta archivos o suites de tests relacionadas y asocia modulos productivos con evidencia de cobertura o ausencia de pruebas
-  3. Cuando existe metadata de cobertura (`coverage.xml`, `.coverage`, `lcov.info`, `jacoco.xml`, etc.), el output la incorpora sin ejecutar tests por defecto
-  4. El comando distingue claramente entre metricas medidas, inferidas y no disponibles para no transmitir precision falsa
-**Plans**: 0 planes
-**UI hint**: no
-
-### Fase 10: Contexto Git y Operativo
-**Goal**: La herramienta añade contexto historico y operativo del repositorio para identificar volatilidad, expertos, integraciones de despliegue y superficie de automatizacion.
-**Depends on**: Fase 9
-**Requirements**: GIT-01, OPS-01, OPS-02, OUT-11
-**Success Criteria** (what must be TRUE):
-  1. Ejecutado como `sourcecode . --git-history`, el output resume commits recientes, autores, frecuencia de cambio y archivos o modulos mas volatiles sin requerir llamadas de red
-  2. La herramienta identifica configuraciones operativas relevantes como `Dockerfile`, `docker-compose`, workflows de GitHub Actions, Terraform, Helm, Makefiles o scripts de despliegue y los agrega como metadata estructurada
-  3. Las variables de entorno o secretos solo se reportan como metadata segura (`nombre`, `origen`, `uso aproximado`) sin exponer valores sensibles
-  4. El comando base `sourcecode .` sigue centrado en estructura + stacks + workflows, mientras que el contexto historico/operativo ampliado queda detras de flags explicitamente solicitados
-**Plans**: 0 planes
-**UI hint**: no
-
-## Progreso
-
-**Orden de ejecucion:**
-Las fases se ejecutan en orden numerico: 1 → 2 → 3 → 4 → 5 → 6 → 7 → 8 → 9 → 10
-
-| Fase | Planes Completos | Estado | Completada |
-|------|-----------------|--------|------------|
-| 1. Fundaciones | 4/4 | Complete   | 2026-04-07 |
-| 2. Deteccion Core | 4/4 | Complete   | 2026-04-07 |
-| 3. Clasificacion y Multi-Stack | 2/2 | Complete   | 2026-04-07 |
-| 4. Pulido y Publicacion | 3/3 | Complete   | 2026-04-07 |
-| 5. Scanner Universal | 4/4 | Complete   | 2026-04-07 |
-| 6. Dependencias Inteligentes | 4/4 | Complete | 2026-04-08 |
-| 7. Grafos de Codigo | 4/4 | Complete | 2026-04-08 |
-| 8. Documentacion Extraida | 0/0 | Not planned | - |
-| 9. Metricas de Calidad | 0/0 | Not planned | - |
-| 10. Contexto Git y Operativo | 0/0 | Not planned | - |