sourcecode 1.30.29__tar.gz → 1.31.0__tar.gz

sourcecode-1.31.0/.continue-here.md

@@ -0,0 +1,101 @@
+# Continue Here — atlas-cli sesión 16
+
+**Paused:** 2026-05-20
+**Repo:** `/Users/user/Downloads/atlas-cli`
+**Branch:** master
+**Working tree:** CHANGELOG.md sin commitear (untracked)
+
+---
+
+## Trabajo de esta sesión (ya commiteado)
+
+**Commit:** `0e430c1 fix(cli+serializer): BUG-1..5 + IMP-1 — UTF-8 stdout, --exclude parsing, onboard fast scan, angular_version null, lazy_routes_count zero, test_gaps config filter`
+
+| ID | Fix | Archivo | Líneas clave |
+|---|---|---|---|
+| BUG-1 | `repo_ir_cmd` usa `stdout.buffer.write(encode("utf-8"))` en vez de `stdout.write()`. `main_entry` llama `stdout.reconfigure(encoding="utf-8")`. UnicodeEncodeError capturado con hint a `--output`. | `cli.py` | ~2367, ~2443 |
+| BUG-2 | `--exclude` añadido a `_OPTIONS_WITH_VALUE` → valor no consumido como repo path. Warning si valor es directorio existente. | `cli.py` | ~173, ~856 |
+| BUG-3 | `onboard --fast` siempre usa `AdaptiveScanner(base_depth=2)`; ya no usa git-index-only (que devolvía solo `.idea/vcs.xml`). | `prepare_context.py` | ~791 |
+| BUG-4 | `deps = {**(pkg.get("dependencies") or {}), ...}` para manejar `null` explícito en package.json. Añade `peerDependencies` como fallback. | `serializer.py` | ~1663 |
+| BUG-5 | Cuenta `loadChildren:` y `loadComponent:` (property syntax modern Angular) en vez del inexistente `loadChildren(`. | `serializer.py` | ~1644 |
+| IMP-1 | `test_gaps` excluye `.eslintrc*`, `karma.conf.js`, `tsconfig*`, `.claude/**`, etc. por defecto. Nuevo flag `--include-config` para override. | `prepare_context.py`, `cli.py` | ~1663, ~1806 |
+| IMP-2 | Stderr warning con workaround exacto cuando se detecta UnicodeEncodeError (BUG-1) o exclude value = directorio (BUG-2). | `cli.py` | ~2373, ~858 |
+
+**Tests:** `tests/test_bug_fixes_v2.py` — 14 tests, todos pasan.
+**Suite completa:** 1010 passed, 0 nuevos failures (3 pre-existentes sin tocar).
+
+---
+
+## Primera acción al retomar
+
+CHANGELOG.md quedó fuera del commit (untracked). Commitear:
+
+```bash
+cd /Users/user/Downloads/atlas-cli
+git add CHANGELOG.md
+git commit -m "docs: add CHANGELOG.md with BUG-1..5 and IMP-1 entries for v1.30.29
+
+Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>"
+```
+
+---
+
+## Pendientes (heredados de sesión 15, siguen vigentes)
+
+1. **Spring bean wiring graph** — `_build_relations` emite `injects` edges para `@Autowired`. Falta: trazar `@Configuration → @Bean → @Autowired` completo, exponer como `wiring_graph`.
+
+2. **Smoke test en repo spring-boot real:**
+   ```bash
+   cd ~/Documents/workspace/spring-boot-realworld-example-app
+   sourcecode repo-ir . --since HEAD~1 2>/dev/null | python3 -c "
+   import json, sys; d=json.load(sys.stdin)
+   print('nodes:', len(d['graph']['nodes']))
+   print('route_surface:', d.get('route_surface', []))
+   print('reverse_graph keys:', len(d.get('reverse_graph', {})))
+   "
+   ```
+
+3. **Transaction boundary tracking** — `@Transactional` detectado. Falta: emitir `transactional_boundary` edges.
+
+4. **`_diff_routes` para `@RequestMapping` en clase** — class-level mapping change debería propagarse a todos los endpoints del controller.
+
+5. **Tests para el symptom fix (sesión 15)** — validar `--symptom "sesiones"` con mock commits produce ranking diferente al baseline. Cubrir en `tests/test_prepare_context_symptom.py`.
+
+6. **`_FRONTEND_SYMPTOM_MAP`** — añadir "sesiones"/"session" con backend terms `["httpsession", "sessionmanager", "sessionservice", "sessionrepository"]`.
+
+---
+
+## Estado de tests al pausar
+
+```
+1010 passed, 3 skipped (pre-existing)
+```
+
+Pre-existing failures (no tocar):
+- `tests/test_block2_coverage.py::TestDocAnalyzerLanguageCoverage::test_java_marked_unsupported` — `DocRecord.__init__()` unexpected kwarg `name`
+- `tests/test_dependency_analyzer_node_python.py::test_python_requirements_without_lockfile_keeps_declared_versions` — typer version mismatch
+- `tests/test_scoring_calibration.py` — varios score calibration tests
+
+---
+
+## Para retomar
+
+```bash
+cd /Users/user/Downloads/atlas-cli
+git log --oneline -3   # 0e430c1 debe estar arriba
+git status             # solo CHANGELOG.md untracked
+
+# 1. Commitear CHANGELOG.md (comando arriba)
+
+# 2. Verificar suite
+python3 -m pytest tests/ \
+  --ignore=tests/test_block2_coverage.py \
+  --ignore=tests/test_scoring_calibration.py \
+  --deselect=tests/test_dependency_analyzer_node_python.py::test_python_requirements_without_lockfile_keeps_declared_versions \
+  -q
+# Expected: 1010 passed, 3 skipped
+```
+
+---
+
+*Pausado 2026-05-20 — gsd:pause-work*

sourcecode-1.30.29/.sourcecode-cache/snapshot-c6e9d39-37df4554.json → sourcecode-1.31.0/.sourcecode-cache/snapshot-0e430c1-37df4554.json

@@ -24,8 +24,8 @@
   ],
   "dependency_summary": {
     "requested": true,
-    "total_count": 10,
-    "direct": 10,
+    "total_count": 12,
+    "direct": 12,
     "sources": [
       "manifest"
     ]
@@ -139,16 +139,10 @@
     }
   },
   "code_notes": [
-    {
-      "kind": "BUG",
-      "path": "src/sourcecode/cli.py",
-      "line": 852,
-      "text": "2: parse --exclude into extra_excludes frozenset"
-    },
     {
       "kind": "BUG",
       "path": "src/sourcecode/prepare_context.py",
-      "line": 1620,
+      "line": 1628,
       "text": "#4: LOW confidence + 0 content matches → clear suspected_areas,"
     },
     {
@@ -175,6 +169,12 @@
       "line": 158,
       "text": "4 — fix-bug ranks Java (changed + annotated) above TypeScript (unchanged)"
     },
+    {
+      "kind": "BUG",
+      "path": "tests/test_repository_ir.py",
+      "line": 740,
+      "text": "3 fix: without --since, scores use call-graph centrality (never all-zero)"
+    },
     {
       "kind": "FIXME",
       "path": "tests/fixtures/latin1_sample.java",

sourcecode-1.30.29/.sourcecode-cache/snapshot-c6e9d39-e9801942.json → sourcecode-1.31.0/.sourcecode-cache/snapshot-0e430c1-e9801942.json

@@ -33,7 +33,7 @@ stacks:
   - package_manager:pip
   - entry:src/sourcecode/cli.py
   - entry:run_cli.py
-  - extensions:137
+  - extensions:144
   produced_by: python
   language_version: null
   packaging: null
@@ -48,8 +48,9 @@ contracts:
   - config_cmd() -> None
   - 'main(ctx: typer.Context, format: str, output: Optional[Pa...'
   - main_entry() -> None
-  - 'prepare_context_cmd(task: Optional[str], path: Path, sinc...'
+  - mcp_serve() -> None
   exports:
+  - prepare_context_cmd
   - repo_ir_cmd
   - telemetry_disable
   - telemetry_enable
@@ -59,6 +60,20 @@ contracts:
   deps:
   - sourcecode
   - typer
+- path: src/sourcecode/mcp/server.py
+  role: entrypoint
+  fn:
+  - 'agent(path: str, git_context: bool) -> dict'
+  - 'compact(path: str, git_context: bool) -> dict'
+  - config() -> dict
+  - "prepare_context(task: Literal['delta', 'review-pr', 'fix-..."
+  - 'repo_ir(path: str) -> dict'
+  exports:
+  - telemetry
+  - version
+  deps:
+  - mcp
+  - sourcecode
 - path: src/sourcecode/context_scorer.py
   role: util
   exports:
@@ -173,29 +188,15 @@ contracts:
     - TaskContextBuilder
     - TaskOutput
     - TaskSpec
-- path: src/sourcecode/ranking_engine.py
-  role: util
-  fn:
-  - 'compute_impact_score(runtime_impact: float, dependency_ce...'
-  - 'resolve_framework_signal(category: str | None) -> float'
-  - 'resolve_runtime_impact(category: str | None) -> float'
-  exports:
-  - k: class
-    names:
-    - FileScore
-    - RankingEngine
-    - TaskWeights
-  deps:
-  - sourcecode
 contracts_meta:
   total: 15
   shown: 15
   truncated: false
 summary:
   files: 15
-  total: 67
+  total: 70
   methods:
-    ast: 67
+    ast: 70
 confidence:
   overall: high
   stack: high

sourcecode-1.30.29/.sourcecode-cache/snapshot-c6e9d39-ee60e0cd.json → sourcecode-1.31.0/.sourcecode-cache/snapshot-0e430c1-ee60e0cd.json

@@ -42,7 +42,7 @@
         "package_manager:pip",
         "entry:src/sourcecode/cli.py",
         "entry:run_cli.py",
-        "extensions:137"
+        "extensions:144"
       ],
       "produced_by": "python",
       "language_version": null,
@@ -61,9 +61,10 @@
         "config_cmd() -> None",
         "main(ctx: typer.Context, format: str, output: Optional[Pa...",
         "main_entry() -> None",
-        "prepare_context_cmd(task: Optional[str], path: Path, sinc..."
+        "mcp_serve() -> None"
       ],
       "exports": [
+        "prepare_context_cmd",
         "repo_ir_cmd",
         "telemetry_disable",
         "telemetry_enable",
@@ -76,6 +77,25 @@
         "typer"
       ]
     },
+    {
+      "path": "src/sourcecode/mcp/server.py",
+      "role": "entrypoint",
+      "fn": [
+        "agent(path: str, git_context: bool) -> dict",
+        "compact(path: str, git_context: bool) -> dict",
+        "config() -> dict",
+        "prepare_context(task: Literal['delta', 'review-pr', 'fix-...",
+        "repo_ir(path: str) -> dict"
+      ],
+      "exports": [
+        "telemetry",
+        "version"
+      ],
+      "deps": [
+        "mcp",
+        "sourcecode"
+      ]
+    },
     {
       "path": "src/sourcecode/context_scorer.py",
       "role": "util",
@@ -262,28 +282,6 @@
           ]
         }
       ]
-    },
-    {
-      "path": "src/sourcecode/ranking_engine.py",
-      "role": "util",
-      "fn": [
-        "compute_impact_score(runtime_impact: float, dependency_ce...",
-        "resolve_framework_signal(category: str | None) -> float",
-        "resolve_runtime_impact(category: str | None) -> float"
-      ],
-      "exports": [
-        {
-          "k": "class",
-          "names": [
-            "FileScore",
-            "RankingEngine",
-            "TaskWeights"
-          ]
-        }
-      ],
-      "deps": [
-        "sourcecode"
-      ]
     }
   ],
   "contracts_meta": {
@@ -293,9 +291,9 @@
   },
   "summary": {
     "files": 15,
-    "total": 67,
+    "total": 70,
     "methods": {
-      "ast": 67
+      "ast": 70
     }
   },
   "confidence": {

sourcecode-1.31.0/CHANGELOG.md

@@ -0,0 +1,25 @@
+# Changelog
+
+## [Unreleased]
+
+### Added
+- `prepare-context generate-tests --include-config`: opt-in flag to include tooling
+  config files (`.eslintrc*`, `karma.conf.js`, `jest.config.js`, etc.) in `test_gaps`.
+  By default these are now excluded (IMP-1).
+
+### Fixed
+- **BUG-1** `repo-ir` stdout: JSON is now written via `stdout.buffer` (UTF-8) so Unicode
+  characters (e.g. `→`) survive on Windows consoles with non-UTF-8 codecs.
+  `main_entry` also calls `stdout.reconfigure(encoding='utf-8')` on startup.
+- **BUG-2** `--exclude` with a space-separated value (`--exclude "a,b"`) was silently
+  consumed as the repository path. Added `--exclude` to the options-with-value registry
+  so its argument is parsed correctly.
+- **BUG-3** `prepare-context onboard --fast` returned only the git-changed file
+  (e.g. `.idea/vcs.xml`). Fast mode for `onboard` now always uses a shallow depth-2
+  scan so manifests and entry points are reliably discovered.
+- **BUG-4** `angular_version: null` when `package.json` has `"dependencies": null`.
+  The merge now uses `or {}` so an explicit `null` key doesn't raise TypeError.
+  Also checks `peerDependencies` as a fallback source.
+- **BUG-5** `lazy_routes_count: 0` in Angular projects. Counting now uses
+  `loadChildren:` and `loadComponent:` (property syntax) instead of the defunct
+  `loadChildren(` call syntax.

{sourcecode-1.30.29 → sourcecode-1.31.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sourcecode
-Version: 1.30.29
+Version: 1.31.0
 Summary: Deterministic codebase context for AI coding agents
 License:                                  Apache License
                                    Version 2.0, January 2004
@@ -212,16 +212,19 @@ Requires-Dist: tree-sitter-javascript>=0.21; extra == 'ast'
 Requires-Dist: tree-sitter-typescript>=0.21; extra == 'ast'
 Requires-Dist: tree-sitter>=0.21; extra == 'ast'
 Provides-Extra: dev
+Requires-Dist: mcp>=1.0.0; extra == 'dev'
 Requires-Dist: mypy>=1.10; extra == 'dev'
 Requires-Dist: pytest>=8; extra == 'dev'
 Requires-Dist: ruff>=0.15; extra == 'dev'
+Provides-Extra: mcp
+Requires-Dist: mcp>=1.0.0; extra == 'mcp'
 Description-Content-Type: text/markdown
 
 # sourcecode
 
 **Deterministic, behavior-aware codebase context for AI agents and PR review.**
 
-![Version](https://img.shields.io/badge/version-1.30.29-blue)
+![Version](https://img.shields.io/badge/version-1.31.0-blue)
 ![Python](https://img.shields.io/badge/python-3.10%2B-green)
 
 ---
@@ -257,7 +260,7 @@ pipx install sourcecode
 
 ```bash
 sourcecode version
-# sourcecode 1.30.29
+# sourcecode 1.31.0
 ```
 
 ---

{sourcecode-1.30.29 → sourcecode-1.31.0}/README.md

@@ -2,7 +2,7 @@
 
 **Deterministic, behavior-aware codebase context for AI agents and PR review.**
 
-![Version](https://img.shields.io/badge/version-1.30.29-blue)
+![Version](https://img.shields.io/badge/version-1.31.0-blue)
 ![Python](https://img.shields.io/badge/python-3.10%2B-green)
 
 ---
@@ -38,7 +38,7 @@ pipx install sourcecode
 
 ```bash
 sourcecode version
-# sourcecode 1.30.29
+# sourcecode 1.31.0
 ```
 
 ---

{sourcecode-1.30.29 → sourcecode-1.31.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "sourcecode"
-version = "1.30.29"
+version = "1.31.0"
 description = "Deterministic codebase context for AI coding agents"
 readme = "README.md"
 requires-python = ">=3.9"
@@ -39,12 +39,16 @@ dev = [
     "pytest>=8",
     "ruff>=0.15",
     "mypy>=1.10",
+    "mcp>=1.0.0",
 ]
 ast = [
     "tree-sitter>=0.21",
     "tree-sitter-typescript>=0.21",
     "tree-sitter-javascript>=0.21",
 ]
+mcp = [
+    "mcp>=1.0.0",
+]
 
 [[tool.mypy.overrides]]
 module = ["tree_sitter", "tree_sitter_typescript", "tree_sitter_javascript"]

{sourcecode-1.30.29 → sourcecode-1.31.0}/src/sourcecode/__init__.py

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