sourcecode 1.35.12__tar.gz → 1.35.14__tar.gz

{sourcecode-1.35.12 → sourcecode-1.35.14}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sourcecode
-Version: 1.35.12
+Version: 1.35.14
 Summary: Persistent structural context and ultra-fast repeated analysis for AI coding agents
 License-File: LICENSE
 Keywords: agents,ai,codebase,context,developer-tools,llm
@@ -39,7 +39,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.12-blue)
+![Version](https://img.shields.io/badge/version-1.35.14-blue)
 ![Python](https://img.shields.io/badge/python-3.10%2B-green)
 
 ---
@@ -113,7 +113,7 @@ pipx install sourcecode
 
 ```bash
 sourcecode version
-# sourcecode 1.35.12
+# sourcecode 1.35.14
 ```
 
 ---

{sourcecode-1.35.12 → sourcecode-1.35.14}/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.12-blue)
+![Version](https://img.shields.io/badge/version-1.35.14-blue)
 ![Python](https://img.shields.io/badge/python-3.10%2B-green)
 
 ---
@@ -76,7 +76,7 @@ pipx install sourcecode
 
 ```bash
 sourcecode version
-# sourcecode 1.35.12
+# sourcecode 1.35.14
 ```
 
 ---

{sourcecode-1.35.12 → sourcecode-1.35.14}/pyproject.toml

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

{sourcecode-1.35.12 → sourcecode-1.35.14}/src/sourcecode/__init__.py

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

{sourcecode-1.35.12 → sourcecode-1.35.14}/src/sourcecode/cli.py

@@ -227,6 +227,10 @@ _SUBCOMMANDS: frozenset[str] = frozenset(
         "spring-audit",
         # Spring impact chain
         "impact-chain",
+        # PR blast-radius report
+        "pr-impact",
+        # Class architectural summary
+        "explain",
     }
 )
 
@@ -266,6 +270,7 @@ _OPTIONS_WITH_VALUE: frozenset[str] = frozenset({
     "--symbol",
     "--max-importers",
     "--exclude",
+    "--files",
 })
 
 
@@ -4027,6 +4032,270 @@ def impact_chain_cmd(
                 typer.echo("✓ copied to clipboard", err=True)
 
 
+# ── PR Impact Report ──────────────────────────────────────────────────────────
+
+@app.command("pr-impact")
+def pr_impact_cmd(
+    path: Path = typer.Argument(
+        Path("."),
+        help="Repository root (default: current directory)",
+    ),
+    files: Path = typer.Option(
+        ...,
+        "--files",
+        help="File containing the list of changed Java files, one path per line.",
+    ),
+    output_path: Optional[Path] = typer.Option(
+        None, "--output", "-o",
+        help="Write output to a file instead of stdout.",
+    ),
+    format: str = typer.Option(
+        "text", "--format", "-f",
+        help="Output format: text (default) or json.",
+        show_default=True,
+    ),
+    copy: bool = typer.Option(
+        False, "--copy", "-c",
+        help="Copy output to clipboard after a successful run.",
+    ),
+) -> None:
+    """PR blast-radius report: what can break if this PR is merged?
+
+    \b
+    Reads a list of changed Java files and produces a consolidated report:
+      - Modified classes found in the changed files
+      - Affected REST endpoints reachable through the call chain
+      - Direct callers of each modified class
+      - Event publishers and consumers triggered by the change
+      - @Transactional methods in the changed classes
+      - Consolidated risk level (CRITICAL / HIGH / MEDIUM / LOW)
+
+    \b
+    Reuses existing graph and impact analysis — no new parsers.
+    JAVA/SPRING ONLY.
+
+    \b
+    Examples:
+      sourcecode pr-impact --files changed_files.txt
+      sourcecode pr-impact /path/to/repo --files diff.txt --format json
+      sourcecode pr-impact --files changes.txt --output pr_report.txt
+    """
+    import json as _json
+
+    from sourcecode.repository_ir import find_java_files
+    from sourcecode.canonical_ir import build_canonical_ir
+    from sourcecode.spring_model import SpringSemanticModel
+    from sourcecode.pr_impact import run_pr_impact
+
+    target = path.resolve()
+    if not target.exists() or not target.is_dir():
+        _emit_error_json(
+            INVALID_INPUT_CODE,
+            f"'{target}' is not a valid directory.",
+            path=str(target),
+            hint="Pass an existing repository directory.",
+            expected="A directory path.",
+        )
+        raise typer.Exit(code=1)
+
+    if not files.exists():
+        _emit_error_json(
+            INVALID_INPUT_CODE,
+            f"--files path '{files}' does not exist.",
+            path=str(files),
+            hint="Pass a file containing one Java file path per line.",
+            expected="An existing file path.",
+        )
+        raise typer.Exit(code=1)
+
+    if format not in ("text", "json"):
+        _emit_error_json(
+            INVALID_INPUT_CODE,
+            f"Invalid format '{format}'.",
+            hint="format must be: text or json.",
+            expected="text | json",
+        )
+        raise typer.Exit(code=1)
+
+    # Read changed-files list
+    changed_files = [
+        line.strip()
+        for line in files.read_text(encoding="utf-8").splitlines()
+        if line.strip()
+    ]
+    if not changed_files:
+        _emit_error_json(
+            INVALID_INPUT_CODE,
+            f"--files '{files}' is empty.",
+            hint="File must contain at least one Java file path.",
+            expected="One Java file path per line.",
+        )
+        raise typer.Exit(code=1)
+
+    file_list = find_java_files(target)
+    if not file_list:
+        data: dict = {
+            "schema_version": "1.0",
+            "modified_classes": [],
+            "risk_level": "UNKNOWN",
+            "risk_reason": "No Java files found in repository — Spring analysis requires Java source.",
+            "analysis_warnings": ["No Java files found."],
+            "metadata": {"changed_files_count": len(changed_files)},
+        }
+        output = _json.dumps(data, indent=2, ensure_ascii=False) if format == "json" else (
+            "No Java files found in repository — Spring analysis requires Java source."
+        )
+        if output_path is not None:
+            output_path.write_text(output, encoding="utf-8")
+            typer.echo("PR impact report written to " + str(output_path), err=True)
+        else:
+            sys.stdout.buffer.write(output.encode("utf-8"))
+            sys.stdout.buffer.write(b"\n")
+            sys.stdout.buffer.flush()
+        return
+
+    cir = build_canonical_ir(file_list, target)
+    model = SpringSemanticModel.build(cir)
+    report = run_pr_impact(cir, changed_files, root=target, model=model)
+
+    if format == "json":
+        output = _json.dumps(report.to_dict(), indent=2, ensure_ascii=False)
+    else:
+        output = report.render_text()
+
+    if output_path is not None:
+        output_path.write_text(output, encoding="utf-8")
+        typer.echo(
+            f"PR impact report written to {output_path} "
+            f"(risk: {report.risk_level}, "
+            f"{len(report.modified_classes)} classes, "
+            f"{len(report.affected_endpoints)} endpoints)",
+            err=True,
+        )
+    else:
+        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)
+
+
+# ── Explain Command ───────────────────────────────────────────────────────────
+
+@app.command("explain")
+def explain_cmd(
+    class_name: str = typer.Argument(
+        ...,
+        help="Simple class name to explain (e.g. UserService, OrderController).",
+    ),
+    path: Path = typer.Argument(
+        Path("."),
+        help="Repository root (default: current directory)",
+    ),
+    format: str = typer.Option(
+        "text", "--format", "-f",
+        help="Output format: text (default) or json.",
+        show_default=True,
+    ),
+    output_path: Optional[Path] = typer.Option(
+        None, "--output", "-o",
+        help="Write output to a file instead of stdout.",
+    ),
+    copy: bool = typer.Option(
+        False, "--copy", "-c",
+        help="Copy output to clipboard after a successful run.",
+    ),
+) -> None:
+    """Human-readable architectural summary for a class.
+
+    \b
+    Generates a structured explanation derived entirely from static analysis:
+      - Purpose and Spring stereotype
+      - Public methods
+      - Incoming callers (who uses this class)
+      - Outgoing dependencies (what this class calls)
+      - Events published and consumed
+      - @Transactional boundaries
+      - Security constraints (@PreAuthorize, @Secured, etc.)
+      - REST endpoints related
+
+    \b
+    JAVA/SPRING ONLY. Reads from existing CIR — no new parsers.
+
+    \b
+    Examples:
+      sourcecode explain UserService
+      sourcecode explain OrderController /path/to/repo
+      sourcecode explain UserService --format json
+    """
+    import json as _json
+
+    from sourcecode.repository_ir import find_java_files
+    from sourcecode.canonical_ir import build_canonical_ir
+    from sourcecode.spring_model import SpringSemanticModel
+    from sourcecode.explain import explain_class
+
+    target = path.resolve()
+    if not target.exists() or not target.is_dir():
+        _emit_error_json(
+            INVALID_INPUT_CODE,
+            f"'{target}' is not a valid directory.",
+            path=str(target),
+            hint="Pass an existing repository directory.",
+            expected="A directory path.",
+        )
+        raise typer.Exit(code=1)
+
+    if format not in ("text", "json"):
+        _emit_error_json(
+            INVALID_INPUT_CODE,
+            f"Invalid format '{format}'.",
+            hint="format must be: text or json.",
+            expected="text | json",
+        )
+        raise typer.Exit(code=1)
+
+    file_list = find_java_files(target)
+    if not file_list:
+        msg = f"No Java files found in '{target}'. sourcecode explain requires a Java/Spring repository."
+        if format == "json":
+            output = _json.dumps({
+                "error": "no_java_files",
+                "message": msg,
+                "class_name": class_name,
+            }, indent=2)
+        else:
+            output = msg
+        if output_path is not None:
+            output_path.write_text(output, encoding="utf-8")
+        else:
+            sys.stdout.buffer.write(output.encode("utf-8"))
+            sys.stdout.buffer.write(b"\n")
+            sys.stdout.buffer.flush()
+        raise typer.Exit(code=1)
+
+    cir = build_canonical_ir(file_list, target)
+    model = SpringSemanticModel.build(cir)
+    explanation = explain_class(class_name, cir, model)
+
+    if format == "json":
+        output = _json.dumps(explanation.to_dict(), indent=2, ensure_ascii=False)
+    else:
+        output = explanation.render_text()
+
+    if output_path is not None:
+        output_path.write_text(output, encoding="utf-8")
+        typer.echo(f"Explanation written to {output_path}", err=True)
+    else:
+        sys.stdout.buffer.write(output.encode("utf-8"))
+        sys.stdout.buffer.write(b"\n")
+        sys.stdout.buffer.flush()
+
+    if copy and _copy_to_clipboard(output):
+        typer.echo("✓ copied to clipboard", err=True)
+
+
 # ── Enterprise Workflow Commands ──────────────────────────────────────────────
 #
 # These are the five canonical enterprise workflows.  Each is a thin wrapper