sourcecode 1.17.0__tar.gz → 1.19.0__tar.gz

sourcecode-1.19.0/.continue-here.md

@@ -0,0 +1,178 @@
+# Continue Here — atlas-cli v1.17.0 defect patch (saint-server round 2)
+
+**Paused:** 2026-05-13 (session 2)
+**Repo:** `/Users/user/Downloads/atlas-cli`
+**Branch:** master
+
+---
+
+## Estado actual
+
+Sesión 2: 6 defectos adicionales contra saint-server. **Sin commit** (instrucción explícita). Pipx venv reinstalado en modo editable para pruebas en vivo. 743 tests pasan.
+
+---
+
+## Defectos corregidos sesión 2 (ESTA SESIÓN)
+
+| ID | Sev | Fix | Fichero |
+|----|-----|-----|---------|
+| FIX-1 | CRITICAL-3 | `--symptom` secondary pass: inyecta ficheros del árbol cuyo path contiene keywords del síntoma (antes solo re-ordenaba candidatos ya en pool). role="symptom_match", score=0.5+boost | `prepare_context.py:655-676` |
+| FIX-2 | HIGH-2 | `_security_surface_from_eps` resuelve constantes Java `ClassName.FIELD_NAME` → busca `ClassName.java` en file_paths y extrae valor literal. `resource_names_unresolved[]` para las irresolubles. Call sites actualizados con root+file_paths | `serializer.py:428-522` |
+| FIX-3 | HIGH-3 | Nota truncación: `"use --full for complete list"` → `"use --full to see all {total}"` | `serializer.py:434` |
+| FIX-4 | REGRESSION | `_file_relevance` items ahora tienen campo `"score"` (= relevance_val). `GenericRestController`/`GenericCRUDRestController` override: category="runtime_core", score=0.95, relevance=0.95, reason/evidence/ranking_reasons específicos | `serializer.py:714-737` |
+| FIX-5 | MEDIUM-3 | `compact_view` confidence_summary ahora incluye `"sections"` breakdown (igual que agent_view) | `serializer.py:1046-1052` |
+| FIX-6 | LOW-1 | `_spring_profiles_context` portal profiles (con `-` en nombre): busca en path completo (no solo stem). Si no hay ficheros, añade perfil con `[]` para que esté presente en `per_profile_variants` | `serializer.py:386-406` |
+
+---
+
+## Defectos corregidos sesión 1 (pendientes de commit)
+
+### CRITICAL
+| ID | Fix | Fichero |
+|----|-----|---------|
+| C1 | `_extract_first_useful_paragraph()` rechaza snippets startup via `_STARTUP_RE` | `summarizer.py` |
+| C2 | `_bootstrap_structured()` emite `sample` (5 primeros) en vez de `modules` (todos) | `serializer.py` |
+| C3 | `safe_read_text()` fallback UTF-8→ISO-8859-1→UTF-8/replace | `tree_utils.py` + consumidores |
+| C4 | `_scan_java_patterns()` custom_annotations[] + base_classes[] | `architecture_analyzer.py` + `schema.py` |
+
+### HIGH
+| ID | Fix | Fichero |
+|----|-----|---------|
+| H1 | `_spring_profiles_context()` estructura detallada | `serializer.py` |
+| H2 | `_is_dto_mapper()` separa @Mapper real de DtoMapper | `serializer.py` |
+| H3 | `_transactional_summary()` truncate a 10 + nota | `serializer.py` |
+| H4 | `_TASK_CONTENT_MAP` per-task filter en prepare-context | `cli.py` + `prepare_context.py` |
+| H5 | Fallback `git log -n 100` + campo `hotspot_method` | `git_analyzer.py` + `schema.py` |
+
+### MEDIUM / LOW
+M1–M5, L1 — ver sesión 1.
+
+---
+
+## Ficheros modificados (ambas sesiones)
+
+```
+src/sourcecode/architecture_analyzer.py   sesión 1
+src/sourcecode/cli.py                     sesión 1
+src/sourcecode/code_notes_analyzer.py     sesión 1
+src/sourcecode/confidence_analyzer.py     sesión 1
+src/sourcecode/doc_analyzer.py            sesión 1
+src/sourcecode/git_analyzer.py            sesión 1
+src/sourcecode/schema.py                  sesión 1
+src/sourcecode/serializer.py              sesión 1 + sesión 2 (FIX-2,3,4,5,6)
+src/sourcecode/summarizer.py              sesión 1
+src/sourcecode/tree_utils.py              sesión 1
+src/sourcecode/prepare_context.py         sesión 1 + sesión 2 (FIX-1)
+```
+
+---
+
+## Tests
+
+- **743 passed, 3 skipped** (sin regresiones)
+- Fallos pre-existentes excluidos:
+  - `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 para saint-server (pendientes — no tenemos acceso a saint-server aquí)
+
+```bash
+# FIX-1: síntoma inyecta ficheros
+sourcecode prepare-context fix-bug saint-server --symptom "ausencias contador" \
+  --output /tmp/fix_symptom.json
+python3 -c "
+import json; d=json.load(open('/tmp/fix_symptom.json'))
+paths=[f['path'] for f in d['relevant_files']]
+assert any('ausencias' in p for p in paths), 'ausencias not found'
+assert any('contador' in p for p in paths), 'contador not found'
+print('FIX-1 PASS')
+"
+
+# FIX-2: resource_names resueltos
+sourcecode saint-server --compact --output /tmp/sec_test.json
+python3 -c "
+import json; d=json.load(open('/tmp/sec_test.json'))
+unresolved=[r for r in d['security_surface']['resource_names']
+            if 'SeguridadRecursosConst.' in str(r)]
+print(f'Unresolved: {len(unresolved)}')
+assert len(unresolved) < 73, 'No improvement'
+"
+
+# FIX-3: note text correcto
+sourcecode saint-server --compact --output /tmp/txn.json
+python3 -c "
+import json; d=json.load(open('/tmp/txn.json'))
+note=d.get('transactional_boundaries',{}).get('note','')
+assert '--full' in note and 'for complete list' not in note, f'bad note: {note}'
+print('FIX-3 PASS:', note)
+"
+
+# FIX-4: score presente y no nulo
+sourcecode saint-server --agent --output /tmp/agent_test.json
+python3 -c "
+import json; d=json.load(open('/tmp/agent_test.json'))
+gcr=next((f for f in d['file_relevance'] if 'GenericRestController' in f['path']),None)
+assert gcr is not None,'not found'
+assert gcr['score'] is not None,'null score'
+assert isinstance(gcr['score'],(int,float)),'not numeric'
+print('FIX-4 PASS: score=', gcr['score'])
+"
+
+# FIX-5: sections en compact
+sourcecode saint-server --compact --output /tmp/conf_test.json
+python3 -c "
+import json; d=json.load(open('/tmp/conf_test.json'))
+cs=d['confidence_summary']
+assert 'sections' in cs,'sections missing'
+assert 'file_relevance' in cs['sections'],'file_relevance key missing'
+print('FIX-5 PASS:', cs['sections'])
+"
+
+# FIX-6: portal profiles presentes
+sourcecode saint-server --compact --output /tmp/prof_test.json
+python3 -c "
+import json; d=json.load(open('/tmp/prof_test.json'))
+variants=d['spring_profiles']['per_profile_variants']
+portal=[p for p in d['spring_profiles']['detected'] if 'portal' in p]
+missing=[p for p in portal if p not in variants]
+assert len(missing)==0, f'Still missing: {missing}'
+print('FIX-6 PASS')
+"
+```
+
+---
+
+## Commit cuando listo
+
+```bash
+git add src/sourcecode/serializer.py src/sourcecode/prepare_context.py \
+        src/sourcecode/architecture_analyzer.py src/sourcecode/cli.py \
+        src/sourcecode/code_notes_analyzer.py src/sourcecode/confidence_analyzer.py \
+        src/sourcecode/doc_analyzer.py src/sourcecode/git_analyzer.py \
+        src/sourcecode/schema.py src/sourcecode/summarizer.py \
+        src/sourcecode/tree_utils.py \
+        tests/test_encoding_regression.py tests/test_task_differentiation.py \
+        tests/fixtures/
+git commit -m "fix: 21 saint-server defects across 2 sessions (C1-C4, H1-H5, M1-M5, L1, FIX-1 to FIX-6)"
+```
+
+---
+
+## Para retomar
+
+```bash
+cd /Users/user/Downloads/atlas-cli
+git diff --stat  # verificar ficheros modificados
+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
+# Then run smoke tests above against saint-server
+```
+
+---
+*Pausado 2026-05-13 sesión 2 — gsd:pause-work*

{sourcecode-1.17.0 → sourcecode-1.19.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sourcecode
-Version: 1.17.0
+Version: 1.19.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.17.0-blue)
+![Version](https://img.shields.io/badge/version-1.19.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.17.0
+# sourcecode 1.19.0
 ```
 
 ---

{sourcecode-1.17.0 → sourcecode-1.19.0}/README.md

@@ -2,7 +2,7 @@
 
 **Compressed AI-ready context for Java/Spring enterprise codebases.**
 
-![Version](https://img.shields.io/badge/version-1.17.0-blue)
+![Version](https://img.shields.io/badge/version-1.19.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.17.0
+# sourcecode 1.19.0
 ```
 
 ---

{sourcecode-1.17.0 → sourcecode-1.19.0}/pyproject.toml

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

{sourcecode-1.17.0 → sourcecode-1.19.0}/src/sourcecode/__init__.py

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

{sourcecode-1.17.0 → sourcecode-1.19.0}/src/sourcecode/prepare_context.py

@@ -637,8 +637,10 @@ class TaskContextBuilder:
         related_notes: list[dict] = []
         if task_name == "fix-bug" and symptom:
             import re as _re
+            _camel_expanded = _re.sub(r'([a-z])([A-Z])', r'\1 \2', symptom)
+            _camel_expanded = _re.sub(r'([A-Z]+)([A-Z][a-z])', r'\1 \2', _camel_expanded)
             symptom_keywords = [
-                w.lower() for w in _re.split(r"[\s\W]+", symptom)
+                w.lower() for w in _re.split(r"[\s\W]+", _camel_expanded)
                 if len(w) > 2
             ]
             if symptom_keywords:
@@ -652,12 +654,60 @@ class TaskContextBuilder:
                             "line": getattr(_n, "line", None),
                             "text": getattr(_n, "text", ""),
                         })
-                # Re-rank relevant_files: boost files whose path matches keywords
+                # Secondary pass: inject files whose path matches symptom keywords
+                # but weren't in the candidate pool (no structural/git signals).
+                _existing_paths = {rf.path for rf in relevant_files}
+                for _p in all_paths:
+                    if _p in _existing_paths:
+                        continue
+                    if Path(_p).suffix.lower() not in _ALL_EXTENSIONS:
+                        continue
+                    _p_lower = _p.lower()
+                    _matching_kws = [kw for kw in symptom_keywords if kw in _p_lower]
+                    if not _matching_kws:
+                        continue
+                    _boost = 0.2 * len(_matching_kws)
+                    _injected_score = round(min(0.5 + _boost, 1.0), 2)
+                    _first_kw = _matching_kws[0]
+                    relevant_files.append(RelevantFile(
+                        path=_p,
+                        role="symptom_match",
+                        score=_injected_score,
+                        reason=f"path matches symptom keyword: {_first_kw}",
+                        why=f"symptom injection: {', '.join(_matching_kws)}",
+                    ))
+                    _existing_paths.add(_p)
+
+                # Re-rank all relevant_files: boost files whose path matches keywords
                 def _symptom_score(rf: "RelevantFile") -> float:
                     path_lower = rf.path.lower()
                     return rf.score + 0.2 * sum(1.0 for kw in symptom_keywords if kw in path_lower)
                 relevant_files = sorted(relevant_files, key=lambda rf: -_symptom_score(rf))
 
+                # Content scan boost: read file body for symptom keywords
+                _src_exts = frozenset({".java", ".py", ".ts", ".js", ".kt", ".go"})
+                _content_boosted: list[RelevantFile] = []
+                for _rf in relevant_files:
+                    _extra = 0.0
+                    if Path(_rf.path).suffix.lower() in _src_exts:
+                        try:
+                            _lines = (self.root / _rf.path).read_text(
+                                encoding="utf-8", errors="replace"
+                            ).splitlines()[:300]
+                            _body = "\n".join(_lines).lower()
+                            _hits = sum(_body.count(kw) for kw in symptom_keywords)
+                            _extra = min(0.30, _hits * 0.02)
+                        except OSError:
+                            pass
+                    _content_boosted.append(RelevantFile(
+                        path=_rf.path,
+                        role=_rf.role,
+                        score=round(min(_rf.score + _extra, 1.0), 2),
+                        reason=_rf.reason + (f", content-match symptom (+{_extra:.2f})" if _extra > 0 else ""),
+                        why=_rf.why,
+                    ))
+                relevant_files = sorted(_content_boosted, key=lambda rf: -rf.score)
+
         # ── 7. Test gaps (generate-tests only) ────────────────────────────
         test_gaps: list[str] = []
         if task_name == "generate-tests":
@@ -839,7 +889,7 @@ class TaskContextBuilder:
         _dominant_stack = ""
         _recently_changed_stacks: set[str] = set()
         if task_name == "fix-bug":
-            _bug_kinds = {"FIXME", "BUG"}
+            _bug_kinds = {"FIXME", "BUG", "HACK", "XXX"}
             for _n in (code_notes or []):
                 if getattr(_n, "kind", "").upper() in _bug_kinds:
                     _annotated_files.add(getattr(_n, "path", ""))
@@ -996,7 +1046,16 @@ class TaskContextBuilder:
                 )
                 for total, path, rf in scored
             }
-            _selected = _ctx.select_subgraph(_ns, contracts=[], budget=15, min_score=0.15)
+            _repo_size = len(all_paths)
+            _task_budget = {
+                "fix-bug": max(20, min(40, _repo_size // 80)),
+                "onboard": max(15, min(25, _repo_size // 150)),
+                "explain": max(10, min(20, _repo_size // 200)),
+                "generate-tests": max(20, min(35, _repo_size // 100)),
+                "refactor": max(15, min(30, _repo_size // 120)),
+            }
+            _budget = _task_budget.get(task_name, 15)
+            _selected = _ctx.select_subgraph(_ns, contracts=[], budget=_budget, min_score=0.15)
             _rf_map = {path: rf for _, path, rf in scored}
             return [_rf_map[p] for p in _selected if p in _rf_map]
         except Exception:
@@ -1012,6 +1071,9 @@ class TaskContextBuilder:
             or "/tests/" in path
             or "/test/" in path
             or "/spec/" in path
+            or (name.endswith("test.java") and name != "test.java")
+            or name.endswith("tests.java")
+            or (name.startswith("test") and name.endswith(".java") and len(name) > 9)
         )
 
     def _is_source(self, path: str) -> bool:

{sourcecode-1.17.0 → sourcecode-1.19.0}/src/sourcecode/serializer.py

@@ -383,16 +383,27 @@ def _spring_profiles_context(sm: "SourceMap") -> "Optional[dict[str, Any]]":
     if not profiles:
         return None
 
-    # Per-profile variants: Java files whose name contains a profile name (case-insensitive)
+    # Per-profile variants: Java/XML files whose stem or path contains the profile name.
+    # Portal profiles (e.g. "ingesa-portal") use dash in directory/resource names but
+    # never in Java class names — match on full path instead of stem only.
     per_profile: dict[str, list[str]] = {}
     for profile in profiles:
         pfx = profile.lower()
-        matches = [
-            p for p in sm.file_paths
-            if pfx in Path(p).stem.lower() and p.endswith(".java")
-        ]
+        is_portal = "-" in profile
+        if is_portal:
+            matches = [
+                p for p in sm.file_paths
+                if pfx in p.lower() and (p.endswith(".java") or p.endswith(".xml"))
+            ]
+        else:
+            matches = [
+                p for p in sm.file_paths
+                if pfx in Path(p).stem.lower() and p.endswith(".java")
+            ]
         if matches:
             per_profile[profile] = [Path(p).name for p in matches[:5]]
+        elif is_portal:
+            per_profile[profile] = []
 
     result: dict[str, Any] = {"detected": profiles}
     if per_profile:
@@ -420,16 +431,53 @@ def _transactional_summary(sm: "SourceMap", *, full: bool = False) -> "Optional[
             if total > 10 and not full:
                 result["classes"] = classes[:10]
                 result["truncated"] = True
-                result["note"] = f"showing 10 of {total}; use --full for complete list"
+                result["note"] = f"showing 10 of {total}; use --full to see all {total}"
             return result
     return None
 
 
-def _security_surface_from_eps(eps: list) -> "Optional[dict[str, Any]]":
+def _resolve_java_constant(symbol: str, root: "Optional[Path]", file_paths: "Optional[list[str]]") -> str:
+    """Resolve a Java constant reference like ClassName.FIELD_NAME to its string value."""
+    import re as _re
+    if not root or not file_paths or "." not in symbol:
+        return symbol
+    parts = symbol.rsplit(".", 1)
+    if len(parts) != 2:
+        return symbol
+    class_name, field_name = parts
+    if not class_name or not field_name or not field_name.isupper():
+        return symbol
+    target_file = f"{class_name}.java"
+    candidates = [p for p in file_paths if Path(p).name == target_file]
+    if not candidates:
+        return symbol
+    _CONST_RE = _re.compile(
+        r'\b' + _re.escape(field_name) + r'\s*=\s*"([^"]+)"'
+    )
+    for rel_path in candidates:
+        try:
+            abs_path = root / rel_path
+            content = abs_path.read_text(encoding="utf-8", errors="replace")
+            m = _CONST_RE.search(content)
+            if m:
+                return m.group(1)
+        except OSError:
+            continue
+    return symbol
+
+
+def _security_surface_from_eps(
+    eps: list,
+    *,
+    root: "Optional[Path]" = None,
+    file_paths: "Optional[list[str]]" = None,
+) -> "Optional[dict[str, Any]]":
     """Extract @M3FiltroSeguridad resource names from entry point evidence strings."""
     import re as _re
     _NOMBRE_RE = _re.compile(r"nombreRecurso=[\"']([^\"']+)[\"']")
+    _CONST_SYMBOL_RE = _re.compile(r'^[\w]+\.[\w]+$')
     resource_names: list[str] = []
+    unresolved: list[str] = []
     seen: set[str] = set()
     for ep in eps:
         evidence = getattr(ep, "evidence", None)
@@ -437,18 +485,30 @@ def _security_surface_from_eps(eps: list) -> "Optional[dict[str, Any]]":
             continue
         for m in _NOMBRE_RE.finditer(evidence):
             nm = m.group(1)
-            if nm and nm not in seen:
-                seen.add(nm)
+            if not nm or nm in seen:
+                continue
+            seen.add(nm)
+            if _CONST_SYMBOL_RE.match(nm):
+                resolved = _resolve_java_constant(nm, root, file_paths)
+                if resolved != nm:
+                    resource_names.append(resolved)
+                else:
+                    resource_names.append(nm)
+                    unresolved.append(nm)
+            else:
                 resource_names.append(nm)
     if not resource_names:
         return None
-    return {
+    result: dict[str, Any] = {
         "schema": (
             "Values used in @M3FiltroSeguridad(nombreRecurso=VALUE) on REST controller "
             "methods. Each value names a permission resource checked at runtime."
         ),
         "resource_names": resource_names,
     }
+    if unresolved:
+        result["resource_names_unresolved"] = unresolved
+    return result
 
 
 def _bootstrap_structured(eps: list) -> "Optional[dict[str, Any]]":
@@ -712,6 +772,7 @@ def _file_relevance(sm: SourceMap, *, limit: int = _FILE_RELEVANCE_LIMIT) -> lis
             "category": file_class.category if file_class else "source",
             "confidence": file_class.confidence if file_class else "low",
             "relevance": relevance_val,
+            "score": relevance_val,
             "reason": file_class.reason if file_class else (fs.reasons[0] if fs.reasons else "source file"),
             "evidence": file_class.evidence if file_class else [],
         }
@@ -722,6 +783,18 @@ def _file_relevance(sm: SourceMap, *, limit: int = _FILE_RELEVANCE_LIMIT) -> lis
         if ranking_reasons:
             item["ranking_reasons"] = ranking_reasons
 
+        # Override metadata for known M3 base controller classes
+        if any(k in stem for k in ("GenericRestController", "GenericCRUDRestController")):
+            item["category"] = "runtime_core"
+            item["relevance"] = 0.95
+            item["score"] = 0.95
+            item["reason"] = (
+                "base class for all REST controllers — extends this to get "
+                "centralized exception handling via handlerException()"
+            )
+            item["evidence"] = ["base_rest_controller"]
+            item["ranking_reasons"] = ["universal base class", "exception handling contract"]
+
         scored.append((combined, item))
 
     # Deterministic sort: score desc, then path asc
@@ -970,7 +1043,12 @@ def compact_view(sm: SourceMap, *, no_tree: bool = False, full: bool = False) ->
     conf_dict: Any = None
     if sm.confidence_summary is not None:
         cs = sm.confidence_summary
-        conf_dict = {"overall": cs.overall, "stack": cs.stack_confidence, "entry_points": cs.entry_point_confidence}
+        conf_dict = {
+            "overall": cs.overall,
+            "stack": cs.stack_confidence,
+            "entry_points": cs.entry_point_confidence,
+            "sections": _section_confidence(sm),
+        }
         if cs.anomalies:
             conf_dict["anomalies"] = cs.anomalies
 
@@ -997,7 +1075,8 @@ def compact_view(sm: SourceMap, *, no_tree: bool = False, full: bool = False) ->
         if _app_server:
             _deployment["app_server_hint"] = _app_server
     _deploy_risks = _project_deployment_risks(sm)
-    _security_surface = _security_surface_from_eps(sm.entry_points)
+    _sec_root = Path(sm.metadata.analyzed_path) if sm.metadata.analyzed_path else None
+    _security_surface = _security_surface_from_eps(sm.entry_points, root=_sec_root, file_paths=sm.file_paths)
     _mybatis = _mybatis_pairing(sm, full=full)
     _transactional = _transactional_summary(sm, full=full)
     _git_ctx = _compact_git_context(sm)
@@ -1515,7 +1594,8 @@ def agent_view(sm: SourceMap, *, full: bool = False) -> dict[str, Any]:
         signals["semantic_graph"] = sem_info
 
     # Java/Spring: security surface, ORM structure, transactional boundaries
-    _sec_surf = _security_surface_from_eps(sm.entry_points)
+    _av_root = Path(sm.metadata.analyzed_path) if sm.metadata.analyzed_path else None
+    _sec_surf = _security_surface_from_eps(sm.entry_points, root=_av_root, file_paths=sm.file_paths)
     if _sec_surf:
         signals["security_surface"] = _sec_surf
     _mb = _mybatis_pairing(sm, full=full)

sourcecode-1.17.0/.continue-here.md

@@ -1,125 +0,0 @@
-# Continue Here — atlas-cli v1.14.0 defect patch (saint-server)
-
-**Paused:** 2026-05-13  
-**Repo:** `/Users/user/Downloads/atlas-cli`  
-**Branch:** master
-
----
-
-## Estado actual
-
-Sesión: patch de 15 defectos contra saint-server (Spring Boot 2.7 / Java 8 / 100 módulos DDD / 467 controllers). **Sin commit** (instrucción explícita: "no hagas commit"). 10 ficheros fuente modificados + 4 ficheros nuevos de test/fixtures.
-
----
-
-## Defectos corregidos esta sesión
-
-### CRITICAL
-| ID | Fix | Fichero |
-|----|-----|---------|
-| C1 | `_extract_first_useful_paragraph()` rechaza snippets de startup via `_STARTUP_RE` (≥2 hits) | `summarizer.py` |
-| C2 | `_bootstrap_structured()` emite `modules` (todos los DDD modules) en vez de `sample` (5 primeros) | `serializer.py` |
-| C3 | `safe_read_text()` con fallback UTF-8→ISO-8859-1→UTF-8/replace — elimina double-encoding de chars españoles | `tree_utils.py` + 3 consumidores |
-| C4 | `_scan_java_patterns()` escanea Java para `@interface` + `extends`, emite `custom_annotations[]` + `base_classes[]` | `architecture_analyzer.py` + `schema.py` |
-
-### HIGH
-| ID | Fix | Fichero |
-|----|-----|---------|
-| H1 | `_spring_profiles_context()` → `{detected, per_profile_variants, note}` | `serializer.py` |
-| H2 | `_is_dto_mapper()` separa `@Mapper` reales de DtoMapper. Añade `dto_mappers[]`, elimina falsos positivos en `missing_xml` | `serializer.py` |
-| H3 | `_transactional_summary()` emite todas las clases; trunca a 10 con `truncated: true` + `note` | `serializer.py` |
-| H4 | `_TASK_CONTENT_MAP` per-task filter en prepare-context. Fix `review-pr` suspected_areas filtrado a root | `cli.py` + `prepare_context.py` |
-| H5 | Fallback `git log -n 100` cuando scan por fecha retorna 0. Nuevo campo `hotspot_method` | `git_analyzer.py` + `schema.py` |
-
-### MEDIUM
-| ID | Fix | Fichero |
-|----|-----|---------|
-| M1 | `_security_surface_from_eps()` añade campo `schema` descriptor. Mantiene `resource_names` (compat) | `serializer.py` |
-| M2 | `_jndi_datasources()` escanea `application.yml` / `persistence.xml` para JNDI names | `serializer.py` |
-| M3 | `_file_relevance()` scoring: +10 entry points, +8 base classes, +6 security config, +2 utils | `serializer.py` |
-| M4 | `--agent` auto-habilita `architecture = True` | `cli.py` |
-| M5 | Help `--compact` actualizado: "1000–3000 tokens" (era "600–800") | `cli.py` |
-
-### LOW
-| ID | Fix | Fichero |
-|----|-----|---------|
-| L1 | `analysis_gaps` expandido: ADRs missing, OpenAPI missing, profile YAMLs sin comentarios | `confidence_analyzer.py` |
-
----
-
-## Ficheros modificados
-
-```
-src/sourcecode/architecture_analyzer.py   +147 líneas — C4
-src/sourcecode/cli.py                     +90 líneas  — H4, M4, M5
-src/sourcecode/code_notes_analyzer.py     +5 líneas   — C3
-src/sourcecode/confidence_analyzer.py     +54 líneas  — L1
-src/sourcecode/doc_analyzer.py            +4 líneas   — C3
-src/sourcecode/git_analyzer.py            +29 líneas  — H5
-src/sourcecode/schema.py                  +5 líneas   — C4, H5
-src/sourcecode/serializer.py              +245 líneas — C2, H1-H3, M1-M3
-src/sourcecode/summarizer.py              +26 líneas  — C1, C3
-src/sourcecode/tree_utils.py              +19 líneas  — C3 utility
-src/sourcecode/prepare_context.py         +5 líneas   — H4
-```
-
-### Ficheros nuevos
-```
-tests/test_encoding_regression.py         — 4 tests C3
-tests/test_task_differentiation.py        — 6 tests H4
-tests/fixtures/latin1_sample.java         — fixture UTF-8
-tests/fixtures/latin1_sample_iso.java     — fixture Latin-1
-```
-
----
-
-## Tests
-
-- **743 passed, 3 skipped** — 0 regresiones
-- Fallos pre-existentes excluidos:
-  - `test_block2_coverage.py::test_java_marked_unsupported` — bug pre-existente en test (`name` vs `symbol`)
-  - `test_dependency_analyzer_node_python.py::test_python_requirements_without_lockfile_keeps_declared_versions` — versión fixture incorrecta
-  - `test_pipeline_integrity.py::TestBenchmarkContamination::test_agent_splits_development_and_auxiliary_eps` — pre-existente
-
----
-
-## Pendientes para próxima sesión
-
-1. **Smoke test en saint-server real:**
-   ```bash
-   python3 run_cli.py /path/to/saint-server --compact --agent --git-context 2>/dev/null | python3 -c "
-   import json,sys; d=json.load(sys.stdin)
-   print('profiles:', d.get('spring_profiles'))
-   print('arch method:', d.get('architecture',{}).get('method'))
-   print('custom_annotations:', len(d.get('architecture',{}).get('custom_annotations',[])))
-   print('hotspot_method:', d.get('git_context',{}).get('hotspot_method'))
-   "
-   ```
-
-2. **Commit** cuando listo:
-   ```bash
-   git add src/sourcecode/ tests/test_encoding_regression.py tests/test_task_differentiation.py tests/fixtures/latin1_sample*.java
-   git commit -m "fix: 15 saint-server defects — C1-C4 critical, H1-H5 high, M1-M5 medium, L1 low"
-   ```
-
-3. **Pre-existing bugs** (no tocados):
-   - `_OPTIONAL_LABEL_MAP` en `architecture_summary.py` tiene valores en español
-   - `lombok` / `sqlite-jdbc` clasificados `role: runtime` incorrectamente
-   - `test_pipeline_integrity::test_agent_splits_development_and_auxiliary_eps` — `agent_view()` no emite `auxiliary_entry_points`
-
----
-
-## Para retomar
-
-```bash
-cd /Users/user/Downloads/atlas-cli
-git diff --stat  # verificar 10 ficheros modificados
-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
-```
-
----
-*Pausado 2026-05-13 — gsd:pause-work*