sourcecode 1.35.26__tar.gz → 1.35.28__tar.gz

{sourcecode-1.35.26 → sourcecode-1.35.28}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sourcecode
-Version: 1.35.26
+Version: 1.35.28
 Summary: Persistent structural context and ultra-fast repeated analysis for AI coding agents
 License-File: LICENSE
 Keywords: agents,ai,codebase,context,developer-tools,llm
@@ -40,7 +40,7 @@ Description-Content-Type: text/markdown
 
 **Persistent structural context and ultra-fast repeated analysis for AI coding agents.**
 
-![Version](https://img.shields.io/badge/version-1.35.26-blue)
+![Version](https://img.shields.io/badge/version-1.35.28-blue)
 ![Python](https://img.shields.io/badge/python-3.10%2B-green)
 
 ---
@@ -114,7 +114,9 @@ pipx install sourcecode
 
 ```bash
 sourcecode version
-# sourcecode 1.35.26
+# sourcecode 1.35.28
+
+**v1.35.28** — 7 bug fixes: `rename-class` cross-package disambiguation (BUG-4), `rename-class` collision detection (BUG-2), `find_java_files` false positive on `com/test/` package paths (BUG-1), `cold-start --compact` correct key names (BUG-6), `@EnableMethodSecurity` no longer suppresses SEC-001 (BUG-3), `explain` @Entity stereotype detection (BUG-5), XML+annotation mixed security retagging (BUG-7).
 ```
 
 ---

{sourcecode-1.35.26 → sourcecode-1.35.28}/README.md

@@ -2,7 +2,7 @@
 
 **Persistent structural context and ultra-fast repeated analysis for AI coding agents.**
 
-![Version](https://img.shields.io/badge/version-1.35.26-blue)
+![Version](https://img.shields.io/badge/version-1.35.28-blue)
 ![Python](https://img.shields.io/badge/python-3.10%2B-green)
 
 ---
@@ -76,7 +76,9 @@ pipx install sourcecode
 
 ```bash
 sourcecode version
-# sourcecode 1.35.26
+# sourcecode 1.35.28
+
+**v1.35.28** — 7 bug fixes: `rename-class` cross-package disambiguation (BUG-4), `rename-class` collision detection (BUG-2), `find_java_files` false positive on `com/test/` package paths (BUG-1), `cold-start --compact` correct key names (BUG-6), `@EnableMethodSecurity` no longer suppresses SEC-001 (BUG-3), `explain` @Entity stereotype detection (BUG-5), XML+annotation mixed security retagging (BUG-7).
 ```
 
 ---

{sourcecode-1.35.26 → sourcecode-1.35.28}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "sourcecode"
-version = "1.35.26"
+version = "1.35.28"
 description = "Persistent structural context and ultra-fast repeated analysis for AI coding agents"
 readme = "README.md"
 requires-python = ">=3.9"

{sourcecode-1.35.26 → sourcecode-1.35.28}/src/sourcecode/__init__.py

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

{sourcecode-1.35.26 → sourcecode-1.35.28}/src/sourcecode/cli.py

@@ -242,6 +242,10 @@ _SUBCOMMANDS: frozenset[str] = frozenset(
         "explain",
         # Spring Boot 2→3 migration readiness
         "migrate-check",
+        # Native file rename (BLOCKER-A)
+        "rename-class",
+        # Large file semantic chunking (BLOCKER-B)
+        "chunk-file",
     }
 )
 
@@ -5009,6 +5013,240 @@ def modernize_cmd(
         _copy_to_clipboard(output)
 
 
+# ── rename-class ──────────────────────────────────────────────────────────────
+
+@app.command("rename-class")
+def rename_class_cmd(
+    path: Path = typer.Argument(
+        Path("."),
+        help="Repository root to operate on (default: current directory)",
+    ),
+    old_name: str = typer.Option(
+        ..., "--from", "-f",
+        help="Current class name (PascalCase, e.g. ServiceA)",
+    ),
+    new_name: str = typer.Option(
+        ..., "--to", "-t",
+        help="New class name (PascalCase, e.g. ServiceB)",
+    ),
+    dry_run: bool = typer.Option(
+        False, "--dry-run",
+        help="Compute changes but do not write any files or rename on disk.",
+    ),
+    no_tests: bool = typer.Option(
+        False, "--no-tests",
+        help="Exclude test files from the rename (src/main only).",
+    ),
+    output_path: Optional[Path] = typer.Option(
+        None, "--output", "-o",
+        help="Write change audit JSON to a file instead of stdout.",
+    ),
+    copy: bool = typer.Option(
+        False, "--copy", "-c",
+        help="Copy output to clipboard after a successful run.",
+    ),
+    format: str = typer.Option(
+        "json", "--format",
+        help="Output format: json (default) or yaml.",
+    ),
+) -> None:
+    """Rename a Java class throughout the repository (BLOCKER-A fix).
+
+    \b
+    Renames a Java class safely:
+      - Updates class/interface/enum declaration
+      - Updates constructor name
+      - Updates all import statements
+      - Updates all type references (fields, params, return types)
+      - Updates extends / implements
+      - Updates generics, casts, Spring @Qualifier names
+      - Renames the physical .java file
+      - Emits a structured change audit trail (BLOCKER-C)
+
+    \b
+    Examples:
+      sourcecode rename-class . --from ServiceA --to ServiceB
+      sourcecode rename-class /path/to/repo --from OrderManager --to OrderService
+      sourcecode rename-class . --from OldName --to NewName --dry-run
+      sourcecode rename-class . --from OldName --to NewName --output rename-audit.json
+    """
+    import json as _json
+    from sourcecode.rename_refactor import rename_class
+
+    root = path.resolve()
+    if not root.is_dir():
+        _emit_error_json(
+            INVALID_INPUT_CODE,
+            f"'{root}' is not a valid directory.",
+            path=str(root),
+            hint="Pass an existing repository directory.",
+            expected="A directory path.",
+        )
+        raise typer.Exit(1)
+
+    result = rename_class(
+        root,
+        old_name,
+        new_name,
+        dry_run=dry_run,
+        include_tests=not no_tests,
+    )
+
+    if result.errors:
+        _emit_error_json(
+            "RENAME_ERROR",
+            result.errors[0],
+            errors=result.errors,
+            old_name=old_name,
+            new_name=new_name,
+        )
+        raise typer.Exit(1)
+
+    result_dict = result.to_dict()
+
+    if format == "yaml":
+        from sourcecode.serializer import to_yaml as _to_yaml
+        output = _to_yaml(result_dict)
+    else:
+        output = _json.dumps(result_dict, indent=2, ensure_ascii=False)
+
+    if output_path:
+        output_path.write_text(output, encoding="utf-8")
+        action = "dry-run simulated" if dry_run else "applied"
+        typer.echo(
+            f"[rename-class] {action}: {old_name} → {new_name} "
+            f"({result.files_modified} file(s) changed). "
+            f"Audit written to {output_path}",
+            err=True,
+        )
+    else:
+        try:
+            sys.stdout.buffer.write(output.encode("utf-8"))
+            sys.stdout.buffer.write(b"\n")
+            sys.stdout.buffer.flush()
+        except AttributeError:
+            sys.stdout.write(output + "\n")
+
+    if copy:
+        _copy_to_clipboard(output)
+
+    if not dry_run and not output_path:
+        action = "Renamed"
+        typer.echo(
+            f"[rename-class] {action}: {old_name} → {new_name} "
+            f"({result.files_modified} file(s) updated, file renamed to {result.new_file})",
+            err=True,
+        )
+
+
+# ── chunk-file ────────────────────────────────────────────────────────────────
+
+@app.command("chunk-file")
+def chunk_file_cmd(
+    file: Path = typer.Argument(
+        ...,
+        help="Java file to chunk (absolute or relative path)",
+    ),
+    max_lines: int = typer.Option(
+        500, "--max-lines", "-n",
+        help="Target max lines per chunk (default: 500). Methods > max_lines emit size_warning.",
+    ),
+    chunk_id: Optional[int] = typer.Option(
+        None, "--chunk", "-c",
+        help="Return only this chunk by ID (1-based). Omit to return all chunks.",
+    ),
+    metadata_only: bool = typer.Option(
+        False, "--metadata-only",
+        help="Return chunk boundaries and metadata without file content.",
+    ),
+    output_path: Optional[Path] = typer.Option(
+        None, "--output", "-o",
+        help="Write output to a file instead of stdout.",
+    ),
+    format: str = typer.Option(
+        "json", "--format",
+        help="Output format: json (default) or yaml.",
+    ),
+    copy: bool = typer.Option(
+        False, "--copy",
+        help="Copy output to clipboard after a successful run.",
+    ),
+) -> None:
+    """Split a large Java file into semantic chunks for AI agent consumption (BLOCKER-B fix).
+
+    \b
+    Splits a Java file at method/class boundaries so AI agents can read
+    large files (10K–25K+ lines) in context-sized pieces without timeout
+    or fragmented analysis.
+
+    Each chunk includes:
+      - chunk_id, start_line, end_line, chunk_type, symbol name
+      - context_header: package + class + imports summary
+      - content: source lines for that chunk
+      - size_warning: True if chunk > max_lines (cannot split mid-method)
+
+    \b
+    Examples:
+      sourcecode chunk-file NominasCalculoService.java
+      sourcecode chunk-file BigService.java --max-lines 300
+      sourcecode chunk-file BigService.java --chunk 5        # read chunk 5 only
+      sourcecode chunk-file BigService.java --metadata-only  # sizes/boundaries only
+    """
+    import json as _json
+    from sourcecode.file_chunker import chunk_java_file
+
+    abs_file = file.resolve()
+    if not abs_file.is_file():
+        _emit_error_json(
+            INVALID_INPUT_CODE,
+            f"'{abs_file}' is not a valid file.",
+            path=str(abs_file),
+            hint="Pass an existing Java source file.",
+            expected="A .java file path.",
+        )
+        raise typer.Exit(1)
+
+    result = chunk_java_file(abs_file, max_lines=max_lines, include_content=not metadata_only)
+
+    if chunk_id is not None:
+        # Return single chunk
+        matching = [c for c in result.chunks if c.chunk_id == chunk_id]
+        if not matching:
+            _emit_error_json(
+                INVALID_INPUT_CODE,
+                f"Chunk {chunk_id} not found. File has {result.total_chunks} chunks.",
+                chunk_id=chunk_id,
+                total_chunks=result.total_chunks,
+            )
+            raise typer.Exit(1)
+        result_dict = matching[0].to_dict()
+    else:
+        result_dict = result.to_dict()
+
+    if format == "yaml":
+        from sourcecode.serializer import to_yaml as _to_yaml
+        output = _to_yaml(result_dict)
+    else:
+        output = _json.dumps(result_dict, indent=2, ensure_ascii=False)
+
+    if output_path:
+        output_path.write_text(output, encoding="utf-8")
+        typer.echo(
+            f"[chunk-file] {result.total_chunks} chunks written to {output_path}",
+            err=True,
+        )
+    else:
+        try:
+            sys.stdout.buffer.write(output.encode("utf-8"))
+            sys.stdout.buffer.write(b"\n")
+            sys.stdout.buffer.flush()
+        except AttributeError:
+            sys.stdout.write(output + "\n")
+
+    if copy:
+        _copy_to_clipboard(output)
+
+
 # ── version ───────────────────────────────────────────────────────────────────
 
 @app.command("activate")
@@ -5159,10 +5397,13 @@ def cold_start_cmd(
     result = _gcs(target)
     if compact:
         # P1-C: cap at ~10K tokens — keep only fields essential for orientation.
-        _cs_keys = {"status", "git_head", "stacks", "entry_points",
-                    "key_dependencies", "project_type", "project_summary",
-                    "validation", "_meta"}
+        # BUG-6 fix: use actual RIS key names (summary/entrypoints, not stacks/entry_points)
+        _cs_keys = {"status", "git_head", "summary", "entrypoints", "endpoints",
+                    "project_type", "validation", "_meta"}
         result = {k: v for k, v in result.items() if k in _cs_keys}
+        # Truncate endpoints to first 30 to stay within ~10K token budget
+        if isinstance(result.get("endpoints"), list):
+            result["endpoints"] = result["endpoints"][:30]
         result["_meta"] = {**(result.get("_meta") or {}), "compact_mode": True,
                            "full_available": "sourcecode cold-start (without --compact)"}
     _out = _json.dumps(result, indent=2, ensure_ascii=False)

{sourcecode-1.35.26 → sourcecode-1.35.28}/src/sourcecode/explain.py

@@ -28,6 +28,9 @@ _STEREOTYPE_DESC: dict[str, str] = {
     "component": "Spring @Component — general-purpose bean",
     "configuration": "Spring @Configuration — bean factory / config",
     "bean": "Spring @Bean — managed component",
+    "entity": "JPA @Entity — persistent domain object mapped to a database table",
+    "mappedsuperclass": "JPA @MappedSuperclass — base class sharing persistent state with subclasses",
+    "embeddable": "JPA @Embeddable — value object embedded in owning entity table",
 }
 
 _SECURITY_ANNOTATION_PREFIXES = (