diagram-to-iac 0.7.0__tar.gz → 0.8.0__tar.gz

diagram_to_iac-0.8.0/PKG-INFO

@@ -0,0 +1,99 @@
+Metadata-Version: 2.4
+Name: diagram-to-iac
+Version: 0.8.0
+Summary: Convert architecture diagrams into IaC modules
+Author-email: vindpro <admin@vindpro.com>
+Description-Content-Type: text/markdown
+Requires-Dist: anthropic==0.54.0
+Requires-Dist: google_api_python_client==2.172.0
+Requires-Dist: langchain_anthropic==0.3.15
+Requires-Dist: langchain-core<1.0.0,>=0.3.62
+Requires-Dist: langchain_google_genai==2.1.5
+Requires-Dist: langchain_openai==0.3.24
+Requires-Dist: langgraph==0.4.8
+Requires-Dist: openai==1.88.0
+Requires-Dist: protobuf>=5.27.0
+Requires-Dist: pydantic==2.11.7
+Requires-Dist: PyYAML==6.0.2
+Requires-Dist: Requests==2.32.4
+Requires-Dist: GitPython<4.0,>=3.1
+Requires-Dist: pytest-mock<4.0.0,>=3.10.0
+
+# diagram-to-iac
+An automated system that intelligently translates visual cloud infrastructure diagrams (specifically Azure) into deployable Infrastructure as Code (IaC). The project leverages AI for analysis and GitHub for collaborative refinement.
+
+## Installation
+
+Create a virtual environment with Python 3.11+ and install the project in editable mode. Development dependencies (linting, testing, etc.) are provided through the `dev` extra:
+
+```bash
+pip install -e .[dev]
+```
+
+## Running the CLI
+
+The project exposes several entry points via `pyproject.toml`. The main one for end‑to‑end automation is `supervisor-agent`.
+
+```bash
+supervisor-agent --help
+```
+
+Running `supervisor-agent` without arguments enters an interactive mode. You will be prompted for the repository URL and branch name:
+
+```bash
+$ supervisor-agent --dry-run
+Repository URL: https://github.com/octocat/Hello-World.git
+🚀 R2D SupervisorAgent - Branch Creation
+📅 Default branch name: r2d-<timestamp>
+📝 Press Enter to use default, or type a custom branch name:
+Branch name:
+```
+
+The agent will then continue with the workflow (cloning, analysis and issue creation). The `--dry-run` flag prints the generated issue text instead of creating it.
+
+## Running Tests
+
+All tests use `pytest` and are located under the `tests` directory. After installing the development dependencies, run:
+
+```bash
+pytest
+```
+
+## Logs and Observability
+
+Each run creates a JSONL log file under the `logs/` directory (e.g. `logs/run-<timestamp>.jsonl`).
+Every significant event emitted by the agents is appended as a single JSON line.
+You can inspect the log with tools like `tail` to follow the workflow progress:
+
+```bash
+tail -f logs/run-*.jsonl
+```
+
+
+In CI runs, the `logs/` directory and any `*.tfplan` files are compressed and
+uploaded as the `logs-and-plans` artifact. Download this artifact from the
+workflow run to inspect full logs and Terraform plans.
+
+
+After each workflow run, a Markdown dashboard is generated at `step-summary.md`
+showing a high level overview of Terraform modules, resource changes and tfsec
+findings. The dashboard is derived from the JSONL logs and can be viewed
+directly in the repository or uploaded as a build artifact.
+
+
+
+This repository provides a container action that runs the `SupervisorAgent` on the current repository. Add the action to a workflow as shown below:
+
+```yaml
+jobs:
+  supervisor:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Run Supervisor Agent
+        uses: ./.github/actions/supervisor
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+```
+
+The action reads `GITHUB_REPOSITORY` and `GITHUB_TOKEN` automatically to clone the repository and execute the agent.

diagram_to_iac-0.8.0/README.md

@@ -0,0 +1,78 @@
+# diagram-to-iac
+An automated system that intelligently translates visual cloud infrastructure diagrams (specifically Azure) into deployable Infrastructure as Code (IaC). The project leverages AI for analysis and GitHub for collaborative refinement.
+
+## Installation
+
+Create a virtual environment with Python 3.11+ and install the project in editable mode. Development dependencies (linting, testing, etc.) are provided through the `dev` extra:
+
+```bash
+pip install -e .[dev]
+```
+
+## Running the CLI
+
+The project exposes several entry points via `pyproject.toml`. The main one for end‑to‑end automation is `supervisor-agent`.
+
+```bash
+supervisor-agent --help
+```
+
+Running `supervisor-agent` without arguments enters an interactive mode. You will be prompted for the repository URL and branch name:
+
+```bash
+$ supervisor-agent --dry-run
+Repository URL: https://github.com/octocat/Hello-World.git
+🚀 R2D SupervisorAgent - Branch Creation
+📅 Default branch name: r2d-<timestamp>
+📝 Press Enter to use default, or type a custom branch name:
+Branch name:
+```
+
+The agent will then continue with the workflow (cloning, analysis and issue creation). The `--dry-run` flag prints the generated issue text instead of creating it.
+
+## Running Tests
+
+All tests use `pytest` and are located under the `tests` directory. After installing the development dependencies, run:
+
+```bash
+pytest
+```
+
+## Logs and Observability
+
+Each run creates a JSONL log file under the `logs/` directory (e.g. `logs/run-<timestamp>.jsonl`).
+Every significant event emitted by the agents is appended as a single JSON line.
+You can inspect the log with tools like `tail` to follow the workflow progress:
+
+```bash
+tail -f logs/run-*.jsonl
+```
+
+
+In CI runs, the `logs/` directory and any `*.tfplan` files are compressed and
+uploaded as the `logs-and-plans` artifact. Download this artifact from the
+workflow run to inspect full logs and Terraform plans.
+
+
+After each workflow run, a Markdown dashboard is generated at `step-summary.md`
+showing a high level overview of Terraform modules, resource changes and tfsec
+findings. The dashboard is derived from the JSONL logs and can be viewed
+directly in the repository or uploaded as a build artifact.
+
+
+
+This repository provides a container action that runs the `SupervisorAgent` on the current repository. Add the action to a workflow as shown below:
+
+```yaml
+jobs:
+  supervisor:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Run Supervisor Agent
+        uses: ./.github/actions/supervisor
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+```
+
+The action reads `GITHUB_REPOSITORY` and `GITHUB_TOKEN` automatically to clone the repository and execute the agent.

{diagram_to_iac-0.7.0 → diagram_to_iac-0.8.0}/pyproject.toml

@@ -4,14 +4,18 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name        = "diagram-to-iac"
-version     = "0.7.0"
+version     = "0.8.0"
 description = "Convert architecture diagrams into IaC modules"
 readme      = "README.md"
 authors     = [{ name="vindpro", email="admin@vindpro.com" }]
-dependencies = ["anthropic==0.51.0", "google_api_python_client==2.169.0", "openai==1.79.0", "protobuf>=3.19.5,<5.0.0dev", "PyYAML==6.0.2", "Requests==2.32.3", "google-generativeai==0.3.1"]   # ← always overwritten by update_deps.py
+dependencies = ["anthropic==0.54.0", "google_api_python_client==2.172.0", "langchain_anthropic==0.3.15", "langchain-core>=0.3.62,<1.0.0", "langchain_google_genai==2.1.5", "langchain_openai==0.3.24", "langgraph==0.4.8", "openai==1.88.0", "protobuf>=5.27.0", "pydantic==2.11.7", "PyYAML==6.0.2", "Requests==2.32.4", "GitPython>=3.1,<4.0", "pytest-mock>=3.10.0,<4.0.0"]   # ← always overwritten by update_deps.py
+
+
 
 [project.scripts]
 diagram-to-iac = "diagram_to_iac.cli:main"
+git-agent = "diagram_to_iac.actions.git_entry:main"
+supervisor-agent = "diagram_to_iac.actions.supervisor_entry:main"
 
 [tool.setuptools]                    # (intentionally left empty)
 

diagram_to_iac-0.8.0/src/diagram_to_iac/__init__.py

@@ -0,0 +1,10 @@
+try:
+    from diagram_to_iac.tools.sec_utils import load_yaml_secrets
+except Exception:  # noqa: BLE001
+    load_yaml_secrets = None
+
+if load_yaml_secrets:
+    try:
+        load_yaml_secrets()
+    except Exception:  # noqa: BLE001
+        pass

diagram_to_iac-0.8.0/src/diagram_to_iac/actions/__init__.py

@@ -0,0 +1,7 @@
+# src/diagram_to_iac/actions/__init__.py
+"""
+Actions module for diagram-to-iac CLI entrypoints.
+
+This module contains command-line interfaces and action handlers for various
+agents and tools within the diagram-to-iac system.
+"""

diagram_to_iac-0.8.0/src/diagram_to_iac/actions/git_entry.py

@@ -0,0 +1,174 @@
+#!/usr/bin/env python
+"""
+CLI entrypoint for GitAgent - Phase 5 Implementation
+
+This module provides a command-line interface for manual execution of the GitAgent,
+following the established patterns in the diagram-to-iac codebase.
+
+Usage:
+    python -m diagram_to_iac.actions.git_entry --repo-url https://github.com/user/repo
+    # Or via console script (after update_deps.py adds it to pyproject.toml):
+    git-agent --repo-url https://github.com/user/repo
+
+Features:
+- Argument parsing for git operations
+- JSON output for programmatic consumption
+- Proper error handling and logging
+- Integration with existing GitAgent implementation
+"""
+
+import argparse
+import json
+import sys
+import logging
+from typing import Optional
+
+from diagram_to_iac.agents.git_langgraph.agent import GitAgent, GitAgentInput
+
+
+def setup_logging(verbose: bool = False) -> None:
+    """Configure logging for the CLI entrypoint."""
+    level = logging.DEBUG if verbose else logging.INFO
+    logging.basicConfig(
+        level=level,
+        format='%(asctime)s - %(name)s - %(levelname)s - %(message)s',
+        datefmt='%Y-%m-%d %H:%M:%S'
+    )
+
+
+def create_argument_parser() -> argparse.ArgumentParser:
+    """Create and configure the argument parser following established patterns."""
+    parser = argparse.ArgumentParser(
+        prog='git-agent',
+        description='GitAgent CLI - DevOps automation for git operations',
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+        epilog="""
+Examples:
+  %(prog)s --repo-url https://github.com/user/repo
+  %(prog)s --query "clone https://github.com/user/repo"
+  %(prog)s --query "open issue in repo: bug report" --verbose
+        """
+    )
+    
+    # Primary input options (mutually exclusive)
+    input_group = parser.add_mutually_exclusive_group(required=True)
+    input_group.add_argument(
+        '--repo-url',
+        type=str,
+        help='Git repository URL to clone'
+    )
+    input_group.add_argument(
+        '--query',
+        type=str,
+        help='DevOps query (git clone, GitHub issue, shell command)'
+    )
+    
+    # Optional arguments
+    parser.add_argument(
+        '--thread-id',
+        type=str,
+        help='Optional thread ID for conversation history'
+    )
+    parser.add_argument(
+        '--verbose',
+        action='store_true',
+        help='Enable verbose logging'
+    )
+    parser.add_argument(
+        '--config-path',
+        type=str,
+        help='Path to YAML configuration file'
+    )
+    parser.add_argument(
+        '--memory-type',
+        type=str,
+        choices=['persistent', 'memory', 'langgraph'],
+        default='persistent',
+        help='Type of memory to use (default: persistent)'
+    )
+    
+    return parser
+
+
+def format_output(result: object, indent: int = 2) -> str:
+    """Format output as JSON with proper indentation."""
+    try:
+        if hasattr(result, 'model_dump'):
+            # Pydantic model
+            return json.dumps(result.model_dump(), indent=indent)
+        else:
+            # Regular object
+            return json.dumps(result, indent=indent, default=str)
+    except Exception as e:
+        # Fallback to string representation
+        logging.warning(f"Failed to serialize output as JSON: {e}")
+        return str(result)
+
+
+def construct_query_from_repo_url(repo_url: str) -> str:
+    """Construct a git clone query from a repository URL."""
+    return f"clone repository {repo_url}"
+
+
+def main() -> int:
+    """Main entrypoint function following established CLI patterns."""
+    try:
+        # Parse arguments
+        parser = create_argument_parser()
+        args = parser.parse_args()
+        
+        # Setup logging
+        setup_logging(args.verbose)
+        logger = logging.getLogger(__name__)
+        
+        # Construct query from arguments
+        if args.repo_url:
+            query = construct_query_from_repo_url(args.repo_url)
+            logger.info(f"Constructed query from repo URL: {query}")
+        else:
+            query = args.query
+            logger.info(f"Using provided query: {query}")
+        
+        # Initialize agent with optional configuration
+        agent_kwargs = {}
+        if args.config_path:
+            agent_kwargs['config_path'] = args.config_path
+        if args.memory_type:
+            agent_kwargs['memory_type'] = args.memory_type
+            
+        logger.info(f"Initializing GitAgent with {agent_kwargs}")
+        agent = GitAgent(**agent_kwargs)
+        
+        # Prepare input
+        agent_input = GitAgentInput(
+            query=query,
+            thread_id=args.thread_id
+        )
+        
+        logger.info(f"Running agent with input: {agent_input.query}")
+        
+        # Execute agent
+        result = agent.run(agent_input)
+        
+        # Output results
+        print(format_output(result))
+        
+        # Return appropriate exit code
+        if result.error_message:
+            logger.error(f"Agent execution failed: {result.error_message}")
+            return 1
+        else:
+            logger.info("Agent execution completed successfully")
+            return 0
+            
+    except KeyboardInterrupt:
+        print("\n⚠️  Operation cancelled by user", file=sys.stderr)
+        return 130
+    except Exception as e:
+        print(f"❌ Error: {e}", file=sys.stderr)
+        logging.exception("Unexpected error in main()")
+        return 1
+
+
+if __name__ == "__main__":
+    sys.exit(main())

diagram_to_iac-0.8.0/src/diagram_to_iac/actions/supervisor_entry.py

@@ -0,0 +1,116 @@
+"""CLI entrypoint for SupervisorAgent."""
+
+import argparse
+import json
+import sys
+import logging
+from datetime import datetime
+from pathlib import Path
+
+from diagram_to_iac.agents.supervisor_langgraph import (
+    SupervisorAgent,
+    SupervisorAgentInput,
+)
+from diagram_to_iac.services import get_log_path, generate_step_summary, reset_log_bus
+
+
+def setup_logging(verbose: bool = False) -> None:
+    level = logging.DEBUG if verbose else logging.INFO
+    logging.basicConfig(
+        level=level,
+        format="%(asctime)s - %(name)s - %(levelname)s - %(message)s",
+        datefmt="%Y-%m-%d %H:%M:%S",
+    )
+
+
+def create_argument_parser() -> argparse.ArgumentParser:
+    parser = argparse.ArgumentParser(
+        prog="supervisor-agent",
+        description="SupervisorAgent CLI - R2D (Repo-to-Deployment) automation",
+    )
+    parser.add_argument("--repo-url", help="Repository URL to operate on")
+    parser.add_argument("--branch-name", help="Branch name (deprecated - supervisor skips branch creation)")
+    parser.add_argument("--thread-id", help="Optional thread id")
+    parser.add_argument("--verbose", action="store_true", help="Enable verbose logging")
+    parser.add_argument("--no-interactive", action="store_true", help="Skip interactive prompts")
+    parser.add_argument("--dry-run", action="store_true", help="Print issue text instead of creating it")
+    return parser
+
+
+def prompt_for_repo_url() -> str:
+    """Prompt the user for a repository URL."""
+    try:
+        return input("Repository URL: ").strip()
+    except (KeyboardInterrupt, EOFError):
+        print("\n⚠️  Repository URL required")
+        sys.exit(1)
+
+
+def format_output(result: object) -> str:
+    try:
+        if hasattr(result, "model_dump"):
+            return json.dumps(result.model_dump(), indent=2)
+        return json.dumps(result, indent=2, default=str)
+    except Exception as e:
+        logging.warning(f"Failed to serialize output: {e}")
+        return str(result)
+
+
+def main() -> int:
+    parser = create_argument_parser()
+    args = parser.parse_args()
+
+    setup_logging(args.verbose)
+
+    # Handle repo url
+    repo_url = args.repo_url
+    if not repo_url and not args.no_interactive:
+        repo_url = prompt_for_repo_url()
+    elif not repo_url:
+        parser.error("--repo-url is required when --no-interactive is used")
+
+    # Branch name is no longer used since supervisor skips branch creation
+    # All errors are handled via GitHub issues instead
+    branch_name = args.branch_name or "main"  # Placeholder for compatibility
+
+    agent = SupervisorAgent()
+
+
+    while True:
+        reset_log_bus()
+        result = agent.run(
+            SupervisorAgentInput(
+                repo_url=repo_url,
+                branch_name=branch_name,
+                thread_id=args.thread_id,
+                dry_run=args.dry_run,
+            )
+
+        )
+
+        print(format_output(result))
+
+        try:
+            generate_step_summary(get_log_path(), Path("step-summary.md"))
+        except Exception as e:  # noqa: BLE001
+            logging.warning(f"Step summary generation failed: {e}")
+
+        if result.success or args.no_interactive:
+            break
+
+        try:
+            choice = input("Retry workflow? [y/N]: ").strip().lower()
+        except (KeyboardInterrupt, EOFError):
+            choice = ""
+
+        if choice != "y":
+            break
+
+        repo_url = prompt_for_repo_url()
+        # No longer prompt for branch name since supervisor skips branch creation
+
+    return 0 if result.success else 1
+
+
+if __name__ == "__main__":
+    sys.exit(main())