Feature/new cmd analyze (#55)

* Duplicate changelog as analyze

* cli to Analyze

Author: lchoquel

README.md

@@ -124,6 +124,18 @@ cocode github sync-labels pipelex/cocode ./labels.json --delete-extra
 
 ### Commands for Other Features
 
+#### Code Analysis
+```bash
+# Analyze git diff with a specific prompt/query
+cocode analyze diff v1.0.0 --prompt "What are the main architectural changes in this update?"
+
+# Analyze security-related changes
+cocode analyze diff HEAD~10 --prompt "Identify any security vulnerabilities or improvements"
+
+# Analyze performance impacts
+cocode analyze diff main --prompt "What changes might affect application performance?"
+```
+
 ## ⚠️ Limitations
 
 This tool is in early development! There are many things to fix and improve. You may encounter bugs, incomplete features, or unexpected behavior. We're actively working on making Cocode more robust and user-friendly.

cocode/cli/analyze/__init__.py

@@ -0,0 +1 @@
+"""Analyze management module."""

cocode/cli/analyze/analyze_cli.py

@@ -0,0 +1,76 @@
+"""
+Analyze management CLI commands.
+"""
+
+import asyncio
+from typing import Annotated, List, Optional
+
+import typer
+from pipelex.core.pipes.pipe_run_params import PipeRunMode
+from pipelex.hub import get_pipeline_tracker
+
+from cocode.common import get_output_dir, validate_repo_path
+from cocode.swe.swe_cmd import swe_from_repo_diff_with_prompt
+
+analyze_app = typer.Typer(
+    name="analyze",
+    help="Analyze management and generation commands",
+    add_completion=False,
+    rich_markup_mode="rich",
+    no_args_is_help=True,
+)
+
+
+@analyze_app.command("diff")
+def analyze_diff_cmd(
+    prompt: Annotated[
+        str,
+        typer.Option("--prompt", "-p", help="Prompt to analyze the git diff"),
+    ],
+    version: Annotated[
+        str,
+        typer.Argument(help="Git version/tag/commit to compare current version against"),
+    ],
+    repo_path: Annotated[
+        str,
+        typer.Argument(help="Repository path (local directory) or GitHub URL/identifier (owner/repo or https://github.com/owner/repo)"),
+    ] = ".",
+    output_dir: Annotated[
+        Optional[str],
+        typer.Option("--output-dir", "-o", help="Output directory path. Use 'stdout' to print to console. Defaults to config value if not provided"),
+    ] = None,
+    output_filename: Annotated[
+        str,
+        typer.Option("--output-filename", "-n", help="Output filename"),
+    ] = "analyze-diff.md",
+    dry_run: Annotated[
+        bool,
+        typer.Option("--dry", help="Run pipeline in dry mode (no actual execution)"),
+    ] = False,
+    ignore_patterns: Annotated[
+        Optional[List[str]],
+        typer.Option(
+            "--ignore-pattern", "-i", help="Patterns to exclude from git diff (e.g., '*.log', 'temp/', 'build/'). Can be specified multiple times."
+        ),
+    ] = None,
+) -> None:
+    """Generate analyze from git diff comparing current version to specified version. Supports both local repositories and GitHub repositories."""
+    repo_path = validate_repo_path(repo_path)
+    output_dir = get_output_dir(output_dir)
+    to_stdout = output_dir == "stdout"
+    pipe_run_mode = PipeRunMode.DRY if dry_run else PipeRunMode.LIVE
+
+    asyncio.run(
+        swe_from_repo_diff_with_prompt(
+            pipe_code="analyze_git_diff",
+            prompt=prompt,
+            repo_path=repo_path,
+            version=version,
+            output_filename=output_filename,
+            output_dir=output_dir,
+            to_stdout=to_stdout,
+            pipe_run_mode=pipe_run_mode,
+            ignore_patterns=ignore_patterns,
+        )
+    )
+    get_pipeline_tracker().output_flowchart()

cocode/cli/main.py

@@ -12,6 +12,7 @@
 from typing_extensions import override
 
 from cocode.cli.ai_instructions.ai_instructions_cli import ai_instructions_app
+from cocode.cli.analyze.analyze_cli import analyze_app
 from cocode.cli.changelog.changelog_cli import changelog_app
 from cocode.cli.doc.doc_cli import doc_app
 from cocode.cli.features.features_cli import features_app
@@ -50,6 +51,7 @@ def get_command(self, ctx: Context, cmd_name: str) -> Optional[Command]:
 
 # Add command groups
 app.add_typer(doc_app, name="doc", help="Documentation management and automation commands")
+app.add_typer(analyze_app, name="analyze", help="Analyze generation and management commands")
 app.add_typer(changelog_app, name="changelog", help="Changelog generation and management commands")
 app.add_typer(ai_instructions_app, name="ai_instructions", help="AI instructions update and management commands")
 app.add_typer(repo_app, name="repo", help="Repository analysis and processing commands")

cocode/pipelex_libraries/pipelines/swe_diff/swe_diff.plx

@@ -87,6 +87,23 @@ Be sure to include changes to code but also complementary pipelines, scripts, do
 @git_diff
 """
 
+[pipe.analyze_git_diff]
+type = "PipeLLM"
+definition = "Analyze the git diff based on a prompt."
+inputs = { git_diff = "GitDiff", prompt = "Text" }
+output = "Text"
+llm = "llm_for_large_text"
+system_prompt = """
+You are an expert technical writer and software architect. Your task is to carefully review and analyze the code diff.
+"""
+prompt_template = """
+Analyze the following code diff based on this prompt: $prompt
+
+@git_diff
+
+Answer in markdown format.
+"""
+
 [pipe.format_changelog_as_markdown]
 type = "PipeJinja2"
 definition = "Format the final changelog in markdown with proper structure"

cocode/swe/swe_cmd.py

@@ -20,6 +20,10 @@
 from cocode.utils import NoDifferencesFound, run_git_diff_command
 
 
+class SweFromRepoDiffWithPromptError(Exception):
+    pass
+
+
 async def swe_from_repo(
     pipe_code: str,
     repo_path: str,
@@ -145,6 +149,54 @@ async def swe_from_repo_diff(
     )
 
 
+async def swe_from_repo_diff_with_prompt(
+    pipe_code: str,
+    prompt: str,
+    repo_path: str,
+    version: str,
+    output_filename: str,
+    output_dir: str,
+    to_stdout: bool,
+    pipe_run_mode: PipeRunMode,
+    ignore_patterns: Optional[List[str]] = None,
+) -> None:
+    """Process SWE analysis from a git diff comparing current version to specified version."""
+    log.info(f"Processing SWE from git diff: comparing current to '{version}' in '{repo_path}'")
+
+    if not prompt:
+        raise SweFromRepoDiffWithPromptError("Prompt is required")
+
+    # Generate git diff
+    try:
+        git_diff = run_git_diff_command(repo_path=repo_path, version=version, ignore_patterns=ignore_patterns)
+    except NoDifferencesFound as exc:
+        log.info(f"Aborting: {exc}")
+        return
+
+    # Run the pipe
+    pipe_output = await execute_pipeline(
+        pipe_code=pipe_code,
+        pipe_run_mode=pipe_run_mode,
+        input_memory={
+            "git_diff": {
+                "concept": "swe_diff.GitDiff",
+                "content": git_diff,
+            },
+            "prompt": prompt,
+        },
+    )
+
+    get_report_delegate().generate_report()
+
+    # Process through SWE pipeline and handle output
+    await process_swe_pipeline_result(
+        pipe_output=pipe_output,
+        output_filename=output_filename,
+        output_dir=output_dir,
+        to_stdout=to_stdout,
+    )
+
+
 async def swe_doc_update_from_diff(
     repo_path: str,
     version: str,