cloudwright-ai-web 0.1.0__tar.gz

cloudwright_ai_web-0.1.0/.claude/notepad.json

@@ -0,0 +1,5 @@
+{
+  "priority": "",
+  "working": [],
+  "manual": []
+}

cloudwright_ai_web-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_web-0.1.0/CLAUDE.md

@@ -0,0 +1,19 @@
+# cloudwright-web
+
+Web UI for Cloudwright. FastAPI backend wrapping core package + React frontend.
+
+## Backend
+
+`backend/app.py` — FastAPI app with endpoints for design, cost, validate, export, catalog.
+
+## Frontend
+
+React + TypeScript + Vite. Interactive architecture diagrams with React Flow,
+cost tables, comparison views. Same chat experience as the CLI but visual.
+
+## Running
+
+```bash
+cloudwright serve          # starts both backend and frontend
+cloudwright chat --web     # same thing
+```

cloudwright_ai_web-0.1.0/PKG-INFO

@@ -0,0 +1,38 @@
+Metadata-Version: 2.4
+Name: cloudwright-ai-web
+Version: 0.1.0
+Summary: Web UI 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,cloud,fastapi,web
+Classifier: Development Status :: 3 - Alpha
+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: fastapi<1,>=0.116
+Requires-Dist: uvicorn[standard]<1,>=0.35
+Description-Content-Type: text/markdown
+
+# cloudwright-web
+
+Web UI for [Cloudwright](https://github.com/xmpuspus/cloudwright) architecture intelligence. FastAPI backend with React frontend.
+
+## Install
+
+```bash
+pip install cloudwright[web]
+```
+
+## Usage
+
+```bash
+cloudwright serve          # starts the web server
+cloudwright chat --web     # same thing
+```
+
+The API runs at `http://localhost:8000` with endpoints for design, cost, validate, export, and catalog operations.
+
+See the [main project README](https://github.com/xmpuspus/cloudwright) for full documentation.

cloudwright_ai_web-0.1.0/README.md

@@ -0,0 +1,20 @@
+# cloudwright-web
+
+Web UI for [Cloudwright](https://github.com/xmpuspus/cloudwright) architecture intelligence. FastAPI backend with React frontend.
+
+## Install
+
+```bash
+pip install cloudwright[web]
+```
+
+## Usage
+
+```bash
+cloudwright serve          # starts the web server
+cloudwright chat --web     # same thing
+```
+
+The API runs at `http://localhost:8000` with endpoints for design, cost, validate, export, and catalog operations.
+
+See the [main project README](https://github.com/xmpuspus/cloudwright) for full documentation.

cloudwright_ai_web-0.1.0/cloudwright_web/__init__.py

@@ -0,0 +1,11 @@
+"""Cloudwright Web — FastAPI backend for architecture intelligence."""
+
+__version__ = "0.1.0"
+
+
+def __getattr__(name: str):
+    if name == "app":
+        from cloudwright_web.app import app
+
+        return app
+    raise AttributeError(f"module 'cloudwright_web' has no attribute {name!r}")

cloudwright_ai_web-0.1.0/cloudwright_web/app.py

@@ -0,0 +1,299 @@
+"""FastAPI backend wrapping the Cloudwright core package."""
+
+from __future__ import annotations
+
+import logging
+from pathlib import Path
+from typing import Literal
+
+from cloudwright import ArchSpec, Constraints
+from cloudwright.architect import Architect
+from cloudwright.catalog import Catalog
+from cloudwright.cost import CostEngine
+from cloudwright.differ import Differ
+from cloudwright.exporter import FORMATS, export_spec
+from cloudwright.validator import Validator
+from fastapi import FastAPI, HTTPException
+from fastapi.middleware.cors import CORSMiddleware
+from fastapi.responses import FileResponse
+from fastapi.staticfiles import StaticFiles
+from pydantic import BaseModel, Field
+
+log = logging.getLogger(__name__)
+
+app = FastAPI(title="Cloudwright", version="0.1.0", description="Architecture intelligence for cloud engineers")
+
+app.add_middleware(
+    CORSMiddleware,
+    allow_origins=["http://localhost:5173", "http://localhost:3000"],
+    allow_methods=["*"],
+    allow_headers=["*"],
+)
+
+# Lazy singletons
+_architect: Architect | None = None
+_catalog: Catalog | None = None
+_cost_engine: CostEngine | None = None
+
+
+def get_architect() -> Architect:
+    global _architect
+    if _architect is None:
+        _architect = Architect()
+    return _architect
+
+
+def get_catalog() -> Catalog:
+    global _catalog
+    if _catalog is None:
+        _catalog = Catalog()
+    return _catalog
+
+
+def get_cost_engine() -> CostEngine:
+    global _cost_engine
+    if _cost_engine is None:
+        _cost_engine = CostEngine()
+    return _cost_engine
+
+
+# --- Request/Response models ---
+
+
+class DesignRequest(BaseModel):
+    description: str = Field(..., min_length=5, max_length=2000)
+    provider: str = "aws"
+    region: str = "us-east-1"
+    budget_monthly: float | None = None
+    compliance: list[str] = Field(default_factory=list)
+
+
+class ModifyRequest(BaseModel):
+    spec: dict
+    instruction: str = Field(..., min_length=3, max_length=2000)
+
+
+class ValidateRequest(BaseModel):
+    spec: dict
+    compliance: list[str] = Field(default_factory=list)
+    well_architected: bool = False
+
+
+class ExportRequest(BaseModel):
+    spec: dict
+    format: str
+
+
+class DiffRequest(BaseModel):
+    old_spec: dict
+    new_spec: dict
+
+
+class CostRequest(BaseModel):
+    spec: dict
+    compare_providers: list[str] = Field(default_factory=list)
+
+
+class CatalogSearchRequest(BaseModel):
+    query: str | None = None
+    provider: str | None = None
+    vcpus: int | None = None
+    memory_gb: float | None = None
+    max_price_per_hour: float | None = None
+    limit: int = Field(default=20, ge=1, le=100)
+
+
+class CatalogCompareRequest(BaseModel):
+    instance_names: list[str] = Field(..., min_length=2)
+
+
+class ChatMessage(BaseModel):
+    role: Literal["user", "assistant"]
+    content: str
+
+
+class ChatRequest(BaseModel):
+    message: str = Field(..., min_length=1, max_length=2000)
+    history: list[ChatMessage] = Field(default_factory=list)
+
+
+# --- Endpoints ---
+
+
+@app.get("/api/health")
+def health():
+    try:
+        catalog = get_catalog()
+        # Quick check: can we search?
+        results = catalog.search(query="m5", limit=1)
+        return {"status": "ok", "catalog_loaded": True, "sample_count": len(results)}
+    except Exception:
+        return {"status": "ok", "catalog_loaded": False}
+
+
+@app.post("/api/design")
+def design(req: DesignRequest):
+    try:
+        architect = get_architect()
+        constraints = None
+        if req.budget_monthly or req.compliance:
+            constraints = Constraints(
+                budget_monthly=req.budget_monthly,
+                compliance=req.compliance,
+            )
+        spec = architect.design(req.description, constraints=constraints)
+        return {"spec": spec.model_dump(exclude_none=True), "yaml": spec.to_yaml()}
+    except Exception as e:
+        log.exception("Design endpoint failed")
+        raise HTTPException(status_code=500, detail="Internal server error") from e
+
+
+@app.post("/api/modify")
+def modify(req: ModifyRequest):
+    try:
+        architect = get_architect()
+        spec = ArchSpec.model_validate(req.spec)
+        updated = architect.modify(spec, req.instruction)
+        return {"spec": updated.model_dump(exclude_none=True), "yaml": updated.to_yaml()}
+    except Exception as e:
+        log.exception("Modify endpoint failed")
+        raise HTTPException(status_code=500, detail="Internal server error") from e
+
+
+@app.post("/api/cost")
+def cost(req: CostRequest):
+    try:
+        engine = get_cost_engine()
+        spec = ArchSpec.model_validate(req.spec)
+        estimate = engine.estimate(spec)
+
+        result = {"estimate": estimate.model_dump()}
+
+        if req.compare_providers:
+            architect = get_architect()
+            alternatives = architect.compare(spec, req.compare_providers)
+            result["alternatives"] = [a.model_dump(exclude_none=True) for a in alternatives]
+
+        return result
+    except Exception as e:
+        log.exception("Cost endpoint failed")
+        raise HTTPException(status_code=500, detail="Internal server error") from e
+
+
+@app.post("/api/validate")
+def validate(req: ValidateRequest):
+    try:
+        validator = Validator()
+        spec = ArchSpec.model_validate(req.spec)
+        frameworks = req.compliance if req.compliance else []
+        results = validator.validate(spec, compliance=frameworks or None, well_architected=req.well_architected)
+        return {"results": [r.model_dump() for r in results]}
+    except Exception as e:
+        log.exception("Validate endpoint failed")
+        raise HTTPException(status_code=500, detail="Internal server error") from e
+
+
+@app.post("/api/export")
+def export(req: ExportRequest):
+    try:
+        spec = ArchSpec.model_validate(req.spec)
+        if req.format not in FORMATS:
+            raise HTTPException(
+                status_code=400, detail=f"Unknown format: {req.format}. Supported: {', '.join(FORMATS)}"
+            )
+        content = export_spec(spec, req.format)
+        return {"content": content, "format": req.format}
+    except HTTPException:
+        raise
+    except Exception as e:
+        log.exception("Export endpoint failed")
+        raise HTTPException(status_code=500, detail="Internal server error") from e
+
+
+@app.post("/api/diff")
+def diff(req: DiffRequest):
+    try:
+        differ = Differ()
+        old = ArchSpec.model_validate(req.old_spec)
+        new = ArchSpec.model_validate(req.new_spec)
+        result = differ.diff(old, new)
+        return {"diff": result.model_dump()}
+    except Exception as e:
+        log.exception("Diff endpoint failed")
+        raise HTTPException(status_code=500, detail="Internal server error") from e
+
+
+@app.post("/api/catalog/search")
+def catalog_search(req: CatalogSearchRequest):
+    try:
+        catalog = get_catalog()
+        instances = catalog.search(
+            query=req.query,
+            vcpus=req.vcpus,
+            memory_gb=req.memory_gb,
+            provider=req.provider,
+            max_price_per_hour=req.max_price_per_hour,
+            limit=req.limit,
+        )
+        return {"instances": instances}
+    except Exception as e:
+        log.exception("Catalog search endpoint failed")
+        raise HTTPException(status_code=500, detail="Internal server error") from e
+
+
+@app.post("/api/catalog/compare")
+def catalog_compare(req: CatalogCompareRequest):
+    try:
+        catalog = get_catalog()
+        result = catalog.compare(*req.instance_names)
+        return {"comparison": result}
+    except Exception as e:
+        log.exception("Catalog compare endpoint failed")
+        raise HTTPException(status_code=500, detail="Internal server error") from e
+
+
+@app.post("/api/chat")
+def chat(req: ChatRequest):
+    try:
+        from cloudwright.architect import ConversationSession
+
+        architect = get_architect()
+        session = ConversationSession(llm=architect.llm)
+
+        # Replay history into the session
+        for msg in req.history:
+            session.history.append({"role": msg.role, "content": msg.content})
+
+        text, spec = session.send(req.message)
+        # Fallback: if session didn't extract a spec, try direct design
+        if spec is None and not req.history:
+            spec = architect.design(req.message)
+            text = f"Architecture: {spec.name}"
+        result: dict = {"reply": text, "history": session.history}
+        if spec:
+            result["spec"] = spec.model_dump(exclude_none=True)
+            result["yaml"] = spec.to_yaml()
+        return result
+    except Exception as e:
+        log.exception("Chat endpoint failed")
+        raise HTTPException(status_code=500, detail="Internal server error") from e
+
+
+# Serve frontend static files if they exist
+_frontend_dist = Path(__file__).parent.parent / "frontend" / "dist"
+if _frontend_dist.exists():
+    app.mount("/assets", StaticFiles(directory=str(_frontend_dist / "assets")), name="assets")
+
+    @app.get("/{path:path}")
+    def serve_frontend(path: str):
+        file_path = (_frontend_dist / path).resolve()
+        if file_path.is_relative_to(_frontend_dist.resolve()) and file_path.is_file():
+            return FileResponse(str(file_path))
+        return FileResponse(str(_frontend_dist / "index.html"))
+
+
+def serve(host: str = "127.0.0.1", port: int = 8000):
+    """Start the Cloudwright web server."""
+    import uvicorn
+
+    uvicorn.run(app, host=host, port=port)

cloudwright_ai_web-0.1.0/frontend/index.html

@@ -0,0 +1,16 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>Cloudwright — Architecture Intelligence</title>
+    <style>
+      * { margin: 0; padding: 0; box-sizing: border-box; }
+      body { font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif; background: #0f172a; color: #e2e8f0; }
+    </style>
+  </head>
+  <body>
+    <div id="root"></div>
+    <script type="module" src="/src/main.tsx"></script>
+  </body>
+</html>

cloudwright_ai_web-0.1.0/frontend/package.json

@@ -0,0 +1,23 @@
+{
+  "name": "cloudwright-web",
+  "private": true,
+  "version": "0.1.0",
+  "type": "module",
+  "scripts": {
+    "dev": "vite",
+    "build": "tsc && vite build",
+    "preview": "vite preview"
+  },
+  "dependencies": {
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1",
+    "@xyflow/react": "^12.3.0"
+  },
+  "devDependencies": {
+    "@types/react": "^18.3.0",
+    "@types/react-dom": "^18.3.0",
+    "@vitejs/plugin-react": "^4.3.0",
+    "typescript": "^5.5.0",
+    "vite": "^5.4.0"
+  }
+}