cloudwright-ai-cli 0.1.0__tar.gz

cloudwright_ai_cli-0.1.0/.gitignore

@@ -0,0 +1,16 @@
+__pycache__/
+*.py[cod]
+*.egg-info/
+dist/
+build/
+.env
+*.db
+!packages/core/cloudwright/data/catalog.db
+node_modules/
+.vite/
+.ruff_cache/
+.pytest_cache/
+.mypy_cache/
+
+# Codebase intelligence (auto-generated)
+.planning/

cloudwright_ai_cli-0.1.0/CLAUDE.md

@@ -0,0 +1,23 @@
+# cloudwright-cli
+
+CLI interface for Cloudwright. Wraps core package with Typer commands and Rich formatting.
+
+## Commands
+
+All commands are in `cloudwright_cli/commands/`. Each is a standalone module registered in `main.py`.
+
+- `design` — Generate architecture from natural language
+- `cost` — Price an ArchSpec, optional multi-cloud comparison
+- `compare` — Full multi-cloud architecture comparison
+- `validate` — Compliance and Well-Architected checks
+- `export` — Export to Terraform, CFN, Mermaid, SBOM, AIBOM
+- `diff` — Compare two ArchSpec files
+- `chat` — Interactive terminal chat or web UI launcher
+- `catalog` — Subgroup with `search` and `compare` subcommands
+
+## Conventions
+
+- Typer for argument parsing, Rich for output formatting
+- All output goes through Rich Console for consistent formatting
+- Errors shown as `[red]Error:[/red] message`
+- Tables for data, Panels for summaries, Syntax blocks for YAML/HCL

cloudwright_ai_cli-0.1.0/PKG-INFO

@@ -0,0 +1,42 @@
+Metadata-Version: 2.4
+Name: cloudwright-ai-cli
+Version: 0.1.0
+Summary: CLI for Cloudwright architecture intelligence
+Project-URL: Homepage, https://github.com/xmpuspus/cloudwright
+Project-URL: Repository, https://github.com/xmpuspus/cloudwright
+Author: Xavier Puspus
+License-Expression: MIT
+Keywords: architecture,cli,cloud,terraform
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.12
+Requires-Dist: cloudwright-ai<1,>=0.1.0
+Requires-Dist: rich<15,>=13.9
+Requires-Dist: typer<1,>=0.21
+Description-Content-Type: text/markdown
+
+# cloudwright-cli
+
+Command-line interface for [Cloudwright](https://github.com/xmpuspus/cloudwright) architecture intelligence.
+
+## Install
+
+```bash
+pip install cloudwright[cli]
+```
+
+## Usage
+
+```bash
+cloudwright design "3-tier web app on AWS"
+cloudwright cost spec.yaml
+cloudwright validate spec.yaml --compliance hipaa
+cloudwright export spec.yaml --format terraform -o ./infra
+cloudwright diff v1.yaml v2.yaml
+cloudwright catalog search "4 vcpu 16gb"
+cloudwright chat
+```
+
+See the [main project README](https://github.com/xmpuspus/cloudwright) for full documentation.

cloudwright_ai_cli-0.1.0/README.md

@@ -0,0 +1,23 @@
+# cloudwright-cli
+
+Command-line interface for [Cloudwright](https://github.com/xmpuspus/cloudwright) architecture intelligence.
+
+## Install
+
+```bash
+pip install cloudwright[cli]
+```
+
+## Usage
+
+```bash
+cloudwright design "3-tier web app on AWS"
+cloudwright cost spec.yaml
+cloudwright validate spec.yaml --compliance hipaa
+cloudwright export spec.yaml --format terraform -o ./infra
+cloudwright diff v1.yaml v2.yaml
+cloudwright catalog search "4 vcpu 16gb"
+cloudwright chat
+```
+
+See the [main project README](https://github.com/xmpuspus/cloudwright) for full documentation.

cloudwright_ai_cli-0.1.0/cloudwright_cli/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.1.0"

cloudwright_ai_cli-0.1.0/cloudwright_cli/__main__.py

@@ -0,0 +1,5 @@
+"""Allow running as `python3 -m cloudwright_cli`."""
+
+from cloudwright_cli.main import app
+
+app()

cloudwright_ai_cli-0.1.0/cloudwright_cli/commands/analyze_cmd.py

@@ -0,0 +1,117 @@
+"""Analyze architecture blast radius and dependencies."""
+
+from __future__ import annotations
+
+import json
+from typing import Annotated
+
+import typer
+from rich.console import Console
+from rich.panel import Panel
+from rich.table import Table
+from rich.tree import Tree
+
+from cloudwright_cli.utils import handle_error
+
+console = Console()
+
+
+def analyze(
+    ctx: typer.Context,
+    spec_file: Annotated[str, typer.Argument(help="Path to ArchSpec YAML/JSON file")],
+    component: Annotated[str | None, typer.Option("--component", "-c", help="Analyze specific component")] = None,
+) -> None:
+    """Analyze blast radius, SPOFs, and dependency structure."""
+    try:
+        from cloudwright import ArchSpec
+        from cloudwright.analyzer import Analyzer
+
+        spec = ArchSpec.from_file(spec_file)
+        analyzer = Analyzer()
+        result = analyzer.analyze(spec, component_id=component)
+
+        if ctx.obj and ctx.obj.get("json"):
+            print(json.dumps(result.to_dict(), indent=2))
+            return
+
+        spof_text = ", ".join(result.spofs) if result.spofs else "None"
+        console.print(
+            Panel(
+                f"Components: {result.total_components}  |  "
+                f"Max Blast Radius: {result.max_blast_radius}  |  "
+                f"SPOFs: {len(result.spofs)}",
+                title=f"Blast Radius Analysis: {spec.name}",
+                border_style="red" if result.spofs else "green",
+            )
+        )
+
+        if result.spofs:
+            console.print(f"\n[bold red]Single Points of Failure:[/bold red] {spof_text}")
+
+        if result.critical_path:
+            console.print(f"\n[bold]Critical Path:[/bold] {' -> '.join(result.critical_path)}")
+
+        table = Table(title="\nComponent Impact")
+        table.add_column("Component", style="cyan")
+        table.add_column("Service")
+        table.add_column("Tier", justify="right")
+        table.add_column("Direct Deps", justify="right")
+        table.add_column("Blast Radius", justify="right")
+        table.add_column("SPOF")
+
+        for impact in result.components:
+            spof_marker = "[red]YES[/red]" if impact.is_spof else ""
+            if impact.blast_radius > result.total_components * 0.5:
+                blast_color = "red"
+            elif impact.blast_radius > 0:
+                blast_color = "yellow"
+            else:
+                blast_color = "green"
+            table.add_row(
+                impact.component_id,
+                impact.service,
+                str(impact.tier),
+                str(len(impact.direct_dependents)),
+                f"[{blast_color}]{impact.blast_radius}[/{blast_color}]",
+                spof_marker,
+            )
+
+        console.print(table)
+
+        if not component:
+            all_targets: set[str] = set()
+            for deps in result.graph.values():
+                all_targets.update(deps)
+            roots = [c.component_id for c in result.components if c.component_id not in all_targets]
+            if not roots and result.components:
+                roots = [result.components[0].component_id]
+
+            tree = Tree("[bold]Dependency Graph[/bold]")
+            visited_tree: set[str] = set()
+            for root in roots:
+                _build_tree(tree, root, result.graph, visited_tree)
+
+            console.print(tree)
+
+    except typer.Exit:
+        raise
+    except Exception as e:
+        handle_error(ctx, e)
+
+
+def _build_tree(
+    parent: Tree,
+    node_id: str,
+    graph: dict[str, list[str]],
+    visited: set[str],
+    depth: int = 0,
+) -> None:
+    if depth > 10:
+        return
+    label = f"[cyan]{node_id}[/cyan]" if node_id not in visited else f"[dim]{node_id} (cycle)[/dim]"
+    branch = parent.add(label)
+    if node_id in visited:
+        return
+    visited.add(node_id)
+    for dep in graph.get(node_id, []):
+        _build_tree(branch, dep, graph, visited, depth + 1)

cloudwright_ai_cli-0.1.0/cloudwright_cli/commands/catalog_cmd.py

@@ -0,0 +1,148 @@
+from __future__ import annotations
+
+from typing import Annotated
+
+import typer
+from cloudwright import Catalog
+from rich.console import Console
+from rich.table import Table
+
+console = Console()
+
+catalog_app = typer.Typer(
+    name="catalog",
+    help="Search and compare cloud service catalog.",
+    no_args_is_help=True,
+)
+
+
+@catalog_app.callback(invoke_without_command=True)
+def catalog_callback(ctx: typer.Context) -> None:
+    # Propagate json/verbose flags from parent ctx into this sub-app's ctx
+    if ctx.obj is None and ctx.parent and ctx.parent.obj:
+        ctx.obj = ctx.parent.obj
+    elif ctx.obj is None:
+        ctx.ensure_object(dict)
+
+
+@catalog_app.command("search")
+def catalog_search(
+    ctx: typer.Context,
+    query: Annotated[str, typer.Argument(help="Natural language search query")],
+    provider: Annotated[str | None, typer.Option(help="Filter by provider (aws, gcp, azure)")] = None,
+    vcpus: Annotated[int | None, typer.Option(help="Minimum vCPUs")] = None,
+    memory: Annotated[float | None, typer.Option(help="Minimum memory in GB")] = None,
+) -> None:
+    """Search the cloud service catalog."""
+    filters: dict = {}
+    if provider:
+        filters["provider"] = provider.lower()
+    if vcpus is not None:
+        filters["min_vcpus"] = vcpus
+    if memory is not None:
+        filters["min_memory_gb"] = memory
+
+    with console.status("Searching catalog..."):
+        results = Catalog().search(query, **filters)
+
+    # Resolve ctx.obj through parent chain when invoked via sub-app
+    obj = ctx.obj or (ctx.parent.obj if ctx.parent else None)
+    if obj and obj.get("json"):
+        import json
+
+        print(json.dumps({"results": results}, default=str))
+        return
+
+    if not results:
+        console.print("[yellow]No results found.[/yellow]")
+        return
+
+    table = Table(title=f'Catalog Search: "{query}"')
+    table.add_column("Service", style="cyan")
+    table.add_column("Provider")
+    table.add_column("Label")
+    table.add_column("vCPUs", justify="right")
+    table.add_column("Memory (GB)", justify="right")
+    table.add_column("$/hr", justify="right")
+    table.add_column("Notes", style="dim")
+
+    for item in results:
+        table.add_row(
+            item.get("service", ""),
+            item.get("provider", ""),
+            item.get("label", ""),
+            str(item.get("vcpus", "-")),
+            str(item.get("memory_gb", "-")),
+            f"${item['hourly']:.4f}" if item.get("hourly") else "-",
+            item.get("notes", ""),
+        )
+
+    console.print(table)
+
+
+@catalog_app.command("compare")
+def catalog_compare(
+    ctx: typer.Context,
+    instances: Annotated[list[str], typer.Argument(help="Instance names to compare (2 or more)")],
+) -> None:
+    """Compare two or more cloud instances side by side."""
+    if len(instances) < 2:
+        console.print("[red]Error:[/red] Provide at least 2 instance names to compare.")
+        raise typer.Exit(1)
+
+    with console.status("Fetching instance details..."):
+        # compare() takes *args, not a list — unpack here
+        results = Catalog().compare(*instances)
+
+    # Resolve ctx.obj through parent chain when invoked via sub-app
+    obj = ctx.obj or (ctx.parent.obj if ctx.parent else None)
+    if obj and obj.get("json"):
+        import json
+
+        inst_map = {r.get("name", r.get("id", "")): r for r in results}
+        print(json.dumps({"comparison": inst_map}, default=str))
+        return
+
+    if not results:
+        console.print("[yellow]No data found for the given instances.[/yellow]")
+        return
+
+    # Results is expected to be a list of dicts, one per instance
+    all_keys = set()
+    for r in results:
+        all_keys.update(r.keys())
+
+    display_fields = ["service", "provider", "label", "vcpus", "memory_gb", "hourly", "monthly", "notes"]
+    fields = [f for f in display_fields if f in all_keys]
+    for k in sorted(all_keys):
+        if k not in fields:
+            fields.append(k)
+
+    table = Table(title="Instance Comparison")
+    table.add_column("Attribute", style="cyan")
+    for instance in instances:
+        table.add_column(instance, justify="right")
+
+    inst_map = {r.get("name", r.get("id", r.get("service", ""))): r for r in results}
+
+    for field in fields:
+        row = [field]
+        for inst in instances:
+            # Try both bare name and provider-prefixed id
+            data = (
+                inst_map.get(inst)
+                or inst_map.get(f"aws:{inst}")
+                or inst_map.get(f"gcp:{inst}")
+                or inst_map.get(f"azure:{inst}")
+                or {}
+            )
+            val = data.get(field, "-")
+            if field in ("hourly", "price_per_hour") and isinstance(val, float):
+                row.append(f"${val:.4f}")
+            elif field in ("monthly", "price_per_month") and isinstance(val, float):
+                row.append(f"${val:,.2f}")
+            else:
+                row.append(str(val) if val is not None else "-")
+        table.add_row(*row)
+
+    console.print(table)

cloudwright_ai_cli-0.1.0/cloudwright_cli/commands/chat.py

@@ -0,0 +1,164 @@
+from __future__ import annotations
+
+from typing import Annotated
+
+import typer
+from cloudwright import Architect, ArchSpec
+from rich.console import Console
+from rich.panel import Panel
+from rich.prompt import Prompt
+from rich.rule import Rule
+from rich.syntax import Syntax
+
+console = Console()
+
+_HELP = """\
+Commands:
+  /save <file>     Save last architecture to YAML file
+  /cost            Show cost estimate for last architecture
+  /export <fmt>    Export last architecture (terraform, mermaid, sbom, aibom)
+  /quit            Exit
+"""
+
+
+def chat(
+    web: Annotated[bool, typer.Option("--web", help="Launch web UI instead of terminal chat")] = False,
+) -> None:
+    """Interactive architecture design chat."""
+    if web:
+        _launch_web()
+        return
+
+    _run_terminal_chat()
+
+
+def _launch_web() -> None:
+    try:
+        import cloudwright_web  # type: ignore
+        import uvicorn
+
+        console.print("[cyan]Launching Cloudwright web UI...[/cyan]")
+        uvicorn.run(cloudwright_web.app, host="127.0.0.1", port=8000)
+    except ImportError:
+        console.print(
+            "[red]Error:[/red] cloudwright-web is not installed.\nInstall it with: pip install cloudwright-web"
+        )
+        raise typer.Exit(1)
+
+
+def _run_terminal_chat() -> None:
+    console.print(
+        Panel(
+            "[bold cyan]Cloudwright Architecture Chat[/bold cyan]\nDescribe any cloud architecture.",
+            subtitle="Type /quit to exit",
+        )
+    )
+    console.print(f"[dim]{_HELP}[/dim]")
+
+    architect = Architect()
+    history: list[dict] = []
+    last_spec: ArchSpec | None = None
+
+    while True:
+        try:
+            user_input = Prompt.ask("\n[bold cyan]>[/bold cyan]")
+        except (KeyboardInterrupt, EOFError):
+            console.print("\n[dim]Exiting.[/dim]")
+            break
+
+        text = user_input.strip()
+        if not text:
+            continue
+
+        if text.lower() in ("/quit", "/exit", "/q"):
+            console.print("[dim]Goodbye.[/dim]")
+            break
+
+        if text.startswith("/save "):
+            path = text[6:].strip()
+            if not last_spec:
+                console.print("[yellow]No architecture to save yet.[/yellow]")
+            else:
+                from pathlib import Path
+
+                Path(path).write_text(last_spec.to_yaml())
+                console.print(f"[green]Saved to {path}[/green]")
+            continue
+
+        if text == "/cost":
+            if not last_spec:
+                console.print("[yellow]No architecture yet.[/yellow]")
+            elif not last_spec.cost_estimate:
+                console.print("[yellow]No cost estimate available.[/yellow]")
+            else:
+                _print_cost_summary(last_spec)
+            continue
+
+        if text.startswith("/export "):
+            fmt = text[8:].strip()
+            if not last_spec:
+                console.print("[yellow]No architecture to export yet.[/yellow]")
+            else:
+                try:
+                    content = last_spec.export(fmt)
+                    lang = {"terraform": "hcl", "mermaid": "text"}.get(fmt, "json")
+                    console.print(Syntax(content, lang, theme="monokai", word_wrap=True))
+                except ValueError as e:
+                    console.print(f"[red]Error:[/red] {e}")
+            continue
+
+        # Treat as architecture request
+        history.append({"role": "user", "content": text})
+
+        with console.status("Thinking..."):
+            try:
+                if last_spec and _looks_like_modification(text):
+                    spec = architect.modify(last_spec, text)
+                else:
+                    spec = architect.design(text)
+            except Exception as e:
+                console.print(f"[red]Error:[/red] {e}")
+                history.pop()
+                continue
+
+        last_spec = spec
+        history.append({"role": "assistant", "content": f"Designed: {spec.name}"})
+
+        yaml_str = spec.to_yaml()
+        console.print(Rule(f"[bold cyan]{spec.name}[/bold cyan]"))
+        console.print(Syntax(yaml_str, "yaml", theme="monokai", word_wrap=True))
+
+        if spec.cost_estimate:
+            _print_cost_summary(spec)
+
+
+def _looks_like_modification(text: str) -> bool:
+    mod_verbs = (
+        "add",
+        "remove",
+        "change",
+        "update",
+        "replace",
+        "increase",
+        "decrease",
+        "modify",
+        "swap",
+        "upgrade",
+        "downgrade",
+    )
+    lower = text.lower()
+    return any(lower.startswith(v) or f" {v} " in lower for v in mod_verbs)
+
+
+def _print_cost_summary(spec: ArchSpec) -> None:
+    from rich.table import Table
+
+    table = Table(title="Cost Estimate", show_footer=True)
+    table.add_column("Component", style="cyan")
+    table.add_column("Monthly", justify="right", footer=f"${spec.cost_estimate.monthly_total:,.2f}")
+    table.add_column("Notes", style="dim")
+
+    for item in spec.cost_estimate.breakdown:
+        table.add_row(item.component_id, f"${item.monthly:,.2f}", item.notes)
+
+    console.print(table)

cloudwright_ai_cli-0.1.0/cloudwright_cli/commands/compare.py

@@ -0,0 +1,75 @@
+from __future__ import annotations
+
+from pathlib import Path
+from typing import Annotated
+
+import typer
+from cloudwright import Architect, ArchSpec
+from rich.console import Console
+from rich.table import Table
+
+console = Console()
+
+
+def compare(
+    spec_file: Annotated[Path, typer.Argument(help="Path to spec YAML file", exists=True)],
+    providers: Annotated[str, typer.Option(help="Comma-separated target providers")],
+) -> None:
+    """Compare an architecture across multiple cloud providers."""
+    target_providers = [p.strip() for p in providers.split(",") if p.strip()]
+    if not target_providers:
+        console.print("[red]Error:[/red] --providers requires at least one provider")
+        raise typer.Exit(1)
+
+    spec = ArchSpec.from_file(spec_file)
+
+    with console.status("Generating alternatives..."):
+        alts = Architect().compare(spec, target_providers)
+
+    all_providers = [spec.provider] + [a.provider for a in alts]
+    alt_map = {spec.provider: spec}
+    for alt in alts:
+        if alt.spec:
+            alt_map[alt.provider] = alt.spec
+
+    # Side-by-side service comparison
+    table = Table(title=f"Provider Comparison — {spec.name}")
+    table.add_column("Component", style="cyan")
+    table.add_column("Original Label")
+    for p in all_providers:
+        table.add_column(p.upper())
+
+    for comp in spec.components:
+        row = [comp.id, comp.label]
+        for p in all_providers:
+            s = alt_map.get(p)
+            if s:
+                mapped = next((c for c in s.components if c.id == comp.id), None)
+                row.append(mapped.service if mapped else "-")
+            else:
+                row.append("-")
+        table.add_row(*row)
+
+    console.print(table)
+
+    # Monthly totals
+    totals_table = Table(title="Monthly Cost Totals", show_header=True)
+    totals_table.add_column("Provider")
+    totals_table.add_column("Monthly Total", justify="right")
+    totals_table.add_column("Key Differences", style="dim")
+
+    origin_total = spec.cost_estimate.monthly_total if spec.cost_estimate else 0.0
+    totals_table.add_row(
+        spec.provider.upper(),
+        f"${origin_total:,.2f}" if origin_total else "-",
+        "(baseline)",
+    )
+    for alt in alts:
+        diffs = ", ".join(alt.key_differences[:3]) if alt.key_differences else ""
+        totals_table.add_row(
+            alt.provider.upper(),
+            f"${alt.monthly_total:,.2f}" if alt.monthly_total else "-",
+            diffs,
+        )
+
+    console.print(totals_table)