sourcecode 1.31.24__tar.gz → 1.31.25__tar.gz

sourcecode-1.31.25/.continue-here.md

@@ -0,0 +1,99 @@
+# Handoff — Sesión 29 (2026-05-25)
+
+## Position
+
+**Project:** sourcecode (atlas-cli)  
+**Activity:** Post-audit bug fixing — AUDIT_v1.31.23.md  
+**Branch:** master  
+**Last commit:** ee636c1 — fix(architecture): bounded_contexts from Maven module names  
+**Tests:** 1590 passed, 3 skipped ✅
+
+---
+
+## Work Done This Session
+
+### Session 28 (committed before this session started)
+- **P0** BFS truncation transparency: `bfs_truncated`, `depth_reached` (actual), `indirect_callers_computed`
+- **P0** Ghost `--deep` flag → fixed to `--full` in serializer.py
+- **P1** `--format` validation in `prepare-context` (exit 2 on invalid)
+- **P1** `relevant_files.score` exposed in output (round float, not popped)
+- 182 tests in TestBfsTransparencyAndTruncation passing
+
+### Session 29 (this session)
+1. **Test fix**: `test_skips_image_only_lines` — description was 22 chars, below 30-char threshold → updated to realistic length
+2. **P1 BFS sampling** (`repository_ir.py`): hub classes (>500 direct callers) now run depth-2 BFS from 20 random seeds. `indirect_callers` contains sampled results. New fields: `indirect_callers_sampled: bool`, `indirect_callers_estimated_count: int`, `indirect_callers_sample_note`. `stats.indirect_callers_computed` now `true` when sampled. 3 new tests (16 total in class).
+3. **P1 project_summary** (`summarizer.py`): `_merge_description_with_structure` for Java stacks appends quantitative suffix: N Java classes, M transactional boundaries, K controller entry points when data in SourceMap.
+4. **P2 role classification** (`repository_ir.py`):
+   - `_JAVA_ROLE_MAP` expanded: `@Entity`, `@Table`, `@MappedSuperclass`, `@Stateless`, `@Stateful`, `@MessageDriven`, `@RegisterForReflection`, `@Aspect`, `@EnableWebSecurity`, `@EnableMethodSecurity`
+   - `_java_role_from_name()`: 14 name-suffix patterns as annotation fallback (OrderServiceImpl→service, CustomerDao→repository, PaymentResource→controller)
+   - `_assemble()`: applies name fallback when annotation role == "unknown"
+5. **P2 hotspot_candidates** (`cli.py` modernize_cmd):
+   - `_get_git_churn` called for all Java files (90-day window)
+   - `hotspot_score = in_degree×2 + (churn/max_churn)×5`
+   - `git_churn_90d` field on each hotspot entry
+   - Roles expanded to include `entity`; churn-active nodes (≥3 commits, in_degree≥1) included even below coupling threshold
+6. **P2 bounded_contexts** (`architecture_analyzer.py`):
+   - `_maven_module_bounded_contexts()`: scans `src/main/java/` markers, extracts module names, strips common prefix (broadleaf-*, keycloak-*), strips -api/-impl/-core suffixes
+   - Priority 0 in `_infer_bounded_contexts()` — fires before SCC and domain approaches
+   - BroadleafCommerce result: `["catalog", "cms", "customer", "framework", "order"]` (was `["dto", "file"]`)
+   - Requires ≥2 distinct modules
+
+---
+
+## Score Update
+
+| Dimension | v1.31.23 | Projected now | Fix applied |
+|---|---|---|---|
+| Correctness impl classes | 8/10 | 8.5/10 | BFS sampling for hub classes |
+| Onboarding context quality | 7/10 | 8/10 | project_summary quantitative + bounded_contexts |
+| Modernize/dead code | 3/10 | 5.5/10 | hotspots with churn, roles classified |
+| Java/Spring depth | 8/10 | 8.5/10 | bounded_contexts Maven modules |
+| **TOTAL** | **6.5/10** | **~7.2/10** | |
+
+---
+
+## Remaining from AUDIT_v1.31.23.md
+
+### P2 unfixed (section 13, items 6–18)
+| # | Issue | File | Effort |
+|---|---|---|---|
+| P2-06 | `subsystem_summary.member_count` always 0 | cli.py modernize_cmd | Medium |
+| P2-07 | `no_security_signal` → detect filter-based security → `security_model: "filter_based"` | repository_ir.py | Medium |
+| P2-10 | `architecture.confidence` inconsistent between `--compact` and `--agent` | serializer.py | Low |
+| P2-13 | `--format`/`--no-cache` flags inconsistent across subcommands | cli.py | Medium |
+| P2-14 | URLs in code_notes truncated (missing `https://bugs.` prefix) | code_notes_analyzer.py | Low (needs repro) |
+| P2-16 | `entry_points.controllers.methods` mismatches `endpoints` count | cli.py | Medium |
+| P2-17 | `--compact --help` token claim outdated | cli.py | Trivial |
+| P2-18 | `impact` via file path: resolve to FQN before IR lookup | repository_ir.py | Low |
+
+### P2 highest impact remaining
+**P2-06 member_count=0** — `subsystem_summary.member_count` always 0 in modernize output. `modernize_cmd` reads `len(s.get("members") or [])` but `_detect_subsystems()` returns subsystem dicts without `members` list populated. Fix: populate `members` in `_detect_subsystems`.
+
+**P2-13 --format consistency** — `--format` and `--no-cache` not accepted by all subcommands. Need to audit which subcommands are missing them.
+
+---
+
+## Key Files Modified
+
+```
+src/sourcecode/repository_ir.py        — BFS sampling, role map, name classifier
+src/sourcecode/summarizer.py           — project_summary Java quantitative suffix
+src/sourcecode/architecture_analyzer.py — Maven module bounded_contexts
+src/sourcecode/cli.py                  — hotspot_candidates with git churn
+tests/test_repository_ir.py            — 3 new BFS sampling tests
+tests/test_surface_honesty.py          — test_skips_image_only_lines fix
+```
+
+---
+
+## Next Session
+
+**Recommended start:** Fix `subsystem_summary.member_count` (P2-06).
+
+Root cause: `_detect_subsystems()` in `repository_ir.py` builds subsystems but doesn't populate the `members` list that `modernize_cmd` reads. Fix: ensure each subsystem dict includes the list of FQNs belonging to it.
+
+Then: `--format`/`--no-cache` flag consistency audit (P2-13).
+
+**Resume command:** `/gsd:resume-work`
+
+**Test baseline:** `python3 -m pytest tests/ → 1590 passed, 3 skipped`

{sourcecode-1.31.24 → sourcecode-1.31.25}/PKG-INFO

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

{sourcecode-1.31.24 → sourcecode-1.31.25}/README.md

@@ -2,7 +2,7 @@
 
 **AI-ready change intelligence for Java/Spring enterprise monoliths.**
 
-![Version](https://img.shields.io/badge/version-1.31.24-blue)
+![Version](https://img.shields.io/badge/version-1.31.25-blue)
 ![Python](https://img.shields.io/badge/python-3.10%2B-green)
 
 ---
@@ -40,7 +40,7 @@ pipx install sourcecode
 
 ```bash
 sourcecode version
-# sourcecode 1.31.24
+# sourcecode 1.31.25
 ```
 
 ---

{sourcecode-1.31.24 → sourcecode-1.31.25}/pyproject.toml

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

{sourcecode-1.31.24 → sourcecode-1.31.25}/src/sourcecode/__init__.py

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

{sourcecode-1.31.24 → sourcecode-1.31.25}/src/sourcecode/cli.py

@@ -2655,6 +2655,12 @@ def repo_ir_cmd(
         help="Output format: json (default) or yaml.",
         show_default=True,
     ),
+    copy: bool = typer.Option(
+        False,
+        "--copy",
+        "-c",
+        help="Copy output to system clipboard after a successful run. No-op when --output is used or clipboard is unavailable.",
+    ),
 ) -> None:
     """Deterministic symbol-level IR for Java repositories.
 
@@ -2764,6 +2770,9 @@ def repo_ir_cmd(
             # Fallback for wrapped stdout without buffer (e.g. some test harnesses)
             _sys.stdout.write(output)
             _sys.stdout.write("\n")
+        if copy:
+            if _copy_to_clipboard(output):
+                typer.echo("✓ copied to clipboard", err=True)
 
 
 # ── impact (blast-radius / change-impact analysis) ────────────────────────────
@@ -2799,6 +2808,12 @@ def impact_cmd(
         "--include-tests",
         help="Include test files in analysis (excluded by default).",
     ),
+    copy: bool = typer.Option(
+        False,
+        "--copy",
+        "-c",
+        help="Copy output to system clipboard after a successful run. No-op when --output is used or clipboard is unavailable.",
+    ),
 ) -> None:
     """Blast-radius analysis: who calls this class and what breaks if it changes?
 
@@ -2869,6 +2884,9 @@ def impact_cmd(
             _sys.stdout.buffer.flush()
         except AttributeError:
             _sys.stdout.write(output + "\n")
+        if copy:
+            if _copy_to_clipboard(output):
+                typer.echo("✓ copied to clipboard", err=True)
 
     # Non-zero exit when target not found
     if result.get("resolution") == "not_found":
@@ -2899,6 +2917,12 @@ def endpoints_cmd(
         help="Output format: json (default) or yaml.",
         show_default=True,
     ),
+    copy: bool = typer.Option(
+        False,
+        "--copy",
+        "-c",
+        help="Copy output to system clipboard after a successful run. No-op when --output is used or clipboard is unavailable.",
+    ),
 ) -> None:
     """Extract REST API endpoint surface from Java source files.
 
@@ -2934,6 +2958,9 @@ def endpoints_cmd(
         _sys.stdout.buffer.write(output.encode("utf-8"))
         _sys.stdout.buffer.write(b"\n")
         _sys.stdout.buffer.flush()
+        if copy:
+            if _copy_to_clipboard(output):
+                typer.echo("✓ copied to clipboard", err=True)
 
 
 # ── Enterprise Workflow Commands ──────────────────────────────────────────────

sourcecode-1.31.24/.continue-here.md

@@ -1,37 +0,0 @@
-# Handoff — Sesión 26
-**Fecha:** 2026-05-25 | **Versión:** 1.31.22 | **Rama:** master
-
-## Trabajo realizado esta sesión
-
-Auditoría técnica v1.31.22 + corrección de bugs sobre BroadleafCommerce y keycloak.
-
-### Fixes commiteados (208723b)
-
-| Bug | Severidad | Fix |
-|-----|-----------|-----|
-| FQN class-name paths en endpoints (Broadleaf: 20 paths garbage) | P0 | Filtro regex en extract_java_endpoints |
-| JAX-RS impl duplicates (keycloak: ClientApi 8→4 endpoints) | P0 | _resolve_jaxrs_prefixes: skip parents con prefix vacío sin @Path |
-| project_summary copia texto de licencia/marketing de README | P1 | _extract_first_useful_paragraph: scan hasta 6 párrafos, rechaza license notices |
-| angular_version null en monorepos Java+Angular | P2 | _angular_analysis: busca también subdirectory/package.json |
-
-### Métricas post-fix
-- BroadleafCommerce endpoints: 130 → 110
-- Keycloak endpoints: 693 → 613
-- BC summary: license notice → "e-commerce framework written in Java"
-- KC summary: marketing text → "provides user federation, strong authentication"
-
-## Próximos pasos sugeridos
-1. Regression tests para los 4 fixes
-2. project_type classification: BC="api", KC="fullstack" — ambos incorrectos
-3. Colon-notation paths en Broadleaf (58, algunos legítimos {var:regex})
-
-## Archivos modificados
-- src/sourcecode/repository_ir.py
-- src/sourcecode/serializer.py
-- src/sourcecode/summarizer.py
-
-## Reanudar
-```bash
-cd /Users/user/Documents/workspace/atlas-cli
-git log --oneline -3
-```