sourcecode 1.20.0__tar.gz → 1.22.0__tar.gz

sourcecode-1.22.0/.continue-here.md

@@ -0,0 +1,173 @@
+# Continue Here — atlas-cli delta engine overhaul
+
+**Paused:** 2026-05-13 (sesión 3)
+**Repo:** `/Users/user/Downloads/atlas-cli`
+**Branch:** master
+**Commit:** `8258c4c implementando delta` (committed, pushed to origin/master)
+
+---
+
+## Estado actual
+
+Sesión 3: `prepare-context delta` completamente reimplementado como motor de contexto incremental real. **Todo committed y pusheado.** Working tree limpio (solo este fichero untracked).
+
+---
+
+## Qué se implementó esta sesión
+
+### Motor delta real (`_build_delta_impact`)
+
+Reemplaza el uso de `_rank_files` para la tarea `delta`. Nuevo flujo:
+
+1. **`_classify_changed_file(path)`** — clasificador estático determinista por ruta/nombre:
+   - Tipos: `security`, `api_endpoint`, `business_logic`, `data_access`, `mybatis_mapper`, `spring_config`, `spring_profile`, `configuration`, `build_manifest`, `db_migration`, `domain_model`, `dto`, `test`, `ide_noise`, `unknown_source`, `unknown_config`, `documentation`
+   - Impacto: `critical / high / medium / low / noise`
+   - Áreas de riesgo: `security`, `api`, `transactions`, `business_logic`, `persistence`, `config`, `dependencies`, `tests`
+   - `.idea/`, `.vscode/`, etc. → `ide_noise`, `is_noise=True`
+
+2. **`_build_delta_impact(changed_files, all_paths, entry_points, since)`** — análisis de impacto:
+   - Changed files siempre incluidos en `relevant_files` (nunca filtrados por score)
+   - Expansión a ficheros relacionados: mismo módulo DDD o mismo directorio padre
+   - Solo expande a stems de alto impacto (controller, service, repository, mapper, security, config)
+   - Límite: 10 ficheros relacionados máximo
+   - Returns: `(relevant_files, impact_summary, affected_modules, risk_areas, why, analysis_gaps)`
+
+3. **Nuevos campos en `TaskOutput`** (delta only):
+   - `impact_summary: str` — resumen textual del impacto global
+   - `affected_modules: list[str]` — módulos DDD afectados
+   - `risk_areas: list[dict]` — por área con severity y ficheros
+   - `since: str` — ref usada
+
+4. **Nuevo output delta** (cli.py):
+   - `project_summary` suprimido (change-focused, no snapshot)
+   - `gaps` habilitado (delta-specific gaps, no ConfidenceAnalyzer gaps)
+   - Serializa: `since`, `impact_summary`, `affected_modules`, `risk_areas`, `reasoning`
+
+### Bugs corregidos
+
+| Bug | Fix |
+|-----|-----|
+| `relevant_files: []` con cambios reales | Changed files usan `_build_delta_impact`, no `_rank_files`. Nunca filtrados por score. |
+| `.idea/vcs.xml` → `relevant_files: []` | Clasificado como `ide_noise`, score=0.1, role="noise". Aparece con mensaje explicativo. |
+| Output idéntico a `--compact` | Delta ya no llama `_rank_files` — lógica completamente separada. |
+| `relevant_files` genérico sin relación al diff | Ahora construye desde changed_files hacia afuera, no desde entrypoints hacia adentro. |
+
+---
+
+## Ficheros modificados esta sesión
+
+```
+src/sourcecode/prepare_context.py   +_classify_changed_file, +_build_delta_impact, +TaskOutput fields, build() delta branch
+src/sourcecode/cli.py               delta content filter: project_summary=False, gaps=True, new fields serialized
+tests/test_signal_hierarchy.py      test_delta_task_returns_valid_json: project_summary not in data, impact_summary in data
+```
+
+---
+
+## Tests
+
+- **743 passed, 3 skipped** — sin regresiones nuevas
+- Fallos pre-existentes (no relacionados):
+  - `test_block2_coverage.py::test_java_marked_unsupported`
+  - `test_dependency_analyzer_node_python.py::test_python_requirements_without_lockfile`
+  - `test_pipeline_integrity.py::TestBenchmarkContamination`
+
+---
+
+## Smoke tests pendientes (necesitan saint-server)
+
+### Smoke delta (nuevo)
+
+```bash
+# Test básico: relevant_files no vacío con cambios reales
+cd saint-server
+git diff --name-only main | head -5  # confirmar hay cambios
+sourcecode prepare-context delta . --since main --output /tmp/delta_test.json
+python3 -c "
+import json; d=json.load(open('/tmp/delta_test.json'))
+assert d['task'] == 'delta'
+assert len(d['relevant_files']) > 0, 'relevant_files is EMPTY — bug not fixed'
+assert 'impact_summary' in d, 'missing impact_summary'
+assert 'affected_modules' in d or 'risk_areas' in d, 'no impact fields'
+assert 'project_summary' not in d, 'project_summary should be suppressed'
+print('delta PASS:', d['impact_summary'])
+print('changed_files:', d.get('changed_files', [])[:3])
+print('affected_modules:', d.get('affected_modules', []))
+"
+
+# Test IDE noise: .idea change → baja prioridad
+python3 -c "
+from sourcecode.prepare_context import TaskContextBuilder
+from pathlib import Path
+b = TaskContextBuilder.__new__(TaskContextBuilder)
+b.root = Path('.')
+relevant, impact, modules, risks, why, gaps = b._build_delta_impact(
+    changed_files=['.idea/vcs.xml'],
+    all_paths=[],
+    entry_points=[],
+    since='main',
+)
+assert len(relevant) == 1
+assert relevant[0].role == 'noise'
+assert relevant[0].score == 0.1
+assert 'no semantic impact' in impact
+print('IDE noise PASS:', impact)
+"
+
+# Test seguridad: cambio en SecurityConfig → impacto critical
+python3 -c "
+from sourcecode.prepare_context import TaskContextBuilder
+b = TaskContextBuilder.__new__(TaskContextBuilder)
+cls = b._classify_changed_file('src/.../security/SecurityConfig.java')
+assert cls['artifact_type'] == 'security'
+assert cls['impact_level'] == 'critical'
+assert 'security' in cls['risk_areas']
+print('security PASS:', cls)
+"
+```
+
+### Smoke tests sesión 2 (pendientes desde antes)
+
+```bash
+# FIX-1: síntoma inyecta ficheros en fix-bug
+sourcecode prepare-context fix-bug saint-server --symptom "ausencias contador" \
+  --output /tmp/fix_symptom.json
+
+# FIX-2: resource_names resueltos en security_surface  
+sourcecode saint-server --compact --output /tmp/sec_test.json
+
+# FIX-4: score presente en file_relevance
+sourcecode saint-server --agent --output /tmp/agent_test.json
+
+# (ver .continue-here.md sesión 2 para comandos completos de verificación)
+```
+
+---
+
+## Mejoras opcionales para sesión siguiente
+
+1. **`_classify_changed_file` con más patrones**: añadir `cli` (como `cli.py`) → `cli_entrypoint`, `interceptor` → `security`, `aspect` → `cross_cutting`
+2. **`--since` sin argumento**: en vez de default `HEAD~1`, inferir mejor (e.g., base del branch actual vs main)
+3. **Soporte para staged/untracked**: cuando `since` es None, incluir `git status --porcelain` para capturar staged + untracked (no solo `git diff --name-only --relative`)
+4. **Test unitario dedicado** para `_build_delta_impact` y `_classify_changed_file` en `tests/test_task_differentiation.py`
+
+---
+
+## Para retomar
+
+```bash
+cd /Users/user/Downloads/atlas-cli
+git log --oneline -3   # debe mostrar 8258c4c implementando delta
+python3 -m pytest tests/ \
+  --ignore=tests/test_block2_coverage.py \
+  --ignore=tests/test_dependency_analyzer_node_python.py \
+  --ignore=tests/test_pipeline_integrity.py -q
+# Expected: 743 passed, 3 skipped
+
+# Smoke test rápido del delta
+python3 run_cli.py prepare-context delta . --since HEAD~3 | python3 -m json.tool | head -30
+```
+
+---
+
+*Pausado 2026-05-13 sesión 3 — gsd:pause-work*

{sourcecode-1.20.0 → sourcecode-1.22.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sourcecode
-Version: 1.20.0
+Version: 1.22.0
 Summary: Deterministic codebase context for AI coding agents
 License:                                  Apache License
                                    Version 2.0, January 2004
@@ -221,7 +221,7 @@ Description-Content-Type: text/markdown
 
 **Compressed AI-ready context for Java/Spring enterprise codebases.**
 
-![Version](https://img.shields.io/badge/version-1.20.0-blue)
+![Version](https://img.shields.io/badge/version-1.22.0-blue)
 ![Python](https://img.shields.io/badge/python-3.10%2B-green)
 
 ---
@@ -255,7 +255,7 @@ pipx install sourcecode
 
 ```bash
 sourcecode version
-# sourcecode 1.20.0
+# sourcecode 1.22.0
 ```
 
 ---

{sourcecode-1.20.0 → sourcecode-1.22.0}/README.md

@@ -2,7 +2,7 @@
 
 **Compressed AI-ready context for Java/Spring enterprise codebases.**
 
-![Version](https://img.shields.io/badge/version-1.20.0-blue)
+![Version](https://img.shields.io/badge/version-1.22.0-blue)
 ![Python](https://img.shields.io/badge/python-3.10%2B-green)
 
 ---
@@ -36,7 +36,7 @@ pipx install sourcecode
 
 ```bash
 sourcecode version
-# sourcecode 1.20.0
+# sourcecode 1.22.0
 ```
 
 ---

{sourcecode-1.20.0 → sourcecode-1.22.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "sourcecode"
-version = "1.20.0"
+version = "1.22.0"
 description = "Deterministic codebase context for AI coding agents"
 readme = "README.md"
 requires-python = ">=3.9"

{sourcecode-1.20.0 → sourcecode-1.22.0}/src/sourcecode/__init__.py

@@ -1,3 +1,3 @@
 """sourcecode — Deterministic codebase context maps for AI coding agents."""
 
-__version__ = "1.20.0"
+__version__ = "1.22.0"

{sourcecode-1.20.0 → sourcecode-1.22.0}/src/sourcecode/cli.py

@@ -1727,9 +1727,9 @@ def prepare_context_cmd(
             "changed_files": False, "affected_entry_points": False,
         },
         "delta": {
-            "project_summary": True, "architecture_summary": False,
+            "project_summary": False, "architecture_summary": False,
             "relevant_files": True, "key_dependencies": False,
-            "gaps": False, "confidence": True,
+            "gaps": True, "confidence": True,
             "suspected_areas": False, "improvement_opportunities": False,
             "test_gaps": False, "code_notes_summary": False,
             "changed_files": True, "affected_entry_points": True,
@@ -1771,6 +1771,18 @@ def prepare_context_cmd(
         out["changed_files"] = output.changed_files
     if _task_include("affected_entry_points") and output.affected_entry_points:
         out["affected_entry_points"] = output.affected_entry_points
+    # Delta-specific impact fields
+    if task == "delta":
+        if output.since:
+            out["since"] = output.since
+        if output.impact_summary:
+            out["impact_summary"] = output.impact_summary
+        if output.affected_modules:
+            out["affected_modules"] = output.affected_modules
+        if output.risk_areas:
+            out["risk_areas"] = output.risk_areas
+        if output.why_these_files:
+            out["reasoning"] = output.why_these_files
     if output.limitations:
         out["limitations"] = output.limitations
     if output.symptom: